Developer Studio 1.2.0 Release note

• Upgrade/Install instructions
• Features
• Known Limitations
• Bugs Fixed
• 1.2.0
• 1.1.2
• 1.1.1
• 1.1.0
• 1.0.2
• 1.0.1

Upgrade/Install instructions

First time install
Please use the provided installer and just follow the steps in order to install Developer Studio for the first time.

Upgrade
Updates are automatically checked at each Developer Studio launch, and it is possible to upgrade to the new version just by following the instructions.
It is also possible to start the updates checking job by using the Help > Check for Updates menu.

Important note concerning workspace compatibility:
Developer Studio 1.2.0 uses a new metadata format for handling Open AT projects.
When reusing an existing workspace which was created with an older version, projects are automatically converted to this new format, but won't be compatible anymore with former versions.
If you plan to still handle projects with former versions, it is recommended to start a fresh new workspace with Developer Studio 1.2.0, and to import the needed projects from the former workspace to the new one.

Note concerning Target Management perspective:
Developer Studio 1.2.0 provides a new Target Management perspective which replace the one provided by former versions. After an upgrade, the old Target Management perspective is not usable anymore; the user should close it, and then open manually the new Target Management perspective.

Note concerning upgrade from 1.1.0 release or older:
If you are currently using Developer Studio version 1.1.0 or older, it is not possible to upgrade it to 1.2.0 release; you have to use the provided Software Installer instead, in order to install it in an empty new directory.

Installation over an Eclipse platform

It is possible to install Developer Studio as a set of plug-ins over an existing Eclipse platform.

• Prerequisites: Developer Studio 1.2.0 requires Eclipse Helios (3.6) version. Download it from http://eclipse.org/downloads
  (Best choice to start is Eclipse for C/C++ Developers)
  Developer Studio plug-ins can be installed on Win32 and Linux (32 or 64 bits) platforms
• Go to Help > Install New Software
• Add the following URL as new update site (drag'n drop the URL to the Eclipse dialog box):
• http://updatesite.sierrawireless.com/developerStudio
• Check the Developer Studio plugins feature in the Developer Studio for Eclipse category, click Install and follow the steps.

Installation of Developer Studio source code (advanced users only)

Developer Studio source code is available for Eclipse developers.
Please follow the steps above to install Developer Studio plug-ins over an Eclipse SDK.
Developer Studio source code can be retrieved by checking the whole Source code category, before selecting the Install button.

Features Developer Studio 1.2.0

1. Packages management

• [New in 1.2.0]Capability to upgrade target firmware from Package Manager view
• Capability to explore packages resources directory with the system explorer
• Package Manager perspective, allowing to manage package repositories and installed packages.
• Capability to download and install packages from remote update sites.
• Packages documentation integrated in the Developer Studio help.
• Capability to configure the installed packages location.

2. Develop

• Lua projects support (bytecode generation from .lua files)
• Outline support in Lua source code editor
• Project creation wizard with Target Platform configuration and easy access to samples documentation
• C/C++ support
• Project Management: Project Creation Wizard / Import Project / Import Open AT Software Packages
• C/C++ Source Code Editor
• Readability: Explicit syntax color coding
• Views: Project View / Function call hierarchy view / Include file hierarchy view
• Searching: Indexation engine and shortcuts
• Writing: Word completion
• Lua source code editor
• Application settings editor and code generation
• Project dependencies management (automated compiler/linker settings update when adding/removing a project dependency)

3. Build

• C/C++ compilers support
• Additional build steps support
• Compiler: GCC ARM EABI 4.4.1 / GCC ARM ELF 4.0.1 / MinGW / ADS Compliant / RVDS (3.1, 4.0) Compliant
• Compilation Flags: Managed for full project or file by file
• Compilation Options: Managed for full project or file by file
• Incremental Build
• Build Reporting: Explicit error and warning message / Direct access to source code linked to errors and warnings
• Batch build capability (invoke a project build from the command line)
• Open AT Plug-ins packaging facility (through scripts), for distribution to the community.
• Enhanced build configuration wizard.
• Automatically embeds information on integrated components version (Open AT OS and Plug-ins) in the application binary
  This information is readable thanks to the ATI9 command (available starting from Firmware version R7.4)
• Paths to GCC/MinGW compilers are configurable (capability to use an external distribution)
• MinGW build support under Linux
  (only if i586-mingw32msvc-gcc cross-compiler toolchain is installed on the system)

4. Target Connectivity

• [New in 1.2.0] Devices View:
• [New in 1.2.0] Multiple targets connection handling
• [New in 1.2.0] Development mode/Production mode configuration
• [New in 1.2.0] Project - Connection link
• Download
• File Type: Application Binary / Firmware binary / Bootloader binary
• File Format: DWL
• [New in 1.2.0] Prompt before redownload the same DWL file to the target (requires 7.43 FW or higher)
• Info View:
• Target Serial Number / Target Mode / Embedded module Identification / Embedded Software Identification
• [New in 1.2.0] Open AT application presence detection
• [New in 1.2.0] Embedded binaries data retrieval
• [New in 1.2.0] Target memory configuration retrieval
• AT Console
• [New in 1.2.0] Configurable colouring in development/production mode
• [New in 1.2.0] Scroll lock
• [New in 1.2.0] File logging

5. Debug

• Trace:
• Trace Filtering / Time Stamp / Log
• [New in 1.2.0] Development mode enablement saved on the target (only with Firmware 7.44 and above versions)
• [New in 1.2.0] Scroll lock
• [New in 1.2.0] File logging
• Backtraces decoding:
• [New in 1.2.0] Retrieve and decode backtraces stored in the module
• [New in 1.2.0] Clear stored backtraces
• [New in 1.2.0] Explicit backtrace messages
• [New in 1.2.0] Hyperlinks to application source code
• [New in 1.2.0] Automated AXF file selection from project link
• Memory: Heap Status (Beta version)
• [New in 1.2.0] Retrieve the list of currently allocated heap memory blocks
• [New in 1.2.0] Automated symbols file selection from project link
• Remote Task Environment
• JTAG
• Possibility to bypass target presence check before launching a JTAG session

5. Miscellaneous

• Software Updates automatically checked on start-up
• Generic Software installer allowing to download an install latest software versions
• [New in 1.2.0] Based on Eclipse Helios 3.6.1 (What's new) and CDT 7.0.1 (What's new)
• CVS and SVN repositories connection support
• Integrated Help
• Integrated Software Update
• Windows® Platform Support: Windows® XP, Windows® Vista, Windows® 7
• Linux support ([New in 1.2.0] including Target Management features and 64 bits Linux)
  Available only by installing over an existing Eclipse platform.
• Developer Studio source code available
  Available only by installing over an existing Eclipse platform.

Known limitations & bugs

1. Generic

• Needs an external Java environment previously installed (JAVA 1.6) when using the installer. Once installed, Developer Studio is standalone

2. Build system / Open AT Projects management

• Build configurations: new Open AT build configurations can only be created through the New > Open AT Configuration menu.
  (configurations created through the New... button of the Build Configuration manager can't build correctly)
• Workspace paths with space characters are not supported
• No synchronization check between the Firmware version used in a project, and the one running on the connected Module

3. Target management

• Heap memory status does not contain links to source code
• No baudrate autodetection
• 7.44 Firmware bug impact: on USB connection, as soon as Development Mode is configured to resist to target reset, AT commands answers are not displayed.
  Workaround: in the preferences, disable the development mode persistence option when working with an USB connection

4. Run & Debug

• JTAG Debug relies on third-party non-integrated software (Open OCD)
• JTAG Debug works only is the download step is skipped in the Run configuration
• No check if the connected Embedded module is "JTAG-able"
• Breakpoints cannot be added during a debug session while the program is running (they have to be added when the execution has stopped on another breakpoint)

Bugs fixed and minor enhancements

Release 1.2.0

1. Packages management

• Already installed packages are grayed in available packages view, and install action is disabled on them
• Capability to import packages from another Developer Studio install
• Fixed: packages sorting order in all views

2. Develop

• >Added possibility to disable application settings editor (and to remove generated.c file)
• Modified trace embedding confguration terminology
• Automatic update + lock of memory type configuration when using plug-ins requiring 1MB+ settings
• Fixed: synchronization issues between the UI and the really used build configuration (dependencies include paths not updates, etc...)
• Fixed: toolchains choice restricted by plug-ins selection in the project creation wizard

3. Build

• Added capability to tag a file, in order to always recompile it on each build
• Added capability to configure error parsers
• Highlighting include and link errors in problems view
• Many fixes concerning link issues with ARM EABI GCC toolchain (C++, inline code)
• Added capability to configure GCC linker script to map sections to application code or RAM areas
• Fixed: delta generation bug introduced in 1.1.2

4. Run & Debug

• Capability to change the used port in launch configurations
• Fixed: perspective switch to Target Management is configurable on Open AT Target application run/debug

5. Miscellaneous

• Added Linux 64 bits support

6. Target management

• Fixed: Developer Studio crashes on operations related to Target management (connect, baudrate autodetection, download)
• Fixed: Trace logging is disabled as soon as the target resets
• Fixed: Target info view is not automatically refreshed
• Added capability to configure Traces and Console buffers length
• Added capability to configure Traces file logging format
• Added action to reset the module
• Added capability to start a download even if module is already in bootloader mode
• Explicit status markers on configuration/connection issues in Target Management views
• Added capability to configure Traces timestamp format
• Added capability to restore production mode when closing connection and/or Developer Studio application
• Fixed: handling of +++ and Ctrl-Z/ESC for text commands in the console
• Fixed: %p handling in traces
• Fixed: target reset handling over USB connection

7. Headless mode / Packages integration

• Add capability to package both Debug and Release built libraries
• Add capability to package "ready to download" applications
• Add capability to package plug-ins with libraries
• Make -samplelib option working with libraries from other plug-ins (in wmnew.opt files)

Release 1.1.2

1. Packages management

• Implemented: background install procedure + "proportional" progress monitor
• Package column in Installed Packages view is now resizable (to show full package name when it is too long)
• Release note tab added in Properties view when selecting a package in Installed Packages view
• Added a confirmation dialog when deleting a repository from Available Packages view
• Fixed: Software Updates were not working after a package installation
• Fixed: Exception when trying to install new package while updates checking job was running

2. Develop

• Generated files names & paths are now changeable in the Application Settings editor.
• Application Settings editor reworded for clarification
• Bugs fixed concerning application settings editor content reseted when project properties are modified
• Used plug-in version selection bug fixed (both old and new versions were kept until old version was unselected again in the UI)
• New project location edit box not cleared anymore when default checkbox is unselected
• Code editor: grayed sections are now matching with the currently active build configuration

3. Build

• Error parsers enhanced to report missing errors wrt. the console output
• Added graphical decorator on the currently active build configuration output folder in the project explorer
• Configure ARM license variables definition in a separated preference page
• Fix usage of tcc with RVDS; now use armcc with the relevant option to choose Thumb or ARM mode

4. Run & Debug

• Fixed: launch configuration was locked when previous launch was canceled due to compilation errors
• Fixed: "Label error" issue on breakpoint stop in RTE

5. Miscellaneous

• Added Windows® 7 support

6. Headless mode / Packages integration

• Add -mem option support in wmnew.opt files for samples integration
• Add requiredMemTypeID property support for packages integration, to force a required memory type on project creation, when depending on the integrated package
• Add stackSizeProcessingRequired property support for packages integration, to declare if integrated samples source codes already manage stack size declaration according to the used toolchain, or not.
• Add helpBooks property support for packages integration, to declare a list of HTML help books to be integrated
• Bug fixed: when creating in headless mode a sample project depending on a sample library (e.g. Application_Download), the dependency reference was not correctly set and the project was not building correctly.
• Modified default RVDS options to make link possible with new EABI compatible GCC.

Release 1.1.1

1. Install / General

• Issues fixed regarding install/uninstall of some packages

2. Build system / Open AT Projects management

• Popup error messages when project package dependencies are missing have been replaced by error markers in the Problems view
• When changing a project's dependency on an SDK profile, all packages dependencies are modified (including plug-ins)
• ATI9 info was not always updated when modifying project dependencies
• Sometimes, "An internal error occurred during: "C/C++ Indexer" message war appearing at project creation/import.
  
• Library projects dependencies are now managed automatically
• It is now possible to import a project created under a Windows Developer Studio into a Linux Developer Studio

3. Run & Debug

• Trace and shell views were closed when launching a new Run/Debug session

Release 1.1.0

1. Install / General

• Uninstall of packages was refused if used by at least one project.
• Help > Software Update menu was not enabled on 1.0.2
• Fix display/indexing issues on Traditional Chinese OS and others

2. Build system / Open AT Projects management

• Developer Studio created project was unable to build after import if it had dependencies on other workspace projects
• ARM ELF GCC / MinGW build was failing if path to SPM Registry is too long (>~100 characters, ie. workspace path >~50 characters with default settings)
  Now embedded compilers are managed in Developer Studio install location, and a warning is displayed in Developer Studio preferences if the install path is too long.
• Cleaning of unnecessary files on project import from IDE V1/creation from a sample

3. Target management

• Debug traces logging to file feature was not usable ("cyclic buffer" behavior, beginning of the file was lost after some time)
• Confirmation messages removed on connection/download success
• Text AT commands (a.g. AT+CMGW) were not supported in shell (Ctrl-Z did not work)

4. Run & Debug

• Warning message when trying to start several launch session at the same time.
• Automatic connection to the target (if not already done) when launching for the first time.

Release 1.0.2

1. Install / General

• Desktop/Start menu shortcuts added for all users
• Online update site available for software update
• "Out of memory" error fixed

2. Build system / Open AT Projects management

• Build errors fixed with ARM ELF GCC & MinGW under Windows Vista
• Remove useless Release configuration for application projects in RTE mode
• Default configurations at project creation time are new Target ARM ELF GCC and RTE MinGW

3. Target management

• DUMP frames sent by the Firmware were not correctly decoded

4. Run & Debug

• Launch configurations (Run/Debug) can be simply created by using the Run/Debug toolbar button
• Automatic switch to Target Management perspective when running a project in RTE

Release 1.0.1

1. Install

• Desktop/Start menu shortcuts added by the Developer Studio light installer
• Windows Vista support issues

2. Build system / Open AT Projects management

• No need anymore to take care about the libraries order on the ARM ELF GCC linker command line
• Some plug-ins samples (e.g. from C-GPS plug-in) dependencies to other plug-ins not correctly managed
• It was not possible to change the current OS version in a library project
• Bad symbol name generation for C-GPS plug-in (makes the build fail with ARM compilers)
• Incremental build was not working (relink of the application was performed on each build request)
• Added by default the -fno-profile option on ARM ELF GCC compiler command line
• IDE V1 project import was not working when source paths out of the project directory were referenced
• IDE V1 library project import was not working
• IDE V1 project import did not import symbols declared with the -flag option
• Several issues fixed concerning IDE V1 projects import depending on library projects

3. Target management

• Target Management Toolbar icons strange behaviour when an automatic build is triggered
• Empty trace levels configuration box after an undetected target reset
• Traces containing a %u format character not correctly displayed
• COM port identifier not correctly configured if greater than 9
• Target management doesn't go anymore to "connected" state if the COM settings are incorrect
• New toolbar button in the trace view usable to force the target back to Debug after an undetected reset