About SiWx917’s Firmware#

The SiWx917 employs the Network Wireless Processor (NWP) processor using the Firmware present in the flash. The SiWx917’s Firmware is an RPS formatted file. The RPS format is a binary executable format understood by the NWP Bootloader to verify the integrity and authenticity of the Firmware Image. If the Firmware Image is valid, the Bootloader executes the Firmware Image.

The Firmware Image includes an RPS header, Boot descriptor, Applications binary image, and an optional trailer (Digital Signature).

SiWx917 Firmware File FormatSiWx917 Firmware File Format

Note: The phrases "firmware image" and "firmware" mean the same throughout the document.

Firmware File Versioning#

The NWP Connectivity Firmware file - SiWG917-B.u.v.w.x.y.z.rps is located at <WiSeConnect v3.x SDK> → connectivity_firmware path of v3.x SDK. The maximum size of SiWx917’s Firmware File is about 1.8 MB.

The following figure explains what each field in the Firmware File name specifies.

image2image2

Firmware Versioning#

This following figure explains what each field in the Firmware version specifies when sl_wifi_get_firmware_version() API is called.

image3image3

NOTE:

  1. To check the SiWx917’s current NWP Firmware version, call the sl_wifi_get_firmware_version() API after initializing the device (after sl_net_init() API call). If the Firmware loaded in the SiWx917’s flash is SiWG917-B.u.v.w.x.y.z.rps, the API returns the Firmware version as 1711.u.v.w.x.y.z.

  2. In the v3.1.1 SDK, the Firmware file version is SiWG917-B.2.10.0.0.4.rps and it does not include the Security version number. This is corrected in the later releases of SDK v3.x. The firmware version obtained using the sl_wifi_get_firmware_version() API call shall include a Security version number field (for example, 1711.2.10.1.0.0.4). Whenever the Security-related vulnerabilities in the SiWx917 firmware are found and fixed, the Security version number shall be incremented.