Todos os produtos
Search

Este produto

    IoT Platform:Exemplo 1: Upload de múltiplos arquivos via MQTT

    Central de documentação

    IoT Platform:Exemplo 1: Upload de múltiplos arquivos via MQTT

    Última atualização: Jun 26, 2026

    Este tópico usa o arquivo de demonstração./demos/mqtt_upload_basic_demo.c do Link SDK for C como exemplo para descrever como chamar as APIs do Link SDK e fazer upload de arquivos para o IoT Platform via MQTT, reduzindo o consumo de recursos de hardware e os custos de desenvolvimento.

    Contexto

    Etapa 1: Inicializar o upload de arquivos

    1. Adicione os arquivos de cabeçalho.

      ……
……
#include "aiot_mqtt_api.h"
#include "aiot_mqtt_upload_api.h"
#include "core_crc64.h"
……

    2. Configure as dependências subjacentes e a saída de log.

      /* A collection of system adaptation functions located in the portfiles/aiot_port/ directory. */
extern aiot_sysdep_portfile_t g_aiot_sysdep_portfile;
/* The server certificate located in external/ali_ca_cert.c. */
extern const char *ali_ca_cert;
/* The log callback, where SDK logs are output. */
static int32_t demo_state_logcb(int32_t code, char *message)
{
    printf("%s", message);
    return 0;
}

    3. Chame aiot_mqtt_upload_init para criar uma instância de cliente de upload de arquivos e inicializar seus parâmetros padrão.

          mqtt_handle = aiot_mqtt_upload_init();

    Etapa 2: Configurar o upload de arquivos

    Chame aiot_mqtt_upload_setopt para configurar as seguintes opções.

    1. Associe o identificador de conexão MQTT.

      Importante

      Antes de configurar os parâmetros do recurso de upload de arquivos, certifique-se de ter configurado as credenciais de autenticação do dispositivo e os parâmetros relacionados. Consulte Configurar parâmetros de conexão MQTT.

      As solicitações de upload de arquivos utilizam conexões MQTT. Associe o identificador de conexão MQTT a esta opção.

          void *up_handle = aiot_mqtt_upload_init();
    aiot_mqtt_upload_setopt(up_handle, AIOT_MQTT_UPLOADOPT_MQTT_HANDLE, mqtt_handle);

    2. (Opcional)

      Configure os parâmetros de upload de arquivos.

      • Código de exemplo:

            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);

      • Parâmetros:

        Parâmetro

        Descrição

        rsp_timeout

        Tempo limite para retransmissão de cada bloco de dados, em milissegundos.

        Padrão: 5.000 ms (5 segundos). Defina como 0 para usar o valor padrão.

        Valor de exemplo: 2.000 ms.

        AIOT_MQTT_UPLOADOPT_RSP_TIMEOUT_MS

        Define o tempo limite para retransmitir cada bloco de dados durante o upload do arquivo.

        rety_count

        Número de tentativas em caso de tempo limite.

        Padrão: 10.

        Valor de exemplo: 5.

        AIOT_MQTT_UPLOADOPT_RETRY_COUNT

        Define o número de tentativas em caso de tempo limite durante o upload do arquivo.

        block_size

        Tamanho máximo de cada bloco de dados, em bytes.

        Intervalo válido: 256–131.072. Padrão: 2.048 bytes.

        Valor de exemplo: 1.024 bytes.

        AIOT_MQTT_UPLOADOPT_DEFAULT_BLOCK_SIZE

        Define o tamanho máximo de cada bloco de dados enviado durante o upload do arquivo.

    (Opcional) Etapa 3: Calcular a soma de verificação CRC64

    Por padrão, o protocolo executa o cálculo CRC16 em cada bloco de dados. Opcionalmente, use CRC64 para validação do arquivo completo. O SDK inclui uma biblioteca C para cálculo de CRC64.

    O código a seguir calcula a soma de verificação CRC64 para um arquivo:

        uint64_t crc = mqtt_upload_get_file_crc64(MQTT_UPLOAD_FILE_NAME);

    Etapa 4: Solicitar um upload de arquivo

    1. Chame aiot_mqtt_upload_open_stream para enviar uma solicitação de upload de arquivo ao IoT Platform.

      Importante

      • Ao fazer upload de um arquivo, não chame aiot_mqtt_upload_open_stream várias vezes para o mesmo arquivo. Se um upload falhar, reenvie a solicitação para retomá-lo.

      • Para uploads de arquivos diferentes, chame aiot_mqtt_upload_open_stream múltiplas vezes. O SDK suporta o upload simultâneo de vários arquivos.

      • Código de exemplo:

        • Defina os tamanhos e nomes dos arquivos:

          #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")

        • Envie solicitações para fazer upload dos arquivos:

           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);

      • Descrição do código de exemplo:

        • O código de exemplo chama esta API para fazer upload de dois arquivos simultaneamente: mqttuploadfile001.txt e mqttuploadfile002.txt.

          Importante

          • Os nomes de arquivos possuem as seguintes restrições:

            • Devem conter apenas dígitos, letras, sublinhados (_) e pontos (.).

            • Devem começar com um dígito ou uma letra.

            • Devem ter no máximo 100 bytes de comprimento.

          • O tamanho máximo do arquivo é de 16 MB.

        • O arquivo mqttuploadfile001.txt usa validação CRC64 e passa o parâmetro userdata.

        • O arquivo mqttuploadfile002.txt não usa validação CRC64 e nenhum parâmetro userdata é passado.

        • O código de exemplo utiliza a política de processamento overwrite. A tabela a seguir descreve as políticas de processamento disponíveis.

          Política

          Descrição

          overwrite

          Política padrão. O IoT Platform exclui o arquivo existente com o mesmo nome e mantém apenas o arquivo recém-carregado.

          append

          Quando um dispositivo envia uma solicitação de upload de arquivo, o IoT Platform retorna informações sobre qualquer arquivo existente com o mesmo nome. O dispositivo pode então:

          • Se o arquivo existente foi carregado incompletamente, retomar o upload.

            Nota

            O IoT Platform retém uploads incompletos por apenas 24 horas.

          • Se o arquivo já foi totalmente carregado, usar a política de sobrescrita ou renomear o arquivo local antes de fazer o upload novamente.

          reject

          O IoT Platform retorna um código de erro indicando que o arquivo já existe e rejeita a solicitação de upload.

    2. O IoT Platform responde à solicitação de upload de arquivo e aciona um callback no dispositivo.

      No callback, o SDK lê o conteúdo do arquivo ou dados da memória em blocos e executa um cálculo CRC16 em cada bloco.

      Importante

      Durante a transferência em blocos, cada bloco de dados não deve exceder o valor de AIOT_MQTT_UPLOADOPT_DEFAULT_BLOCK_SIZE. Exceto pelo último bloco, cada bloco deve ter pelo menos 256 bytes.

      A função de callback a seguir, mqtt_upload_read_data_handler, lê os dados do arquivo em blocos:

      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. (Opcional)

      Para cancelar um upload em andamento, chame aiot_mqtt_upload_cancel_stream.

      Referência da API: aiot_mqtt_upload_cancel_stream.

    Etapa 5: Tratar o status do upload

    Durante o upload do arquivo, chame aiot_mqtt_upload_process em um loop para verificar o status do upload:

        while(1) {
        aiot_mqtt_upload_result_t result = aiot_mqtt_upload_process(up_handle);
        if (result.code == STATE_MQTT_UPLOAD_FINISHED) {
            /* Upload successful. */
            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 ) {
            /* Upload failed. */
            printf("MQTT Upload file(%s) failed,res:-0x%.4X\r\n", result.file_name, -result.code);
            /* Destroy the MQTT UPLOAD instance. */
        } 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);
    }

    Etapa 6: Desinicializar o upload de arquivos

    Chame aiot_mqtt_upload_deinit para destruir a instância do cliente de upload de arquivos e liberar recursos:

    aiot_mqtt_upload_deinit(&up_handle);

    Logs do lado do dispositivo

    Visualize os resultados da execução no lado do dispositivo.

    • Logs de conexão:

      Uma conexão bem-sucedida do dispositivo ao IoT Platform produz o seguinte log:

      [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

    • Assinaturas de tópicos de upload de arquivos:

      [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

    • Logs de solicitação de upload de arquivos:

      O dispositivo envia solicitações de upload para dois arquivos:

      Nome do arquivo

      Tamanho (bytes)

      Validação CRC64

      mqttuploadfile001.txt

      2048

      Sim

      mqttuploadfile002.txt

      1151

      Não

      		 
      [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                             | }}

    • Logs de resposta de upload de arquivos:

      Logs de resposta para os dois arquivos:

      • 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"}

    • Logs de leitura de arquivos:

      Após o IoT Platform responder e acionar o callback, os logs de leitura do arquivo são:

      • 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******
......
......
......

    • Logs de monitoramento de status de upload:

      Após a conclusão do upload, o IoT Platform retorna informações de status:

      • mqttuploadfile001.txt

        Nota

        Este arquivo usa validação de integridade CRC64, portanto, o log inclui o valor CRC64 validado.

        [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

    • Logs de saída do programa:

      Após a conclusão do upload, o programa cancela a assinatura dos tópicos relacionados e encerra a execução.

      [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

    Logs do IoT Platform

    Gerencie os arquivos carregados e visualize os logs de execução no console do IoT Platform.

    • Para visualizar os arquivos carregados, acesse Device Management > Devices. Clique em View para o dispositivo desejado e selecione a aba File Management.

      A lista de arquivos exibe o nome do arquivo, tamanho, hora do upload e operações disponíveis. Você pode usar as opções Download ou Delete para os arquivos carregados.

      Gerenciar arquivos.

    • No painel de navegação à esquerda, acesse Monitoring and O&M > Log Service. Selecione o produto relevante para visualizar os logs de upload de arquivos do dispositivo.

      Na aba Cloud-side Runtime Log, a lista de logs exibe Time, TraceID, Message Content, DeviceName, Business Type, Operation, Content e Status. Para uploads de arquivos de dispositivos, o tipo de negócio é Device File Upload e a operação é FileUploadFinished. O status 200 indica sucesso.

    Próximas etapas

    • Após configurar o arquivo de exemplo, compile-o para criar o arquivo executável ./output/mqtt-upload-basic-demo. Consulte Compilar e executar a demonstração.

    • Para solucionar problemas de mensagens de erro nos logs de execução, verifique as descrições dos códigos de status em aiot_mqtt_upload_api.h.