ESP8266 AT指令实战：从OneNet数据上云到天气时间信息获取

1. ESP8266与AT指令基础入门

第一次接触ESP8266模块时，我被它小巧的体积和强大的Wi-Fi功能惊艳到了。这个售价不到20元的小模块，居然能让我们轻松实现物联网设备的联网功能。不过要真正玩转它，AT指令是绕不开的一道坎。

AT指令就像是我们和ESP8266沟通的语言。想象一下，你新交了一个外国朋友，如果不会对方的语言，再好的想法也无法交流。AT指令就是这样的"通信语言"，通过串口发送特定格式的文本命令，就能控制模块完成各种网络操作。

我刚开始使用时，经常遇到指令不响应的情况。后来发现，每个AT指令必须以回车换行符结尾（即\r\n），这是很多新手容易忽略的细节。比如最简单的AT测试指令，正确的发送格式应该是：

AT\r\n

模块会回复"OK"，表示通信正常。如果没反应，先检查波特率是否匹配（默认115200），再确认接线是否正确。ESP8266的TX要接开发板的RX，RX接TX，这个反接规则我当初就搞错过。

2. 连接OneNet云平台实战

OneNet是国内比较成熟的物联网平台，免费额度对个人开发者非常友好。我去年做的智能温室项目就是用它来存储和展示传感器数据。下面分享具体操作步骤，包含一些我踩过的坑。

2.1 前期准备工作

首先要在OneNet官网创建产品和设备。注意选择HTTP协议（比MQTT简单些），记下三个关键信息：

• 设备ID：类似设备的身份证号
• API密钥：相当于密码
• 产品ID：用于分类管理

建议先用Postman测试接口，确认这些信息正确无误。我就遇到过因为API密钥输错，调试半天的情况。

2.2 建立TCP连接

ESP8266连接OneNet的核心代码如下：

AT+CWMODE=1\r\n // 设置为Station模式 AT+CWJAP="WiFi名称","密码"\r\n // 连接WiFi AT+CIPSTART="TCP","183.230.40.33",80\r\n // 连接OneNet服务器

这里有个实用技巧：先执行AT+CIPDNS_CUR?查询DNS解析。有次我始终连不上，最后发现是DNS解析问题，直接改用IP地址后解决。

2.3 数据上传技巧

上传数据需要构造特定的HTTP报文。经过多次实践，我总结出一个可靠的结构：

POST /devices/设备ID/datapoints HTTP/1.1 api-key: 你的API密钥 Host: api.heclouds.com Content-Length: 数据长度 {"datastreams":[{"id":"温度","datapoints":[{"value":25.5}]}]}

关键点：

1. Host和api-key必须正确
2. Content-Length要精确计算（包括所有花括号、引号等符号）
3. 报文头和正文之间要有空行

我专门写了个计算Content-Length的Python小工具，需要可以私信我。

3. 获取网络时间信息

很多物联网设备需要精确时间，比如我的智能插座需要根据时段调整功率。苏宁时间API是个免费稳定的选择。

3.1 基础连接方法

AT+CIPSTART="TCP","quan.suning.com",80\r\n AT+CIPMODE=1\r\n // 进入透传模式 AT+CIPSEND\r\n > GET http://quan.suning.com/getSysTime.do HTTP/1.1 Host: quan.suning.com

注意透传模式结束后要发送"+++"（不带回车）。返回的JSON数据包含完整时间信息，解析时建议使用Arduino的Json库。

3.2 错误处理经验

网络时间获取最怕遇到：

1. 服务器无响应：添加5秒超时检测
2. 数据解析失败：严格校验JSON格式
3. 时区问题：中国是UTC+8

我的解决方案是设计三级回退机制：

1. 首选苏宁API
2. 失败后尝试阿里云NTP
3. 最后使用本地RTC备份

4. 获取天气数据实战

知心天气的免费版足够个人项目使用。获取长沙天气的典型流程：

4.1 API请求构造

AT+CIPSTART="TCP","api.seniverse.com",80\r\n AT+CIPSEND\r\n > GET https://api.seniverse.com/v3/weather/now.json?key=你的密钥&location=changsha&language=en&unit=c Host: api.seniverse.com

返回数据包含温度、天气状况、风速等信息。建议缓存结果，避免频繁请求（免费版有次数限制）。

4.2 数据解析优化

原始JSON数据较复杂，我推荐使用字段过滤：

{ "results": [ { "now": { "temperature": "23", "text": "晴" } } ] }

在ESP8266上解析时，可以只提取关键字段，节省内存。对于中文项目，建议language=zh-Hans。

5. 项目集成与优化

将上述功能整合时，我总结出几个实用技巧：

5.1 内存管理

ESP8266内存有限，建议：

• 使用String对象代替char数组
• 及时释放不需要的变量
• 分段处理大数据

5.2 网络稳定性

Wi-Fi连接可能不稳定，我的解决方案：

1. 添加自动重连机制
2. 关键操作设置超时
3. 重要数据本地缓存

5.3 电源管理

电池供电设备要注意：

• 深度睡眠模式
• 按需唤醒
• 低功耗Wi-Fi扫描

曾经有个户外项目因为没处理好电源，续航从预计的1个月降到3天。后来改用定时唤醒方案才解决。

6. 常见问题排查

根据我的经验，90%的问题集中在以下几类：

6.1 连接失败

检查顺序：

1. Wi-Fi密码是否正确
2. 模块供电是否充足（建议3.3V 500mA以上）
3. 天线是否连接良好

6.2 AT指令无响应

可能原因：

1. 波特率不匹配
2. 未添加回车换行
3. 模块处于睡眠模式

6.3 数据发送异常

典型情况：

1. HTTP格式错误
2. Content-Length计算错误
3. JSON格式不规范

建议先用串口助手单独测试每个环节，再逐步集成。保留详细的调试日志也非常重要。