单片机与物联网 / 系统课时

上报设备数据

上报设备数据

这一课把传感器读数变成结构稳定的 JSON 消息,再发布到约定的 MQTT Topic。完成后,你可以在 Broker 的订阅端看到设备 ID、温湿度和序号组成的遥测数据。

学习目标

  • 能设计便于消费和扩展的设备遥测 Topic
  • 能用 cJSON 生成合法 JSON 负载
  • 能使用 QoS 1 发布消息并通过确认事件验证发送结果

约定 Topic 与负载

设备上报最好先固定主题命名和字段含义。例如本课使用 devices/esp32-room-01/telemetry,把设备身份放在 Topic 中,把变化频繁的传感器值放在 JSON Payload 中。

本课负载包含 device_id、temperature_c、humidity_pct 和 seq。字段名一旦被服务端消费,就应保持兼容;新增字段通常比随意改名更安全。

传感器数据编码并发布到 MQTT 的数据流

准备 JSON 与 MQTT 组件

如果当前工程还没有相应依赖,可在项目根目录加入 MQTT 和 cJSON 组件:

bash
idf.py add-dependency espressif/mqtt
idf.py add-dependency espressif/cjson

预期结果:

text
项目依赖清单中包含 espressif/mqtt 和 espressif/cjson;实际终端提示与解析出的版本号可能不同。

依赖安装完成后,代码可以直接包含 mqtt_client.h 与 cJSON.h。真正的传感器驱动只需把采样结果传给发布函数,不必让传感器模块了解 MQTT 细节。

编码并发布遥测数据

下面是片段示例,依赖上下文是 Wi-Fi 已联网,并在启动后创建 MQTT 客户端。为了让示例可重复验证,这里先用固定温湿度模拟一次采样;接入真实传感器时替换这两个数值即可。

c
#include "esp_event.h"
#include "esp_log.h"
#include "mqtt_client.h"
#include "cJSON.h"

static const char *TAG = "telemetry";
static int sequence = 1;

static int publish_telemetry(esp_mqtt_client_handle_t client,
                             float temperature_c,
                             float humidity_pct)
{
    cJSON *root = cJSON_CreateObject();
    if (root == NULL) {
        return -1;
    }

    cJSON_AddStringToObject(root, "device_id", "esp32-room-01");
    cJSON_AddNumberToObject(root, "temperature_c", temperature_c);
    cJSON_AddNumberToObject(root, "humidity_pct", humidity_pct);
    cJSON_AddNumberToObject(root, "seq", sequence++);

    char *payload = cJSON_PrintUnformatted(root);
    if (payload == NULL) {
        cJSON_Delete(root);
        return -1;
    }

    int msg_id = esp_mqtt_client_publish(
        client,
        "devices/esp32-room-01/telemetry",
        payload,
        0,
        1,
        0);

    ESP_LOGI(TAG, "payload=%s msg_id=%d", payload, msg_id);
    cJSON_free(payload);
    cJSON_Delete(root);
    return msg_id;
}

static void mqtt_event_handler(void *handler_args,
                               esp_event_base_t base,
                               int32_t event_id,
                               void *event_data)
{
    esp_mqtt_event_handle_t event = event_data;

    if (event_id == MQTT_EVENT_CONNECTED) {
        ESP_LOGI(TAG, "connected");
        publish_telemetry(event->client, 26.4f, 58.0f);
    } else if (event_id == MQTT_EVENT_PUBLISHED) {
        ESP_LOGI(TAG, "broker acknowledged msg_id=%d", event->msg_id);
    }
}

esp_mqtt_client_handle_t mqtt_start_after_wifi_connected(void)
{
    const esp_mqtt_client_config_t config = {
        .broker.address.uri = "mqtt://<BROKER_HOST>:<PORT>",
        .credentials.client_id = "esp32-room-01",
    };

    esp_mqtt_client_handle_t client = esp_mqtt_client_init(&config);
    if (client == NULL) {
        ESP_LOGE(TAG, "failed to create mqtt client");
        return NULL;
    }

    ESP_ERROR_CHECK(esp_mqtt_client_register_event(
        client, ESP_EVENT_ANY_ID, mqtt_event_handler, NULL));
    ESP_ERROR_CHECK(esp_mqtt_client_start(client));
    return client;
}

预期输出:

text
I (<TIME>) telemetry: connected
I (<TIME>) telemetry: payload={"device_id":"esp32-room-01","temperature_c":26.4,"humidity_pct":58,"seq":1} msg_id=<ID>
I (<TIME>) telemetry: broker acknowledged msg_id=<ID>

<BROKER_HOST>、<PORT>、<TIME> 和 <ID> 的实际值会不同。示例使用 QoS 1,因此成功发布后可通过 MQTT_EVENT_PUBLISHED 观察 Broker 的确认;retain 参数为 0,不会要求 Broker 把这条遥测消息保存为主题的保留消息。

验收上报结果

在另一台客户端订阅 devices/esp32-room-01/telemetry,应能收到可解析的 JSON,并确认 Topic、设备 ID 和字段类型都符合约定。若 esp_mqtt_client_publish() 返回负值,先检查 MQTT 是否已连接、发送缓冲是否可用以及网络状态。

当订阅端持续收到结构一致的 JSON,且 QoS 1 的消息能观察到发布确认,就说明“采样 → 编码 → 发布 → Broker 接收”的最小设备数据链路已经打通。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

上报设备数据

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通