1. 项目背景与核心价值
在物联网设备开发领域，EC800M作为一款高性价比的Cat.1通信模组，正在成为中小型物联网项目的热门选择。这个项目演示了如何通过MQTT协议将EC800M模组接入OneNet物联网平台并实现数据上传，整个过程涉及模组AT指令控制、MQTT协议栈配置、OneNet平台对接等关键技术点。
我曾在一个智能农业监测项目中首次使用EC800M模组，当时需要将大棚温湿度数据实时上传到云端。相比传统的WiFi方案，EC800M的4G Cat.1网络覆盖更广，功耗控制更好，特别适合部署在郊区农场等网络环境复杂的场景。通过MQTT协议连接OneNet平台，我们实现了设备数据的可视化展示和远程告警功能。
2. 硬件准备与环境搭建
2.1 所需硬件清单
- EC800M模组（建议使用EC800M-CN版本，支持国内主流频段）
- USB转TTL调试器（推荐CH340G芯片版本，稳定性好）
- 4G天线（确保支持800/900/1800/2100MHz频段）
- SIM卡（已开通物联网流量套餐）
- 开发板或面包板（用于连接调试）
注意：购买EC800M模组时需确认固件版本，建议使用V2.0以上版本，早期版本可能缺少必要的MQTT AT指令支持。
2.2 开发环境配置
-
安装串口调试工具：
- Windows平台推荐使用SecureCRT或Putty
- MacOS可使用CoolTerm或自带的screen命令
- 设置波特率为115200，8N1，无流控
-
物理连接：
plaintext复制
EC800M TXD -> 调试器 RXD EC800M RXD -> 调试器 TXD EC800M GND -> 调试器 GND EC800M VCC -> 3.8V电源（切勿接5V！） -
测试基础通信：
发送AT指令，应收到"OK"响应：at复制AT
3. OneNet平台准备工作
3.1 创建OneNet产品
-
登录OneNet控制台（https://open.iot.10086.cn）
-
进入"产品开发"→"创建产品"：
- 产品名称：自定义（如"EC800M_Demo"）
- 行业类别：选择"其他"
- 联网方式：蜂窝网络（2G/3G/4G）
- 协议类型：MQTT（旧版协议）
- 其他参数保持默认
-
记录关键信息：
- ProductID（产品ID）
- Master-APIkey（主API密钥）
3.2 创建设备与数据流
-
在刚创建的产品下"添加设备"：
- 设备名称：EC800M_Device01
- 设备编号：IMEI（可留空自动生成）
- 鉴权信息：自定义（如"qws2023"）
-
创建数据流模板：
- 添加"temperature"和"humidity"两个数据流
- 单位分别设置为"℃"和"%RH"
-
获取设备连接参数：
- 设备ID（DEVICE_ID）
- 产品ID（PRODUCT_ID）
- 鉴权信息（AUTH_INFO）
4. EC800M模组网络配置
4.1 基础网络设置
-
检查SIM卡状态：
at复制AT+CPIN?正常响应应为"+CPIN: READY"
-
设置APN（以中国移动为例）：
at复制AT+CGDCONT=1,"IP","CMNET" -
激活网络连接：
at复制AT+QIACT=1成功激活后会返回"OK"
-
检查网络注册状态：
at复制AT+CREG?确认返回"+CREG: 0,1"（表示已注册）
4.2 网络连接测试
-
获取IP地址：
at复制AT+QIACT?返回示例：
plaintext复制
+QIACT: 1,1,1,"10.120.156.11" -
测试网络连通性：
at复制AT+QPING=1,"www.baidu.com"正常应收到ping通的响应
5. MQTT协议栈配置
5.1 MQTT参数计算
OneNet旧版MQTT协议需要特殊计算clientId、username和password：
-
ClientID格式：
code复制<device_id> // 直接使用设备ID -
Username格式：
code复制<product_id> // 直接使用产品ID -
Password计算：
code复制token = hmacsha1(<auth_info>, <product_id>+<device_id>) password = base64(<product_id>+<device_id>+<token>)
提示：可以使用在线HMAC工具生成token，Python示例：
python复制import hmac, base64 auth_info = "qws2023" product_id = "123456" device_id = "654321" message = product_id + device_id token = hmac.new(auth_info.encode(), message.encode(), 'sha1').hexdigest() password = base64.b64encode((product_id+device_id+token).encode()).decode()
5.2 EC800M MQTT配置
-
初始化MQTT客户端：
at复制AT+QMTCFG="recv/mode",0,1,1 -
设置MQTT版本（OneNet使用3.1.1）：
at复制AT+QMTCFG="version",0,4 -
设置keepalive时间（建议60秒）：
at复制AT+QMTCFG="keepalive",0,60 -
设置clean session为1：
at复制AT+QMTCFG="session",0,1
6. 连接OneNet平台
6.1 建立MQTT连接
-
连接MQTT服务器：
at复制AT+QMTOPEN=0,"183.230.40.39",6002成功返回"+QMTOPEN: 0,0"
-
登录OneNet：
at复制AT+QMTCONN=0,"client123","123456","aGVsbG8="参数说明：
- client123：替换为设备ID
- 123456：替换为产品ID
- aGVsbG8=：替换为计算得到的password
成功返回"+QMTCONN: 0,0,0"
6.2 订阅主题
OneNet数据点上传需要订阅特定主题：
at复制AT+QMTSUB=0,1,"$sys/123456/654321/dp/post/json/accepted",1
参数说明：
- 123456：产品ID
- 654321：设备ID
7. 数据上传实现
7.1 数据格式规范
OneNet旧版MQTT协议要求特定JSON格式：
json复制{
"id": 123,
"dp": {
"temperature": [{
"v": 25.5,
"t": 1672531200
}],
"humidity": [{
"v": 65.2,
"t": 1672531200
}]
}
}
7.2 AT指令上传数据
-
构造JSON数据（示例上传温度26.5℃）：
at复制AT+QMTPUBEX=0,0,0,0,"$sys/123456/654321/dp/post/json",86然后在下一行输入：
json复制{"id":123,"dp":{"temperature":[{"v":26.5}]}} -
组合上传温湿度：
json复制{"id":124,"dp":{"temperature":[{"v":26.5}],"humidity":[{"v":65.2}]}}
注意：JSON数据中的id需要递增，t参数可省略（平台会自动添加时间戳）
8. 实战经验与问题排查
8.1 常见错误代码
| 错误代码 | 含义 | 解决方案 |
|---|---|---|
| +QMTOPEN: 0,1 | 网络连接失败 | 检查APN设置和网络激活状态 |
| +QMTCONN: 0,1 | MQTT连接失败 | 检查clientId/username/password计算 |
| +QMTSUB: 0,1 | 订阅失败 | 确认主题路径是否正确 |
| +QMTPUBEX: 0,1 | 发布失败 | 检查JSON格式和主题路径 |
8.2 稳定性优化技巧
-
心跳保持：
at复制AT+QMTCFG="keepalive",0,30 // 缩短keepalive时间 -
自动重连：
at复制AT+QMTCFG="auto_connect",0,1 -
数据缓存：
在模组本地缓存最近3次数据，当网络中断时先存储，恢复后批量上传 -
省电模式：
at复制AT+QSCLK=1 // 启用睡眠模式
8.3 JSON数据生成优化
对于资源受限的嵌入式设备，建议：
-
使用固定格式模板：
c复制char json_template[] = "{\"id\":%d,\"dp\":{\"temperature\":[{\"v\":%.1f}],\"humidity\":[{\"v\":%.1f}]}}"; char buffer[128]; snprintf(buffer, sizeof(buffer), json_template, id++, temp, humi); -
避免浮点运算：
将温度值26.5℃转换为整数265传输，在平台端除以10
9. 进阶功能实现
9.1 平台命令接收
-
订阅命令主题：
at复制AT+QMTSUB=0,2,"$sys/123456/654321/cmd/request/+",1 -
处理接收到的命令：
plaintext复制
+QMTRECV: 0,2,0,"$sys/123456/654321/cmd/request/12345678","{"cmd":"reboot"}" -
发送响应：
at复制AT+QMTPUB=0,0,0,0,"$sys/123456/654321/cmd/response/12345678",25数据内容：
json复制{"errno":0,"data":"OK"}
9.2 数据透传模式
对于高频数据采集场景，可以使用透传模式：
-
启用透传：
at复制AT+QMTMODE=0,1 -
进入透传模式：
at复制AT+QMTOPEN=0,"183.230.40.39",6002 AT+QMTCONN=0,"client123","123456","aGVsbG8=" AT+QMTMODE=0,1 -
直接发送数据：
plaintext复制
> // 进入透传模式 {"id":125,"dp":{"temp":[{"v":26.7}]}} ^+] // 退出透传(CTRL+])
10. 实际项目中的经验总结
在工业现场部署时，我们发现EC800M的金属外壳容易造成天线信号衰减。解决方案是在模组和金属安装板之间加装3mm厚的绝缘垫片，使信号强度提升了15dB。另外，对于需要24小时运行的设备，建议配置以下看门狗机制：
-
硬件看门狗：
at复制AT+QWDT=1,60 // 60秒超时 -
软件心跳检测：
at复制AT+QMTSTATUS? // 每小时检查MQTT连接状态 -
异常重启策略：
at复制AT+QCFG="urc/ri",1 // 开启RI引脚唤醒
对于数据安全要求高的场景，可以在应用层添加AES加密。虽然EC800M支持TLS，但在资源受限的场景下，轻量级的应用层加密可能是更优选择。