Developer Studio 4.1 Release note

• Getting Started
• Compatibility
• Features
• Known Limitations
• Bugs fixed and minor enhancements
  • 4.1
  • 4.0
  • 3.6
  • 3.5
  • 3.4
  • 3.3
  • 3.2
  • 3.1
  • 3.0

---

Getting Started

Installation instructions and requirements are listed in the following documents:

• Legato Application Development Kit - Windows
• Legato Application Development Kit - Linux

Please refer to these online docs in order to know how to install Developer Studio on your system.

---

Compatibility

Developer Studio version 4.1 is compatible with Legato versions from 16.01 to 16.04.
Legato versions out of this range should not be fully compatible with Developer Studio 4.1, and some features may not work as expected.

---

Features of Developer Studio 4.1

1. Packages management

• 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 explore packages resources directory with the system explorer
• Capability to configure the installed packages location.
• Capability to display only baselines (default mode), or all packages (for advanced users)
• On Linux hosts, command line application to install Legato packages from the official Sierra Wireless repository

2. Development

• Project creation wizard:
  • Hardware configuration
  • Target Platform configuration
  • Easy access to samples documentation
  • Hardware configuration or detection from connected module
• Project import wizards
• Project configuration properties pages
• C/C++ languages support
• [New in 4.1] Java language support
• Source Code Editor (for all supported languages)
  • Readability: Explicit syntax color coding
  • Views: Project View / Function call hierarchy view / Include file hierarchy view
  • Searching: Index engine and source code navigation
  • Writing: Word completion
• Project dependencies management (automated build settings update when adding/removing a project dependency)
• Target Platform configuration (package dependencies) management:
  • At project level
  • At workspace level
  • At build configuration level
• "Built-in" Target Platforms management (automatically created, based on package baselines)
• "Refactoring" support (automatic settings update when the source code layout is modified):
  • projects renaming
  • folder renaming
• Application tagging facilities and Application Repository management
• Managed projects:
  • Legato Linux toolchain for standard C/C++ projects management
  • Legato Application Framework projects management
• Legato settings files edition:
  • Supports edition for application definition (*.adef) files, in text mode
  • Supports edition for component definition (*.cdef) files, in text mode
  • Supports edition for system definition (*.sdef) files, in text mode
  • Supports edition for API definition (*.api) files, in text mode
  • Contextual help on Legato API from source code editor
  • Contextual help on Legato settings from *.adef, *.cdef and *.sdef files editors
  • Hyperlinks (Ctrl-click), completion (Ctrl-space), renaming management from *.cdef files to:
    • source files
    • required and provided *.api files
    • required libraries from toolchain
  • Hyperlinks (Ctrl-click), completion (Ctrl-space), renaming management from *.api files to referenced *.api files, and for various types and constants used in *.api files
  • Hyperlinks (Ctrl-click), completion (Ctrl-space), renaming management from *.adef files to:
    • referenced *.cdef files (in executables and bindings sections)
    • referenced *.api files (in bindings sections)
    • bundled files and folders
• Code generation (for all supported languages) from API files
• Available API paths node in Project Explorer

3. Build

• C/C++ compilers support
• [New in 4.1] Java compiler support
• 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)
• Enhanced build configuration wizard.
• Paths to compilers are configurable (capability to use an external distribution)
• Support of makefiles generation
• Application packaging facility for upload to a target device through the AirVantage platform.
• [New in 4.1] For Java, configuration of embedded Java Virtual Machine to be used on the device.

4. Target Connectivity

Connection management:

• Device connection settings over SSH session
• Supports USB and Ethernet connectivity
• Device discovery on the network
• Serial console for troubleshooting (terminal only)

SSH terminal:

• Full-featured SSH terminal, supporting completion, colors, command history, etc...
• Multiple instances terminal on the same device
• Configurable terminal colors and buffer size

File system:

• Full file system access over SFTP (browsing, copy, move, deletion)
• Files exchange through drag and drop from/to the Project Explorer
• On-device text files edition support

Application management:

• List of installed Legato applications on the device
• Installation of new applications on the device
• Deletion of applications
• Start/Stop/Restart of applications
• Access to standard streams of an application through a dedicated console
• Display of each application state and version
• Sanity checks before download (check for redownload, compatibility between Framework version used to build WRT the running one on the device)

Legato Framework and system software management:

• Display of framework state and version
• Display of system software version (Bootloader, Modem firmware and Linux)
• Update of system software from Legato Device Image packages, or from external CWE file
  ([New in 4.1] with management of SKU and Carrier configuration)
• [New in 4.1] Export wizard to build a full device image including a custom Legato Framework and/or Linux Yocto kernel+root FS
• Upgrade of running Legato framework instance on the device (from a rebuilt version of Legato Framework)
• Start/Stop/Restart of the Legato framework
• Sanity checks before download (consistency check between Framework and Firmware)

Configuration database:

• Browsing of the configuration database
• Displaying of current values
• Modification of values
• Import/Export from/to a local file

Device recovery:

• Access to recovery tooling both on Linux and Windows hosts
• Step by step wizard to recover a bricked Legato device

5. Debug

Logging:

• Log console displaying device log content
• Coloring (WRT. message severity) and filtering of log messages
• Log content control interface (severity and tracing keywords)
• Log writing to disk
• Log columns configuration
• [New in 4.1] Access to log recorded before connection setup

Legato processes inspection

• Inspection view, allowing to monitor Legato processes
• Configurable refresh rate
• Several tabs available to inspect:
  • Memory pools
  • Timers
  • Threads
  • Semaphores
  • Mutexes

System resources:

• System resources monitoring view
• Monitoring of global CPU load (up to 1, 5 and 15 minutes)
• Monitoring of global memory consumption
• Monitoring of each process (used CPU and memory, consumed CPU time, uptime, application container)
• String filter (matching command line or application name)

Monitoring rules:

• Global monitoring system for Legato devices data
• Management of monitoring rules (create/delete/enable/disable/edit)
• Combination of rules conditions
• Actions triggered when a rule is broken:
  • Notification
  • Line coloration in the adhoc view (for Inspection and Linux resources monitoring)
• Built-in rules:
  • Monitoring of application state, and application generated core files
  • Monitoring of Firmware and Framework consistency
  • Monitoring of missing (unbound or waiting) bindings for Legato applications
  • Check is connected Legato device is running a supported Legato version
• User defined rules:
  • Monitoring of memory pools data (e.g. to debug a memory leak)
  • Monitoring of Linux resources data (e.g. to debug an abnormal CPU consumption)
  • Monitoring of threads
  • Monitoring of timers
  • Monitoring of semaphores
  • Monitoring of mutexes

Step by step debugging:

• Embedded GDB
• Debugging of several applications at the same time
• Debugging of several processes (in the same application container) at the same time
• Grouping of Legato launch configurations (in order to launch several applications in one operation)
• "Attach mode" debugging: start a debug session on an already running Legato application process

Post-mortem debugging:

• Dedicated view to manage (download/delete) core dump files stored on the device
• Debug session to analyze the core dump file with the debugger

Strace:

• "Attach" strace session handling (attach to an already running process)
• "Launch" strace session handling (launch of application processes through strace)
• strace output dedicated console

7. Miscellaneous

• Software installation:
  • Windows: Software installer allowing to install USB drivers, Developer Studio and packages
  • Linux: Standalone archive, with a minimum set of dependencies
  • MacOS: Standalone archive, with a minimum set of dependencies
• Software Updates automatically checked on start-up
• Based on [New in 4.1] Eclipse Mars 4.5.2 (What's new) and [New in 4.1] CDT 8.8.1 (What's new)
• Integrated Help
• Integrated Software Update
• Notification center for messages concerning software updates and remote device connections
• Integrated unified search support on online help, Source and Developer Forum
• Developer Community news (articles and forum posts) access and update notifications
• Windows Platform Support: Windows 7, Windows 8, Windows 10
• Linux Platform Support: tested on Ubuntu and Debian distributions
• Developer Studio source code available
  Available only by installing over an existing Eclipse platform.

8. Discontinued Features

Discontinued features since Developer Studio 4.X

Support of following features has been discontinued starting from Developer Studio 4.X release:

• Support for Open AT application framework
• Support for WP710X Legato module

To continue using these features, it is recommended to keep using Developer Studio 3.X versions and not to install future releases, in order to ensure tooling compatibility with these features.

---

Known limitations & bugs

1. Build system

• Workspace paths with space characters are not supported

2. MacOS support

• Debug (Step-by-step, attach, post-mortem) is not supported on MacOS
• Device recovery is not supported on MacOS

3. Legato 16.04 / Developer Studio 4.1 versions limitations

• Debug: launching a debug session is not working in Legato 16.04
  Workaround: use the Debug Attach feature instead
• Strace: launching an strace session is not working in Legato 16.04
  Workaround: use the Attach Strace feature instead
• Device image upgrade: requiring a device image update (over IP connectivity) is not working in Legato 16.04 (i.e. the file is sent, but after reset nothing is updated)
  Workaround: use the Recovery feature instead
• There is no live validation in ADEF/CDEF/SDEF/API files editors in Developer Studio 4.1
  Workaround: validation is done when triggering a manual build.

---

Bugs fixed and minor enhancements

Release 4.1

1. Package Management

• [New] Module filtering in preferences. Filter is applied to available packages, Target Platform selection, new packages notification.
• [New] Filter Docker packages by default on Linux hosts
• [New] Bundle Docker images with Legato packages (no need for additional download once packages are installed)
• [New] Manage full installer on Windows (one big exe file, containing everything to get started)
• [New] Manage full archives on Linux (one big zip file, containing everything to get started)
• [New] Manage uninstall in legato-spm
• [New] Add button to display full official repository (including legacy Legato versions)

2. Development

• [New] Import wizards to use Legato application/component/system source code from external location
• [Fixed] Existing project import was not working with nested project
• [Fixed] Removed all useless errors and warnings in ADEF/CDEF/SDEF/API file editors

3. Build

• [New] Now requires Docker Toolbox to be preinstalled on the system (for Windows hosts)
• [New] New Docker Machine Toolbox view, to help fixing Docker setup issues if any
• [New] Docker build troubleshooting guide is now integrated in Developer Studio documentation
• [New] New build shell command for Docker projects (invoke a build terminal in Docker container, whatever is the host)
• [Fixed] First build triggered on a project didn't have any affect (it was needed to ask for build several times to get it working)
• [Fixed] Legato systems build was not working from Developer Studio Legato System projects

4. Target Management

• [New] Manage WP750X modules

5. Miscellaneous

• [Fixed] Usefull perspectives are opened by default
• [Fixed] Cheat sheet opened from welcome page gracefully close the welcome page

Release 4.0

1. Package Management

• [New] Highlight (with decorators) packages that are out of support range (deprecated (too old), or not yet supported (too new))
• [New] Propose to install packages on first launch (if no packages are installed yet)
• [New] New Sierra Wireless Legato license agreement
• [New] Default package install location is now <User Home Directory>/legato/packages
• [New] Completely reworked command line packages install application (legato-spm)
• [New] Access to Legato source code distribution packages through legato-spm app

2. Development

• [New] New sections managed in SDEF files (commands, preloaded)
• [New] Add capability to export an app for AirVantage, without binary
• [Fixed] Formatting issues in Legato settings files editors
• [Fixed] Renaming a nested component project now renames it physically on the disk.
• [Fixed] C++ includes were not shown on Legato component projects using Docker toolchain.

3. Target Management

• [New] Automatic naming of connection created through device discovery
• [New] Automatic update of IP address in device settings on startup (thanks to device discovery)
• [New] Enhanced Legato Log console view: regular expression filter, displayed fields selection, increased default console buffer size

4. Miscellaneous

• [New] Minimum Java required version is now Java 8
• [New] Desktop shortcut creation + User information recording + packages install wizard on first launch (on Linux hosts)

Release 3.6

1. Development

• [New] Manage new Legato components as nested projects
• [New] Use chosen project name for component, executable and source file when no sample is selected in the wizard
• [Fixed] Code generation improved (triggered on settings update, cleaning of removed interfaces)

2. Build

• [New] Added progress monitor when downloading docker images
• [New] Replaced Boot2Docker by Docker Machine
• [Fixed] Legato application build (through Docker VM) was failing if Docker VM wasn't restarted after a workspace switch
• [Fixed] It is now possible to bind an host directory out of the workspace into the Docker build container. This feature can be used to access any file out of the workspace when building a Legato application.

3. Target Management

• [New] Added capability to create monitoring rules by double-clicking on a table cell
• [New] Added decorator icon when a data is monitored by a rule
• [New] Added action to remove monitoring rules from Memory pools/Linux resources views
• [New] Added capability to monitor global CPU load and memory consumption with user rules
• [New] Display processes under application nodes in the Remote system Explorer
• [New] Added a "clean all" button in memory pools view
• [New] Resume memory pools monitoring after application restart
• [New] Manage installation of *.update Legato application files
• [Fixed] Memory pools inspection fixed on Legato 15.10 (was not working since Legato 15.08)
• [Fixed] Open AT: UI wasn't opening anymore once the Flash Objects view is opened

4. Debug

• [Fixed] Debug of Legato applications was not working on WP85 since Legato 15.08: now using native debugger from Legato toolchain on Linux hosts, and upgraded bundled debugger to GDB 7.6 version

5. Miscellaneous

• [New] Removed notification toolbar; Now generating desktop notifications.

Release 3.5

1. Development

• [New] Providing C library documentation tooltips in the C/C++ code editor
• [New] Support flags for C++ compiler, for Legato projects
• [New] Add capability to customize makefile for Legato application build
• [Fixed] In user defined target platform editor, fix too restrictive packages filtering

2. Build

• [Fixed] When using linked folders for Legato build, they are now resolved before writing down the makefile
• [Fixed] Developer Studio version was set to null in generated code during headless Open AT application build
• [Fixed] Warning in the Legato application build console when company name was contained space charaters
• [Fixed] Legato applications incremental build was not working in Docker/Boot2Docker mode
• [Fixed] Legato applications build was failing in the project folder was not immediatly under the workspace root

3. Target Management

• [New] Support for device-timestamped traces on compatible Open AT Firmware versions
• [New] Added combo for Open AT commands console, displaying the commands history
• [New] Display a notification when a new Legato device is detected on the network
• [New] Manage automatic reconnection to Legato device after a Device Image update

4. Debug

• [New] Launch shortcut support on core files for Post-mortem debugging configuration
• [Fixed] Fixed bug that was preventing to create breakpoints in C++ source files for Legato
• [Fixed] Fixed bug that was preventing to load symbols and use breakpoints in Legato attach debug session
• [Fixed] No need anymore to specify a wait action in Legato multi-application launch configuration to handle multi-debug properly
• [Fixed] Source paths configuration was not efficient until the Launch configuration was edited manually

5. Miscellaneous

• [New] Added support of Linux 32 bits hosts for Legato
• [New] Added a preference to enable/disable desktop notifications integration
• [New] Added a preference to enable/disable notifiers globally
• [Fixed] Fixed text search on Source and Forum online resources

Release 3.4

1. Package Management

• Removed Legato toolchain global preference, but added capability to install a toolchain installed in "/opt" as a Legato Toolchain package
• [Fixed] Fixed Open AT package generation: generated documentation link was missing when installed on a Developer Studio 2.X version
• [Fixed] Fixed display refresh bug when Package Manager perspective is opened before startup packages refresh job is terminated

2. Development

• Removed form editors for ADEF and CDEF files, now only editable through text editors
• Module configuration used by projects is now integrated in the Target Platform concept
• Project creation wizard simplified to only propose Target Platform selection (the project can be customized after from the property pages)
• Target Platform editor refactored, in order to remove useless warning messages for advanced users
• [Fixed] Fixed ADEF parsing errors on faultAction and process command line with arguments

3. Build

• [Fixed] Line endings issue on Windows hosts, preventing to build correctly Legato applications
• [Fixed] Error markers for mkapp/mkcomp/mksys builders were not generated with line information in Legato settings files
• [Fixed] When using C++ in Open AT applications, exceptions were not catched correctly
• [Fixed] More informative error messages and logs when failing to start Boot2Docker
• [Fixed] Badly detected Legato toolchain include paths in project indexer ("Includes" node in Project Explorer)

4. Target Management

• Refactored internal management for Legato devices; information loading performances improved, and useless information removed from property view
• Improved performances on running applications listing and properties parsing
• Warn the user concerning the Legato device upgrade workflow: Firmware must be upgrade before upgrading the Legato Framework
• [Fixed] Fixed scroll lock bug on Open AT Traces view, on Linux hosts.
• [Fixed] Fixed some bad behaviors on USB port management for Open AT 3G products (port not displayed in the devices list, port frozen/crash after download)
• [Fixed] Now manage the intermediate Legato Framework installation state, when startup scripts are update, requiring reboot.

5. Debug

• Diplaying Legato source code in step by step debugging
• [Fixed] Fixed source code access when debugging Legato component built in Docker mode (e.g. on Windows)
• [Fixed] Fixed Legato launch configuration names
• [Fixed] Breakpoint removal when double-clicking on line in source code editor

6. Miscellaneous

• [Fixed] Fixed RSS feed display from Sierra Wireless Source on the welcome page
• [Fixed] Improved JVM version (32 bits vs 64 bits) detection to have a better error message in case of incompatible version

Release 3.3

1. Package Management

• Filter native Legato packages on Windows hosts
• Support of AR8652 Legato modules
• [Fixed] Prevent uninstallation of packages referenced in Target Platforms defined in the preferences

2. Development

• Now managing Legato System projects, in order to build global systems composed of several applications
• [Fixed] Project creation bug (project empty) as soon as an AR7 toolchain package is installed
• [Fixed] Splited text and form editors for adef and cdef files

3. Build

• Added commands to control Boot2Docker VM lifecycle (principally for troubleshooting)
• Added capability to build through Docker (instead of Boot2Docker) on Linux hosts
• Added capability concatenate referenced Firmware to Application binary when building an Open AT application
• Support of AR8652 Legato modules
• [Fixed] Manage corner case states of Boot2Docker VM (paused, saved...) to resume builds
• [Fixed] Fixed corrupted File System configuration DWL files generation in some cases on 3G and CDMA devices
• [Fixed] Open AT projects build was not working on Linux when DS was installed through apt-get
• [Fixed] AirVantage interface path wasn't resolved for Legato projects on Windows

4. Target Management

• Added host name in displayed properties of connected Legato device
• Degraded mode for backtrace decoding on Open AT devices
• Support of SFTP (in addition to SCP) in order to exchange files with Legato devices
• Support of AR8652 Legato modules
• [Fixed] Improved progress monitor dialog when reading information from Legato device
• [Fixed] Disable actions (e.g. status refresh) when port is not opened on Open AT device Target Management
• [Fixed] Paste in Open AT command console was pasting two times
• [Fixed] In some cases, on Legato devices, Firmware update job was running endlessly without timeout

5. Debug

• [Fixed] Error message while trying to launch a run/debug session, if a core file already exists for a Legato application
• [Fixed] Post-mortem debugging is now supported with Docker toolchains

6. Miscellaneous

• [Fixed] On Linux 64 bits systems, automatically install required 32 bits dependencies in order to run bundled 32 bits tooling (e.g. gdb for Legato, Open AT toolchain, etc...)

Release 3.2

1. Package Management

• Manage Legato Toolchain packages
• Manage Legato Device Image and Legato baseline packages
• Defaultly checking for available Legato packages in official Sierra Wireless repository
• Packages installation folders are now shorter

2. Development

• Parser update for ADEF/CDEF files (adaptation to 14.10 syntax)
• [Fixed] It was not possible to configure an Open AT project to use other packages than the one contained in an Open AT AF baseline
• [Fixed] Report missing packages identifiers in Target Platform property pages
• [Fixed] Manage folders to be bundled in Legato applications in ADEF file editor

3. Build

• Legato projects build is now possible on Windows hosts
• Generate makefiles for Legato build
• [Fixed] On Open AT projects for SL8/SL3 and other related products, generated concatenated application + file system configuration files were not working

4. Target Management

• On Open AT devices, added the capability to manage text commands (e.g. AT+CMGW or AT+CMGS) in AT commands scripts
• On Legato devices, enable/disable actions depending on the state of the Legato Framework or Application
• Add refresh actions to query information update from connected Legato device
• [Fixed] On Open AT devices, task status was reporting Open AT tasks in wrong order
• [Fixed] On Open AT devices, sometimes the device detection timeout was too short
• [Fixed] On Open AT devices, tasks identifiers are not displayed in correct order in task status
• [Fixed] Fixed AirVantage operations list view
• [Fixed] On Open AT devices, fixed a bug preventing to display bootloader update dialog in some cases

5. Debug

• Legato application step by step debugging is now possible on Windows hosts
• Added dynamic management of process arguments from the ADEF file in Legato launch configurations
• Added support of Run mode for Legato launch configurations

6. Miscellaneous

• On Linux, plugged the notification center on desktop notifications
• Revamped software installer for Windows
• [Fixed] Bug that was preventing to drag and move toolbars
• [Fixed] Intermittent crashes that were occuring on Linux hosts, when displaying the Welcome page or the Help window

Release 3.1

1. Packages Management

• Changed default Linux "explore" command to xdg-open
• Improved package installation procedure performances
• Packages generated by Developer Studio 3.X were failing to install on DS 2.X
• Added capability to add notes/comments to installed packages

2. Development

• Now managing Legato Component projects, in order to make libraries reusable by several applications projects
• Added action to delete a tagged version from the application repository
• New memLimit and cpuShare fields support in ADEF file editor
• Improve Target Platform configuration by proposing compatible packages, even the ones that are not installed yet.
• Provide form and text mode edition features in the same editor, for ADEF and CDEF files.
• Import source code in project creation wizard
• Management of Legato application version, with build qualifier generation
• Added support for C++ source files in Legato ADEF/CDEF files
• Added support for groups section in ADEF files
• Fixed issue on Linux library project creation using Legato Linux toolchain
• Fixed useless error markers when configuring a File System image on devices which can't configure their memory mapping
• Fixed paths management without quotes in ADEF and CDEF files text editor
• Fixed exception on application repository import action
• Improvements on ADEF and CDEF files editors (text format, parsing issues)

3. Build

• Now reporting warnings raised by mkapp Legato builder in the Problems view
• Fixed missing cpu option on GCC build with Open AT library projects

4. Target Management

• Display Legato Framework version running on a connected device
• Capability to generate a local trace session configuration file from Open AT devices
• File system provisioning for 3G and CDMA products
• Configuration database editor is now able to display/edit all the database roots
• Now automatically triggers a refresh after a file system format on Open AT devices
• Added user prompt (Skip, Retry, Abort) when write error occur on recursive download in Open AT device file system
• Added action to download folder from host to Open AT device file system
• Enabling the "install" action only on .dwl files on Open AT device file system
• Added capability to modify configuration database value type
• Fixed trace profiles checkboxes behavior.
• Don't store anymore duplicates in the AT commands console history.
• Fixed response parsing for AT! commands, allowing to use them in AT Commands scripts.
• Fixed USB AT command port detection issue on 3G and CDMA products.
• Fixed AirVantage package generation when containing deltas + file system images
• Trace logging wasn't starting on port open when the preference was enabled

5. Debug

• Improved Legato applications debug workflow: no need to recompile the application in "debug mode" anymore; debug can now be triggered without changing the application configuration.
• Improved dynamic libraries search path when debugging Legato application; it is now possible to debug in Legato components and Legato framework source code.

6. Miscellaneous

• Fixed news fetching from forum/Source on the Welcome Page

Release 3.0

1. Packages Management

• Packages views now display information on hardware supported by a given package.
• Packages views content can now be filtered by entering a module name: only compatible packages will be displayed

2. Development

• Fixed issue on delta generation for SL8 devices
• Added management of delta generation for Q2698 devices
• Added possibility to install packages from the project creation wizard

3. Target Management

• Fixed too short timeout after download (in particular Firmware upgrade) on 3G and CDMA devices
• Fixed random bug causing download procedure to stay blocked until it is cancelled
• Fixed trace view log button bad toggle behavior when using the global "start logging" action
• Fixed performance issue when an Open AT device switches rapidly between production and development mode