很多人一看到“物联网”“云平台”“MQTT”这些词，第一反应就是：

难，太难了。

总觉得这玩意儿离自己很远，像是“高手专属”，新手一碰就废。

但我前段时间亲手折腾了一遍 ESP8266 连接 OneNET 云平台，从烧录固件，到设备上线，再到订阅消息、上报数据，整套流程跑下来之后，我最大的感受就一句话：

它真没大家想象中那么复杂。

你甚至不用一开始就懂特别多底层原理，只要把关键步骤理顺，很多地方其实就是“照着做就能跑通”。

这篇文章，我就把自己跑通这套流程的全过程，整理成一篇更适合新手看的版本。你会看到：

• ESP8266 怎么烧录 AT 固件
• OneNET 平台怎么创建产品和设备
• Token 怎么生成
• MQTT 怎么连
• 怎么订阅平台消息
• 怎么给平台发数据
• 平台下发的数据怎么接收

如果你正打算入门物联网，或者刚好在折腾 ESP8266，这篇能帮你少走不少弯路。

---

一、别被“物联网”这三个字吓住了，真正难的其实没你想的那么多

很多新手不是败在不会，而是败在“还没开始就先把自己吓退了”。

因为“ESP8266”“OneNET”“MQTT”这几个词摆在一起，压迫感实在有点强。

感觉像什么？

像刚学会拧螺丝，就被通知明天直接去造火箭。

但如果把整个流程拆开来看，它其实很清晰：

• ESP8266 负责连 WiFi
• OneNET 负责当云平台
• MQTT 负责消息通信
• AT 指令帮你快速把整个链路跑通

说白了，对于入门来说，最重要的不是先学懂所有原理，而是先把整个流程跑通。

只要你第一次能看到设备在线、能看到数据上云、能收到平台下发的消息，你对物联网这套东西的理解会立刻从“抽象概念”变成“我真的做出来了”。

而这，才是新手最需要的成就感。

---

二、开搞之前，先把东西准备齐

这次用到的东西不算多，主要分成硬件和软件两部分。

1、硬件准备

① ESP8266 模块（ESP-01S）

这次用的是 ESP-01S，它负责连接 WiFi 和云平台，是整个项目的核心。

② 烧录器

烧录器用来给 ESP8266 烧固件，也方便后续串口调试。

这里顺便说一句，烧录器真的别太省。

我之前买过一个很坑的，插上之后稍微碰一下就断连，调试的时候整个人都快崩溃。后来换了个靠谱点的，体验立马顺畅很多。

有时候你不是不会，是工具先把你搞崩了。

---

2、软件准备

软件这边主要有 3 个：

① 烧录软件

可以去安信可官网下载，原文里提到打开官网后下拉就能找到。

② AT 固件

这里一定要注意，因为用的是 ESP-01S，所以要选 1M 对应的固件。原文中提到使用的是 1471 号固件。

③ 串口调试助手

后面发 AT 指令、看返回信息，全都得靠它。

---

三、第一步：先把 AT 固件烧进去

如果你的 ESP8266 还没烧录好固件，那就先做这一步。

1、把模块和烧录器接好

把 ESP-01S 插到烧录器上，再把烧录器插进电脑 USB 接口。

---

2、打开烧录软件

进入烧录软件文件夹，找到对应程序，双击启动。

如果弹出窗口，直接点 OK。

---

3、选择固件文件

点击界面上三个点的按钮，找到刚刚下载好的 AT 固件，选中打开。

---

4、填写烧录参数

这里几个关键参数要注意：

• 烧录地址填 0x000
• 波特率选 115200
• COM 口选你的烧录器对应端口

如果电脑上串口比较多，一个很实用的方法就是：
把烧录器拔下来再插上去，看哪个口新出现，那就是它。

参数都设置好以后，点击 START 开始烧录。

---

5、等待烧录完成

软件提示烧录成功之后，就可以关闭了。

到这里，固件这一步就算搞定了。

---

四、第二步：去 OneNET 平台上创建产品和设备

设备端准备好后，就该去云平台把信息配好。

1、搜索并打开 OneNET 云平台

浏览器搜索 OneNET 云平台。

---

2、注册账号并登录

原文里特别提到，虽然它是中国移动的，但不一定非得用中国移动手机号，其他手机号也可以注册。

---

3、进入开发者中心

登录之后，点击右上角的 开发者中心。

---

4、创建产品

在产品开发中点击“创建产品”。

产品品类可以选择“其它行业”。

设备接入这里继续往下配置。

原文中的产品设定建议如下：

• 名称：自己填
• 城市：随便填
• 节点类型：直连设备
• 接入协议：MQTT
• 数据协议：OneJson
• 联网方式：WiFi
• 开发方案：标准方案

创建成功后，就会看到产品已经建好了。

---

5、配置物理模型

接下来点击产品开发，添加自定义功能点，去设置物理模型。

这一步很重要，因为后面设备上报的数据、平台下发的属性，都是基于这里配置的模型来的。

---

6、创建设备

接着创建设备，原文示例中设备名设置成了 01。

到这里，云端的产品和设备就都准备好了。

---

五、第三步：生成连接 OneNET 所需要的 Token

很多人连不上平台，问题往往就出在 Token 这里。

因为这个东西看起来有点“劝退”，但只要你把几个参数弄明白，其实并不复杂。

1、先下载 Token 生成工具

原文里给了文档中心入口，可以从那里下载。

---

2、填写参数并生成 Token

这里最关键的是下面几个参数：

res

格式是：

products/产品ID/devices/设备名称

原文示例：

products/YQ5299H9m8/devices/01

其中：

• YQ5299H9m8 是产品 ID
• 01 是设备名

et

这是时间戳，而且必须填未来某个时间点，不能填过去的时间，不然 Token 会失效。

key

这里填写的是设备密钥。

这些参数都可以在设备详情里找到。

填好以后点击 Generate，就会生成 Token。

很多人到这一步会卡住，最常见的问题就是：

时间戳填错了，或者 Token 已经过期。

所以这里一定要仔细。

---

六、第四步：打开串口工具，正式连接云平台

终于来到最关键的一步。

1、打开串口调试助手

双击打开串口调试工具。

---

2、配置串口参数

串口选择烧录时用的那个端口，波特率设置为 115200，然后打开串口。

---

3、按一下复位键，确认模块正常启动

按一下烧录器上的复位按键，如果看到模块信息和固件信息输出，就说明模块工作正常。

---

4、先发一个最简单的 AT 命令试试

在发送栏输入：

AT

如果返回 OK，说明能正常通信。

---

5、设置为 Station 模式

输入下面这条命令，把模块设置成 Station 模式，也就是让它去连接外部 WiFi：

AT+CWMODE=1

---

6、连接 WiFi

然后输入你的 WiFi 名称和密码：

AT+CWJAP="你的WiFi名称","你的WiFi密码"

这里必须提醒一句：

ESP8266 只能连接 2.4G WiFi，不能连接 5G。

如果你用的是手机热点，而手机默认开的又是 5G 热点，那它就会怎么都连不上。原文专门提到了这一点。

这个坑，真的太多人踩了。

---

7、配置 MQTT 参数并连接 OneNET

先配置 MQTT 用户属性：

AT+MQTTUSERCFG=0,1,"设备名称","产品ID","生成的Token",0,0,""

再连接 OneNET 服务器：

AT+MQTTCONN=0,"mqtts.heclouds.com",1883,1

如果一切正常，这时候你去平台上看，设备应该已经显示在线了。

看到“在线”的那一刻，真的会特别有成就感。

因为这意味着：
你的设备，真的开始和云平台建立连接了。

---

七、设备在线还不够，还得让它能“听懂”平台的话

很多教程写到设备在线就戛然而止，但实际上这只是第一步。

真正完整的链路，还得包括：

• 设备接收平台下发的消息
• 设备主动向平台上报数据

这才叫真正意义上的“连通”。

---

八、第五步：订阅 Topic，准备接收平台消息

设备在线之后，先订阅平台的 Topic。

1、订阅属性设置 Topic

用于接收输出口控制指令：

AT+MQTTSUB=0,"$sys/产品ID/设备名称/thing/property/set",1

还可以额外订阅一个上报响应 Topic，用来看平台是否成功收到数据：

AT+MQTTSUB=0,"$sys/产品ID/设备名称/thing/property/post/reply",1

做到这里，设备就已经具备“接收平台控制指令”的能力了。

---

九、第六步：开始上报数据，最爽的部分来了

订阅成功后，就可以尝试上报数据了。

原文里给了几个典型示例。

1、上报普通属性值

AT+MQTTPUB=0,"$sys/你的产品ID/你的设备名称/thing/property/post","{\"id\":\"1\",\"version\":\"1.0\",\"params\":{\"input1\":{\"value\":1}}}",1,0

2、上报布尔类型开关值

比如测试 sw 这个布尔值：

开：

AT+MQTTPUB=0,"$sys/产品ID/设备名称/thing/property/post","{\"id\":\"1\",\"version\":\"1.0\",\"params\":{\"sw\":{\"value\":true}}}",1,0

关：

AT+MQTTPUB=0,"$sys/产品ID/设备名称/thing/property/post","{\"id\":\"1\",\"version\":\"1.0\",\"params\":{\"sw\":{\"value\":false}}}",1,0

原文中特别提到：
如果发送之后返回内容里有 success，才说明上报成功。

这一步一旦成功，你会立刻意识到：

这已经不是在“发几条串口命令”了，
而是真正实现了设备到云平台的数据上报。

---

十、第七步：接收平台下发的消息

最后，就是看平台怎么把消息发给设备。

你可以在 OneNET 平台中选择你设定好的物理模型，然后进行属性设定测试。

只要前面的订阅没问题，ESP8266 这边就可以收到平台下发的数据。

走到这里，整个流程才算真正打通：

• 设备能联网
• 设备能连云平台
• 平台知道设备在线
• 设备能上报数据
• 平台能下发指令
• 设备能接收消息

对于一个入门项目来说，这已经非常完整了。

---

十一、为什么很多人总觉得这东西难？其实大多数都卡在这几个坑里

我把最容易翻车的几个点，给你直接总结出来：

1、固件下错了

ESP-01S 对应的固件必须匹配，不然烧进去也可能各种异常。

2、WiFi 频段不对

再强调一次：
ESP8266 只能连 2.4G，不能连 5G。

3、Token 过期了

et 必须是未来时间戳，一旦过期，平台就不会认。

4、产品 ID 或设备名写错

Topic、MQTT 参数里这些字段只要有一个字符错了，连接和收发都会出问题。

5、JSON 格式写错

尤其是在 AT 指令里拼 JSON，非常容易在引号、转义符这些细节上翻车。

很多人最后不是败在技术难，而是败在：

少一个符号，多一个空格，或者复制粘贴的时候改错了一个字符。

这很真实。

---

十二、为什么我特别建议新手先用这套方法入门？

因为这套方法最大的好处，不是“多高级”，而是：

它能让你非常快地看到结果。

新手最怕的不是不会，而是学了半天什么都没跑起来。

明明看了很多教程，也懂了很多概念，但设备就是不上线，平台就是不回消息，最后只剩下一种感觉：

我是不是不适合学这个？

其实不是。

很多时候，你只是缺一套能快速建立闭环的方法。

而 ESP8266 + AT 指令 + OneNET 这套组合，恰好就是一个很适合入门的闭环：

• 先烧录
• 再联网
• 再连平台
• 再订阅
• 再上报
• 再接收

一步一步下来，只要你跑通一次，后面再去学更底层的东西，理解会轻松很多。

因为你已经不是在“想象物联网是什么”，而是已经亲手做出过一个真正在线、真正能收发消息的设备。

---

十三、最后说一句大实话：物联网真没你想的那么遥远

很多技术，看起来难，是因为没人用人话把它讲清楚。

ESP8266 接 OneNET 就是个特别典型的例子。

在你没做之前，你会觉得：

• 云平台很复杂
• MQTT 很抽象
• Token 很麻烦
• 设备接入门槛很高

但你真正按流程做一遍以后就会发现：

核心就那么几步。

把固件烧进去。
把产品和设备建好。
把 Token 生成好。
把 WiFi 连上。
把 MQTT 配好。
把 Topic 订阅好。
然后测试上报和接收。

就这些。

难的从来不是“学不会”，
而是没人把它讲得足够直白。

而一旦你跑通了第一次，后面很多东西都会迎刃而解。

---

如果你也在折腾 ESP8266、OneNET、MQTT 这些内容，或者你已经踩过什么特别离谱的坑，欢迎在评论区聊聊。