单片机与物联网 / 系统课时
接收远程控制
接收远程控制
本节把 ESP32 从“只上报数据”改成“可被远程控制”:设备订阅 MQTT 控制主题,收到 JSON 指令后先校验格式和允许的操作,再执行 LED 控制并发布回执。重点不是把任意数据直接映射到硬件,而是建立一条可验证、可拒绝的控制链路。
学习目标
- 订阅设备专属控制主题,并在回调中读取消息载荷。
- 校验指令编号、动作名和参数类型,只执行白名单操作。
- 用回执主题确认执行结果,并能通过命令行完成联调。
先约定控制消息
控制消息应尽量小而明确。下面约定设备只接受 led.set,并要求每条命令带唯一 id。value 必须是布尔值,不能把字符串 "true" 当成合法参数。
{"id":"req-001","action":"led.set","value":true}设备成功执行后向 device/<ID>/control/ack 发布回执;失败时仍使用同一个回执主题,但返回 rejected 和原因。这样控制端可以区分“消息没到设备”和“设备收到但拒绝执行”。
建立订阅与执行链路

这条链路里,MQTT 回调只是入口。真正的安全边界来自三层检查:限制最大载荷,拒绝无法解析的 JSON,再把 action 映射到程序内明确写死的操作。不要把主题里的字符串直接拼成函数名、GPIO 编号或系统命令。
实现校验与控制
下面示例使用 Arduino ESP32、PubSubClient 和 ArduinoJson。请先把 <SSID>、<PASSWORD>、<HOST> 与 <ID> 替换成实际值;LED_PIN 也要按开发板修改。示例 Broker 使用未加密的 1883 端口,只用于受控实验网络。
#include <WiFi.h>
#include <PubSubClient.h>
#include <ArduinoJson.h>
const char* WIFI_SSID = "<SSID>";
const char* WIFI_PASS = "<PASSWORD>";
const char* MQTT_HOST = "<HOST>";
constexpr uint16_t MQTT_PORT = 1883;
const char* CLIENT_ID = "esp32-<ID>";
const char* CONTROL_TOPIC = "device/<ID>/control";
const char* ACK_TOPIC = "device/<ID>/control/ack";
constexpr int LED_PIN = 2;
WiFiClient network;
PubSubClient mqtt(network);
void publishAck(const char* id, const char* status, const char* detail) {
StaticJsonDocument<192> doc;
doc["id"] = id;
doc["status"] = status;
doc["detail"] = detail;
char payload[192];
serializeJson(doc, payload, sizeof(payload));
bool ok = mqtt.publish(ACK_TOPIC, payload, false);
Serial.printf("ack %s id=%s status=%s\n",
ok ? "published" : "failed", id, status);
}
void onMessage(char* topic, byte* payload, unsigned int length) {
if (strcmp(topic, CONTROL_TOPIC) != 0) {
return;
}
// 先限制输入规模,避免异常消息占用过多解析内存。
if (length == 0 || length > 256) {
publishAck("unknown", "rejected", "invalid_length");
return;
}
StaticJsonDocument<384> doc;
DeserializationError error = deserializeJson(doc, payload, length);
if (error) {
publishAck("unknown", "rejected", "invalid_json");
return;
}
if (!doc["id"].is<const char*>() ||
!doc["action"].is<const char*>()) {
publishAck("unknown", "rejected", "missing_fields");
return;
}
const char* id = doc["id"];
const char* action = doc["action"];
// 只允许显式白名单中的动作,拒绝任意 GPIO 或任意命令执行。
if (strcmp(action, "led.set") != 0) {
publishAck(id, "rejected", "unsupported_action");
return;
}
if (!doc["value"].is<bool>()) {
publishAck(id, "rejected", "value_must_be_boolean");
return;
}
bool on = doc["value"].as<bool>();
digitalWrite(LED_PIN, on ? HIGH : LOW);
Serial.printf("accepted id=%s action=%s value=%s\n",
id, action, on ? "true" : "false");
publishAck(id, "ok", on ? "led_on" : "led_off");
}
void connectWiFi() {
WiFi.begin(WIFI_SSID, WIFI_PASS);
while (WiFi.status() != WL_CONNECTED) {
delay(500);
}
Serial.print("Wi-Fi connected: ");
Serial.println(WiFi.localIP());
}
void connectMqtt() {
while (!mqtt.connected()) {
if (mqtt.connect(CLIENT_ID)) {
mqtt.subscribe(CONTROL_TOPIC, 1);
Serial.printf("MQTT connected, subscribed: %s\n", CONTROL_TOPIC);
} else {
delay(1000);
}
}
}
void setup() {
Serial.begin(115200);
pinMode(LED_PIN, OUTPUT);
connectWiFi();
mqtt.setServer(MQTT_HOST, MQTT_PORT);
mqtt.setCallback(onMessage);
mqtt.setBufferSize(512);
}
void loop() {
if (!mqtt.connected()) {
connectMqtt();
}
mqtt.loop();
}预期输出
Wi-Fi connected: <IP>
MQTT connected, subscribed: device/<ID>/control
accepted id=req-001 action=led.set value=true
ack published id=req-001 status=ok<IP> 会随局域网分配结果变化。若发送未知动作或把 value 写成字符串,设备不应改变 LED,只应发布 rejected 回执。
联调控制主题
在安装了 Mosquitto 客户端的电脑上发布一条控制消息。<HOST> 与 <ID> 必须和固件中的值一致。
mosquitto_pub -h <HOST> -p 1883 -t 'device/<ID>/control' -q 1 -m '{"id":"req-001","action":"led.set","value":true}'预期结果
命令成功时 mosquitto_pub 通常不打印正文;ESP32 串口出现 accepted 与 ack published,LED 切换为开启状态。如果要同时观察回执,可在另一个终端订阅 device/<ID>/control/ack。远程控制上线前还应加入 Broker 身份认证、TLS、主题 ACL 和设备级授权,但这些机制不能替代设备端的输入校验。
把远程控制限制在安全边界
控制接口越“通用”越难审计。生产固件应优先暴露业务动作,例如 relay.set、mode.set,而不是“写任意 GPIO”“执行任意文本命令”。对会产生不可逆副作用的动作,还应校验命令时效、权限和重复请求,确保网络中的异常数据最多被拒绝,而不是直接触发硬件。