示例一:MQTT多文件上传

本文以C Link SDK中的Demo文件./demos/mqtt_upload_basic_demo.c为例,介绍如何调用Link SDK的API,帮助设备基于MQTT协议的连接,将文件上传至物联网平台,以减少硬件资源的开销,并降低开发成本。

背景信息

  • 文件上传功能的更多信息,请参见文件上传概述

  • 文件上传功能基于MQTT接入,开发过程中涉及MQTT接入的代码说明,请参见MQTT接入

步骤一:初始化文件上传功能

  1. 添加头文件。

    ……
    ……
    #include "aiot_mqtt_api.h"
    #include "aiot_mqtt_upload_api.h"
    #include "core_crc64.h"
    ……
  2. 配置底层依赖和日志输出。

    /* 位于portfiles/aiot_port文件夹下的系统适配函数集合 */
    extern aiot_sysdep_portfile_t g_aiot_sysdep_portfile;
    /* 位于external/ali_ca_cert.c中的服务器证书 */
    extern const char *ali_ca_cert;
    /* 日志回调函数, SDK的日志会从这里输出 */
    static int32_t demo_state_logcb(int32_t code, char *message)
    {
        printf("%s", message);
        return 0;
    }
  3. 调用aiot_mqtt_upload_init,创建文件上传功能的客户端实例,并初始化默认参数。

        mqtt_handle = aiot_mqtt_upload_init();

步骤二:配置文件上传功能

调用aiot_mqtt_upload_setopt,配置以下功能。

  1. 关联MQTT连接的句柄。

    重要

    配置文件上传功能参数前,请确保已配置设备认证信息等相关参数。具体操作,请参见MQTT配置连接参数

    文件上传功能的请求基于MQTT连接,通过该配置项,关联MQTT连接句柄。

        void *up_handle = aiot_mqtt_upload_init();
        aiot_mqtt_upload_setopt(up_handle, AIOT_MQTT_UPLOADOPT_MQTT_HANDLE, mqtt_handle);
  2. (可选)

    配置要上传文件的相关参数。

    • 示例代码:

          uint32_t rsp_timeout = 2000;
          aiot_mqtt_upload_setopt(up_handle, AIOT_MQTT_UPLOADOPT_RSP_TIMEOUT_MS, &rsp_timeout);
          uint32_t rety_count = 5;
          aiot_mqtt_upload_setopt(up_handle, AIOT_MQTT_UPLOADOPT_RETRY_COUNT, &rety_count);
          uint32_t block_size = 1024;
          aiot_mqtt_upload_setopt(up_handle, AIOT_MQTT_UPLOADOPT_DEFAULT_BLOCK_SIZE, &block_size);
    • 相关参数:

      配置项

      说明

      rsp_timeout

      定义每包数据重发的超时时间,单位毫秒。

      如果不设置或设置为0,则超时时间为5秒。

      示例代码将超时时间设置为2000毫秒。

      AIOT_MQTT_UPLOADOPT_RSP_TIMEOUT_MS

      调用aiot_mqtt_upload_setopt,设置上传文件时每包数据重发的超时时间。

      rety_count

      定义超时重试的次数。

      默认重试次数为10次。

      示例代码设置的重试5次。

      AIOT_MQTT_UPLOADOPT_RETRY_COUNT

      调用aiot_mqtt_upload_setopt,设置上传文件时超时重试的次数。

      block_size

      定义每包数据发送的最大值,单位字节。

      取值范围为256~131072,默认为2048字节。

      示例代码设置的最大值为1024字节。

      AIOT_MQTT_UPLOADOPT_DEFAULT_BLOCK_SIZE

      调用aiot_mqtt_upload_setopt,设置上传文件时每包数据发送的最大值。

(可选)步骤三:计算完整文件的CRC64

上传文件时,协议内默认对分片数据进行CRC16计算。您可以根据业务需要,选择CRC64计算,SDK默认提供CRC64计算C版库。

以下示例代码为计算完整文件的CRC64。

    uint64_t crc = mqtt_upload_get_file_crc64(MQTT_UPLOAD_FILE_NAME);

步骤四:请求上传文件

  1. 调用aiot_mqtt_upload_open_stream,向物联网平台发起上传文件请求。

    重要
    • 同名文件上传过程中,请勿调用aiot_mqtt_upload_open_stream发起多次请求。上传失败后,您可以重复请求续传文件。

    • 不同名文件上传过程中,可以调用aiot_mqtt_upload_open_stream发起多次请求,且支持多文件上传。

    • 示例代码:

      • 定义要上传的文件大小和文件名:

        #define MQTT_UPLOAD_FILE_SIZE       (2 * 1024)
        #define MQTT_UPLOAD_FILE_NAME       ("mqttuploadfile001.txt")
        #define MQTT_UPLOAD_FILE_SIZE2       (1 * 1024 + 127)
        #define MQTT_UPLOAD_FILE_NAME2       ("mqttuploadfile002.txt")
      • 发起请求上传文件:

         uint32_t test_userdata = 100;
            aiot_mqtt_upload_open_stream(up_handle, MQTT_UPLOAD_FILE_NAME, MQTT_UPLOAD_FILE_SIZE,
                AIOT_MQTT_UPLOAD_FILE_MODE_OVERWRITE, &crc, mqtt_upload_read_data_handler, &test_userdata);
            mqtt_upload_create_upload_file(MQTT_UPLOAD_FILE_NAME2, MQTT_UPLOAD_FILE_SIZE2);
            aiot_mqtt_upload_open_stream(up_handle, MQTT_UPLOAD_FILE_NAME2, MQTT_UPLOAD_FILE_SIZE2,
                AIOT_MQTT_UPLOAD_FILE_MODE_OVERWRITE, NULL, mqtt_upload_read_data_handler, NULL);
    • 示例代码说明:

      • 示例代码调用该接口同时上传两个文件mqttuploadfile001.txtmqttuploadfile002.txt

        重要
        • 上传文件的名称限制如下:

          • 支持数字、英文字母、下划线(_)和英文句点(.)。

          • 首字符仅支持数字和英文字母。

          • 长度不超过100字节。

        • 单个文件不超过16 MB。

      • mqttuploadfile001.txt有CRC64校验,有userdata传参。

      • mqttuploadfile002.txt无CRC64校验,无userdata传参。

      • 示例代码使用的上传文件的处理策略为overwrite。处理策略的详细说明如下:

        处理策略(conflictStrategy)

        说明

        覆盖模式(overwrite)

        默认模式,删除已存在的同名文件,仅保留最新上传的文件。

        文件追加模式(append)

        发起上传文件请求后,物联网平台返回已存在的同名文件信息,设备端可根据业务需要,选择以下操作:

        • 如果已存在的同名文件为未完成上传的文件,则设备继续执行上传任务。

          说明

          物联网平台仅在24小时内保留未完成上传的文件。

        • 如果已存在的同名文件为已完成上传的文件,则设备选择覆盖模式或重命名文件后,重新上传文件。

        拒绝模式(reject)

        物联网平台返回文件已存在的错误码,并拒绝再次上传该文件。

  2. 物联网平台接收文件上传的请求后,向设备返回应答消息。设备接收消息后,触发回调函数。

    在回调函数中,SDK分片读取文件内容或您的内存数据,获取到data数据后,对单包data数据进行CRC16计算。

    重要

    分片传输过程中,单包数据不大于AIOT_MQTT_UPLOADOPT_DEFAULT_BLOCK_SIZE设置的值。同时,除最后一包数据外,单包数据不小于256字节。

    示例代码如下,回调函数为mqtt_upload_read_data_handler

    int32_t mqtt_upload_read_data_handler(const aiot_mqtt_upload_recv_t *packet, uint8_t *data, uint32_t size, void *userdata) {
        int32_t read_len = 0;
        if (userdata != NULL) {
            uint32_t *test_userdata = (uint32_t *)userdata;
            printf("test_userdata:%d\r\n", *test_userdata);
        }
        if (packet == NULL) {
            return 0;
        }
        if (packet->desc.code == UPLOAD_FILE_OK) {
            if (data != NULL && size != 0) {
                uint32_t read_size = size;
                FILE *fp;
                char* file_name = packet->desc.file_name;
                fp = fopen(file_name, "r");
                uint32_t offset = packet->desc.file_offset;
                fseek(fp, offset, SEEK_SET);
                printf("Open %s read at: %d\r\n", file_name, offset);
                read_len = fread(data, sizeof(uint8_t), read_size, fp);
                printf("Read_len: %d\r\n", read_len);
                fclose(fp);
            }
        } else {
            printf("Error code:%d, message:%s\r\n", packet->desc.code, packet->desc.message);
        }
        return read_len;
    }
  3. (可选)

    上传文件过程中,如果需要取消上传,您可以调用aiot_mqtt_upload_cancel_stream。

    取消上传接口的详细说明,请参见aiot_mqtt_upload_cancel_stream

步骤五:处理文件上传状态

文件上传过程中,调用aiot_mqtt_upload_process,循环检测文件上传的状态。示例代码如下:

    while(1) {
        aiot_mqtt_upload_result_t result = aiot_mqtt_upload_process(up_handle);
        if (result.code == STATE_MQTT_UPLOAD_FINISHED) {
            /* 上传成功 */
            printf("MQTT Upload file(%s) success\r\n", result.file_name);
            uploaded_file++;
            if (uploaded_file == 2) {
                break;
            }
        } else if (result.code == STATE_MQTT_UPLOAD_FAILED ||
                   result.code == STATE_MQTT_UPLOAD_FAILED_TIMEOUT ||
                   result.code == STATE_MQTT_UPLOAD_CANCEL_FAILED ) {
            /* 上传失败 */
            printf("MQTT Upload file(%s) failed,res:-0x%.4X\r\n", result.file_name, -result.code);
            /* 销毁MQTT UPLOAD实例 */
        } else if (result.code == STATE_MQTT_UPLOAD_CANCEL_SUCCESS) {
            printf("MQTT Upload file(%s) cancel success,res:-0x%.4X\r\n", result.file_name, -result.code);
        } else if (result.code == STATE_MQTT_UPLOAD_FAILED_WHOLE_CHECK) {
            printf("MQTT Upload file(%s) whole file md5 failed,res:-0x%.4X\r\n", result.file_name, -result.code);
        }
        sleep(1);
    }

步骤六:退出文件上传程序

调用aiot_mqtt_upload_deinit,销毁文件上传功能的客户端实例,释放资源。

aiot_mqtt_upload_deinit(&up_handle);

设备端日志

您可以在设备端查看运行结果。

  • 连接日志:

    出现如下日志,表示设备与物联网平台连接成功。

    [1637138922.457][LK-0313] MQTT user calls aiot_mqtt_connect api, connect
    [1637138922.457][LK-032A] mqtt host: iot-******.iot-as-mqtt.unify.aliyuncs.com
    [1637138922.457][LK-0317] user name: LightSwitch&a18wP******
    [1637138922.457][LK-0318] password: 2AE57DEEAADE002064F87DEC55EE2EDD2A1996E44BA8F5622507D1EFD6******
    success to establish tcp, fd=5
    local port: 57139
    [1637138922.488][LK-1000] establish mbedtls connection with server(host='iot-******.iot-as-mqtt.unify.aliyuncs.com', port=[1883])
    [1637138922.507][LK-1000] success to establish mbedtls connection, (cost 45247 bytes in total, max used 47983 bytes)
    [1637138922.654][LK-0313] MQTT connect success in 197 ms
    AIOT_MQTTEVT_CONNECT
                        
  • 订阅文件上传功能相关Topic:

    [1637138922.654][LK-2013] aiot_mqtt_upload_init init
    [1637138922.654][LK-0309] sub: /sys/a18wP******/LightSwitch/thing/file/upload/mqtt/init_reply
    [1637138922.654][LK-0309] sub: /sys/a18wP******/LightSwitch/thing/file/upload/mqtt/send_reply
    [1637138922.654][LK-0309] sub: /sys/a18wP******/LightSwitch/thing/file/upload/mqtt/cancel_reply
  • 上传文件的请求日志:

    设备向物联网平台发起上传请求,请求上传两个文件,分别为:

    文件名

    大小(字节)

    是否进行CRC64校验

    mqttuploadfile001.txt

    2048

    mqttuploadfile002.txt

    1151

    [1637138922.655][LK-0309] pub: /sys/a18wP******/LightSwitch/thing/file/upload/mqtt/init
    [LK-030A] > 7B 22 69 64 22 3A 22 31  22 2C 22 70 61 72 61 6D | {"id":"1","params"
    [LK-030A] > 73 22 3A 7B 22 66 69 6C  65 4E 61 6D 65 22 3A 22 | :{"fileName":"
    [LK-030A] > 6D 71 74 74 75 70 6C 6F  61 64 66 69 6C 65 30 30 | mqttuploadfile001.txt"
    [LK-030A] > 31 2E 74 78 74 22 2C 22  66 69 6C 65 53 69 7A 65 | ,"fileSize
    [LK-030A] > 22 3A 32 30 34 38 2C 22  63 6F 6E 66 6C 69 63 74 | ":2048,"conflictStrategy"
    [LK-030A] > 53 74 72 61 74 65 67 79  22 3A 22 6F 76 65 72 77 | :"overwrite"
    [LK-030A] > 72 69 74 65 22 2C 22 66  69 63 4D 6F 64 65 22 3A | ,"ficMode":
    [LK-030A] > 22 63 72 63 36 34 22 2C  22 66 69 63 56 61 6C 75 | "crc64","ficValue"
    [LK-030A] > 65 22 3A 22 66 34 38 66  34 33 37 64 35 35 64 34 | :"f48f437d55**
    [LK-030A] > 37 31 34 63 22 7D 7D                             | ****"}}
    [1637138922.655][LK-0309] pub: /sys/a18wP******/LightSwitch/thing/file/upload/mqtt/init
    [LK-030A] > 7B 22 69 64 22 3A 22 32  22 2C 22 70 61 72 61 6D | {"id":"2","params"
    [LK-030A] > 73 22 3A 7B 22 66 69 6C  65 4E 61 6D 65 22 3A 22 | :{"fileName":"
    [LK-030A] > 6D 71 74 74 75 70 6C 6F  61 64 66 69 6C 65 30 30 | mqttuploadfile002.txt"
    [LK-030A] > 32 2E 74 78 74 22 2C 22  66 69 6C 65 53 69 7A 65 | ,"fileSize
    [LK-030A] > 22 3A 31 31 35 31 2C 22  63 6F 6E 66 6C 69 63 74 | ":1151,"conflictStrategy"
    [LK-030A] > 53 74 72 61 74 65 67 79  22 3A 22 6F 76 65 72 77 | :"overwrite"
    [LK-030A] > 72 69 74 65 22 7D 7D                             | }}
  • 请求上传文件的应答日志:

    根据不同名的两个文件,示例代码发起两次请求后,返回的应答日志分别为:

    • mqttuploadfile001.txt

      [1637138923.214][LK-0309] pub: /sys/a18wP******/LightSwitch/thing/file/upload/mqtt/init_reply
      [LK-030A] < 7B 22 63 6F 64 65 22 3A  32 30 30 2C 22 64 61 74 | {"code":200,"data"
      [LK-030A] < 61 22 3A 7B 22 66 69 6C  65 4E 61 6D 65 22 3A 22 | :{"fileName":"
      [LK-030A] < 6D 71 74 74 75 70 6C 6F  61 64 66 69 6C 65 30 30 | mqttuploadfile001.txt"
      [LK-030A] < 31 2E 74 78 74 22 2C 22  75 70 6C 6F 61 64 49 64 | ,"uploadId
      [LK-030A] < 22 3A 22 6B 54 48 76 63  47 45 31 78 58 56 48 33 | ":"kTHvcGE1xXVH3
      [LK-030A] < 46 79 44 4C 34 4C 55 30  31 30 32 30 30 22 2C 22 | FyDL4LU******","
      [LK-030A] < 6F 66 66 73 65 74 22 3A  30 2C 22 66 69 6C 65 53 | offset":0,"fileSize"
      [LK-030A] < 69 7A 65 22 3A 32 30 34  38 2C 22 63 6F 6E 66 6C | :2048,"conflictStrategy"
      [LK-030A] < 69 63 74 53 74 72 61 74  65 67 79 22 3A 22 6F 76 | :"overwrite"}
      [LK-030A] < 65 72 77 72 69 74 65 22  7D 2C 22 69 64 22 3A 22 | ,"id":"1"
      [LK-030A] < 31 22 2C 22 6D 65 73 73  61 67 65 22 3A 22 73 75 | ,"message":
      [LK-030A] < 63 63 65 73 73 22 7D                             | "success"}
      test_userdata:100
      Open mqttuploadfile001.txt read at: 0
    • mqttuploadfile002.txt

      [LK-030A] < 7B 22 63 6F 64 65 22 3A  32 30 30 2C 22 64 61 74 | {"code":200,"data"
      [LK-030A] < 61 22 3A 7B 22 66 69 6C  65 4E 61 6D 65 22 3A 22 | :{"fileName":"
      [LK-030A] < 6D 71 74 74 75 70 6C 6F  61 64 66 69 6C 65 30 30 | mqttuploadfile002.txt"
      [LK-030A] < 32 2E 74 78 74 22 2C 22  75 70 6C 6F 61 64 49 64 | ,"uploadId
      [LK-030A] < 22 3A 22 6B 6F 48 54 45  4B 46 34 59 58 31 6E 61 | ":"koHTEKF4YX1na
      [LK-030A] < 46 30 74 49 33 43 35 30  31 30 32 30 30 22 2C 22 | F0tI3C5******","
      [LK-030A] < 6F 66 66 73 65 74 22 3A  30 2C 22 66 69 6C 65 53 | offset":0,"fileSize"
      [LK-030A] < 69 7A 65 22 3A 31 31 35  31 2C 22 63 6F 6E 66 6C | :1151,
      [LK-030A] < 69 63 74 53 74 72 61 74  65 67 79 22 3A 22 6F 76 | "conflictStrategy":
      [LK-030A] < 65 72 77 72 69 74 65 22  7D 2C 22 69 64 22 3A 22 | "overwrite"},"id":"
      [LK-030A] < 32 22 2C 22 6D 65 73 73  61 67 65 22 3A 22 73 75 | 2","message":
      [LK-030A] < 63 63 65 73 73 22 7D                             | "success"}
  • 读取文件的日志:

    物联网平台返回的应答消息触发回调函数后,读取两个文件的日志分别为:

    • mqttuploadfile001.txt

      Open mqttuploadfile001.txt read at: 0
      Read_len: 1024
      [1637138923.215][LK-2014] Read data_len:1024[1637138923.215][LK-0309] pub: /sys/a18wP******/LightSwitch/thing/file/upload/mqtt/send
      [LK-030A] > 00 55 7B 22 69 64 22 3A  22 34 22 2C 22 70 61 72 | .U{"id":"4","params"
      [LK-030A] > 61 6D 73 22 3A 7B 22 75  70 6C 6F 61 64 49 64 22 | :{"uploadId"
      [LK-030A] > 3A 22 6B 54 48 76 63 47  45 31 78 58 56 48 33 46 | :"kTHvcGE1xXVH3F
      [LK-030A] > 79 44 4C 34 4C 55 30 31  30 32 30 30 22 2C 22 6F | yDL4LU******",
      [LK-030A] > 66 66 73 65 74 22 3A 30  2C 22 62 53 69 7A 65 22 | "offset":0,"bSize"
      [LK-030A] > 3A 31 30 32 34 7D 7D 55  4E 41 56 41 4F 4F 56 4C | :1024}}UNAVAOOVL
      [LK-030A] > 53 43 58 4C 57 59 43 54  5A 58 45 4C 47 43 4E 57 | SCXLWYCTZXELGCNW
      [LK-030A] > 58 55 55 41 46 54 47 46  46 42 4D 46 48 48 54 59 | XUUAFTGFFBMFHHTY
      [LK-030A] > 52 59 46 58 44 49 57 45  4A 4E 50 47 46 4A 49 45 | RYFXDIWEJNPGFJIE
      [LK-030A] > 4E 43 55 43 50 4B 54 57  54 50 4F 4F 49 45 4B 4C | NCUCPKTWTPOOIEKL
      [LK-030A] > 4F 5A 54 55 55 42 4C 4B  58 5A 48 59 4D 4A 49 43 | OZTUUBLKXZHYMJIC
      [LK-030A] > 46 41 4E 54 49 41 59 41  46 4E 4B 4D 52 4F 43 51 | FANTIAYAFNKMROCQ
      [LK-030A] > 48 4F 43 56 44 59 54 51  59 57 52 4D 48 4E 42 50 | HOCVDYTQY******
      ......
      ......
      ......
    • mqttuploadfile002.txt

      Open mqttuploadfile002.txt read at: 0
      Read_len: 1024
      [1637138923.216][LK-2014] Read data_len:1024[1637138923.216][LK-0309] pub: /sys/a18wP******/LightSwitch/thing/file/upload/mqtt/send
      [LK-030A] > 00 55 7B 22 69 64 22 3A  22 33 22 2C 22 70 61 72 | .U{"id":"3","params"
      [LK-030A] > 61 6D 73 22 3A 7B 22 75  70 6C 6F 61 64 49 64 22 | :{"uploadId"
      [LK-030A] > 3A 22 6B 6F 48 54 45 4B  46 34 59 58 31 6E 61 46 | :"koHTEKF4YX1naF
      [LK-030A] > 30 74 49 33 43 35 30 31  30 32 30 30 22 2C 22 6F | 0tI3C5******",
      [LK-030A] > 66 66 73 65 74 22 3A 30  2C 22 62 53 69 7A 65 22 | "offset":0,"bSize"
      [LK-030A] > 3A 31 30 32 34 7D 7D 55  4E 41 56 41 4F 4F 56 4C | :1024}}UNAVAOOVL
      [LK-030A] > 53 43 58 4C 57 59 43 54  5A 58 45 4C 47 43 4E 57 | SCXLWYCTZXELGCNW
      [LK-030A] > 58 55 55 41 46 54 47 46  46 42 4D 46 48 48 54 59 | XUUAFTGFFBMFHHTY
      [LK-030A] > 52 59 46 58 44 49 57 45  4A 4E 50 47 46 4A 49 45 | RYFXDIWEJNPGFJIE
      [LK-030A] > 4E 43 55 43 50 4B 54 57  54 50 4F 4F 49 45 4B 4C | NCUCPKTWTPOOIEKL
      [LK-030A] > 4F 5A 54 55 55 42 4C 4B  58 5A 48 59 4D 4A 49 43 | OZTUUBLKXZHYMJIC
      [LK-030A] > 46 41 4E 54 49 41 59 41  46 4E 4B 4D 52 4F 43 51 | FANTIAYAFNKMROCQ
      [LK-030A] > 48 4F 43 56 44 59 54 51  59 57 52 4D 48 4E 42 50 | HOCVDYTQYW******
      ......
      ......
      ......
  • 监控文件上传状态的日志:

    完成文件上传后,物联网平台返回文件上传状态信息,两个文件的相关日志分别为:

    • mqttuploadfile001.txt

      说明

      由于该文件进行了CRC64完整性校验,因此日志中包含校验后的CRC64。

      [1637138924.099][LK-0309] pub: /sys/a18wP******/LightSwitch/thing/file/upload/mqtt/send_reply
      [LK-030A] < 7B 22 63 6F 64 65 22 3A  32 30 30 2C 22 64 61 74 | {"code":200,"data"
      [LK-030A] < 61 22 3A 7B 22 66 69 63  56 61 6C 75 65 43 6C 69 | :{"ficValueCli
      [LK-030A] < 65 6E 74 22 3A 22 66 34  38 66 34 33 37 64 35 35 | ent":"f48f437d55
      [LK-030A] < 64 34 37 31 34 63 22 2C  22 66 69 63 4D 6F 64 65 | ******","ficMode
      [LK-030A] < 22 3A 22 63 72 63 36 34  22 2C 22 75 70 6C 6F 61 | ":"crc64","uploadId"
      [LK-030A] < 64 49 64 22 3A 22 6B 54  48 76 63 47 45 31 78 58 | :"kTHvcGE1xX
      [LK-030A] < 56 48 33 46 79 44 4C 34  4C 55 30 31 30 32 30 30 | VH3FyDL4LU******
      [LK-030A] < 22 2C 22 6F 66 66 73 65  74 22 3A 31 30 32 34 2C | ","offset":1024,
      [LK-030A] < 22 63 6F 6D 70 6C 65 74  65 22 3A 74 72 75 65 2C | "complete":true,
      [LK-030A] < 22 66 69 63 56 61 6C 75  65 53 65 72 76 65 72 22 | "ficValueServer"
      [LK-030A] < 3A 22 66 34 38 66 34 33  37 64 35 35 64 34 37 31 | :"f48f437d55****
      [LK-030A] < 34 63 22 2C 22 62 53 69  7A 65 22 3A 31 30 32 34 | **","bSize":1024
      [LK-030A] < 7D 2C 22 69 64 22 3A 22  36 22 2C 22 6D 65 73 73 | },"id":"6","message"
      [LK-030A] < 61 67 65 22 3A 22 73 75  63 63 65 73 73 22 7D    | :"success"}
      [1637138924.099][LK-2014] Upload total size:2048
    • mqttuploadfile002.txt

      [1637138923.884][LK-0309] pub: /sys/a18wP******/LightSwitch/thing/file/upload/mqtt/send_reply
      [LK-030A] < 7B 22 63 6F 64 65 22 3A  32 30 30 2C 22 64 61 74 | {"code":200,"data"
      [LK-030A] < 61 22 3A 7B 22 75 70 6C  6F 61 64 49 64 22 3A 22 | :{"uploadId":"
      [LK-030A] < 6B 6F 48 54 45 4B 46 34  59 58 31 6E 61 46 30 74 | koHTEKF4YX1naF0t
      [LK-030A] < 49 33 43 35 30 31 30 32  30 30 22 2C 22 6F 66 66 | I3C5******","offset"
      [LK-030A] < 73 65 74 22 3A 31 30 32  34 2C 22 63 6F 6D 70 6C | :1024,"complete"
      [LK-030A] < 65 74 65 22 3A 74 72 75  65 2C 22 62 53 69 7A 65 | :true,"bSize
      [LK-030A] < 22 3A 31 32 37 7D 2C 22  69 64 22 3A 22 35 22 2C | ":127},"id":"5",
      [LK-030A] < 22 6D 65 73 73 61 67 65  22 3A 22 73 75 63 63 65 | "message":"success"
      [LK-030A] < 73 73 22 7D                                      | }
      [1637138923.884][LK-2014] Upload total size:1151
  • 退出程序相关日志:

    文件上传完成后,退出程序,并取消订阅相关Topic。

    [1637648533.379][LK-2124] Complete upload total size:2048
    MQTT Upload file(mqttuploadfile001.txt) success
    [1637648534.407][LK-2100] Finish upload,Deleted upload task.
    MQTT Upload file(mqttuploadfile002.txt) success
    [1637648534.407][LK-210F] aiot_mqtt_upload_deinit
    [1637648534.407][LK-0309] unsub: /sys/a18wP******/LightSwitch/thing/file/upload/mqtt/init_reply
    [1637648534.408][LK-0309] unsub: /sys/a18wP******/LightSwitch/thing/file/upload/mqtt/send_reply
    [1637648534.408][LK-0309] unsub: /sys/a18wP******/LightSwitch/thing/file/upload/mqtt/cancel_reply
    [1637648534.513][LK-1000] adapter_network_deinit

物联网平台日志

您可以在物联网平台控制管理上传的文件,并查看例程运行后的日志信息。

  • 管理上传的文件:

    在左侧导航栏,选择设备管理设备,然后单击设备对应的查看按钮。在文件管理页签下,您可以查看该设备上传的文件列表。

    设备文件管理

    更多信息,请参见文件管理

  • 查看相关日志:

    在左侧导航栏,选择监控运维 > 日志服务,选择产品后,查看设备上传文件的相关日志。

    文件上传功能相关日志

后续步骤

  • 例程文件配置完成后,需进行编译,生成可执行文件./output/mqtt-upload-basic-demo。更多信息,请参见编译与运行

  • 运行日志中出现的错误信息,请参见aiot_mqtt_upload_api.h,中的状态码描述根据提示解决问题。