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

接入物联网服务

接入物联网服务

这一课把 ESP32 的网络能力串成一个可验收闭环:设备首次启动完成 Wi-Fi 配网,联网后向 MQTT 上报遥测数据,并订阅控制主题接收远程指令。示例采用 Arduino-ESP32、WiFiManager 和 PubSubClient。

学习目标

  • 使用 SoftAP 配网页面保存 Wi-Fi 凭据并自动重连。
  • 建立 MQTT 上报与订阅通道,完成“设备数据上行、控制命令下行”。
  • 识别明文 MQTT、阻塞重连和主题设计在生产环境中的风险。

把配网、上报和控制串成一条链路

首次启动时,ESP32 先创建临时热点 ESP32-Setup。手机连接热点并在配网页面选择家庭或实验室 Wi-Fi,WiFiManager 会把凭据保存到设备;后续启动优先直接连接已保存网络。获得 IP 后再建立 MQTT 连接,发布遥测主题并订阅命令主题。

ESP32 配网与 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。

cpp
#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);
}

预期输出

text
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 中限制设备只能写自己的遥测与状态主题、读自己的命令主题。做到“能配网、能上报、能控制”只是功能闭环,身份、加密、重试和权限才决定它能否成为长期运行的物联网节点。

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

目录与阅读设置

阅读设置

17

记录一个想法

接入物联网服务

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

登录哪都通