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

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

 

2.2.2.5    工作模式:AT+ATM

l      功能:

设置/查询工作模式。

l       格式(ASCII):

AT+ATM=[!?][mode]

+OK[=mode]

l       参数:  

attachments-2018-09-hmk8UcI35b8e27ad53bba.jpg


l  
示例:

查询当前工作模式:

AT+ATM=?

+OK=1

 

修改模式为自动工作模式:

AT+ATM=!0

+OK

 

2.2.2.6    自动工作模式下的socket连接:AT+ATRM

l      功能:

设置/查询自动工作模式下自动创建的socket连接信息。

l      格式(ASCII):

AT+ATRM=[!?][protocol],[cs],[host/timeout],[port]

+OK[=protocol,cs, host/timeout,port]

l      参数:  

       protocol:协议类型

attachments-2018-09-S10bs9UL5b8e28cb2cdd3.jpg

  具体请参考:自动工作模式下的透传应用
 

 

2.2.2.7    无线网络名称:AT+SSID

l       功能:

       设置/查询STA模式下需要加入的无线网络名称,即ssid

l       格式(ASCII):

AT+SSID=[!?][ssid]

+OK[=ssid]

l      参数:  

ssid: 无线网络名称,1~32个字符,加不加双引号都可以

l      示例:

AT+SSID=! Air_Test_WiFi

+OK

 具体请参考本文档:STA加入AP流程

 

2.2.2.8    SoftAP无线网络名称:AT+APSSID

l       功能:

       SoftAP无线网络名称,即SSID,在SoftAPAPSTA模式有效。

l       格式(ASCII):

AT+APSSID=[!?][ssid]

+OK[=ssid]

l       参数:  

ssid: 无线网络名称,1~32个字符,加不加双引号都可以

l       示例:

AT+APSSID=!"AAAA-Test-Wifi"

+OK

 具体应用请参考本文档 创建SoftAP流程

 

2.2.2.9    无线网络安全模式:AT+ENCRY

l       功能:

设置/查询无线网络安全模式。需要特别说明的是除了OPEN模式以外,其它安全模式都需要配合AT+KEY指令设置正确的网络密钥,此外AP或者AD-HOC模式时,模块仅支持设置OPENWEP64WEP128

l        格式(ASCII):

AT+ENCRY=[!?][encry mode]

+OK[=encry mode]

  

 l     参数:  

       encry mode: 安全模式

attachments-2018-09-EnomYayV5b8e2bde1bab3.jpg

l     示例:

查询网络安全模式:

AT+ENCRY=?

+OK=0

设置网络安全模式为WEP64

AT+ENCRY=!1

+OK

 

2.2.2.10    SoftAP无线网络安全模式:AT+APENCRY

l        功能

设置/查询SoftAP无线网络安全模式。除了OPEN模式以外,其它安全模式都需要配合AT+APKEY指令设置正确的网络密钥。

l   格式ASCII):

AT+ENCRY=[!?][encry mode]

+OK[=encry mode]

l        参数 

       encry mode: 安全模式

attachments-2018-09-pERRCviD5b8e2db5563e7.jpg
 

2.2.2.11    网络密钥:AT+KEY

l  功能:

       设置/查询网络密钥。需要说明的是,在使用本命令设置网络密钥之前有时候需要使用AT+ENCRY命令设置网络安全模式。

l  格式(ASCII):

AT+KEY=[!?][format],[index],[key]

+OK[=format,index,key]

l       参数:  

Format密钥格式

attachments-2018-09-x5z1LIeg5b8e3472c734d.jpg

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

   key:密钥字符串,加不加双引号皆可,根据不同的安全模式,密钥使用的长度与格式要求定义如下

attachments-2018-09-Va5VGQ035b8e3564cc9ad.jpg

116进制字符指0~9a~f(不区分大小写),如"11223344dd"

2ASCII字符指国际标准化组织(ISO)规定的标准ASCII字符集中的数字0~9与字母a~z(区分大小写),如"14u6E"

l       示例:

AT+KEY=!1,0,"A123456"

+OK

 

2.2.2.12    SoftAP网络密钥:AT+APKEY

l  功能:

设置/查询SoftAP无线网络密钥。需要说明的是,在使用本命令设置网络密钥之前必须首先使用AT+APENCRY命令设置无线网络安全模式。

l  格式(ASCII):

AT+APKEY=[!?][format],[index],[key]

+OK[=format,index,key]

l  参数:  

format: 密钥格式

attachments-2018-09-dP1AISaA5b8e36d7532d1.jpg

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

key: 密钥字符串,加不加双引号皆可,根据不同的安全模式,密钥使用的长度与格式要求定义如下:


attachments-2018-09-sSR99IfJ5b8e3780e4050.jpg

116进制字符指0~9a~f(不区分大小写),如"11223344dd"

2ASCII字符指国际标准化组织(ISO)规定的标准ASCII字符集中的数字0~9与字母a~z(区分大小写),如"14u6E"

l  示例:

 

AT+APKEY=!1,1,123456

+OK

 

2.2.2.13    设置/查询指定APBSSID地址:AT+BSSID

l  功能:

设置/查询指定APBSSID地址,本设置仅在模块作为STAinfra网络下有效。

l  格式(ASCII):

AT+BSSID=[!?][mode],[bssid]

+OK[=mode,bssid]

l  参数:  

modeBSSID模式

attachments-2018-09-k0nZjX5U5b8e389a6db61.jpg

bssid:网络BSSID,长度为12的十六进制数,格式为001EE3A34455

 

2.2.2.14    设置/查询指定无线信道方式:AT+CHL

l  功能:

       设置/查询指定无线信道方式。

l  格式(ASCII):

AT+CHL=[!?][ mode],[channel]

+OK[=mode,channel]

l  参数:  

 mode:信道模式

attachments-2018-09-C9jM8PLd5b8e428eca195.jpg


 

2.2.2.15    设置/查询SoftAP无线信道方式:AT+APCHL

l  功能:

 设置/查询SoftAP无线信道方式。

l  格式(ASCII):

AT+APCHL=[!?][ mode],[channel]

+OK[=mode,channel]

l  参数:  

    mode:信道模式

attachments-2018-09-WwCrg1xR5b8e42a04b931.jpg

 

channel: 无线信道号,有效范围114

 

2.2.2.16    无线信道列表:AT+CHLL

l  功能:

    设置/查询无线信道列表。无线信道列表参数用于规定模块的工作信道范围,不包含在列表中的信道将不会被扫描,合理的使用本参数,可以加快模块的扫描以及联网速度。

l  格式(ASCII):

AT+CHLL=[!?][channel list]

+OK[=channel list]

l  参数:  

channel list无线信道列表,采用16进制格式,从最低位开始,每一位表示一个信道,缺省为3fff表示1~14所有信道。


 

2.2.2.17       使能自动创建adhoc网络功能:AT+WATC

l  功能:

     设置/查询是否使能自动创建adhoc网络功能。本设置仅在无线网络类型设置为adhoc时有效,表示当加入网络失败时是否自动创建同名的adhoc网络。

l  格式(ASCII):

AT+WATC=[!?][enable]

+OK[=enable]


l  参数:  

    enable:使能标志

attachments-2018-09-ubvYta6L5b8e440d2425b.jpg

 

2.2.2.18        打开/关闭自动节能模式:AT+WPSM

l  功能:   打开/关闭自动节能模式。

注:

这种节能模式是wifi协议的节能模式,只是关闭了无线的收发并降低CPU主频,这种模式CPU没有休眠,所以可以接收AT/RI指令。

打开节能模式后,WiFi模块在无线空闲之后会进入WiFi_off状态,没有被外部唤醒的情况下,在beacon帧的TIM信息元素指示的时间周期【最小100ms】到来时打开WiFi,根据Beacon帧中的TIM域判断是否有数据需要接收【包括广播帧和单播帧】,如果没有数据,则立即进入WiFi_off状态,如果有数据处理完毕之后无线空闲时再进入WiFi_off状态;如果WiFi_off时有外部唤醒则会打开WiFi,直到下次无线空闲再进入WiFi_off状态。

唤醒模块的方式:AT口直接发送数据会唤醒模块

l  格式(ASCII):

AT+WPSM=[!?][enable]

+OK[=enable]

l  参数:  

 enable:使能标志

attachments-2018-09-NQ4zhmkr5b8e44558ff18.jpg

l  示例

打开节能模式(注:AT+WPSM=1在模块加入热点以后输入才有效):

AT+WPSM=1

+OK

关闭节能模式:

AT+WPSM=0

+OK


 

2.2.2.19         使能/禁止AP SSID广播:AT+BRDSSID

l  功能:

       使能/禁止AP SSID广播,该设置仅在模块作为AP时有效。

l  格式(ASCII):

AT+BRDSSID=[!?][enable]

+OK[=enable]

l  参数:  

 enable:是否使能SSID广播

attachments-2018-09-dqbOYnXz5b8e465632414.jpg


 2.2.2.20       UART口数据格式:AT+UART

l  功能:设置/查询uart接口数据格式。

l  格式(ASCII):

AT+UART=[!?][baudrate],[databit],[stopbit],[parity],[flowcontrol]

+OK[=baudrate,databit,stopbit,parity]

l  参数:  

baud rate:波特率,有效值范围1200115200bps

attachments-2018-09-s8aczmmC5b8e48c9db112.jpg

attachments-2018-09-WETjbVQX5b8e48b57778c.jpg

attachments-2018-09-WETjbVQX5b8e48b57778c.jpg

 

2.2.2.21       是否内置使能WEB管理服务器:AT+WEBS

l  功能:设置/查询内置是否使能WEB管理服务器

l  格式(ASCII

AT+WEBS=[!?][enable],[port]

+OK[=enable,port]

l  参数:  

enable:使能标志

attachments-2018-09-gOfGTBFi5b8e4944b262a.jpg

port:服务器端口号,缺省为80

 

2.2.2.22          设备名称:AT+DNAME

l  功能:设置/查询设备名称。

l  格式(ASCII

AT+DNAME=[!?][devicename]

+OK[=devicename]

l  参数:  

devicename:设备名称,1~32个字符

 

2.2.2.23       系统登录密码:AT+PASS

l  功能:设置/查询系统登录密码。

l  格式(ASCII

AT+PASS=[!?][pass]

+OK[=pass]

l  参数:  

pass6ASCII字符

 

2.2.2.24        接收用户数据:AT+CUSTDATA

l  功能:

接收通过一键配置工具发送的用户数据,使用前要先发送AT+ONESHOT=1命令,将模块配置成一键配置模式。

l  格式:  

AT+CUSTDATA[=?]

+OK=data

l  参数:

 

2.2.2.25      查询配置的联网参数:AT+CNTPARAM

l  功能:

查询配置的联网参数。

l  格式(ASCII):

AT+CNTPARAM[=?]

+OK=,[bssid],[ssid],

l  参数: 无。

 返回值:bssid_en值的含义

attachments-2018-09-krKgSBcr5b8e4af6cecae.jpg

 

2.2.3          网络控制类

2.2.3.1      网卡接口模式:AT+PORTM

l  功能:

设置/查询网卡的接口模式。

l  格式(ASCII):

AT+PORTM=[!?][mode]

+OK[=mode]

l  参数:

mode:接口模式

attachments-2018-09-kKekaVCw5b8e4b9e93c47.jpg


l  示例:

查询网卡接口模式:

AT+PORTM=?

+OK=0

 

2.2.3.2          获取外网域名的IP地址:AT+SKGHBN

l     功能:

获取外网域名的IP

l     格式(ASCII):

AT+SKGHBN =[!?][URL]

+OK[=IP]

l     参数:

       URL:外网域名

       IP:对应的IP地址

l     示例:

  加网成功后才能查询外网域名的IP地址,如下:


attachments-2018-09-q5J8YCjy5b8e4e1d8357a.jpg



2.2.3.3         设置/查询WPS功能:AT+WWPS

l  功能:设置/查询 WPS 功能。

l  格式(ASCII):

AT+WWPS=[!?][mode],[pin]

+OK[=mode],[pin]

l  参数:

modeWPS 功能选择,为空的参数不用填写。

attachments-2018-09-DE1JcJZ55b8e4efe2887b.jpg

pin:无线路由器的PIN

 

2.2.3.4      加入指定APAT+WJOIN

l  功能:

根据设置的网络类型的不同,加入/创建指定网络。如果当前网络类型为为 STA 时,本指令功能为连接 AP。如果当前网络类型SoftAP 时,本指令功能为创建 SoftAP。如果当前网络类型为 Adhoc,本指令功能为连接指定 Adhoc 网络,并可根据设置参数选择是否在未检测到指定 SSID的网络,则自动创建该网络。如果当前网络已经处于联网或已创建状态,则直接返回网络连接信息。对于 ASCII 格式,系统在网络连接成功后返回响应消息。

l  格式(ASCII):

AT+WJOIN

+OK=,,,,,

l  参数:  

b

ssid:网络BSSID,长度为12的十六进制数,格式为001EE3A34455

attachments-2018-09-N41OapWb5b8e4ffc7604b.jpg

SSID: 无线网络名称,1~32个字符,双引号包围

rssi:网络信号强度,不含负号,单位Db,即50表示信号强度为-50Db

l  示例:

AT+SSID=TP-LINK_HyFi_1E

+OK

AT+KEY=1,0,""

+OK

AT+WJOIN

+OK=3c46d82bd81e,0,11,0,"TP-LINK_HyFi_1E",53

 

 

2.2.3.5          断开当前网络:AT+WLEAV

l  功能:

       该指令仅在模块作为STA时有效,用于断开当前无线网络。

l  格式(ASCII):

AT+WLEAV

+OK

l  参数:  

l  示例:

加网后查询连接状态,然后退网后查询连接状态:

attachments-2018-09-GisNIttM5b8e5127e64e7.jpg

 

2.2.3.6        扫描无线网络:AT+WSCAN

l  功能:

     该指令仅在模块作为STA时有效,用于扫描无线网络,完成后返回。

l  格式(ASCII):

AT+WSCAN

+OK=,,,,,

,,,,,

……

l  参数:  

       AT+WJOIN

l 例:

attachments-2018-09-2PpT9seU5b8e523863c9a.jpg

 

2.2.3.7       查询本端网络连接状态:AT+LKSTT

l  功能:查询本端网络连接状态。

l  格式(ASCII):

AT+LKSTT

+OK[=status,ip,netmask,gateway,dns1,dns2]

l  参数:  

status: 连接状态

attachments-2018-09-GOgeUHBv5b8e537d3c38d.jpg

Ipip地址,数据格式为"192.168.1.22",不含引号

netmask子网掩码,数据格式同ip地址

gateway网关地址,数据格式同ip地址

dns1DNS1地址,数据格式同ip地址

dns2DNS2地址,数据格式同ip地址

l  示例:

l  加网后查询连接状态,然后退网后查询连接状态:

attachments-2018-09-DlAFWsMO5b8e542f79137.jpg

 

2.2.3.8          设置/查询SoftAP状态:AT+APLKSTT

l  功能:

设置/查询SoftAP无线信道状态,仅在SoftAPAPSTA模式有效。

l  格式:  

AT+APLKSTT<CR>

+OK[=status,ip,netmask,gateway,dns1,dns2]<CR><LF><CR><LF>

l  参数:  

  status: 连接状态

attachments-2018-09-jzuzcgXp5b8f2c4268045.png

Ipip地址,数据格式为”192.168.1.22”,不含引号

Netmask子网掩码,数据格式同ip地址

Gateway网关地址,数据格式同ip地址

dns1DNS1地址,数据格式同ip地址

dns2DNS2地址,数据格式同ip地址

attachments-2018-09-UBVYjCxL5b8f2cdff1d12.jpg

 

2.2.3.9          查询已经连接的station AT+SLIST

l  功能:   查询已经连接的station

l  格式:  

AT+SLIST<CR>

+OK[=sta_number,sta_mac1,sta_ip1,sta_mac2,sta_ip2…]<CR><LF><CR><LF>

l  参数:  

sta_number: 已经连接的station数目

sta_mac: stationmac地址

sta_ip: stationip地址

l  示例:

紧接着设置/查询SoftAP状态:AT+APLKSTT中的示例。在没有任何手机加入Luat_TEST_AP这个热点之前查询AT+SLIST

AT+SLIST

+OK=0

然后,手机加入Luat_TEST_AP,查询AT+SLIST

AT+SLIST

+OK=1,,94-FE-22-9A-B5-28,192.168.1.2

 


2.2.3.10          建立socket连接:AT+SKCT 

l      功能:

建立socket。在client模式,等待连接完成(成功或失败)后返回;在server模式下,创建完成后直接返回。

l       格式(ASCII):

AT+SKCT=[protocol],[cs],[host_timeout],<remote_port>,<local_port><CR>

+OK=<socket><CR><LF><CR><LF>

attachments-2018-09-iMrNJx2B5b8f2eec3b875.jpg

remote_port:远程端口号

local_port:本地端口号

socketsocket

l       示例:

AT+SKCT=0,0,180.97.81.180,51950,37189

+OK=1

1socket id

 

2.2.3.11     通过指定的socket发送数据:AT+SKSND

l  功能:

通过指定的socket发送数据,完成后返回。此命令使用二进制格式发送数据,用户应在接收到模块的响应消息(+OK)之后再开始发送原始数据。模块接收完指定长度的数据后自动结束数据传输阶段,并将数据发送到网络上,多余的数据将被丢弃。否则,模块在等待超时(1s)后,强制结束数据传输阶段并将已经接收到的数据发送到网络上。

l  格式(ASCII):

AT+SKSND=<socket>,<size><CR>

+OK=<actualsize><CR><LF><CR><LF>

[data steam]

l  参数:  

socketsocket

size:准备发送的数据长度,字节数

actualsize:允许发送的数据长度,字节数

data steam:原始数据

l  示例: 

attachments-2018-09-yJuCJexM5b8f32281c919.jpg



2.2.3.12        读取指定socket的接收缓冲区中的数据:AT+SKRCV

l  功能:

读取指定socket的接收缓冲区中的数据,完成后返回。接收到此命令后,模块将在发送完成相应消息(+OK

后使用二进制格式传送指定长度数据。

l  格式(ASCII):

AT+SKRCV=<socket>,<maxsize><CR>

+OK=<size><CR><LF><CR><LF>

[data steam]

l  参数:  

socketsocket

maxsize:可接收的最大数据长度

size:实际接收到的数据长度

data steam:原始数据

l  示例:

AT+SKRCV=2,20

+OK=17

HELLO WIFI MODULE


   


  • 发表于 2018-09-04 14:36
  • 阅读 ( 4331 )
  • 分类:默认分类

0 条评论

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

软件工程师

17 篇文章

作家榜 »

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