WP76xx Firmware Release 12.0.1 Components

May 23, 2022 - Author: Sierra Wireless - Version 2.0 - 1791 Views

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

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

Release 12.0.1 Components

WP76xx Firmware Release 12.0.1 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 — PTCRB)	SWI9X07Y_02.18.05.00 / 002.041_005	Download	Custom Modem Firmware can NOT be created by customers
Modem Firmware (Generic — GCF)	SWI9X07Y_02.25.02.01 / 002.056_002	Download	Custom Modem Firmware can NOT be created by customers
Modem Firmware (AT&T)	SWI9X07Y_02.18.05.00 / 002.040_003	Download	Custom Modem Firmware can NOT be created by customers
Modem Firmware (Verizon)	SWI9X07Y_02.18.05.00 / 002.041_003	Download	Custom Modem Firmware can NOT be created by customers
Modem Firmware (Sierra Wireless (PTCRB))	SWI9X07Y_02.18.05.00 / 001.002_004	Download	Custom Modem Firmware can NOT be created by customers
Modem Firmware (Sierra Wireless (GCF))	SWI9X07Y_02.25.02.01 / 001.014_002	Download	Custom Modem Firmware can NOT be created by customers
MCU Firmware	002.011	MCU Firmware included as part of Linux Distribution Custom MCU Firmware can NOT be created by customers.
Linux Distribution	SWI9X07Y_02.25.04.01	Download	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	18.10.3	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	Linux Distro Source	Linux Distro Licences	Toolchain
18.10.3 Source	SWI9X07Y_02.25.04.01 Source (Based on Kernel 3.18.122 and Yocto 2.2.2)	Open Source Licenses	32-bit ToolChain 64-bit ToolChain

Note: The Linux Distro Source, ONLY purposed for rebuilding the Linux Distribution, has been updated with "SWI9x07Y_02.37.10.01 - for example" and correctly configured in order to accommodate changes made through new memory driver updates. No impact on all the shipping SKU's directly from factory.

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 Developer Studio users
(Linux, Windows) Follow the instructions from Build your own custom Device Image using Developer Studio.

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 Developer Studio users (Linux, Windows)	Follow the Custom Device Image Update Instructions with Developer Studio to install your own combined image created at previous step.
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.