FSC-BW256B AT命令集

描述

本设计指南适用于工程师开发 FSC-BW256B 系列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-BW256B,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-BW256B,V4.4.6
>> OK

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

Command	AT+BAUD{=Param}
`Param`	2400/4800/9600/19200/38400/57600/115200/128000/ 230400/256000/460800/512000/921600/1000000/1382400 2000000/3000000/3250000
Response	+BAUD=Param
`Param`	返回当前所设置的波特率

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

设置波特率
<< AT+BAUD=115200
>> 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+REBOOT-模块重启

Command	AT+REBOOT
Response	OK
Description	模块释放与远端设备的所有连接，然后重启

Example:
模块重启
<< AT+REBOOT
>> OK

AT+RESTORE-恢复出厂设置

Command	AT+RESTORE
Response	OK
Description	模块恢复到出厂设置，然后重启

Example:
恢复出厂设置
<< AT+RESTORE
>> OK

AT+STAT-查询连接状态

Command	AT+STAT
Response	+STAT=Param1, Param2, Param3, Param4, Param5, Param6, Param7,Param8
`Param1`	WIFI STA 模式下的连接状态
`Param2`	模块作为 TCP server 时的连接状态
`Param3`	模块作为 TCP client 时的连接状态
`Param4`	模块 BLE 从端的连接状态
`Param5`	模块 SPP 的连接状态
`Param6`	模块 SSL Client 的连接状态
`Param7`	模块 MQTT 的连接状态
Description	0: 未初始化 1 :空闲 2: 正在连接 3: 已连接

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

AT+NAME - 查询/设置蓝牙BR/EDR名称

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

Example:
查询BR/EDR蓝牙名称
<< AT+NAME
>> +NAME=FSC-BW256-XXXX
>> OK

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

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

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

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

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

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

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

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

Command	AT+DSCA
Response	OK
Description	模块断开Wifi或蓝牙的连接

Example:
断开与AP的连接
<< AT+DSCA=1
>> OK
断开与BLE的连接
<< AT+DSCA=2
>> OK

SPP指令

AT+ADDR-查询蓝牙BR/EDR地址码

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

Example:
<< AT+ADDR
>> +ADDR=DC0D300016F4
>> OK

AT+SPPSTAT-读SPP状态

Command	AT+SPPSTAT
Response	+SPPSTAT=Param
`Param`	0:未初始化 1:未连接 2:连接中 3:已连接
Description	查询SPP连接状态

AT+SPPDISC-断开SPP连接

Command	AT+SPPDISC
Response	OK
Description	断开当前与远程设备的SPP连接

AT+SPPSEND-发送 SPP 数据

Command	AT+SPPSEND=Param1,Param2
`Param1`	需要发送的数据长度
`Param2`	需要发送的数据内容
Response	OK:发送完成 ERR002:参数或格式不正确 ERR003:蓝牙未连接
Description	数据长度应小于1000

Example:
模块发送”123”
<< AT+SPPSEND=3,123
>> OK

AT+SSP-查询/修改BT配对模式

Command	AT+SSP{=Param}
`Param`	0:简易配对模式(默认) 1:配对码模式
Response	OK
Description

Example:
查询配对模式
<< AT+SSP
>> +SSP=0
>> OK
设置为配对码模式
<< AT+SSP=1
>> OK

AT+PIN-查询/修改BT配对码

Command	AT+PIN{=Param}
`Param`	配对码
Response	OK
Description	配对码默认为”0000”,数据长度不超过15位,仅在配对码模式下有效即SSP=1

Example:
查询BT配对码
<< AT+PIN
>> +PIN=0000
>> OK
设置配对码为12345678
<< AT+PIN=12345678
>> OK

AT+COD-查询/修改BT设备类型

Command	AT+COD{=Param}
`Param`	设备类型(16进制)
Response	OK
Description	默认打印机(0x680)

Example:
查询蓝牙设备类型
<< AT+COD
>> +COD=680
>> OK
修改蓝牙设备类型为HeadPhone(0x418)
<< AT+COD=418
>> OK

BLE指令

AT+LEADDR-查询蓝牙BLE地址码

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

Example:
<< AT+LEADDR
>> +LEADDR=DD0D300016F4
>> OK

AT+GATTSEND-发送 BLE 数据

Command	AT+GATTSEND=Param1,Param2
`Param1`	需要发送的数据长度
`Param2`	需要发送的数据内容
Response	OK: 发送完成 ERR002:参数或格式不正确 ERR003:蓝牙未连接
Description	数据长度应小于1000

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

AT+GATTSTAT-查询BLE连接状态

Command	AT+GATTSTAT
Response	+GATTSTAT=Param
`Param`	0:未初始化 1:未连接 2:连接中 3:已连接
Description

Example:
查询BLE连接状态
<< AT+GATTSTAT
>> +GATTSTAT=3
>> OK

AT+ADVDATA-查询/修改BLE广播数据

Command	AT+ADVDATA=Param
`Param`	BLE广播内容
Response	OK: 设置完成 ERR002:参数或格式不正确
Description	数据长度应小于31字节

Example:
修改BLE广播数据
<< AT+ADVDATA=1234
>> OK
查询BLE广播数据,返回为16进制
<< AT+ADVDATA
>> +ADVDATA=31323334
>> OK

AT+ADVCLR-恢复默认BLE广播数据

Command	AT+ADVCLR
Response	OK: 设置完成
Description

Example:
恢复默认BLE广播数据
<< AT+ADVCLR
>> OK

Wi-Fi指令

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

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

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

AT+SCAN-扫描周围设备

Command	AT+SCAN=5(扫描周围热点)
Response	+SCAN=Param1,Param2,Param3,Param4,Param5,Param6
`Param1`	扫描序号
`Param2`	固定值 5,代表扫描热点
`Param3`	热点的地址码
`Param4`	模块与热点之间的信号值
`Param5`	信道
`Param6`	热点名称
Description

Example:
扫描周围热点
<< AT+SCAN=5
>> +SCAN=1,5,F0B4292428F0,-42,11,Feasycom_D710_2.4G
>> +SCAN=2,5,F0B4292428F1,-44,153,Feasycom_D710_5G
>> +SCAN=3,5,98BB991F6B45,-48,13,GOCLOUD_1F6B46

AT+RAP-连接热点

Command	AT+RAP=<Param1>,<Param2>,<Param3>
`Param1`	热点的名称
`Param2`	热点的密码
`Param2`	指定加密方式
Response	OK
Description	1. 需在STA模式或共存模式下发送该指令,即+ROLE=1 或 3 2. 模块默认以 WPA/WPA2/WPA3 Personal的加密方式连接热点 3. 若需要连接加密方式为 OPEN 的热点，只设置第一个参数即可，如 AT+RAP=Feasycom 4. 发送 AT+RAP,可查询设置的热点名称 4. 如需连接WEP加密方式的热点,需要设置第三个参数为WEP

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

AT+CAP-清除热点信息

Command	AT+CAP
Response	OK
Description	只会清除当前连接热点信息,不会主动断开连接,下次重启不会再连接

Example:
<< AT+CAP
>> OK

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

Command	AT+LIP
Response	+LIP=Param
`Param`	IP 地址
Description	当模块成功连上热点后，会获取到一个 IP 地址，否则返回”0.0.0.0”

Example
查询当前模块IP地址
<< AT+LIP
<< +LIP=192.168.1.100
>> 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+LHNAME - 查询/设置模块STA设备名

Command	AT+LHNAME{=Param}
`Param`	设备名(不大于32字节)
Response	+LHNAME=Param
Description	默认为FSC-BW256

Example:
查询模块STA设备名
<< AT+LHNAME
>> +LHNAME=FSC-BW256
>> OK
设置STA和设备名为my_test
<< AT+LHNAME=my_test
>> 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+APINFO - 查询模块已连接热点的信息

Command	AT+APINFO
Response	+APINFO=Param1,Param2,Param3,Param4
`Param1`	热点MAC地址(12 Bytes ASCII)
`Param2`	0表示2.4G, 1表示5G
`Param3`	热点的频段
`Param4`	热点的SSID
Description	只在已连接热点的情况下才能查询

Example:
<< AT+APINFO
>> +APINFO=B4F02429F128,1,5765,Feasycom_D710_5G
>> OK

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

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

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

AT+CHANNEL - 查询/设置AP模式信道

Command	AT+CHANNEL{=Param}
`Param`	模块作为AP模式时的信道
Response	+CHANNEL=Param
Description	模块将根据信道选择决定开启2.4G还是5G热点

Example:
查询AP模式信道
<< AT+CHANNEL
>> +CHANNEL=1
>> OK
设置AP模式信道
<< AT+CHANNEL=157
>> OK

AT+WLANC - 启动SOCKET/MQTT/WEBSOCKET

Command	AT+WLANC=Param
`Param`	3:启动TCP/UDP/SSL等 4:连接MQTT或云平台 5:启动WEBSOCKET
Response	OK
Description	需要在SOCKET连接或者MQTT连接参数都正确设置后再发此条指令

TCP/UDP指令

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
开启模块SSL client功能,模块端口9100,连接httpbin.org测试
<< AT+SOCK=SSL,9100,httpbin.org,443
>> OK

AT+MAXCON - 查询和设置TCP Server模式下允许连接的最大Client数

Command	AT+MAXCON=Param
`Param`	允许连接的最大Client数(默认3,范围1~6)
Response	OK
Description	此条指令设置影响AT+WFSEND发送的ID设置和+WFDATA返回时的ID

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

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

Command	AT+WFSEND=Param1,Param2,Param3
`Param1`	TCP/UDP连接的ID
`Param2`	发送数据长度
`Param3`	发送数据内容
Response	OK
Description	指令整体长度不超过2k字节模块作为 TCP server 时，默认最多可以被 3 个远端 client 连接,则 3路连接的 ID 号分别为 0, 1, 2; 模块作为 TCP client 时，通信的 ID 号默认为3,具体为AT+MAXCON设置的值; 模块开启 UDP 时，通信的 ID 号默认为4,具体为AT+MAXCON设置的值+1。

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+SSLSEND - 发送SSL数据给远端服务器

Command	AT+SSLSEND=Param1,Param2
`Param1`	发送数据长度
`Param2`	发送数据内容
Response	OK
Description	指令整体长度不超过2k字节

Example:
连接httpbin.org后,通过GET方式获取数据
<< AT+SSLSEND=40,GET /get HTTP/1.1\r\nHost: httpbin.org\r\n\r\n
>> (返回网页内容)

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

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

Example:
<< AT+CLOSE
>> OK

AT+IDLETO - 查询/设置TCP Server短连接无数据自动断开时间

Command	AT+IDLETO{=Param}
`Param1`	短连接无数据自动断开的时间(单位s,默认为0,即长连接)
Response	OK
Description

Example:
查询模块短连接无数据自动断开时间
<< AT+IDLETO
>> +IDLETO=0
>> OK
设置模块短连接无数据自动断开时间为5秒
<< AT+IDLETO=5
>> OK

AT+BRDDATA - 查询/设置UDP广播数据

Command	AT+BRDDATA{=Param1,Param2,Param3}
`Param1`	UDP广播端口
`Param2`	UDP广播间隔(单位s)
`Param3`	UDP广播内容(128字节以内)
Response	OK
Description

Example:
查询UDP广播数据
<< AT+BRDDATA
>> +BRDDATA=6000,5,
>> OK
设置模块短连接无数据自动断开时间为5秒
<< AT+BRDDATA=6000,5,hello world
>> OK

AT+BRDEN - 查询/设置UDP广播开关

Command	AT+BRDEN{=Param}
`Param`	0:关闭UDP广播, 1:打开UDP广播
Response	OK
Description

Example:
查询UDP广播开关
<< AT+BRDEN
>> +BRDEN=0
>> OK
打开UDP广播
<< AT+BRDEN=1
>> OK

HTTP指令

AT+HTTP - 访问HTTP服务器

Command	AT+HTTP=Param1,Param2,Param3{,Param4}
`Param1`	HTTP请求方法, 目前只支持GET和POST
`Param2`	HTTP服务服务器地址
`Param3`	HTTP访问目录
`Param4`	断点续传支持,可缺省,格式为Range:bytes=起始字节-终止字节
Response	OK
Description	AT+HTTP用于访问HTTP服务器. 如果需要访问HTTPS服务器, 请用AT+HTTPS指令替代 HTTP服务器默认访问端口为80, 如果需要修改访问端口, 请在服务器地址后面跟:指定端口, 例如指定端口为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
>> {具体数据}

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

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

Note

用户可用httpbin.org 进行测试

HTTPS指令

AT+HTTPS - 访问HTTPS服务器

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

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

访问百度,读取第3-10字节数据
<< AT+HTTPS=GET,www.baidu.com,/,Range:bytes=3-10
>> 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 到httpbin.org/post
<< AT+HTTPS=POST,httpbin.org,/post,param1=test_data1&param2=test_data2
>> OK
>> {返回数据}

Note

用户可用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/bw256/get,0
>> OK

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

Note

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

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

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

Example:
<< AT+UNSUBTPC=/fsc/bw256/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/bw256/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+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}时，服务器会自动断开连接

固件升级(远程OTA)

AT+OTA - 远程OTA

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

Example:
<< AT+OTA=Feasycom_V426
>> 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/bw256/get,10,1234567890

SSL指示

+SSLDATA - SSL接收数据

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

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

>> +SSLDATA=10,1234567890

STA模式连接状态指示

+WLANSTAT - STA模式连接状态

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

Example: STA连接WiFi成功

>> +WLANSTAT=3

SOCKET指示

+WFDATA - SOCKET接收数据

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

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

>> +WFDATA=5,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

SPP指示

+SPPSTAT - SPP状态

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

+SPPDATA - SPP接收数据

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

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

>> +SPPDATA=10,1234567890

附录

下载 PDF版本

下载PDF版本