Uploading the ROM¶
The xPico 600 gateway supports Firmware Over the Air (FOTA) update capability through the Device feature in Web Manager or through the firmware update Web API. Because the xPico 600 series devices ship from the Lantronix factory with Secure Boot enabled, you must first sign the firmware image with your private key before loading the firmware to the device; see Secure Boot.
Note
Currently, you must share your firmware with Lantronix to obtain a signed image.
Web Manager¶
Follow these steps to upload firmware to an xPico 600 device using Web Manager.
- Open Web Manager, go to the Device page, and click Firmware Upgrade.
- Click Choose File, browse to
work/project_name, and select the signed ROM file. - Click Upload and then click OK to confirm that you want to upload a new firmware image. The device erases the old image and receives and writes the new image. After the new firmware is written, the device reboots automatically. It may take a few minutes for this process to complete. After the reboot, the new firmware is active.
- If the new firmware includes a line protocol, change the line's protocol to the new option you just uploaded. Click Line and then click Configuration. From Protocol, select the new project's protocol and then click Submit. The changes take effect immediately.
Web API¶
Use this endpoint to upload firmware to an xPico 600 device using the Web API.
- Description: Load the firmware image file
- Protocol: HTTP
- Method: POST
- Content Type: multipart/form-data
- URL: http://<hostname>/upgrade
Note
The request format emulates a filled-in form to produce a POST request with an HTTP content-type of "multipart/form-data".
Parameters:
imageFile: Name of the file containing the upgrade image.
HTTP Response Codes:
- 200: Success
- 507: Invalid partition size
- 500: All other failures
CURL example: