引脚定义
VCC:3.3V供电
GND:接地
TXD: 串口发送
RXD: 串口接收
RST: 重置复位引脚,低电平有效/长按(持续5秒低电平)进入配网
IO11: 网络指示灯 常亮 闪烁频率
IO12:输出引脚 /PWM - 对应IO1输入
IO14:输出引脚 /PWM - 对应IO5输入
IO17:输出引脚 /PWM - 对应IO2输入
IO3: 输出引脚 /PWM - 对应IO4输入
IO1: 输入引脚 - 对应IO12输出
IO5: 输入引脚 - 对应IO14输出
IO2: 输入引脚 - 对应IO17输出
IO4: 输入引脚 - 对应IO3输出
引脚中断事件处理机制
输出引脚中断事件
向服务器同步上报以下格式数据:
e|p{引脚号}|{电平值}
<引脚号>:可选4个输出引脚,数字12 14 17 3分别对应IO12/IO14/IO17/IO3.
<电平值>:0/1 低电平 高电平
例子:
当IO12引脚被拉低时,向服务器同步数据: e|p12|0 (如果是输出PWM不用上报)
输入引脚中断事件
当输入引脚IO1/IO5/IO2/IO4电平变化时,分别对应的输出引脚电平进行翻转(同时输出引脚也触发中断向服务器上报数据)。
串口RXD中断事件
外部MCU向RXD串口发送数据原样上报到服务器。
注意:模组内置指令不需要上报服务器,参考后面的模组API指令处理。
远程指令下发处理机制
模组接收到远程下发指令后通过TXD串口原样发送给MCU。
注意:模组内置指令不需要转发给MCU,参考后面的模组API指令处理。
a|{指令标识} 云端下发指令到设备
<pin={引脚号,电平}> 输出电平 设置IO12口输出低电平 如:a|pin=12,0
<pwm={引脚号,周期us,占空比0~100}> 输出PWM 如:a|pwm=12,25,50
<pwm={引脚号}> 关闭PWM 如:a|pwm=12
模组内置API处理
s|{模组内置指令} 用户通过串口向模组发出指令
<wif> 查询WIFI情况,会触发wifi模组事件返回
<mqt> 查询服务器连接情况,会触发mqtt模组事件返回
<snt> 查询时间
<sap={SsId},{Pwd}> 设置并连接WIFI
<int={ProductId}> 设置客户端 ProductId,设置完成后执行重新连接到服务器
<mqt={ProductId},{ClientId},{UserName},{Password},{Host},{Port}> 设置并连接到MQTT服务器
<pub={Topic},{Qos},{Retained},{Payload}> 发送消息
<sub={Topic},{Qos}> 订阅主题
<uns={Topic}> 取消息订阅一个主题
设置指令结果需要存储到模组中。
s|{模组内置事件} 模组事件通过串口向用户MCU发出消息
<ok> 成功标识
<err> 失败标识
<wok> WIFI已连接
<werr> WIFI已断开
<mok> MQTT服务器已连接
<merr> MQTT服务器已断开
<snt:<week> <month> <day> <HH>:<mm>:<ss> <yyyy>> 返回当前时间
例子:MCU接收到“s|wok”表示WIFI已连接
云模组配网
1.扫描二维码配网模式
用户MCU无需参与,通过接收WIFI连接事件,判断是否联网,或者通过内置指令主动查询模组现在网络情况。
进入配网状态,用户打开APP扫描模组二维码,APP发送配置数据到设备:
{"SsId":"WIFI名称","Pwd":"WIFI密码","ProductId":"产品ID","ClientId":"设备ID","UserName":"用户名","Password":"密码","Host":"主机地址","Port":"端口","Baudrate":"波特率"}
优点:产品ID与模组绑定,MCU无需参与模组配网等操作,上电自动完成联网动作,通过串口收发数据即可。
缺点:需提前生成模组二维码贴于产品设备上。
2.附近搜索配网模式
打开APP搜索附近设备,APP与设备建立连接,APP发送配置数据到设备:
{"SsId":"WIFI名称","Pwd":"WIFI密码","ClientId":"设备ID","UserName":"用户名","Password":"密码","Host":"主机地址","Port":"端口","Baudrate":"波特率"}
注意,这里是没有产品ID,需要通过串口指令向模组发送"ProductId"过来。
优点:产品ID与MCU绑定,模组可以随意通用到其它产品。
缺点:需要MCU向模组送"ProductId"。
3.自定义配网
通过MCU发送MQTT服务器配置数据到设备。
优点:可以快速接入任何标准MQTT物联网平台。
缺点:需要通过MCU发送指令操作。
掉线重连机制
WIFI掉线后需要定时进行重连,重连成功后触发"s|wok"WIFI连接成功事件通知MCU。
MQTT掉线后在WIFI正常连接情况下,定时进行重连,重连成功后触发"s|mok"MQTT连接成功事件通知MCU。
以上重连频率最少大于5秒。