单片机与物联网 / 系统课时
上报设备数据
上报设备数据
这一课把传感器读数变成结构稳定的 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。字段名一旦被服务端消费,就应保持兼容;新增字段通常比随意改名更安全。

准备 JSON 与 MQTT 组件
如果当前工程还没有相应依赖,可在项目根目录加入 MQTT 和 cJSON 组件:
idf.py add-dependency espressif/mqtt
idf.py add-dependency espressif/cjson预期结果:
项目依赖清单中包含 espressif/mqtt 和 espressif/cjson;实际终端提示与解析出的版本号可能不同。依赖安装完成后,代码可以直接包含 mqtt_client.h 与 cJSON.h。真正的传感器驱动只需把采样结果传给发布函数,不必让传感器模块了解 MQTT 细节。
编码并发布遥测数据
下面是片段示例,依赖上下文是 Wi-Fi 已联网,并在启动后创建 MQTT 客户端。为了让示例可重复验证,这里先用固定温湿度模拟一次采样;接入真实传感器时替换这两个数值即可。
#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;
}预期输出:
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 接收”的最小设备数据链路已经打通。