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

 

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


   


相关文章:

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

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



上次更新 2021-01-28