单片机与物联网 / 系统课时
接入物联网服务
接入物联网服务
这一课把 ESP32 的网络能力串成一个可验收闭环:设备首次启动完成 Wi-Fi 配网,联网后向 MQTT 上报遥测数据,并订阅控制主题接收远程指令。示例采用 Arduino-ESP32、WiFiManager 和 PubSubClient。
学习目标
- 使用 SoftAP 配网页面保存 Wi-Fi 凭据并自动重连。
- 建立 MQTT 上报与订阅通道,完成“设备数据上行、控制命令下行”。
- 识别明文 MQTT、阻塞重连和主题设计在生产环境中的风险。
把配网、上报和控制串成一条链路
首次启动时,ESP32 先创建临时热点 ESP32-Setup。手机连接热点并在配网页面选择家庭或实验室 Wi-Fi,WiFiManager 会把凭据保存到设备;后续启动优先直接连接已保存网络。获得 IP 后再建立 MQTT 连接,发布遥测主题并订阅命令主题。

示例约定主题 lab/esp32/telemetry、lab/esp32/cmd/led 和 lab/esp32/state/led。命令载荷只接受 on 与 off,这样远程控制的输入边界明确,也便于后续增加鉴权和审计。
实现配网与 MQTT 双向通信
在 Arduino IDE 或 PlatformIO 中安装 WiFiManager 与 PubSubClient。把 <MQTT_HOST> 替换为可访问的 Broker 地址;<SETUP_PASSWORD> 至少 8 个字符。示例默认 LED 在 GPIO 2,若开发板的板载灯不是该引脚,需要修改 LED_PIN。
#include <Arduino.h>
#include <WiFi.h>
#include <WiFiManager.h>
#include <PubSubClient.h>
constexpr int LED_PIN = 2;
const char *MQTT_HOST = "<MQTT_HOST>";
constexpr uint16_t MQTT_PORT = 1883;
const char *TELEMETRY_TOPIC = "lab/esp32/telemetry";
const char *COMMAND_TOPIC = "lab/esp32/cmd/led";
const char *STATE_TOPIC = "lab/esp32/state/led";
WiFiClient net;
PubSubClient mqtt(net);
unsigned long lastReconnect = 0;
unsigned long lastPublish = 0;
bool ledOn = false;
void onMessage(char *topic, byte *payload, unsigned int length) {
String msg;
msg.reserve(length);
for (unsigned int i = 0; i < length; ++i) {
msg += static_cast<char>(payload[i]);
}
if (String(topic) != COMMAND_TOPIC || (msg != "on" && msg != "off")) {
return; // 只接受约定主题和白名单命令
}
ledOn = (msg == "on");
digitalWrite(LED_PIN, ledOn ? HIGH : LOW);
mqtt.publish(STATE_TOPIC, ledOn ? "on" : "off", true);
Serial.printf("command: %s\n", msg.c_str());
}
void ensureMqtt() {
if (mqtt.connected() || millis() - lastReconnect < 5000) {
return;
}
lastReconnect = millis();
String clientId = "esp32-";
clientId += WiFi.macAddress();
clientId.replace(":", "");
if (mqtt.connect(clientId.c_str())) {
mqtt.subscribe(COMMAND_TOPIC);
Serial.println("MQTT connected");
}
}
void setup() {
Serial.begin(115200);
pinMode(LED_PIN, OUTPUT);
// autoConnect 有已保存凭据时直接联网,否则开启临时配网热点。
WiFiManager wm;
wm.setConfigPortalTimeout(180);
if (!wm.autoConnect("ESP32-Setup", "<SETUP_PASSWORD>")) {
ESP.restart();
}
Serial.printf("Wi-Fi connected: %s\n", WiFi.localIP().toString().c_str());
mqtt.setServer(MQTT_HOST, MQTT_PORT);
mqtt.setCallback(onMessage);
lastReconnect = millis() - 5000;
}
void loop() {
ensureMqtt();
mqtt.loop();
if (mqtt.connected() && millis() - lastPublish >= 10000) {
lastPublish = millis();
char body[96];
snprintf(body, sizeof(body),
"{\"rssi\":%d,\"uptime_ms\":%lu}",
WiFi.RSSI(), millis());
mqtt.publish(TELEMETRY_TOPIC, body, false);
Serial.printf("publish: %s\n", body);
}
delay(10);
}预期输出
Wi-Fi connected: <IP>
MQTT connected
publish: {"rssi":<VALUE>,"uptime_ms":<VALUE>}
command: on<IP> 与 <VALUE> 会随网络环境和运行时间变化。远程客户端向 lab/esp32/cmd/led 发布 on 后,GPIO 2 置高,并在 lab/esp32/state/led 得到保留状态 on;发布 off 时行为相反。
验证上下行闭环
验收时不要只看“MQTT connected”。应同时确认配网、上报和控制三个方向:清除设备已保存的 Wi-Fi 凭据后能重新进入配网页面;联网后遥测主题持续出现数据;向控制主题发送 on 或 off 后,LED 与状态主题同时变化。
上线前补齐安全与恢复
示例使用 1883 端口和无认证连接,只适合受控实验网络。生产设备应改为 TLS 连接,校验服务器证书,并使用每台设备独立的身份与权限;配网热点也不应使用统一默认密码。网络异常时应采用退避重连和离线缓存,避免 Broker 故障让主循环长时间阻塞。
主题也应按设备身份划分,例如把 <DEVICE_ID> 放入上报和控制路径,并在 Broker ACL 中限制设备只能写自己的遥测与状态主题、读自己的命令主题。做到“能配网、能上报、能控制”只是功能闭环,身份、加密、重试和权限才决定它能否成为长期运行的物联网节点。