Firmware Upgrade over WiFi Tera Term Script#

The Wireless Firmware upgrade application demonstrates how RS9116W device can be configured as an Access point and runs a DHCP and HTTP Server (webserver). This allows another WiFi station to connect e.g. a PC where the firmware file is stored and update the firmware wirelessly through the modules' internal webpage.

Before continuing, ensure the RS9116 EVK is plugged into your computer and TeraTerm is connected as described in Getting Started with PC using AT Commands.

STEP 1. Reset the RS9116 EVK.

STEP 2. In the Tera Term menu select Control->Macro.

Tera Term MacroTera Term Macro

STEP 3. Navigate to the folder <SDK>/examples/at_commands/teraterm/wlan_fw_update and select the file fw_update_over_wifi.ttl.

Tera Term script to be selectedTera Term script to be selected

STEP 4. After running fw_update_over_wifi.ttl script, it will pop up as shown.

Application Start pop upApplication Start pop up

STEP 5. Next command is opermode command at+rsi_opermode=6,1,18,0 , This configures the EVK to function in AP mode. The module responds with “OK”.

Opermode command successOpermode command success

STEP 6. Tera term will pop up for input (Band - 2.4 GHz or 5 GHz) from the user, user needs to enter the band value (0) and hit 'OK', (at+rsi_band=0) This configures the operating band 2.4 GHz of the EVK. The module responds with “OK”.

Band input promptBand input prompt

STEP 7. at+rsi_init command initializes the RF of the module. The module responds with OK<MAC_Address>.

Init command successInit command success

STEP 8. If a user wants to configure a different subnet and gateway than ipconf command has to be issued at this stage else AP will be configured to default subnet and gateway. e.g."at+rsi_ipconf=0,192.168.0.30,255.255.255.0,192.168.0.30", This command configures the IP (192.168.0.30 in this example) of the AP. The module responds with “OK”.

IPConfig SuccessIPConfig Success

STEP 9. Tera term will pop up for input (operating channel) from the user, user can enter any value between 1 to 11 e.g. enter the channel(1) and hit 'OK' as shown:

Channel Parameter input promptChannel Parameter input prompt

STEP 10. Tera term will now pop up for input (SSID of the AP) from the user, user needs to enter the SSID (e.g. Silabs) and hit 'OK'.

SSID input promptSSID input prompt

STEP 11. The next pop up is for input (security mode) from the user, user needs to enter the security mode(2) and hit 'OK', 0 - Open Security 2 - WPA2 PSK Security

Security mode input promptSecurity mode input prompt

STEP 12. Tera term will pop up for input (PSK of the AP) from the user, the user needs to enter the PSK (12345678) and hit 'OK'.

PSK input promptPSK input prompt

STEP 13. The command will go as at+rsi_apconf=1,silabs,2,2,12345678,100,3,3 The SSID is configured as “silabs” operate in channel 1 and the WPA2 PSK set is "12345678"

APConf command successAPConf command success

STEP 14. The next command at+rsi_join=silabs,0,2,6 starts the Access Point functionality. Observe OKG response. The module is now configured as an Access Point. It's IP address is 192.168.0.30.

AP configuration successAP configuration success

A remote peer can now scan for networks and the SSID of the module “silabs”. After the remote peer connects to the AP, it acquires an IP address over DHCP.

STEP 15. Connect a Laptop which has the new firmware file (.rps extension) to the module.

waiting for station to connectwaiting for station to connect

STEP 16. Once a station is connected a pop up appears with “Waiting for the Firmware Upgrade Query from the module”

waiting for firmware upgradewaiting for firmware upgrade

STEP 17. Open the URL http://<Module's IP address> in the Laptop. For example, if the module is configured to have an IP of 192.168.0.30, then the URL is http://192.168.0.30.

Note: Make sure the browser proxies are disabled.

Once the webpage is opened select the "ADMINISTRATION" tab.

webpagewebpage

STEP 18. Click on "Choose File" to navigate to the location of the firmware file (.rps extension), select the file and click "Open". Next, click on "Upgrade".

STEP 19. The module sends a response (AT+RSI_FWUPREQ) to the Host PC to confirm the Firmware Upgrade, as shown in the figure below. The Host sends the confirmation command (AT+RSI_FWUPOK) to start updating the firmware.

Upgrade in progressUpgrade in progress

STEP 20. Once the updation is done, a "Firmware Upgraded Successfully" pop up message is displayed in browser, as shown in the figure below.

Firmware upgrade SuccessFirmware upgrade Success

FWUPSUCCESS Tera TermFWUPSUCCESS Tera Term

Note: If you have issues running the “FW_upgrade_over_wifi.ttl” script, you need to clear the webpages which were loaded in the Module flash using following commands.

  1. To erase the webpage given the filename use this command : “at+rsi_erasefile=< filename >\r\n”

  2. To erase the webpage while filename is unknown use this command : “at+rsi_clearfiles=1\r\n”