Legato Beta Release Notes - 15.05

Copyright © Sierra Wireless Inc. All rights reserved.


Welcome to Legato

This page summarizes important information about the Legato Beta 15.05 release:
Downloads
Services APIs
Linux Host Package
New Features
Modifications
Known Issues
Documentation


Here's other info you may need to look at:
Upgrade Legato
Legato Beta 15.01 release notes
Complete Legato documentation


Downloads

These are the Legato 15.05 source packages, available at: Legato Downloads:

Sources package - Legato-Dist-Source-mdm9x15-15.05.0.Beta.tar.bz2

Toolchain for Linux PC i686 Legato - Legato-Toolchain-mdm9x15-15.05-i686.sh

Toolchain  for Linux PC x86 64bits - Legato-Toolchain-mdm9x15-15.05-x86_64.sh

WP71x firmware package (with Legato) - spkgz-yocto-legato-wp71-060354.cwe

WP71x firmware package (without Legato) - spkgz-yocto-wp71-060354.cwe


Service APIs Changes since 15.01

These Services APIs were modified for this release:

In SIM API (le_sim)

le_simType_t type has been replaced by le_sim_Id_t type.

le_sim_Create() and le_sim_Delete() functions are deleted. Then, all the other le_sim functions don’t take a sim reference as an input argument but a le_sim_Id_t type parameter.

In Audio API (le_audio)

le_audio_OpenFilePlayback() changes to le_audio_OpenPlayer().

le_audio_OpenFileRecording() changes to  le_audio_OpenRecorder().

le_audio_Play() changes to le_audio_PlayFile().

le_audio_Record() changes to le_audio_RecordFile().

le_audio_AddStreamEventHandler()/le_audio_RemoveStreamEventHandler() change to le_audio_AddMediaHandler()/le_audio_RemoveMediaHandler().

FileEvent type changes to MediaEvent type.

Le_audio_GetFileEvent() function deleted.

Linux Command-line host packages

The ninja-build Linux package is now used with the Application Framework.

New Features

The following new features were included in this release:

[App Mgmt] Implement Application Update over LWM2M.

[App Mgmt] Implement Firmware Update over LWM2M.

[App Mgmt] Add application fall back mechanism.

[App Mgmt] Create an appInfo component.

[App Mgmt] avcDaemon support for framework/app management with LWM2M.

[App Mgmt] Added appCfg component to read the app configurations from the config DB's system tree.

[App Mgmt] Added Install Status component to provide notifications of app install and uninstall.

[App Mgmt] Tool support for the LWM2M management objects.

[Audio] 'STOP' function for audio playback/recording.

[Audio] Audio platform adapter for AR8652.

[Audio] Added support for PCM insertion/extraction.

[Audio] Added AMR codec support for playback.

[DTMF] DTMF encoding APIs.

[eCall] Added new event to indicate a MSD request is received from PSAP

[FOTA] FOTA Control API.

[Modem] API to get Manufacturer ID.

[Modem] API to get PRI ID.

[Modem] Added Signal Quality APIs.

[Position] Added AGPS support to Positioning services.

[Position] GNSS Engine Selection.

[Ring Indicator] Added ring indicator control APIs.

[Sandbox] Peripheral interfaces can be used from a sandbox app.

[Security] Secure File Storage APIs.

[SIM] Remote eUICC provisioning API.

[SIM] SIM profile switch API.

[SIM] Added le_sim_IsEmergencyCallSubscriptionSelemkavpackcted() to get the current subscription.

[SMS] SMS Inbox APIs

[Tool] New, faster mk tools.

[Tool] Added temperature threshold APIs to the cm tool.

[Tool] Generate MDM9x15 Legato framework image.

[Tool] Provide a way to list what processes/threads are running in an app.

[Tool] SIM selection management to cm tool.

[USB] Support USB CDC-EEM

Modifications

The following modifications were included in this release:

Legato Framework

[App Mgmt] Apps OTA installation will retry after an installation failure

[App Mgmt] Support deferral of application OTA download/installation

[App Mgmt] Support user agreement procedure for application update/installation

[Audio] Resolved muting issue with audio playback during a call

[Audio] Resolved timeout issue during audio closure function pcm_close()

[ADC] Access external ADC pins.

[Audio] Updated audio platform adaptor for AR8652/AR6554RD.

[Audio] Modify audio gain computation to correct le_audio_SetGain/le_audio_GetGain functions.

[Audio] Properly handle call termination when voice call is terminated on the remote side.

[Data] Resolved issue with 3GPP2 data connection on the CDMA network

[Data Connection] Two RmNet interfaces can be supported concurrently.

[eCall] le_ecall_ImportMsd: resolved MSD data input issue.

[eCall] Resolved speaker handset voice issue when performing voice call under eCall.

[eCall] Stop interval timer when eCall ends.

[eCall] Usage clarification: le_ecall_GetPsapNumber will return LE_FAULT if le_ecall_SetPsapNumber has never been called before.

[Event Loop] le_event_ServiceLoop() accepts epoll_wait() returning zero and returns LE_WOULD_BLOCK.

[FW Update] Split fwupdate service daemon from mode services daemon.

[Modem] Resolved reference count issue in le_sim_Ref_t quick create/delete.

[RTC] Switch to BOOTTIME to preserve system time across suspend states.

[Sandbox] /dev/input/mice is now accessible in sandbox

[SIM] SIM selection is now consistent with modem setting.

[SMS] Resolved issue with long SMS message.

[SMS] le_sms_Send: added sending failure causes.

[SMS] Resolved app crash when using the SMS message list.

[Supervisor] Improved shutdown time

[Supervisor] Resolved issue with supervisor failing to stop apps

[Supervisor] Unsandboxed app can now be deleted with its processes.

[Supervisor] stopLegato will now shutdown the supervisor and the framework.

[System] Set file permission to 644 when creating system files

[Tool] Improved code generation tool chain (ifgen).

[Tool] Memory inspection tool now supports the display of subpools.

[Tool] Resolved cm tool blocking issue due to apps not starting.

[Tool] Resolved issue causing Legato framework reinstallation on every reboot.

[Upgrade/Downgrade] Improved too chain to handle different packaging and upgrade/downgrade scenarios for the Legato framework

[Voice Call] Added termination causes.

Yocto

[build] Ability to build Legato apps provided.

[CDC-ECM] Fix ECM MAC address after initial generation.

[Code] Link to codeaurora git (+cache) rather than using tarballs.

[CVE-2014-{9297,9298}] added.

[ID] Tag identifier added to Linux kernel and LK bootloader.

[iptables] Add xt_conntrack module to provide additional iptables config options.

[Keys] home/end/delete/insert/page up/page down keys enabled.

[libcap] Provide libcap in rootfs and toolchain

[libcc] Added libgcc dep for lk

[LPM] Enable the sleep mode by default.

[Non-volatile ECM] (host) MAC address after initial generation added. [opencore-amr] Library in Yocto build added.

[RFS] tc and iperf added to target root file system. [simple qmuxd] Process monitor added.

[TCF Agent] Hostname to discovery string sent by TCF agent automatically added.

[Start] Monitor and handle qmuxd restart during repetitive framework start/restart. 

[sysroot] Provide Fix sysroot to gcc and ld

[Tool] Makefile update (external.mk).

[tools] Yaffs tools in toolchain provided.

[USB] Utils to rootfs added.

[xt_conntrack] Module added.

[USB] Support USB CDC-EEM

[version] Platform/system/core to the version specified by latest 4.7 release in Codeaurora.org updated.

[Virtual] Remove bash from virt image

[Virtual] Do not include opencore-amr in virt toolchain

[wm8944] Codec update to support local playback

[yaffs2-utils] Make yaffs2-utils common

kernel

[ADB] support fix

[alarmtimer] alarm_expires_remaining added.

[alarmtimer] alarm_start_relative added.

[alarmtimer] alarm_forward_now added.

[alarmtimer] alarm_restart added.

[alarmtimer] Use hrtimer per-alarm instead of per-base now used.

[alarmtimer] Implement minimum alarm interval allowing suspend.

[alarmtimer] Provide accessor to alarmtimer rtc deviceChanges to support 32-bit loff_t.

[Checkpoint] Refactored checkpoint chunk and block offsetting.

[Flash] Implement non-page aligned flash writes.

[menuconfig] Removed repetitive entries in kernel menuconfig.

[Module crash] After LTP stress test overnight fixed.

[Nand Read] Nand read routine triggering "undefined fixed.

[RI] Export Ring Indicator as GPIO11 in kernel.

[rtc-pm8xxx] Register device with alarmtimer.

[timerfd] Support CLOCK_BOOTTIME clock.

[timerfd] alarm timers added.

[USB] support added.

[userland] msm_otg notify userland on DISCONNECT.

[WM8944] audio codec support added.

[yaffs] Route all writes into the yaffs cache by default.

[yaffsfs] yaffs_format function added.

Linux kernel configuration

[menuconfig] duplicate entries in kernel removed.

[WM8944] codec added.

Updates from upstream Linux/Yocto

[build-appliance-image] Update to daisy head revision.

[build-appliance-image] Update to daisy head revision.

[curl] Security Advisory - curl - CVE-2014-3620 added.

[curl] Security Advisory - curl - CVE-2014-3613 added.

[dev-manual] "Making Images More Secure" section updated.

[documentation] "November 2014" to manual history lists added.

[gnupg] CVE-2013-4242 added.

[gst-ffmpeg: Security Advisory - ffmpeg - CVE-2013-0869 added.

[gst-ffmpeg] Security Advisory - ffmpeg - CVE-2013-4358 added.

[libarchive] avoid dependency on e2fsprogs added.

[ltp] zip-native as a DEPENDS added.

[lttng-modules] Updated to version 2.4.2

[openssh] screen sessions killed on disconnect with systemd fixed.

[openssl: Upgraded to 1.0.1j.

[poky-ent] YOCTO_RELEASE_NOTES variable updated.

[poky.conf] Bumped DISTRO_VERISON for 1.6.2

[pseudo.inc] backport of version update to 1.6.2 cleaned up.

[pseudo*.bb] pseudo 1.6.2 update.

[profile-manual] LTTng Documentation section updated.

[python] force off_t size to 8 to enable large file support added.

[readline] Patch for readline multikey dispatch issue.

[readline] Security Advisory - readline - CVE-2014-2524 added.

[wget] Fix for CVE-2014-4887.

[yocto-bsp] qemu inclusion lists updated.

Known Issues

Legato 15.05 Beta has the following known issues:

[App Mgmt] Apps OTA installation may not succeed if interrupted during download.

[App Mgmt] If Apps OTA installation doesn't succeed, the app will first have to be deleted from AirVantage, and then reinstalled again.

[Audio] le_audio_Play, le_audio_Record fail if called several times with the same file reference.

[Config Tree] Floating point conversion may not be precise.

[eCall] le_ecall_ExportMsd return erroneous msd.

[eCall] Erroneous controls flags in MSD send in only Mode.

[eUICC] BIP errors may be observed from Open Channel command.

[Modem] le_mrc_SetManualRegisterMode fails with -6.

[SMS] le_sms_CreateRxMsgList() returns NULL when SMS storage is full.

[SMS] SMS service fails if an incoming message has non-numeric origination id.

[Voice Call] Voice call notifications not properly handled.

Limitations & Constraints

[Upgrade] When upgrading to the 15.05 from a previous version, user will be asked to reset the target after running instlegato; symbol look up error messages may be displayed after the reset. The target will start successfully, and the error messages shouldn't be displayed again in the subsequent instlegato command. 

[Downgrade] When "downgrading" from a newer framework release to an older one, all apps should be removed from the target before installing the older framework.

[Upgrade/Downgrade] Configdb is restored to default after each Legato framework upgrade/downgrade.  App should make sure the configuration is initialized correctly.

Documentation

Services

The Services documentation was reorganized.

The Application and Foundation sections were combined into one Services topic. The topic contains links to all Services, descriptions, and lists services that are already multi-app safe (meaning arbitration is fully managed among apps so multiple apps can share the same resources).

New Services were added for Ring Indicator, App Status and SMS Inbox Service.

How To topics

A new How To section has been added with these topics:

o    Customize Legato Yocto USB (moved from PDF version in 15.01)

o    Manage Device Power

o    Debug Apps

o    Port Legacy Apps General

o    Port Legacy Apps C Language.

o    Use Logs

o    NMEA Port Setup

Format and Navigation

Data Structure tree was removed (never used).

About tree was moved to the top of left navigation tree. About Legato page now dynamically generates the release number (including tag). More details on using/searching the documentation and a Glossary were added. 

Stylesheet improvements: recognizing blank lines in code samples and left aligned graphics.

General

The Getting Started topics were reorganized to better reflect the installation process with new Target and Dev Host PC sections.

Basics topics to create new apps and components were restructured following coding changes.

Demo Apps topics were renamed to Sample Apps. Topics were split and more detail was added.

Other Info topics: Platform Constraints was added with an Audio Limitations topic and Yocto topics were moved from Getting Started.

Copyediting and various docs fixes were also included.