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

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

Release 15.2 Components

WP7702 Firmware Release 15.2 combined image

Components	Revision	Binaries	How to rebuild a custom Component ?
Modem Firmware (Generic)	SWI9X06Y_02.36.08.14 / 001.082_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	SWI9X06Y_03.00.15.03	Download	Custom Linux Distribution can be built through Yocto by customers either to add/remove a driver within your Linux kernel and/or to add/remove FOSS (Free Open Source Software) from your Root FileSystem To do so, refer to "Rebuild Linux Distribution and/or Legato from source" (below).
Base Legato System	21.05.4	Download	Custom Base Legato System can be built by customers either to create and add apps as part of the native apps deployed within the Base Legato System (recommended to create production units) and/or to add a driver to the Linux kernel through Legato kernel modules and/or to customize and rebuild the Legato Application Framework from the open source project. To do so, refer to "Rebuild Linux Distribution and/or Legato from source" (below).

Rebuild Linux Distribution and/or 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
21.05.4 Source	SWI9X06Y_03.00.15.03 Source (Based on Kernel 3.18 and Yocto 2.5)	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.