App Inventor 远程控制 ESP8266:接入移动 OneNET,手机不在同一网络也能控灯

« 返回首页

宿舍里做一个「手机控制 ESP8266 开灯」的项目,演示时很风光,但一到带去教室、比赛现场或者放假回家,App 就连不上了——因为大多数教程用的是局域网直连(Socket、TCP 或者 App 直接访问 ESP8266 起的 Web 服务),手机和 ESP8266 必须在同一个 WiFi 里。这篇文章给出一个在国内网络环境下稳定可用的方案:ESP8266 通过 MQTT 接入中国移动 OneNET 平台,App Inventor 通过 OneNET 的 REST 接口下发命令、查询状态,手机在 4G/5G 流量下照样能控。

整体架构与一个重要提醒

手机 App(App Inventor)
     │  HTTPS(REST 接口)
     ▼
中国移动 OneNET 云平台
     ▲  MQTT(1883 端口)
     │
ESP8266 + 继电器/LED

先说一个很多人踩过的坑:不建议让 App 也用 MQTT 直接连 OneNET。OneNET 的 MQTT 接入里,一个设备同一时间只允许一个 MQTT 连接(第二个连上来会把第一个踢掉),而且设备之间不能互相直接发消息——下行命令走的是平台接口。所以网上一些旧教程「App 注册成另一个设备、直接订阅对方主题」的写法,在现在的 OneNET 上跑不通,或者两个端互相踢线。正确的分工是:

  • ESP8266:作为设备用 MQTT 接入,负责上报状态、接收下行命令(这是 MQTT 的强项,低功耗、断线重连都好处理);
  • App:用 Web 组件调 OneNET 的 REST 接口下发命令、用计时器轮询设备状态。对手机来说,隔几秒查一次数据完全够用。

另外一个坑:网上老文章里写的 183.230.40.39:6002、183.230.40.33:6002 这些地址是 OneNET 旧版多协议接入的,新注册的账号已经用不了了。新版 MQTT 服务器是 mqtts.heclouds.com,端口 1883(不加密)/ 8883(TLS)。

准备工作:OneNET 侧的配置

  1. 注册中国移动 OneNET 账号(open.iot.10086.cn),完成实名认证。
  2. 创建产品:接入协议选 MQTT,联网方式选 WiFi,数据协议用默认的 OneJSON(物模型)。
  3. 在产品里添加物模型功能点:比如建一个布尔型的功能点,标识名 led,读写方向「读写」(读写才能被命令下发)。
  4. 创建设备,记下三个东西(三元组):产品 ID(product_id)、设备名称(device_name)、设备密钥(device key,access_key)。
  5. 生成 token:OneNET 新版的 MQTT 密码和 REST 接口鉴权都用 token,格式是 version=2018-10-31&res=products/xxxx/devices/yyyy&et=有效期时间戳&method=md5&sign=签名。签名自己算比较麻烦,用官方提供的 token 生成工具(产品文档里有网页版/下载版),填入 res、key、method 选 md5,et(过期时间)教学项目直接给个几年的时间戳,生成的 token 复制保存好。注意 ESP8266 和 App 各自需要一个 token(res 分别指向自己用的那个设备或整个产品,工具里按提示填)。

ESP8266 端:Arduino 代码要点

环境:Arduino IDE + ESP8266 开发板支持包 + PubSubClient 库。核心逻辑:连 WiFi → 连 MQTT(ClientID 用设备名,用户名用产品 ID,密码用上面生成的 token)→ 订阅属性设置主题 → 收到命令就开关灯 → 每隔一段时间上报状态。

#include <ESP8266WiFi.h>
#include <PubSubClient.h>

WiFiClient net;
PubSubClient mqtt(net);

const char* PRODUCT_ID  = "你的产品ID";
const char* DEVICE_NAME = "你的设备名";
const char* TOKEN       = "你生成的token";   // 长字符串
const char* MQTT_SERVER = "mqtts.heclouds.com";
const int   MQTT_PORT   = 1883;

// 物模型主题
String topicSet = "$sys/" + String(PRODUCT_ID) + "/" + DEVICE_NAME + "/thing/property/set";
String topicPost = "$sys/" + String(PRODUCT_ID) + "/" + DEVICE_NAME + "/thing/property/post";

bool ledOn = false;

void callback(char* topic, byte* payload, unsigned int len) {
  // 下行的 OneJSON 大致是 {"id":"1","params":{"led":true}}
  String msg = "";
  for (unsigned int i = 0; i < len; i++) msg += (char)payload[i];
  if (msg.indexOf("\"led\":true") >= 0)  { ledOn = true;  digitalWrite(2, HIGH); }
  if (msg.indexOf("\"led\":false") >= 0) { ledOn = false; digitalWrite(2, LOW);  }
  report();          // 立刻回一次状态
}

void report() {
  // OneJSON 上报格式
  String body = "{\"id\":\"1\",\"version\":\"1.0\",\"params\":{\"led\":";
  body += ledOn ? "true" : "false";
  body += "}}";
  mqtt.publish(topicPost.c_str(), body.c_str());
}

void setup() {
  pinMode(2, OUTPUT);
  WiFi.begin("你的WiFi名", "你的WiFi密码");
  while (WiFi.status() != WL_CONNECTED) delay(500);
  mqtt.setServer(MQTT_SERVER, MQTT_PORT);
  mqtt.setCallback(callback);
}

void loop() {
  if (!mqtt.connected()) reconnect();   // 重连函数里做 mqtt.connect(设备名, 产品ID, token)
  mqtt.loop();
  static unsigned long last = 0;
  if (millis() - last > 30000) {        // 每30秒上报一次
    last = millis();
    if (mqtt.connected()) report();
  }
}

连上后,先到 OneNET 控制台的设备调试 / 命令下发页面手动发一个 {"led":true},看板上灯有没有亮、属性值有没有变化。平台侧验证通过再写 App,不然出了问题分不清是设备端还是 App 端。

App Inventor 端

组件清单:文本输入框、按钮(开灯、关灯)、标签(显示状态)、Web 两个(Web_下发、Web_查询,分开用避免消息混在一起)、计时器(定时查询)、微数据库(可选,记住 token)、对话框。这些组件都是内置的,不用装扩展。

整体积木逻辑:

global 产品ID = "你的产品ID"
global 设备名 = "你的设备名"
global 平台Token = "version=2018-10-31&res=..."

when 按钮_开灯.Click() {
  下发属性(true)
}

when 按钮_关灯.Click() {
  下发属性(false)
}

procedure 下发属性(开关值) {
  Web_下发.Url = "https://iot-api.heclouds.com/thingmodel/set-device-property"
  Web_下发.RequestHeaders = [["token", 平台Token]]
  Web_下发.PostText(join("{\"product_id\":\"", 产品ID, "\",\"device_name\":\"", 设备名, "\",\"params\":{\"led\":", 开关值, "}}"))
}

when Web_下发.GotText(url, responseCode, responseType, responseContent) {
  if responseCode = 200 and textContains(responseContent, "\"code\":0") {
    对话框1.ShowAlert("命令已下发")
  } else {
    对话框1.ShowAlert(join("下发失败:", responseContent))
  }
}

when 计时器_查询.Timer() {
  Web_查询.Url = join("https://iot-api.heclouds.com/thingmodel/query-device-property?product_id=", 产品ID, "&device_name=", 设备名, "&identifier=led")
  Web_查询.RequestHeaders = [["token", 平台Token]]
  Web_查询.Get()
}

when Web_查询.GotText(url, responseCode, responseType, responseContent) {
  if textContains(responseContent, "\"value\":true") {
    标签_灯状态.Text = "灯:开"
  } else if textContains(responseContent, "\"value\":false") {
    标签_灯状态.Text = "灯:关"
  }
}

两点说明:

  • 计时器的 TimerInterval(计时间隔)建议设 3000~5000 毫秒,别太快,一是费流量,二是查询太频繁没有意义。
  • 判断灯状态上面用了简单的文本包含判断,方便快速跑通;如果你要做多个属性的状态面板,建议改用 Web 组件的解码JSON文本把返回的 JSON 解析成字典再逐个取值,更严谨。Web 组件的完整属性和方法见组件中文文档,对着积木面板核对一遍再连。

常见连不上 / 不生效排查

按出现频率从高到低:

  1. ESP8266 连 MQTT 一直失败:九成是 token 的问题。检查 res 是否填对(是 products/产品ID/devices/设备名 这种格式)、et 时间戳是否已过期、key 是不是复制成了别的产品的。token 错了 MQTT 会直接断开且提示不明显,多试几个 method(md5/sha1/sha256)和工具选项。
  2. 宿舍/公司 WiFi 下 ESP 连不上,手机热点下正常:很多校园网和办公网封了 1883 这类非网页端口。这不是你代码的问题,换个网络测试,或者改走 8883 的 TLS(PubSubClient 需要换用 WiFiClientSecure 并设置 setInsecure)。
  3. 命令下发返回成功,ESP 没反应:检查三件事——物模型功能点是不是建了、标识名是不是严格叫 led(大小写一致)、功能点方向是不是「读写」(只读的属性平台不会下发)。另外确认 ESP 确实订阅了 $sys/.../thing/property/set 这个主题,拼错一个字符都收不到。
  4. App 端返回 401 / 鉴权失败:REST 用的 token 和 MQTT 的 token 不一定要同一个,res 的范围不同;用生成工具重新生成一个指向你设备的 token 给 App 用。
  5. App 切到后台就收不到状态了:这是国产手机的后台管控,不是 App 的 bug。小米/红米:安全中心 → 应用管理 → 给你的 App 开自启动、省电策略改为「无限制」;华为/荣耀:设置 → 电池 → 启动管理里关掉「自动管理」、允许后台活动;OPPO/vivo 类似,在电池和权限管理里放行。测试时最好保持 App 在前台。
  6. 被同产品下另一个连接踢线:如果你之前调试时在电脑上开着 MQTT 调试工具连了同一个设备,ESP 会反复掉线。同一设备同时只能有一个 MQTT 连接,调试工具记得断开。

小结

这个方案的本质是「设备端走 MQTT,手机端走 REST,云端做中转」,绕开了局域网的限制,也符合 OneNET 目前的接入规范。搭好一次之后,扩展很方便:加个 DHT11 温湿度,ESP 端在 report 里多传一个属性,App 端查询里多解析一个标识名,就是一个可以带去比赛展示的远程环境监控项目了。

最后提醒一句安全:token 直接写在 App 里,APK 发给别人就能被提取,教学和比赛项目问题不大,但如果要做真正部署的产品,中间应该加一层自己的后端服务做鉴权,别把平台密钥放进手机 App。

文档反馈