Manufacturing Utility Commands#

In this section some of the useful and commonly used manufacturing utility commands are mentioned.

SiWG917 Info#

You can get the manufacturing and device information of the SiWG917 by using the following commands.

Manufacturing Info#

The command provides the following information of the SiWG917 OPN.

  • OPN

  • Wi-Fi MAC address

  • Wi-Fi MAC address (customer)

  • Flash size

  • Flash variant

  • Flash type

  • NWP firmware version

  • MBR variant

  • Manufacturing SW version

  • Application region start address

  • Application code start address

  • Application region end address

  • Flash configuration

  • PSRAM option

  • Mode

  • NWP roll-back prevention

  • NWP digital signature validation

  • NWP firmware encryption

  • NWP secure boot

  • Application roll-back prevention

  • Application digital signature validation

  • Application code encryption

  • Application secure boot

Syntax:

commander manufacturing info -d <OPN Number>

Note: The Manufacturing SW version provided by the above command is embedded into the SiWG917 during chip manufacturing at PTE. This serves as the factory default setting in the production testing software.

Device Info#

The command provides the following information of the SiWG917 OPN.

  • Part Number

  • Product Revision

  • Flash Size

  • SRAM Size

  • Unique ID

Syntax:

commander device info -d <OPN Number>

PSRAM Pinset Update#

In any of the SiWG917 OPN except SiWG917M121XGTBA, and SiWG917M141XGTBA, by default the external PSRAM is configured on pins (52 to 57), that is pinset 3. If you would like to configure the PSRAM on pins (46 to 51), that is pinset 2, refer to the following steps. The MBR is updated with the psrampinsetupdate.json file.

Write TA MBR#

The following command is used to write TA MBR.

Syntax:

commander manufacturing write tambr --data psrampinsetupdate.json [--skipload] -d <OPN Number>

Example:

commander manufacturing write tambr --data psrampinsetupdate.json -d SiWG917M111MGTBA

Write M4 MBR#

The following command is used to write M4 MBR.

Syntax:

commander manufacturing write <m4mbrcf|m4mbrdf> --data psrampinsetupdate.json [--skipload] [--pinset n] -d <OPN Number>

Example:

commander manufacturing write m4mbrcf --data psrampinsetupdate.json -d SiWG917M111MGTBA

User Data – Update#

The user data space in the M4 starts at 0x047f7000, and ends at 0x047fbfff. You can use the following commands to write, read, write to a location and erase user data.

Write User Data#

The following command is used to read user data.

Syntax:

commander manufacturing write userdata --data <filename.bin>

Example:

commander manufacturing write userdata --data updateuserdata.bin

Read User Data#

The following command is used to write user data.

Syntax:

commander manufacturing read userdata

Write User Data to a Location#

The following command is used to write user data.

Syntax:

commander manufacturing write userdata --data <filename.bin> --address <location_address>

Example:

commander manufacturing write userdata --data updateuserdata.bin --address 0x047fbfe0

Erase User Data#

The following command is used to write user data.

Syntax:

commander manufacturing erase userdata

MAC Address – Update#

When you write the MAC address to the flash or eFuse, it is stored as the Wi-Fi MAC address (customer). The SiWG917 uses this MAC address instead of the default one. This process allows you to customize the MAC address for your specific use case.

You can give the command “commander manufacturing info” in the commander CLI and view both the default Wi-Fi MAC address, and Wi-fi MAC address (customer).

The Wi-Fi MAC address is updated using the manufacturing utility using the following structure and available fields which is stored as a .json file. For example,file is provided here: MAC_Address_update_fields.json.

You can modify MAC address in the the customer_wlan_mac_address field as per your requirement.

{
  "customer_wlan_info_magic_byte": 90,
  "customer_wlan_mac_address": "112233445566"
}

Write to Flash#

The following command can be used to update the Wi-Fi MAC address in the flash

Syntax:

commander manufacturing write efusecopy --data MAC_Address_update_fields.json -d <full opn>

Example:

commander manufacturing write efusecopy --data MAC_Address_update_fields.json -d SiWG917M111MGTBA

Write to eFuse#

The following command can be used to update the Wi-Fi MAC address in the eFuse.

Syntax:

commander manufacturing write efuse --data MAC_Address_update_fields.json -d <full opn>

Example:

commander manufacturing write efuse --data MAC_Address_update_fields.json -d SiWG917M111MGTBA

Read MAC Address#

The following command can be used to read the Wi-Fi MAC address from the flash or eFuse.

Syntax:

commander manufacturing read <efusecopy|efuse> --property customer_wlan_mac_address -d <full opn>

Note:

  • efusecopy – For flash

  • efuse – For eFuse

Example:

  • Read from flash

    commander manufacturing read efusecopy --property customer_wlan_mac_address -d SiWG917M111MGTBA

  • Read from eFuse

    commander manufacturing read efusecopy --property customer_wlan_mac_address -d SiWG917M111MGTBA

Flash Type – Update#

All the OPN MBR files except for SiWG917M110LGTBA contains configurations of GIGA flash by default. SiWG917M110LGTBA OPN will have XMC flash as default.

The flash configurations can be changed by the following steps.

For Macronix Flash#

While loading MBR, add the "macronix.json" file in the following command using "--data" option.

Syntax:

commander manufacturing provision --mbr <filename.bin|default> --data macronix.json -d <full opn>

Example:

commander manufacturing provision --mbr ta_mbr_SiWG917M111XGTBA.bin --data macronix.json

For XMC Flash#

While loading MBR, add the "xmc.json" file in the following command using "--data" option.

Syntax:

commander manufacturing provision --mbr <filename.bin|default> --data xmc.json -d <full opn>

Example:

commander manufacturing provision --mbr ta_mbr_SiWG917M111XGTBA.bin --data xmc.json

Change from XMC to GIGA#

While loading MBR, add the "giga.json" file in the following command using "--data" option.

Syntax:

commander manufacturing provision --mbr <filename.bin|default> --data giga.json -d <full opn>

Example:

commander manufacturing provision --mbr ta_mbr_SiWG917M110GTBA.bin --data giga.json

Note: By adding the flash_pinset field to the flash_config section in the json files above, the flash pinset can be updated.