The WP76xx device's flash is partitioned according to the following diagram. Some partitions are customizable and can be updated by either using the default image provided by Sierra Wireless or by customizing the image and updating the partition using your own customized image.  Images can either be updated by connecting to the device directly or remotely updating the device over the air (SOTA and FOTA), by using AirVantage. 

To find the current version of your firmware run "fwupdate query" on your target.

Non-customizable components are provided as .cwe image files and are included within the Leaf SDK or are individually downloadable.  Follow the instructions below to combine the .cwe files into an .spk and update the firmware partition of your device.

Binary Components:

Component	Leaf SDK Image Location	Binary .cwe file	Source Code
Modem Firmware (Generic — PTCRB)	/leaf-data/<profilename>/wp76-modem-image or use environment variable $WP76XX_MODEM_IMAGES	SWI9X07Y_02.28.03.01 / 002.064_000	Not available
Modem Firmware (AT&T)		SWI9X07Y_02.28.03.01 / 002.071_000	Not available
MCU Firmware	002.011	MCU Firmware is included as part of Linux Distribution. Custom MCU Firmware can NOT be created by customers.
Linux Distribution	/leaf-data/<profilename>/wp76-linux-image or use environment variable $WP76XX_LINUX_IMAGE	SWI9X07Y_02.28.03.01	Leaf: leaf getsrc swi-linux Gerrit:  repo init -u ssh://<userid>@gerrit.legato.io:29418/manifest -m products/wp76xx/releases/Release13.xml -g default,-cache; repo sync (Clones both Legato and Linux Source Code) Tarball: SWI9X07Y_02.28.03.01 Source  (Based on Kernel 3.18.122 and Yocto 2.2.2)
Base Legato System	/leaf-data/<profilename>/wp76-legato-image or use environment variable $WP76XX_LEGATO_IMAGE	19.02.0	Leaf: leaf getsrc legato Gerrit:  repo init -u ssh://<userid>@gerrit.legato.io:29418/manifest -m products/wp76xx/releases/Release13.xml -g default,-cache; repo sync (Clones both Legato and Linux Source Code) Tarball: 19.02.0 Source

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

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  "Rebuild Linux Distribution or/and Legato from source"

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"Rebuild Linux Distribution or/and Legato from source"

Custom Legato systems and applications can be built by customers.  To do so you need a copy of the Legato Application Framework and the toolchain installed on a Linux development machine (virtual or physical).  The Legato Application Framework and all tools (including the toolchain) are automatically downloaded, installed and configured with the Leaf Workspace Manager.  Sierra Wireless also provides the source code on our Gerrit Server, and can be cloned by using the repo tool.

Legato Source	Linux Distro Source	Linux Distro Licences	Toolchain
		Open Source Licenses	32-bit ToolChain 64-bit ToolChain
Repo Command (replace <userid> with your Gerrit User ID), clones both the Legato Source Code and Linux Source Code:  repo init -u ssh://<userid>@gerrit.legato.io:29418/manifest -m products/wp76xx/releases/Release13.xml -g default,-cache; repo sync

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

Release 13 Components

WP76xx Firmware Release 13 combined image

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

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:

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.