W12S WIFI云模组工作模式

引脚定义

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秒。