WP76xx Firmware Release 16 Components

Aug 24, 2020 - Author: Sierra Wireless - Version 16 - 31695 Views

This page describes in detail the components included with the Firmware Release, how to build your own custom device image based on Release 16 components and how to download it on your product.

The Firmware and its components are mapped into the flash as follows:

Release 16 Components

WP76xx Firmware Release 16 combined image

Note: If your carrier is not listed and you are unsure which Generic to use, check with your carrier.

Components	Revision	Binaries	How to rebuild a custom Component ?
Modem Firmware (Generic — GCF & PTCRB)	SWI9X07Y_02.37.03.00 / 002.095_000	Download	Custom Modem Firmware can NOT be created by customers
Modem Firmware (AT&T — PTCRB)	SWI9X07Y_02.37.00.00 / 002.098_000	Download	Custom Modem Firmware can NOT be created by customers
Modem Firmware (Sierra Wireless — GCF)	SWI9X07Y_02.37.03.00 / 001.060_000	Download	Custom Modem Firmware can NOT be created by customers
Modem Firmware (Sprint — GCF)	SWI9X07Y_02.37.02.00 / 001.027_000	Download	Custom Modem Firmware can NOT be created by customers
Modem Firmware (T-Mobile — PTCRB)	SWI9X07Y_02.35.02.00 / 001.017_000	Download	Custom Modem Firmware can NOT be created by customers
Modem Firmware (Verizon — GCF)	SWI9X07Y_02.37.06.00 / 002.107_000	Download	Custom Modem Firmware can NOT be created by customers
MCU Firmware	002.015	MCU Firmware included as part of Linux Distribution Custom MCU Firmware can NOT be created by customers.
Linux Distribution	SWI9X07Y_02.37.07.00	Download R16	Custom Linux Distribution can be built through Yocto by customers either to add/remove a driver within your Linux kernel or/and to add/remove FOSS (Free Open Source Software) from your Root FileSystem To do so, go to next step "Rebuild Linux Distribution or/and Legato from source"
Base Legato System	19.11.2	Download	Custom Base Legato System can be built by customers either to add your apps as part of the native apps deployed within the Base Legato System (recommended to create production units): Instructions for Developer Studio users to add apps in the Base Legato System Instructions for Legato CLI users to add apps in the Base Legato System or/and to rebuild the Legato Application Framework from the open source project. To do so, go to next step "Rebuild Linux Distribution or/and Legato from source"

Rebuild Linux Distribution or/and Legato from source

In case where you need to rebuild either the Linux Distribution or Legato or both, you can use the following resources:

Legato Source	Release #	Linux Distro Source	Linux Distro Licences	Toolchain
19.11.2 Source	R16	(Based on Kernel 3.18.140 and Yocto 2.5) SWI9X07Y_02.37.07.00 Source	Open Source Licenses	32-bit ToolChain 64-bit ToolChain

The instructions to rebuild Legato are available on legato.io.

The instructions to rebuild the Linux Distribution through Yocto project are available here.

Build your custom Device Image

Once you have customized one or several of the components from source, or once you have created your own Base Legato System, it is time to assembly the components in one Device Image.

Instructions for Linux CLI users
(Linux)

1. Install swicwe tool
2. To build your own combined image custom-firmware.spk from the following components:

Modem Firmware: modemFW.spk
Linux Distribution: boot-yocto.cwe
Base Legato System: legatoz.cwe

you need to launch the following command line:

swicwe -o custom-firmware.spk -c modemFW.spk boot-yocto.cwe legatoz.cwe

Note 1: You may decide to generate a custom Device Image without the full list of components (e.g. without Modem Firmware or without the Linux Distribution). If you do so, when you will flash this image later, only the components included within the custom Device Image package will be updated, the others will remain untouched. By doing this, you shall insure that the untouched components are compliant with the ones you are updating through the custom Device Image.

Note 2: If your custom Device Image is including a Base Legato System, when you will flash this image later, the Overlay Legato System will be erased and reinitialized with the same content as the Base Legato System.

Flash your custom Device Image

After having created your own Device Image, you can load it on your target.

Instructions for Visual Studio Code users (Linux)	Visual Studio Code and the Legato plugin provide an easy-to-use IDE that automates the building and updating of your system onto your smart module. Install Visual Studio Code and the Legato Plugin. Select the "Target Menu". Choose the Flash .cwe/.spk to a target (via swiflash) option. Choose the image that you created in "Build your custom Device Image" (above) to update your smart module.
Instructions for Legato CLI users (Linux)	1. Connect the mangOH USB cable to your host (or establish any IP connection with the target) 2. Open a terminal and execute the Legato command line: `fwupdate download <combined_image_file> 192.168.2.2`
Instructions with AirVantage IoT Cloud	Follow the WP Series - AirVantage FOTA & SOTA Guidelines to create the AirVantage package for your custom Device Image, load it on AirVantage and use it to operate Firmware OTA.

Recovery

In case of failure after having downloaded within the product an unstable custom device image, you can launch a Recovery Procedure to restore a stable firmware.