FSC-BW236 AT命令集

描述

本设计指南适用于工程师开发 FSC-BW236 系列Wi-Fi SoC模块。

指令说明

规范说明

适用于整个文档

{} : 包括与{…}中的内容为可选项
<< : 主机发给模组的 COMMAND
>> : 模组回复主机的 RESPONSE/EVENT

指令格式

AT+Command{=Param1{,Param2{,Param3...}}}<CR><LF>

所有的指令使用 AT 开头，使用 <CR><LF> 结尾
<CR> 代表回车符，对应 HEX 为 0x0D
<LF> 代表换行符，对应 HEX 为 0x0A
若指令包含参数，参数应使用 = 分隔
若指令包含多项参数，参数应使用 , 分隔
若指令有响应返回，响应使用 <CR><LF> 开始，使用 <CR><LF> 结束
模组应当总是返回指令执行的结果 (成功返回 OK，失败时返回 ERR<code>)

Error Code	Meaning
001	Failed
002	Invalid parameter
003	Invalid state
004	Command mismatch
005	Busy
006	Command not supported
007	Profile not turned on
008	No memory
Others	Reserved for future use

Example：读取模块固件版本

发送: <<AT+VER<CR><LF>
响应: >><CR><LF>+VER=FSC-BW236,V5.1.3<CR><LF>
响应：>><CR><LF>OK<CR><LF>

当在蓝牙没有连接的情况下通过蓝牙发数据

发送: <<AT+GATTSEND=3,123<CR><LF>
响应: >><CR><LF>ERR003<CR><LF>

Event格式

<CR><LF>+Indication{=Param1{,Param2{,Param3...}}}<CR><LF>

所有的事件使用<CR><LF>开始, 使用<CR><LF>结束
若事件包含参数, 参数应位于 “=” 后面
若事件包含多项参数, 参数应使用 “,” 分割

Example: 手机端通过GATT协议发送”1234567890”

响应: >><CR><LF>+GATTDATA=10,1234567890<CR><LF>

指令表

通用指令

AT - 串口测试指令

Command	AT
Response	OK
Description	通过AT指令测试串口通信是否正常

Example:
<< AT
>> OK

AT+VER - 读取固件版本

Command	AT+VER
Response	+VER=Param1,Param2
`Param1`	模块类型
`Param2`	固件版本

Example:
<< AT+VER
>> +VER=FSC-BW236,V4.2.5
>> OK

AT+BAUD - 查询/设置串口波特率

Command	AT+BAUD{=Param}
`Param`	2400/4800/9600/19200/38400/57600/115200(default)/128000/ 230400/256000/460800/512000/921600/1000000/1382400 2000000/3000000/4000000/5000000/6000000
Response	+BAUD=Param
`Param`	返回当前所设置的波特率
Description	修改波特率后，重启模块生效

Example:
读取波特率
<< AT+BAUD
>> +BAUD=115200
>> OK

设置波特率
<< AT+BAUD=9600
>> OK

AT+TPMODE - 查询/设置透传模式

Command	AT+TPMODE{=Param}
`Param`	1:开启透传模式 0:关闭透传模式
Response	+TPMODE=Param
`Param`	返回当前透传模式设置
Description	当透传模式开启，并建立了 TCP, GATT 等连接，模块串口将输出从远端收到的原始数据，模块串口接收到的数据也将直接发送至远端。当透传模式关闭，任何状态下，模块串口对接收到的数据只做指令处理，模块从远端接收的数据，将从串口以指令格式输出。

Example:
读取当前透传模式设置
<< AT+TPMODE
>> +TPMODE=0
>> OK
设置为透传模式
<< AT+TPMODE=1
>> OK

AT+LPM - 进入低功耗模式

Command	AT+LPM{=Param}
`Param`	1:进入轻度休眠 2:进入深度休眠
Response	OK
Description	模块进入轻度休眠后,和热点已经TCP均保持连接,可通过WLAN数据唤醒,功耗在30mA左右。模块进入深度休眠后,将停止所有功能,功耗在 10uA 左右。拉高模块第7脚即可唤醒。

Example:

进入轻度休眠

<< AT+LPM=1

>> OK

AT+SCAN - 扫描周围设备

Command	AT+SCAN=Param1{,Param2}{,Param3}
`Param1`	5:扫描周围热点 1:扫描蓝牙设备 0:停止扫描
`Param2`	只在扫描蓝牙设备时起作用，指定扫描时长(单位秒)，超时后自动停止
`Param3`	只在扫描蓝牙设备时起作用，指定蓝牙设备名扫描一段时间，超时后自动停止
Response	+SCAN=param1,param2,param3,param4,param5,param6
`Param1`	扫描WIFI设备时, 此参数表示扫描序号；扫描蓝牙设备时，此参数表示扫描序号
`Param2`	扫描WIFI设备时, 此参数固定为5; 扫描蓝牙设备时, 此参数表示蓝牙设备地址类型
`Param3`	扫描WIFI设备时, 此参数表示热点的地址码；扫描蓝牙设备时，此参数表示蓝牙设备地址码
`Param4`	扫描WIFI设备时, 此参数表示模块与热点的之间的信号值；扫描蓝牙设备时，此参数表示模块与蓝牙设备之间的信号值
`Param5`	扫描WIFI设备时, 此参数表示热点名称长度；扫描蓝牙设备时，此参数表示蓝牙设备名长度
`Param6`	扫描WIFI设备时, 此参数表示热点名称; 扫描蓝牙设备时，此参数表示蓝牙设备名
Description	扫描周围热点时，模块需处于 STA 模式，即+ROLE=1 扫描蓝牙设备时，模块需处于蓝牙主端模式，即+MODE=1

Example:
扫描WIFI热点
<< AT+SCAN=5
>> +SCAN=1,5,9C9D7E7E0AF3,-45,18,Feasycom_D710_2.4G
>> +SCAN=2,5,9C9D7E7E0AF2,-47,16,Feasycom_D710_5G
>> +SCAN=3,5,D4DA210B8505,-50,13,Redmi_8502_5G

扫描蓝牙设备
<< AT+SCAN=1
>> +SCAN=1,0,DC0D94B9105C,-92,8,Feasycom
>> +SCAN=2,1,27AD5E8F09D6,-66,9,Feasycom1
>> +SCAN=3,0,DC0D300005B4,-82,9,Feasycom2
>> +SCAN=4,0,DC0D1EDA2008,-92,9,Feasycom3

扫描指定蓝牙设备10s
<< AT+SCAN=1,10,FSC-BT976
>> +SCAN=1,0,DC0D3000073D,-66,9,FSC-BT976

AT+REBOOT - 软件复位

Command	AT+REBOOT
Response	OK
Description	模块将复位

Example:
<< AT+REBOOT
>> OK

AT+RESTORE - 恢复出厂设置

Command	AT+RESTORE
Response	OK
Description	模块将恢复为出厂设置并重启

Example:
<< AT+RESTORE
>> OK

AT+BTEN - 开关蓝牙

Command	AT+BTEN{=Param}
`Param`	0-关闭蓝牙 1-打开蓝牙
Description	打开关闭蓝牙设置只在当前生效，重启后失效

AT+STAT - 查询模块连接状态

Command	AT+STAT
Response	+STAT=Param1, Param2, Param3, Param4, Param5, Param6, Param7
`Param1`	蓝牙从模式下的连接状态
`Param2`	蓝牙主模式下的连接状态
`Param3`	Wi-Fi连接状态
`Param4`	Tcp Server连接状态
`Param5`	Tcp Client连接状态
`Param6`	SSL client连接状态
`Param7`	MQTT连接状态
Description	0: 未初始化 1 :空闲 2: 正在连接 3: 已连接

Example:查询当前模块连接状态
<< AT+STAT
>> +STAT=0,1,3,1,0,0,0
>> OK

AT+DSCA - 断开Wi-Fi或蓝牙连接

Command	AT+DSCA=Param
`Param`	1:断开模块与热点的连接 2:断开模块与蓝牙的连接
Response	OK
Description	STA模式断开连接和蓝牙从模式断开连接

Example:
断开与热点的连接
<< AT+DSCA=1
>> OK
断开与蓝牙的连接
<< AT+DSCA=2
>> OK

蓝牙指令

AT+ADDR/LEADDR - 查询BLE蓝牙MAC地址

Command	AT+ADDR/LEADDR
Response	+ADDR/LEADDR=Param
`Param`	模块的BLE蓝牙MAC地址(12 Bytes ASCII)
Description	蓝牙地址码只支持查询，不支持设置

Example:
<< AT+ADDR/LEADDR
>> +ADDR/LEADDR=DC0D30010203
>> OK

AT+NAME/LENAME - 查询/设置BLE蓝牙名称

Command	AT+NAME/LENAME{=Param1{,Param2}}
`Param1`	BLE蓝牙名称(1~25 Bytes ASCII)
`Param2`	使能MAC地址后缀(0/1,default:1) 0: 关闭后缀 1: 开启后缀“-XXXX”(MAC地址后4Byte)
Response	+NAME/LENAME=Param
Description	如果存在参数则设置蓝牙名称，否则只是读取

Example:
查询BLE蓝牙名称
<< AT+NAME/LENAME
>> +NAME/LENAME=FSC-BW236-XXXX
>> OK

设置BLE蓝牙名称,且关掉后缀
<< AT+NAME/LENAME=ABC,0
>> OK

设置BLE蓝牙名称为“ABC”并自动添加地址后缀
<< AT+NAME/LENAME=ABC,1
>> OK

AT+GATTSEND - 从模式发送BLE数据

Command	AT+GATTSEND=Param1,Param2
`Param1`	需要发送的数据长度
`Param2`	需要发送的数据内容
Response	OK
Description	数据长度应小于1000

Example:
从端发送”123”给蓝牙主端
<< AT+GATTSEND=3,123
>> OK

AT+MODE: 查询/设置蓝牙模式

Command	AT+MODE{=Param}
`Param`	0:蓝牙从模式 1:蓝牙主模式
Response	+MODE=Param
Description	设置完成后模块会自动重启

Example:
查询当前蓝牙模式
<< AT+MODE
>> +MODE=0
>> OK
设置为蓝牙主模式
<< AT+MODE=1
>> OK

AT+LECONN - 主模式下连接远端设备

Command	AT+LECONN=Param1,Param2
`Param1`	远端设备地址类型(0:public,1:random)
`Param2`	远端设备地址码
Response	OK
Description	需要在蓝牙主模式下(+MODE=1)才能生效

Example:
连接远端设备
<< AT+LECONN=0,DC0D30600002
>> OK

AT+GATTAC - 主模式下查询/设置上电自动连接

Command	AT+GATTAC{=Param}
`Param`	0:关闭上电自动连接 1:开启上电自动连接(default)
Response	+GATTAC=Param
Description	设置完成后重启生效

Example:
查询当前是否开启上电自动连接
<< AT+GATTAC
>> +GATTAC=1
>> OK
关闭上电自动连接
<< AT+GATTAC=0
>> OK

AT+LESEND - 主模式下发送BLE数据

Command	AT+LESEND=Param1,Param2
`Param1`	需要发送的数据长度
`Param2`	需要发送的数据内容
Response	OK
Description	数据长度应小于1000

Example:
<<AT+LESEND=10,1234567890
>> OK

Wi-Fi指令

AT+ROLE - 查询/设置Wi-Fi模式

Command	AT+ROLE{=Param}
`Param`	1:STA模式 2:AP模式 3:STA+AP共存模式
Response	+ROLE=Param
Description	设置完成后模块会自动重启

Example:
查询当前Wi-Fi模式
<< AT+ROLE
>> +ROLE=1
>> OK
设置AP模式
<< AT+ROLE=2
>> OK

AT+RAP - 查询已设置热点/连接热点

Command	AT+RAP{=Param1}{,Param2}
`Param1`	热点的名称
`Param2`	热点的密码,如果没密码则此处为空
Response	+RAP=Param1,Param2
Description	需要在STA模式或AP+STA共存模式下发送此命令,即+ROLE=1或3 模块会自动适配WEP/WPA/WPA2等加密方式

Example:
连接名为test,密码为12345678的热点
<< AT+RAP=test,12345678
>> OK
查询当前已设置热点
<< AT+RAP
>> +RAP=test,12345678
>> OK
连接名为test,无密码的热点
<< AT+RAP=test
>> OK

AT+BRAP - 以热点地址码连接热点

Command	AT+BRAP{=Param1}{,Param2}
`Param1`	热点的地址码
`Param2`	热点的密码,如果没密码则此处为空
Response	+BRAP=Param1,Param2
Description	需要在STA模式或AP+STA共存模式下发送此命令,即+ROLE=1或3 模块会自动适配WEP/WPA/WPA2等加密方式

Example:
热点地址码为1063C85FCB9F,密码为12345678的热点
<< AT+BRAP=1063C85FCB9F,12345678
>> OK
查询当前已设置热点
<< AT+BRAP
>> +BRAP=1063C85FCB9F,12345678
>> OK
1063C85FCB9F,无密码的热点
<< AT+BRAP=1063C85FCB9F
>> OK

AT+CAP - 清除已设置的热点信息

Command	AT+CAP
`Param`	None
Response	OK
Description	Clear Connected AP’s Information

Example:
清除热点信息
<< AT+CAP
>> OK

AT+BSSID - 查询模块已连接热点的MAC

Command	AT+BSSID
Response	+BSSID=Param
Description	如果返回ERR003, 则表示模块当前没有连接到热点

Example:
查询已连接热点的MAC
<< AT+BSSID=1063C85FCB9F
>> OK

AT+LIP - 查询模块当前IP地址

Command	AT+LIP
Response	+LIP=Param
Description	如果返回为0.0.0.0, 则表示模块当前没有连接到热点

Example:
查询IP地址
<< AT+LIP=192.168.0.224
>> OK

AT+MDNSEN - 查询/设置MDNS功能

Command	AT+MDNSEN{=Param}
`Param`	0:关闭MDNS功能(default) 1:开启MDNS功能
Response	+MDNSEN=Param

Example:
查询MDNS开关
<< AT+MDNSEN
>> +MDNSEN=0
>> OK
打开MDNS功能
<< AT+MDNSEN=1
>> OK

AT+DHCP - 查询/设置DHCP模式

Command	AT+DHCP{=Param}
`Param`	0:使用静态IP 1:使用动态IP(default)
Response	+DHCP=Param
Description	使用静态IP进行连接时,需设置并保证静态IP、掩码、网关、DNS设置正确,否则网络通信可能存在问题

Example:
查询DHCP模式
<< AT+DHCP
>> +DHCP=1
>> OK
设置为静态IP模式
<< AT+DHCP=0
>> OK

AT+SIP - 查询/设置静态IP

Command	AT+SIP{=Param}
`Param`	IPV4地址
Response	+SIP=Param
Description	只在静态IP模式下生效,即+DHCP=0

Example:
查询设置的静态IP地址
<< AT+SIP
>> +SIP=0.0.0.0
>> OK
设置静态IP为192.168.0.23
<< AT+SIP=192.168.0.23
>> OK

AT+GW - 查询/设置网关

Command	AT+GW{=Param}
`Param`	IPV4地址
Response	+GW=Param
Description	只在静态IP模式下生效,即+DHCP=0

Example:
查询设置的网关地址
<< AT+GW
>> +GW=192.168.1.1
>> OK
设置网关地址为192.168.10.1
<< AT+GW=192.168.10.1
>> OK

AT+MASK - 查询/设置子网掩码

Command	AT+MASK{=Param}
`Param`	IPV4地址
Response	+MASK=Param
Description	只在静态IP模式下生效,即+DHCP=0

Example:
查询设置的子网掩码
<< AT+MASK
>> +MASK=255.255.0.0
>> OK
设置子网掩码为255.255.255.0
<< AT+MASK=255.255.255.0
>> OK

AT+DNS - 查询/设置DNS地址

Command	AT+DNS{=Param}
`Param`	IPV4地址
Response	+DNS=Param
Description	只在静态IP模式下生效,即+DHCP=0,如果DNS不匹配将无法访问外网

Example:
查询设置的DNS
<< AT+DNS
>> +DNS=0.0.0.0
>> OK
设置DNS为8.8.8.8
<< AT+DNS=8.8.8.8
>> OK

AT+APAC - 查询/设置上电自动连接热点

Command	AT+APAC{=Param}
`Param`	0:关闭上电自动连接热点 1:开启上电自动连接热点(default)
Response	+APAC=Param
Description	该指令在STA模式或STA+AP共存模式下生效,即+ROLE=1或3

Example:
查询上电自动连接热点
<< AT+APAC
>> +APAC=1
>> OK
设置上电自动连接热点
<< AT+APAC=1
>> OK

AT+RSSI - 查询与热点之间的信号强度

Command	AT+RSSI
Response	+RSSI=Param
`Param`	RSSI value (-99 ~ 0)
Description	未连接热点时,RSSI的查询结果为0

Example:
查询RSSI
<< AT+RSSI
>> +RSSI=-56
>> OK

AT+MAC - 查询模块Wi-Fi MAC地址

Command	AT+MAC
Response	+MAC=Param
`Param`	模块的Wi-Fi MAC地址(12 Bytes ASCII)
Description	MAC地址只支持查询, 不支持设置

Example:
<< AT+MAC
>> +MAC=DC0D30800204
>> OK

AT+SCFG - 快速配网

Command	AT+SCFG=Param
`Param`	1:开始简易配网 2:开始airkiss配网 0:停止配网
Response	OK
Note	需分别配合 FeasyWiFi 和 airkiss APP 使用

AT+WEBCFG - 开启网页配网模式

Command	AT+WEBCFG=Param
`Param`	0:开始网页配网 1:停止网页配网
Response	OK
Description	需要模块处于AP模式下,即+ROLE=2

Example:
开始网页配网
<< AT+WEBCFG=1
>> OK

AT+WPSCFG - 开启WPS配网模式

Command	AT+WPSCFG=Param
`Param`	1:开始WPS配网
Response	OK

Example:
开启WPS配网模式
<< AT+WPSCFG=1
>> OK

AT+LAP - 查询/设置AP模式参数

Command	AT+LAP{=Param1,Param2,Param3}
`Param1`	模块作为热点时的名称
`Param2`	模块作为热点时的密码
`Param3`	模块作为热点时的IP
Response	+LAP=Param1, Param2, Param3
Description	若要将模块配置成 OPEN 加密方式的热点, 则第二个参数可以不用设置, 如AT+LAP=FSC-BW236-AP,192.168.1.1

Example:
查询AP模式参数
<< AT+LAP
>> +LAP=FSC-BW236-AP,12345678,192.168.1.1
>> OK
设置AP模式参数
<< AT+LAP=test,12345678,192.168.10.1
>> OK

TCP指令

AT+SOCK - 查询和设置SOCKET

Command	AT+SOCK{=Param1,Param2,Param3,Param4}
`Param1`	协议类型(TCPS,TCPC,UDP,SSL)
`Param2`	模块端口号
`Param3`	远端地址
`Param4`	远端端口号
Response	+SOCK=Param1, Param2, Param3, Param4
Decription	模块上电后默认开启TCP SERVER, 默认端口9100 将模块设置成 TCP server 时,Param3 和 Param4 可以缺省将模块设置成 UDP 时,Param3 和 Param4 可以缺省

Example:
查询SOCK设置
<< AT+SOCK
>> +SOCK=TCPS,9100,0.0.0.0,0
>> OK
设置模块作为TCP Server, 端口8080
<< AT+SOCK=TCPS,8080
>> OK
设置模块作为TCP client, 端口8080,连接远端服务器192.168.0.224,端口6000
<< AT+SOCK=TCPC,8080,192.168.0.224,6000
>> OK
开启模块UDP功能,端口4000
<< AT+SOCK=UDP,4000
>> OK

AT+WLANC - 启动SOCKET/MQTT

Command	AT+WLANC=Param
`Param`	1 or 2:Wi-Fi回连,需要在+RAP已设置的情况下(建议直接用AT+RAP指令替代) 3:启动TCP/UDP/SSL等 4:连接MQTT或云平台 5:启动WEBSOCKET
Response	OK
Description	需要在SOCKET连接或者MQTT连接参数都正确设置后再发此条指令

AT+MAXCON - 查询/设置模块作为TCP Server时的最大连接数

Command	AT+MAXCON=Param
`Param`	最大连接数
Response	+MAXCON=Param
Description	模块作为TCP Server的最大连接数默认为3

Example:
查询TCP Server最大连接数
<< AT+MAXCON
>> +MAXCON=3
>> OK
设置TCP Server最大连接数为1
<< AT+MAXCON=1
>> OK

AT+WFSEND - 发送SOCKET数据给远端设备

Command	AT+WFSEND=Param1,Param2,Param3
`Param1`	TCP/UDP连接的ID
`Param2`	发送数据长度(不超过1460字节)
`Param3`	发送数据内容
Response	OK
Description	模块作为 TCP server 时，默认最多可以被 3 个远端 client 连接,则 3路连接的 ID 号分别为 0, 1, 2; 模块作为 TCP client 时，通信的 ID 号为MAXCON 的设定值, 默认为3; 模块开启 UDP 时，通信的 ID 号为 MAXCON+1, 默认为4。通信 ID 会随 MAXCON 的设定值而变化，如 MAXCON 为 6, 则作为 TCPserver 的 ID 为 0~5, 作为 TCP client 的 ID 号为 6, 作为 UDP 的 ID 号为7

Example:
给TCP Client发送数据
<< AT+WFSEND=0,3,123
>> OK
给TCP Server发送数据
<< AT+WFSEND=3,3,123
>> OK
给UDP发送数据
<< AT+WFSEND=4,3,123
>> OK

AT+CLOSE - 断开TCP Client与服务器的连接

Command	AT+CLOSE
Response	OK
Description	模块作为TCP Client模式与服务器连接时, 可通过此条指令断开与服务器的连接

Example:
<< AT+CLOSE
>> OK

WEBSOCKET指令

AT+WEBSOCK - 查询/设置WEBSOCKET地址

Command	AT+WEBSOCK=Param1,Param2
`Param1`	WSC :模块作为Client WSS :模块作为Server
`Param2`	模块作为Client时,此处为远端Server地址;模块作为Server时,此处为模块地址;
Response	+WEBSOCK=Param1,Param2
Description	Param2地址格式为需要以ws://或wss://开头, 如果需要指定端口的话, 在地址后面跟:指定端口

Example:
模块作为Client访问远程Server
<< AT+WEBSOCK=WSC,ws://192.168.0.188:443/read
>> OK

Example:
模块作为Server
<< AT+WEBSOCK=WSS,ws://192.168.0.144
>> OK

Note

端口设置可以缺省, 当没有指定端口时, ws默认以80端口连接,wss默认以443端口连接
WEBSOCKET跟TCP功能有冲突,不能同时使用

AT+WSSEND - 发送websocket数据

Command	AT+WSSEND=Param1{,Param2},Param3,Param4
`Param1`	WSC :模块作为Client WSS :模块作为Server
`Param2`	指定需要发送的客户端ID, 只在模块作为Server时需要此参数
`Param3`	数据长度
`Param4`	数据
Response	OK
Description	模块作为Server时默认支持一个Client接入, 所以发送数据时Param2为1

Example:
模块作为Client发送数据
<< AT+WSSEND=WSC,10,0123456789
>> OK

Example:
模块作为Server发送数据
<< AT+WSSEND=WSS,1,10,0123456789
>> OK

AT+WSCLS - 关闭WEBSOCKET

Command	AT+WSCLS
Response	OK
Description	断开跟远程的连接&关闭模块的Server

Example:
关闭WEBSOCKET
<< AT+WSCLS
>> OK

AT+WSSTAT - 查询WEBSOCKET状态

Command	AT+WSSTAT
Response	+WSSTAT=Param1,Param2
Description	返回CLient和Server的状态

Example:
查询WEBSOCKET
<< AT+WSSTAT
>> +WSSTAT=3,0
>> OK

HTTP指令

AT+HEADER - 查询/修改HTTP请求头

Command	AT+HEADER{=Param}
Response	+WSSTAT=Param1
Description	由多个请求头时,以逗号隔开,设置完后需调用AT+CLRHEADER手动清除或下次重启后会自动清除

Example:
为请求头增加格式为applcation/json
<< AT+HEADER=Content-Type:applcation/json
>> OK
为请求头增加范围请求前1K字节
<< AT+HEADER=Range:bytes=0-1023
>> OK
查询当前设置的请求头
<< AT+HEADER
>> +HEADER=Range:bytes=0-1023
>> OK

AT+CLRHEADER - 清除HTTP请求头

Command	AT+CLRHEADER
Response	OK
Description	清除设置的HTTP请求头

Example:
<< AT+CLRHEADER
>> OK

AT+HTTP - 访问HTTP服务器

Command	AT+HTTP=Param1,Param2,Param3{,Param4}
`Param1`	HTTP请求方法, 目前只支持GET和POST
`Param2`	HTTP服务服务器地址
`Param3`	HTTP访问目录
`Param4`	断点续传支持,可缺省,格式为Range:bytes=起始字节-终止字节,也可以在指令AT+HEADER里设置
Response	OK
Description	AT+HTTP用于访问HTTP服务器. 如果需要访问HTTPS服务器, 请用AT+HTTPS指令替代 HTTP服务器默认访问端口为80, HTTPS服务器默认访问端口为443,如果需要修改访问端口, 请在服务器地址后面跟:指定端口, 例如指定端口为778, 则可以用192.168.0.179:778

Example:
访问百度,读取全部数据
<< AT+HTTP=GET,www.baidu.com,/
>> OK
>> {具体数据}

访问百度,读取第3-10字节数据
<< AT+HTTP=GET,www.baidu.com,/,Range:bytes=3-10
>> OK
>> {具体数据}
或者使用如下方式
<< AT+HEADER=Range:bytes=3-10
<< AT+HTTP=GET,www.baidu.com,/
>> OK
>> {具体数据}

访问内部HTTPS服务器,下载OTA目录下test.bin文件, 指定端口为778
<< AT+HTTPS=GET,192.168.0.179:778,/OTA/test.bin
>> OK
>> {具体数据}

POST param1=test_data1&param2=test_data2 到http://httpbin.org/post
<< AT+HTTP=POST,httpbin.org,/post,param1=test_data1&param2=test_data2
>> OK
>> {返回数据}

Note

用户可用http://httpbin.org 进行测试

MQTT指令

AT+BROKER - 查询/设置MQTT broker地址

Command	AT+BROKER{=Param}
`Param`	MQTT服务器地址
Response	+BROKER=Param
Description	用户可用gpssensor.ddns.net 进行测试

Example:
查询MQTT broker地址
<< AT+BROKER
>> +BROKER=gpssensor.ddns.net
>> OK

设置MQTT broker地址
<< AT+BROKER=gpssensor.ddns.net
>> OK

AT+CLIENTID - 查询/设置MQTT Client ID

Command	AT+CLIENTID{=Param}
`Param`	MQTT Client ID
Response	+CLIENTID=Param

Example:
查询MQTT Client ID
<< AT+CLIENTID
>> +CLIENTID=user
>> OK

设置MQTT Client ID
<< AT+CLIENTID=447a74ab3e60494e8c97dad36b00399b
>> OK

AT+USERNAME - 查询/设置MQTT USERNAME

Command	AT+USERNAME{=Param}
`Param`	MQTT USERNAME
Response	+USERNAME=Param

Example:
查询MQTT USERNAME
<< AT+USERNAME
>> +USERNAME=admin
>> OK

设置MQTT USERNAME
<< AT+USERNAME=admin
>> OK

AT+MQTTPWD - 查询/设置MQTT password

Command	AT+MQTTPWD{=Param}
`Param`	MQTT Password
Response	+MQTTPWD=Param

Example:
查询MQTT MQTTPWD
<< AT+MQTTPWD
>> +MQTTPWD=12345678
>> OK

设置MQTT Password
<< AT+MQTTPWD=12345678
>> OK

AT+SUBTPC - 查询/订阅 MQTT主题

Command	AT+SUBTPC{=Param1,Param2}
`Param1`	Topic
`Param2`	QOS值, 只能为0,1或者2
Response	+SUBTPC=Param1,Param2

Example:
查询MQTT TOPIC
<< AT+SUBTPC
>> +SUBTPC=/fsc/bw236/get,0
>> OK

设置MQTT TOPIC
<< AT+SUBTPC=/fsc/bw236/test,2
>> OK

Note

重复订阅同名TOPIC,指令会返回错误
当前最大支持订阅5个不同Topic,如不满足使用需求，在实际使用中建议用户先搭配通配符使用

AT+UNSUBTPC - 取消订阅 MQTT主题

Command	AT+UNSUBTPC=Param
`Param`	指定需要取消订阅的Topic
Response	OK
Description	取消订阅主题不需要指定QOS值

Example:
<< AT+UNSUBTPC=/fsc/bw236/get
>> OK

AT+UNSUBALL - 取消订阅全部MQTT主题

Command	AT+UNSUBALL
Response	OK

Example:
<< AT+UNSUBALL
>> OK

AT+MQTTSEND - 发送MQTT数据

Command	AT+MQTTSEND=Param1,Param2,Param3,Param4
`Param1`	发布主题
`Param2`	QOS(0,1,2)
`Param3`	数据长度
`Param4`	数据内容
Response	OK

Example:
<< AT+MQTTSEND=fsc/bw236/get,0,3,abc
>> OK

AT+MQTTMODE - 查询/设置MQTT模式

Command	AT+MQTTMODE{=Param}
`Param`	0: 连接普通MQTT服务器(默认) 1: 连接阿里云平台 2: 连接腾讯云平台
Response	OK
Description	通过切换不同的模式, 模块以MQTT的方式连接不同的云平台

Example:
<< AT+MQTTMODE
>> +MQTTMODE=0
>> OK

AT+MQTTS - 查询/设置 MQTT开启SSL/TLS加密

Command	AT+MQTTS{=Param}
`Param`	0: 关闭SSL/TLS加密(默认) 1: 开启SSL/TLS加密
Response	+MQTTS=Param

Example:
查询是否开启加密
<< AT+MQTTS
>> +MQTTS=0
>> OK
开启SSL/TLS加密
<< AT+MQTTS=1
>> OK

Note

如果用户需要使用SSL/TLS加密, 并使用自定义TLS证书, 请联系FAE处理

AT+MQTTPORT - 查询/设置 MQTT端口

Command	AT+MQTTPORT{=Param}
`Param`	MQTT端口值, 默认为1883
Response	+MQTTPORT=Param
Descrirtion	需要根据服务器实际端口来设置

Example:
查询MQTT端口
<< AT+MQTTPORT
>> +MQTTPORT=1883
>> OK
设置MQTT端口为8883
<< AT+MQTTPORT=8883
>> OK

AT+MQTTKAI - 查询/设置 MQTT保活心跳时间

Command	AT+MQTTKAI{=Param}
`Param`	MQTT保活时间, 单位为秒, 默认为60秒
Response	+MQTTKAI=Param

Example:
查询MQTT保活时间
<< AT+MQTTKAI
>> +MQTTKAI=60
>> OK
设置MQTT保活时间为300s
<< AT+MQTTKAI=300
>> OK

Note

请根据实际平台的使用限制来设置, 常见平台如阿里云的MQTT保活时间要求为30秒~1200秒
当设备意外断开连接超过{保活心跳时间*1.5}时，服务器会自动断开连接

AT+MQTTVER - 查询/设置 MQTT版本

Command	AT+MQTTVER{=Param}
`Param`	MQTT版本(3或者4,默认为3)
Response	+MQTTVER=Param
Note

Example:
查询MQTT版本
<< AT+MQTTVER
>> +MQTTVER=3
>> OK
设置MQTT版本为3
<< AT+MQTTVER=3
>> OK

Note

当需要增加对消息队列(MQ)的支持时, 需要将版本修改为4, 否则不要修改此值

AT+MQTTCLS - 关闭MQTT连接

Command	AT+MQTTCLS
Response	OK

Example:
<< AT+MQTTCLS
>> OK

云平台相关指令(三元组)

AT+DEVNAME - 查询/设置Device Name

Command	AT+DEVNAME{=Param}
`Param`	Device Name
Response	+DEVNAME=Param

Example:
查询Device Name
<< AT+DEVNAME
>> +DEVNAME=printer
>> OK
设置Device Name
<< AT+DEVNAME=printer
>> OK

AT+PROKEY - 查询/设置Product Key

Command	AT+PROKEY{=Param}
`Param`	Product Key
Response	+PROKEY=Param

Example:
查询Product Key
<< AT+PROKEY
>> +PROKEY=a1jdkjfuh
>> OK
设置Product Key
<< AT+PROKEY=a1jdkjfuh
>> OK

AT+DEVSECRET - 查询/设置Device Secret

Command	AT+DEVSECRET{=Param}
`Param`	Device Secret
Response	+DEVSECRET=Param

Example:
查询Device Secret
<< AT+DEVSECRET
>> +DEVSECRET=15kjdfydfhnflh
>> OK
设置Device Secret
<< AT+DEVSECRET=15kjdfydfhnflh
>> OK

固件升级(远程OTA)

AT+OTA - 远程OTA

Command	AT+OTA=Param
`Param`	需要升级的固件名
Response	OK
Description	固件名由工程或技术支持人员提供，升级成功后模块会返回$OTA=1

Example:
<< AT+OTA=Feasycom_V429
>> OK
>> $OTA=1

Note

升级过程中不要操作其它指令或者功能,不然可能会导致升级失败或者意外的情况

Events表

MQTT指示

+MQTTSTAT - MQTT状态

Format	+MQTTSTAT=Param
`Param`	(0) 未初始化 (1) 未连接 (2) 连接中 (3) 已连接

+MQTTDATA - MQTT接收数据

Format	+MQTTDATA=Param1,Param2,Param3
`Param1`	Topic
`Param2`	Payload length
`Param3`	Payload

Example: 通过MQTT从服务器接收到数据”1234567890”

>> +MQTTDATA=/fsc/bw236/get,10,1234567890

WEBSOCKET指示

+WSSTAT - WEBSOCKET状态

Format	+WSSTAT=Param1,Param2
`Param1`	CLient状态 \| (0) 未初始化 \| (1) 未连接 \| (2) 连接中 \| (3) 已连接
`Param2`	Server状态 \| (0) 未初始化 \| (1) 未连接 \| (2) 连接中 \| (3) 已连接

SSL指示

+SSLSTAT - SSL Client状态

Format	+SSLSTAT=Param
`Param`	(0) 未初始化 (1) 未连接 (2) 连接中 (3) 已连接

+SSLDATA - SSL接收数据

Format	+SSLDATA=Param1,Param2
`Param1`	Payload length
`Param2`	Payload

Example: 通过SSL从服务器接收到数据”1234567890”

>> +SSLDATA=10,1234567890

SOCKET指示

+WFDATA - SOCKET接收数据

Format	+WFDATA=Param1,Param2,Param3
`Param1`	TCP/UDP连接的ID
`Param2`	Payload length
`Param3`	Payload

Example: 通过SOCKET从服务器接收到数据”1234567890”

>> +WFDATA=3,10,1234567890

Note

连接ID的具体说明查看AT+WFSEND指令

GATT指示

+GATTSTAT - GATT状态

Format	+GATTSTAT=Param
`Param`	(0) 未初始化 (1) 未连接 (2) 连接中 (3) 已连接

+GATTDATA - GATT接收数据

Format	+GATTDATA=Param1,Param2
`Param1`	Payload length
`Param2`	Payload

Example: 通过GATT从远端设备接收到数据“ 1234567890”

>> +GATTDATA=10,1234567890

附录

下载 PDF版本

下载PDF版本