Form the update request

A request to perform an update is communicated to the XBee Cellular through Remote Manager by using the Data Services Device Request feature. The device request should be sent to the FTP_OTA target and the payload of the request is the concatenation of the six fields identifying the full FTP location of the update file using the NUL byte as a delimiter. We recommend using the base64 encoded binary transport option to avoid issues representing the request in XML.

For example, you want to update a module with the file sample.bin in the support/example directory on Digi's FTP server.

The full body of the request:

ftp1.digi.com␀21␀anonymous␀example@digi.com␀support/example␀sample.bin

Note The ␀ character represents a byte in the date with the value zero.

The base64 encoded representation of the payload in turn:

ZnRwMS5kaWdpLmNvbQAyMQBhbm9ueW1vdXMAZXhhbXBsZUBkaWdpLmNvbQBzdXBwb3J0L2V4YW1wbGUAc2FtcGxlLmJpbg==

The full Remote Manager device request is as shown below. Make sure to replace the Device ID attribute with the ID for your device.

 

<sci_request version="1.0">
  <data_service>
    <targets>
      <device id="Your device ID here"/>
    </targets>
    <requests>
      <device_request target_name="FTP_OTA" format="base64">
        ZnRwMS5kaWdpLmNvbQAyMQBhbm9ueW1vdXMAZXhhbXBsZUBkaWdpLmNvbQBzdXBwb3J0L2V4YW1wbGUAc2FtcGxlLmJpbg==
      </device_request>
    </requests>
  </data_service>
</sci_request>