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 mfg917 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 NWP MBR#

The following command is used to write NWP MBR.

Syntax:

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

Example:

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

Write M4 MBR#

The following command is used to write M4 MBR.

Syntax:

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

Example:

commander mfg917 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 mfg917 write userdata --data <filename.bin>

Example:

commander mfg917 write userdata --data updateuserdata.bin

Read User Data#

The following command is used to write user data.

Syntax:

commander mfg917 read userdata

Write User Data to a Location#

The following command is used to write user data.

Syntax:

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

Example:

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

Erase User Data#

The following command is used to write user data.

Syntax:

commander mfg917 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 mfg917 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 mfg917 write efusecopy --data MAC_Address_update_fields.json -d <full opn>

Example:

commander mfg917 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 mfg917 write efuse --data MAC_Address_update_fields.json -d <full opn>

Example:

commander mfg917 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 mfg917 read <efusecopy|efuse> --property customer_wlan_mac_address -d <full opn>

Note:

  • efusecopy – For flash

  • efuse – For eFuse

Example:

  • Read from flash

    commander mfg917 read efusecopy --property customer_wlan_mac_address -d SiWG917M111MGTBA

  • Read from eFuse

    commander mfg917 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 mfg917 provision --mbr <filename.bin|default> --data macronix.json -d <full opn>

Example:

commander mfg917 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 mfg917 provision --mbr <filename.bin|default> --data xmc.json -d <full opn>

Example:

commander mfg917 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 mfg917 provision --mbr <filename.bin|default> --data giga.json -d <full opn>

Example:

commander mfg917 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.