合宙Luat WiFi模块AT指令手册及示例(三)

本手册介绍合宙Luat嵌入式Wi-Fi模块的AT+指令通讯协议,AT+指令协议采用一套基于ascii的命令行格式指令集,通过UART接口与Wi-Fi芯片进行通讯。

2.2.3.13          获取指定的socket状态:AT+SKSTT

 功能:

获取指定的socket状态,返回值的第一行表示的是用户指定的socket的状态信息,如果该socket类型为TCP服务器,那么从下一行开始每一行表示一个接入的clientsocket状态。 

attachments-2018-09-Crsy8gle5b8f33335793f.jpg

l       参数:  

 socketsocket

 statussocket状态

attachments-2018-09-q3mZPxK75b8f389948d28.jpg

host:对端ip地址

HostPort:对端端口号

LocalPort:本地端口号

rx_data:接收buffer中数据长度

 示例 

AT+SKSTT=1

+OK=1,2,"36.7.87.100",6100,59749,0


2.2.3.14        关闭指定的socket AT+SKCLS

l  功能:

关闭指定的socket

l  格式(ASCII):

AT+SKCLS=<socket><CR>

+OK<CR><LF><CR><LF>

l  参数:  

socketsocket

l  示例:

AT+SKCLS=1

+OK

 

2.2.3.15          设置系统默认发送的socket AT+SKSDF

l  功能:

设置系统默认发送的socket。当用户需要在命令模式下进入透明传输模式时,使用本命令可以指定将串口的透明数据发送的目的地。

l  格式(ASCII):

AT+SKSDF=<socket><CR>

+OK<CR><LF><CR><LF>

l  参数:  

socketsocket

l  示例:

请参考串口进入透传模式:AT+ENTM示例

 

2.2.3.16          获取当前socket收到数据的源IP地址:AT+SKSRCIP

l  功能:

获取当前socket收到数据的源IP地址。

l  格式(ASCII):

AT+SKSRCIP=?<CR>

+OK=[host]<CR><LF><CR><LF>

l  参数:  

Host:数据的源IP地址

l  示例:

AT+SKSRCIP=?

+OK=36.7.87.106

 

2.2.3.17       socket主动上报接收数据AT+SKRPTM

l  功能:

打开和关闭socket主动上报接收数据功能

l  格式(ASCII):

AT+SKRPTM=<mode><CR>

+OK<CR><LF><CR><LF>

l  参数:  

 Mode

attachments-2018-09-yDmHAa7n5b8f3a17e6fc8.jpg

l  示例:

AT+ SKRPTM=1

+OK

 

2.2.3.18          一键配置功能:AT+ONESHOT

l  功能:

 打开和关闭一键配置功能

l  格式(ASCII):

AT+ONESHOT=<status><CR>

+OK<CR><LF><CR><LF>

l  参数:  

 status

attachments-2018-09-khJNYAKG5b8f3ac7e0ab4.jpgl  示例:
attachments-2018-09-k9CmKck75b8f3baa644d8.jpg


2.2.3.19         HTTP客户端post get功能:AT+HTTPC

l  功能:

http客户端post get功能

l  格式(ASCII):

AT+HTTPC=<url>,<verb>,<postdata><CR>

+OK<CR><LF><CR><LF>

l  参数:  

  url:远程http服务器端地址;

  verb

attachments-2018-09-zr8Wfk7T5b8f3d6b3a986.jpg

       post dataverb23时使用,为http上传数据。

       备注:使用httpc指令前需要打开socket主动上报功能AT+SKRPTM=1


 

2.2.4        MQTT指令

2.2.4.1    设置MQTT服务器:AT+MSERVER

l  功能:设置MQTT服务器IP地址和端口。

l  格式(ASCII):

AT+MSERVER=<port>,<ipaddr><CR>

+OK<CR><LF><CR><LF>

l  参数:

<port>MQTT服务器端口号,不用加双引号

<ipaddr>MQTT服务器IP地址(暂不支持域名地址),不用加双引号

 

2.2.4.2          设置登录账号和密码:AT+MLOGIN

l  功能:设置MQTT用户名和密码。

l  格式(ASCII):

AT+MLOGIN=<user>,<password><CR>

+OK<CR><LF><CR><LF>

l  参数:

<user>:用户名,不用加双引号

<password>:密码,不用加双引号

 

2.2.4.3          设置client idAT+MID

l  功能:设置MQTTclient id

l  格式(ASCII):

AT+MID=<client_id><CR>

+OK<CR><LF><CR><LF>

l  参数:

<client_id>client id,不用加双引号

 

2.2.4.4          连接MQTT服务器:AT+MCONNECT

l  功能:连接MQTT服务器。

l  格式(ASCII):

AT+MCONNECT<CR>

+OK<CR><LF><CR><LF>

成功:+MQTT:CONNECTED <CR><LF><CR><LF>

失败:+MQTT:FAIL<CR><LF><CR><LF>

l  参数:

 

2.2.4.5          订阅一个主题:AT+MSUB

l  功能:订阅一个主题。

l  格式(ASCII):

AT+MSUB=<topics>,<qos><CR>

+OK<CR><LF><CR><LF>

 成功:+MSUB:OK

失败:+MSUB:<result>

l  参数:

<result>结果码

 

2.2.4.6          发布一条消息:AT+MPUB

l  功能:发布一条消息。

l  格式(ASCII):

AT+MPUB=<topics>,<qos>,< retatin>,<mssage><CR>

+OK<CR><LF><CR><LF>

 成功:+MPUB:OK

失败:+MPUB:<result>

l  参数:

<result>结果码


 

2.2.4.7          收到一条消息:AT+MTOPIC,AT+MQD

l  功能:收到一条消息。

l  格式(ASCII):

+MTOPIC:<topiclen>,<topic>

+MQD:<len>,<data>

l  参数:

<topiclen>:主题长度

<topic>:主题内容

<len>:消息内容的长度

<data>:消息内容

 

2.2.4.8       关闭MQTT服务器:AT+MCLOSE

l  功能:关闭MQTT服务器。

l  格式(ASCII):

AT+MCLOSE<CR>

+OK<CR><LF><CR><LF>

l  参数:


2.2.4.9    MQTT结果码

attachments-2018-09-rKhbjMrn5b8f40121f371.jpg 

 

2.2.4.10          MQTT使用方法示例

注意:目前MSERVER命令中MQTT 服务器地址暂不支持域名,只支持IP地址

attachments-2018-09-KXe1E71d5b8f41e120a96.jpgattachments-2018-09-0JdBg0yD5b8f41e8b031a.jpg

 

3         常用操作

3.1     创建SoftAP流程

(1)     WPRT设置无线网卡工作模式为SoftAP

            AT+WPRT=2

(2)     APSSID设置无线网卡对于STA的网络名称MyAp

            AT+APSSID=MyAp

(3)     APENCRY设置无线网卡安全模式为WEP64

            AT+APENCRY=1

            参数:open0WEP641WEP1282

(4)     APKEY设置无线网卡密钥12345

            AT+APKEY=1,1,12345

            参数1:密钥格式,0表示HEX1表示ASCII

            参数2index: 密钥索引号,14用于WEP加密密钥,其它加密方式固定为0

            参数3:无线密钥。例如:12345

(5)     APNIP设置ip地址和子网掩码

            AT+APNIP=1,192.168.1.1,255.255.255.0,192.168.1.1,192.168.1.1

           参数1:地址类型,0表示使用DHCP动态分配,1表示静态地址

           参数2ip:192.168.1.1

           参数3netmask255.255.255.0

           参数4gateway192.168.1.1

           参数5dns192.168.1.1

6  PMTF保存上述参数到spi flash,下次开机只需从第7步开始

           AT+PMTF

7  WJOIN创建无线网络MyAp

           AT+WJOIN

8  SLIST      查询SoftAP连接的STA信息

           AT+SLIST

 

 3.2        扫描AP流程

无线网卡扫APAT指令为:AT+WSCAN

 

3.3        STA加入AP流程

1  WPRT 设置工作模式为STA

            AT+WPRT=0

2  SSID 设置需要加入的AP名称如TEST_AP

            AT+SSID=TEST_AP

3  KEY  设置需要加入的AP的无线密钥12345

           AT+KEY=1,0,12345678

           参数1:密钥格式,0表示HEX1表示ASCII

           参数2index: 密钥索引号,14用于WEP加密密钥,其它加密方式固定为0

           参数3:无线密钥。例如:12345678

4  NIP   启用DHCP

            AT+NIP=0

5  PMTF 保存上述参数到spi flash,下次开机只需从第6步开始

            AT+PMTF

6  WJOIN加入无线网络TEST_AP

           AT+WJOIN

 

3.4         创建APSTA流程

1  WPRT 设置工作模式为APSTA

           AT+WPRT=3

2  SSID   设置需要加入的AP名称如TEST_AP

           AT+SSID=TEST_AP

3  KEY    设置需要加入的AP的无线密钥12345

           AT+KEY=1,0,12345678

           参数1:密钥格式,0表示HEX1表示ASCII

           参数2index: 密钥索引号,14用于WEP加密密钥,其它加密方式固定为0

           参数3:无线密钥。例如:12345678

4  APSSID 设置创建的SOFTAP的网络名称

           AT+APSSID=”MYSoftAP”

5  APENCRY      设置SoftAP的加密类型(WPA2-TKIP)

           AT+APENCRY=5

6  APKEY    设置SoftAP的密码(ASCII87654321)

           AT+APKEY=1,0,87654321

7  APNIP     设置IP地址和子网掩码

           AT+APNIP=1,192.168.1.1,255.255.255.0,192.168.1.1,192.168.1.1

8  PMTF 保存上述参数到spi flash,下次开机只需从第9步开始

           AT+PMTF

9  WJOIN 加入无线网络TEST_AP

           AT+WJOIN

 

3.5     STA如何断开连接的AP

无线网卡断开APAT指令为:AT+WLEAV

3.6       SoftAP断网

SoftAP断网的AT指令为:AT+WLEAV=2

 

3.7      STA如何查看当前状态

无线网卡查看当前网卡的状态的AT指令为:AT+LKSTT

 

3.8      查看当前SoftAP状态

查看当前SoftAP状态的AT指令为:AT+APLKSTT

 

3.9       如何使用socket功能

1建立一个PC端的TCP server,如使用TCP调试助手,TCP server地址为192.168.1.100,监听端口为1000

attachments-2018-09-ncE91qEw5b8f44c3efd9a.png

 

2建立Socket

TX:     AT+SKCT=0,0,192.168.1.100,1000,1000

RX:     +OK=1     ---> 1socket

Note:在发送SKCT之前,请先保证模块已经连接了有INTERNET连接的WIFI热点。


attachments-2018-09-cw9tOzhW5b8f44fa21e4c.png

 

3 发送数据:

TX:       AT+SKSND=1,5

kevin

RX    +OK=5

attachments-2018-09-95MirnFS5b8f46137aadd.png

TCP server接收到数据界面为:

attachments-2018-09-zOIKAU2l5b8f463a5a267.png

 

4接收数据:

TCP调试助手界面输入发送数据hello,点击发送。

attachments-2018-09-iOP3df7m5b8f4713b5153.png

TX      AT+SKRCV=1,5

RX      +OK=5

hello


attachments-2018-09-I1Cr6r275b8f4746cdfca.png

 

5查询Socket状态:

TX   AT+SKSTT=1

RX  +OK=1,2,"192.168.1.100",1000,1024,0

attachments-2018-09-p9bvkgdX5b8f47d08ab6d.png

6关闭Socket连接

TX   AT+SKCLS=1

RX  +OK

attachments-2018-09-dSzTkDrh5b8f47f386302.png


 

3.10       自动工作模式下的透传应用

(1)     WPRT 设置无线网卡工作模式为STA

            AT+WPRT=0

(2)     SSID 设置需要加入的AP名称如airm2m_wifi

            AT+SSID=airm2m_wifi

(3)      KEY  设置需要加入的AP的无线密钥12345678

            AT+KEY=1,0,12345678

(4)      NIP   启用DHCP

             AT+NIP=0

(5)      ATM  设置为自动工作模式

             AT+ATM=0

(6)      ATRM 设置自动工作模式下的socket连接

             AT+ATRM=0,0,192.168.1.100,1000

(7)       PMTF保存参数到spi flash

              AT+PMTF

(8)       复位无线网卡使配置生效

             AT+Z

             复位后,模块自动建立ATRM设置的socket连接。如果使用过程中断链,会自动重连。


相关文章:

合宙Luat WiFi模块AT指令手册及示例(二)

合宙Luat WiFi模块AT指令手册及示例(一)




  • 发表于 2018-09-05 10:02
  • 阅读 ( 5036 )
  • 分类:默认分类

0 条评论

请先 登录 后评论
不写代码的码农
qin0036

软件工程师

17 篇文章

作家榜 »

  1. 技术销售Delectate 43 文章
  2. 陈夏 26 文章
  3. 国梁 24 文章
  4. miuser 21 文章
  5. 晨旭 20 文章
  6. 朱天华 19 文章
  7. 金艺 19 文章
  8. 杨奉武 18 文章