1. 硬件准备与环境搭建
第一次接触NB-IoT设备开发时，我花了两周时间才搞明白硬件选型的门道。STM32作为主控芯片的优势很明显：性价比高、生态完善、资料丰富。我常用的组合是STM32F103C8T6最小系统板+BC28 NB-IoT模块，整套成本不到100元，特别适合个人开发者和小型项目。
核心硬件清单：
- STM32开发板（推荐正点原子或野火的入门款）
- BC28/BG36等NB-IoT通信模块
- SIM卡（必须支持NB-IoT网络，建议直接使用电信物联网卡）
- USB转TTL模块（用于调试AT指令）
- 杜邦线若干
硬件连接其实就三步：
- 用杜邦线连接STM32的UART接口与NB-IoT模块的串口（注意交叉连接TX/RX）
- 给NB-IoT模块单独供电（BC28需要3.7V电压，电流峰值可达300mA）
- 插入已激活的NB-IoT专用SIM卡
这里有个坑我踩过：千万不要用普通手机卡！NB-IoT需要专用APN，普通4G卡即使能识别网络也无法正常通信。我第一次调试时卡在这问题上整整三天，后来换了电信的物联网专用卡才解决。
2. 天翼物联平台配置详解
天翼物联平台（AIoT）的界面改版过三次，最新版本的操作流程比早期简洁多了。注册账号时有个小技巧：直接使用企业邮箱注册，个人开发者用163/QQ邮箱可能会被要求补充企业资质。
2.1 产品创建实战
创建产品时最容易出错的是协议选择。实测发现：
- 电信NB-IoT必须选LWM2M协议
- 移动/联通的NB-IoT可能要用CoAP协议
- 数据加密建议先用"明文"调试，上线后再改为"DTLS"
产品参数配置示例：
产品名称：智能农业监测终端 分类：农业->环境监测 节点类型：设备 接入方式：设备直连 网络类型：NB-IoT 通信协议：LWM2M 认证方式：IMEI认证（最常用） 设备型号：BC28 省电模式：DRX+PSM混合模式2.2 设备添加技巧
获取IMEI时要注意：
- BC28模块上电后需要等待30秒才能响应AT指令
- 发送
AT+CGSN=1指令后，返回的15位数字要去掉首尾的换行符 - IMSI号不是必填项，但建议记录备用
平台上的设备状态变化有明确时序：
未注册 -> 已注册 -> 已激活 -> 在线如果卡在"已注册"状态，八成是AT指令配置有误，重点检查AT+NCDP设置的平台地址是否正确。
3. AT指令全流程解析
NB-IoT模块的AT指令就像乐高积木，组合方式决定最终效果。下面是我整理的必用指令序列：
# 基础配置 AT+NCONFIG=AUTOCONNECT,TRUE # 开启自动连接 AT+NCDP=221.229.214.202,5683 # 设置电信平台地址 AT+QREGSWT=1 # 启用自动注册 # 网络检查 AT+NRB # 软重启模块 AT+CGPADDR # 检查IP地址 AT+NMSTATUS? # 查看注册状态调试时常见问题处理：
- 如果
AT+CGPADDR返回空IP：检查SIM卡是否欠费 AT+NMSTATUS?返回MO_DATA_ENABLED才表示真正联网成功- 波特率一定要设9600，115200会导致数据丢包
4. 数据上报的二进制艺术
电信平台的数据上报就像发电报，必须严格遵循特定编码格式。温度上报的二进制报文02002B00040000001C可以拆解为：
| 字段 | 值 | 说明 |
|---|---|---|
| CMDType | 02 | 上报指令 |
| DatasetID | 002B | 服务ID（43的十六进制） |
| PayloadLength | 0004 | 数据长度4字节 |
| PayloadData | 0000001C | 温度值28的十六进制 |
实际开发中，建议用这个函数处理数据转换：
void generate_payload(uint8_t service_id, float value, uint8_t* output) { uint32_t int_val = (uint32_t)(value * 100); // 保留两位小数 output[0] = 0x02; // 上报指令 output[1] = 0x00; output[2] = service_id >> 8; output[3] = service_id & 0xFF; output[4] = 0x00; output[5] = 0x04; // 4字节长度 output[6] = (int_val >> 24) & 0xFF; output[7] = (int_val >> 16) & 0xFF; output[8] = (int_val >> 8) & 0xFF; output[9] = int_val & 0xFF; }发送时注意：BC28模块的AT+QLWULDATAEX命令第一个参数是字节数，不是字符数。比如02002B00040000001C虽然是16个字符，但实际是8字节的十六进制数据，所以参数应该填8。
5. 实战中的避坑指南
三年间我部署过200+个NB-IoT节点，总结出这些经验：
信号优化：
- NB-IoT的穿透性强但速率低，安装位置要避开金属柜体
- 使用
AT+CSQ检查信号质量，20以上才算稳定 - 农村地区优先选择电信网络，覆盖最好
低功耗设计：
- 上报间隔不要小于10分钟，否则PSM模式失效
- 在平台设置合理的"预期心跳间隔"
- STM32在发送间隙应进入Stop模式
数据安全：
- 正式环境务必启用DTLS加密
- IMEI号不要硬编码在代码中
- 平台侧设置IP白名单
有个客户案例印象深刻：某农业大棚的传感器每天凌晨3点准时离线，后来发现是运营商基站定时重启。解决方案是在平台设置"离线重连超时"为30分钟，完美避开维护时段。
6. 进阶开发技巧
当基础功能跑通后，可以尝试这些优化：
批量上报：
AT+QLWULDATAEX=16,02002B00040000001C02002C000400000064,0x0100这条指令同时上报了温度(28℃)和湿度(100%)，减少通信次数能显著降低功耗。
平台回调配置： 在"产品->消息推送"中设置HTTP/HTTPS回调地址，当设备上报数据时，平台会主动推送到指定服务器。我常用Flask搭建简易接收服务：
from flask import Flask, request app = Flask(__name__) @app.route('/callback', methods=['POST']) def callback(): data = request.json print(f"收到设备{data['deviceId']}的数据：{data['services']}") return 'OK'本地日志诊断： 在STM32上实现环形缓冲区记录AT指令交互过程，出现问题时通过AT+CMEE=2开启详细错误码返回，结合日志能快速定位故障点。
