Release Date: Sep 14, 2018

See Licenses to view Legato AF Licensing Information.

The following provides a summary of changes that have been made in the 18.08 Legato AF Release.

Download the source code and get started with building Legato AF.

New Features

The following are the list of new features that have been added into the 18.08 Release:

Modem Radio Control API

Disconnect Reasons and Codes: New functions have been added to the Network interface settings to provide an extended disconnect reason and code to work properly with IPv4v6 interfaces.

The following functions have been deprecated and will be removed in a subsequent release:

• le_mdc_GetDisconnectionReason() and is replaced with le_mdc_GetDisconnectionReasonExt()
• le_mdc_GetPlatformSpecificDisconnectionCode() and is replaced with le_mdc_GetPlatformSpecificDisconnectionCodeExt()
• le_mdc_GetPlatformSpecificFailureConnectionReason() and is replaced with le_mdc_GetPlatformSpecificFailureConnectionReasonExt()

PCI Network Scan: The following functions have been added to mrc API to support PCI scanning. The PCI scan is used to get the MCC/MNC for each neighboring cell ID:

• le_mrc_PerformPciNetworkScan()
• le_mrc_PerformPciNetworkScanAsync()
• le_mrc_GetFirstPciScanInfo()
• le_mrc_GetNextPciScanInfo()
• le_mrc_GetFirstPlmnInfo()
• le_mrc_GetNextPlmnInfo()
• le_mrc_GetPciScanCellId()
• le_mrc_GetPciScanMccMnc()
• le_mrc_DeletePciNetworkScan()

Kernel Modules

Kernel Modules functionality has been added to support dependencies between kernel modules and dependencies between kernel modules and apps/components. We have also included functionality to bundle other files with the kernel module sources and provide scripts to load and unload the kernel module from your target.

New tutorials will walk you through real world examples of kernel modules and demonstrate how to set up:

• application dependencies
• kernel module dependencies
• install and remove scripts
• bundle binary files with scripts

Note

Before building kernel modules into your Legato System you may have to perform some extra toolchain setup steps.

Beta Features

The following features have been added to the 18.08 Release and are feature complete but are still in a testing phase. Please provide feedback for these features on our forums.

Alpha Features

The following are the list of features that have been added into the 18.08 Release but are still being developed and should not be used on production targets. Please provide feedback for these features on our forums:

Modem Radio Control API

The network scan can now obtain the Network global Celular identifier when performing a network scan by using the function le_mrc_GetCellularNetworkGlobalCellId().

Multiple SIM Support

The framework now provides support for multiple embedded SIM profiles and administration by a subscription management server such as AirVantage.

Fixed Issues

All development work is tagged in GitHub as "18.08.0". The list of changes and commit messages can be found on GitHub.

• Legato AF 18.08.0 Fixes

Note

This is only the list of fixes for the Application Framework and Platform Services, for the list of changes in the Platform Adapters and AVC Service view the commits under the tag 18.08.0 in the individual repositories on GitHub.

Known Issues

Constraints and Limitations

Dev Machine Linux Version

To develop applications within the Legato Application Framework, a current supported Long Term Support version of Ubuntu Linux is required on your dev machine (or running in a virtual box on Windows). Ubuntu 16.04 is the current recommended version to use on your dev machine.

ECM-USB modem manager issue

Ubuntu 15.10 and newer has Modem Manager version 1.4.12-1ubuntu1 installed by default which conflicts with the ECM-USB driver when connecting a target. Modem manager may cause the Ubuntu Network Manager to crash on your host and/or your target device to become unavailable over USB.

Symptoms:

• NetworkManager crashing when plugging into your device over USB, or
• The target device becomes inaccessible after 30 seconds.

Recommended Work Around:

• Uninstall modemmanager from Ubuntu or
• Downgrade modemmanager to version 1.0.0-2ubuntu1

Sierra Wireless Toolchain Install

There is currently an error with setting up the WP76XX and WP77XX toolchain and the toolchain only partially installs. The part of the script to install and setup the kernel headers does not run and produces the following errors:

scripts/kconfig/Makefile:36: recipe for target 'silentoldconfig' failed
make[2]: *** [silentoldconfig] Error 1
Makefile:546: recipe for target 'silentoldconfig' failed
make[1]: *** [silentoldconfig] Error 2
make: *** No rule to make target 'include/config/auto.conf', needed by 'scripts'.  Stop.

To resolve this remove the installed toolchain and reinstall with sudo privileges.

Example of setting up the toolchain for a 64bit dev machine and a WP76 module with product release 9:

$ rm -rf /opt/swi/y22-ext
$ sudo poky-swi-ext-glibc-x86_64-meta-toolchain-swi-ext-armv7a-neon-toolchain-swi-ext-2.2.3.sh

Copyright (C) Sierra Wireless Inc.