IoT Platform:Configure device OTA update

Important notes

The steps in this topic are performed as a regular user. If an operation requires administrative permissions, prefix the command with sudo.

Procedure

1. Obtain the C device SDK: C SDK 4.x.

2. Unzip the C device SDK package and modify the device connection information in the /LinkSDK/demos/fota_posix_demo.c file.

   Use the device information for SDevice1.

   char *product_key       = "g18***";
   char *device_name       = "SDevice1";
   char *device_secret     = "cefbebf00***";
   ...
   ...
   char  *url = "iot-***.mqtt.iothub.aliyuncs.com";

   Parameter	Example	Description
   url	iot-***.mqtt.iothub.aliyuncs.com	The device connection endpoint. New public instances: On the Instance Details page, click View Development Configurations. The endpoint appears on the Development Configurations panel. Old public instances: The endpoint format is${YourProductKey}.iot-as-mqtt.${YourRegionId}.aliyuncs.com. View instance endpoints.
   product_key	g18***	The device certificate information. For more information, see Obtain a device certificate. This sample uses the unique-certificate-per-device authentication method.
   device_name	SDevice1
   device_secret	cefbebf00***

   The fota_posix_demo.c file provides sample code for an OTA update. The device reports its version as 1.0.0 before the update. In a production environment, you must obtain the actual version number from the device configuration area and implement logic to report it. For more information, see Description of the sample code.

       cur_version = "1.0.0";
       res = aiot_ota_report_version(ota_handle, cur_version);
       if (res < STATE_SUCCESS) {
           printf("aiot_ota_report_version failed: -0x%04X\r\n", -res);
       }

3. On the Linux virtual machine, install the required software.

   sudo apt-get install -y build-essential make gcc

4. Upload the modified LinkSDK package to your Linux development environment.

5. In the SDK root directory /LinkSDK, run the make command to build the sample program.

   make clean
   make

   The sample program, fota-posix-demo, is generated in the ./output directory.

6. Run the sample program:

   ./output/fota-posix-demo

7. View the device runtime logs and status.

   • The following log shows the device connection information and the reported version number.

     :/opt/LinkSDK# ./output/fota-posix-demo
     [1630993401.977][LK-0313] MQTT user calls aiot_mqtt_connect api, connect
     [1630993401.977][LK-0317] SDevice1&g18xxx
     [1630993401.977][LK-0318] 348xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxC
     core_sysdep_network_establish host iot-xxx.mqtt.iothub.aliyuncs.com port 443, type 0
     establish tcp connection with server(host='iot-xxx.mqtt.iothub.aliyuncs.com', port=[443])
     success to establish tcp, fd=3
     local port: 32776
     [1630993401.988][LK-1000] establish mbedtls connection with server(host='iot-xxx mqtt.iothub.aliyuncs.com', port=[443])
     [1630993401.999][LK-1000] success to establish mbedtls connection,  (cost 45247 bytes in total, max used 47983 bytes)
     [1630993401.999][LK-0319] xxx.SDevice1|timestamp=2524608000000,_ss=1,_v=sdk-c-4.1.0,securemode=2,signmethod=hmacsha256,ext=3,_conn-tls_11|
     [1630993402.066][LK-0313] MQTT connect success in 86 ms
     AIOT_MQTTEVT_CONNECT
     [1630993402.066][LK-0309] pub: /ota/device/inform/g18xxx/SDevice1
     [LK-030A] > 7B 22 69 64 22 3A 31 2C  20 22 70 61 72 61 6D 73   {"id":1, "params
     [LK-030A] > 22 3A 7B 22 76 65 72 73  69 6F 6E 22 3A 22 31 2E   ":{"version":"1.
     [LK-030A] > 30 2E 30 22 7D 7D                                    0.0"}}

   • Return to the IoT Platform console for your instance. In the left-side navigation pane, navigate to Device Management > Devices. Find the target device and check its status. A status of Online indicates that the device is connected to IoT Platform.