FSC-BW246 指令手册¶
介绍¶
描述¶
本设计指南适用于工程师开发 BW246 Wi-Fi SoC 模组
硬件说明¶
引脚图¶

引脚描述¶
Pin |
Pin Name |
Type |
Pin Descriptions |
---|---|---|---|
1 |
UART_TX |
O |
串口TX |
2 |
UART_RX |
I |
串口RX |
3 |
UART_CTS |
I |
串口流控脚(高电平生效) |
4 |
UART_RTS |
O |
串口流控脚(高电平生效) |
9 |
UART_LOG_OUT |
O |
模块调试串口TX |
10 |
UART_LOG_IN |
I |
模块调试串口RX |
11 |
RESET/CHIP_EN |
I/O |
复位脚, 低电平有效 |
12 |
VDD_3V3 |
VDD |
3.3V供电 |
13 |
GND |
VSS |
接地 |
21 |
GND |
VSS |
接地 |
22 |
GND |
VSS |
接地 |
32 |
LED0 |
I/O |
蓝牙已连接输出高电平 |
33 |
LED1 |
I/O |
Wi-Fi已连接输出高电平 |
35 |
GND |
VSS |
接地 |
36 |
EXT_ANT |
ANT |
改变天线附近的0欧电阻, 可以外接蓝牙天线 |
硬件设计说明¶
模组简易测试只需要连接VDD/GND/UART_RX/UART_TX即可使用
编程手册只提供简单的IO口说明, 更详细的说明及注意事项请参考设计文档
画完原理图后请发给飞易通进行审核, 避免蓝牙或Wi-Fi距离达不到最佳效果
硬件接口¶
GPIO
PWM
UART
SPI SLAVE
I2S Master/Slave
Analog Input/Output
支持蓝牙协议¶
SPP Client (Serial Port Profile)
SPP Server (Serial Port Profile)
GATT Server (Generic Attribute Profile)
HID (HID Human Interface Device Profile)
支持Wi-Fi协议¶
TCP (Transmisson Control Protocol)
UDP (USER Datagram Protocol)
HTTP (Hypertext Transfer Protocol)
MQTT (Message Queuing Telemetry Transport)
SSL/TLS(Secure Sockets Layer/Transport Layer Security)
WEBSOCKET Client
模块默认参数¶
Wi-Fi默认设置¶
Wi-Fi Mode |
STA Mode |
Local AP SSID |
FSC-BW246-AP |
Local AP Password |
12345678 |
Local AP IP Address |
192.168.1.1 |
蓝牙默认设置¶
BLE Name |
FSC-BW246-LE |
BLE Mode |
LE-Peripheral |
SPP Name |
FSC-BW246 |
SPP PAIRCODE |
0000 |
串口默认设置¶
Baudrate |
921600bps |
Data Bits |
8 |
Parity |
None |
Stop Bits |
1 |
指令表¶
规范说明¶
适用于整个文档
{} : 包括与{…}中的内容为可选项
<< : 主机发给模组的 COMMAND
>> : 模组回复主机的 RESPONSE/EVENT
指令格式¶
所有的指令以 “AT” 开始,以 <CR><LF> 结束
<CR> 对应 HEX 为 0x0D
<LF> 对应 HEX 为 0x0A
如果指令带有参数,应放在 = 后面
如果指令包含多项参数,应以 , 分隔
如果指令有回复,回复以 <CR><LF> 开始,以 <CR><LF> 结束
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 |
Event格式¶
所有的事件使用<CR><LF>开始, 使用<CR><LF>结束
若事件包含参数, 参数应位于 “=” 后面
若事件包含多项参数, 参数应使用 “,” 分割
通用指令¶
AT - 串口测试指令¶
Command |
AT |
Response |
OK |
Description |
通过AT指令测试串口通信是否正常 |
AT+VER - 读取固件版本¶
Command |
AT+VER |
Response |
+VER=Param1,Param2 |
|
模块类型 |
|
固件版本 |
AT+BAUD - 查询/修改串口波特率¶
Command |
AT+BAUD{=Param} |
|
2400/4800/9600/19200/38400/57600/115200/128000/
230400/256000/460800/512000/921600/1000000/1382400
2000000/3000000/4000000/5000000
|
Response |
+BAUD=Param |
|
返回当前所设置的波特率 |
AT+TPMODE-查询/修改透传模式¶
Command |
AT+TPMODE{=Param} |
|
1:开启透传模式
0:关闭透传模式
|
Response |
+TPMODE=Param |
|
返回当前透传模式设置 |
Description |
当透传模式开启,并建立了 TCP, GATT 等连接,模块串口将输出从远端收到的原始数据,模块串口接收到的数据也将直接发送至远端。
当透传模式关闭,任何状态下,模块串口对接收到的数据只做指令处理,模块从远端接收的数据,将从串口以指令格式输出。
|
AT+REBOOT-模块重启¶
Command |
AT+REBOOT |
Response |
OK |
Description |
模块释放与远端设备的所有连接,然后重启 |
AT+RESTORE-恢复出厂设置¶
Command |
AT+RESTORE |
Response |
OK |
Description |
模块恢复到出厂设置,然后重启 |
AT+STAT-查询连接状态¶
Command |
AT+STAT |
Response |
+STAT=Param1, Param2, Param3, Param4, Param5, Param6, Param7,Param8 |
|
WIFI STA 模式下的连接状态 |
|
模块作为 TCP server 时的连接状态(是否有client连接到模块的TCP server) |
|
模块作为 TCP client 时的连接状态(是否有连接到外部的TCP server) |
|
模块 BLE 从端的连接状态 |
|
模块 SPP 的连接状态 |
|
模块 HID 的连接状态 |
|
模块 MQTT 的连接状态 |
|
模块 SSL 客户端的连接状态 |
Description |
0: 未初始化
1 :空闲
2: 正在连接
3: 已连接
|
AT+NAME - 查询/修改蓝牙BR/EDR名称¶
Command |
AT+NAME{=Param1{,Param2}} |
|
BR/EDR蓝牙名称(1~29 Bytes ASCII) |
|
使能MAC地址后缀(0/1,default:0)
0: 关闭后缀
1: 开启后缀“-XXXX”(MAC地址后4Byte)
|
Response |
+NAME=Param |
Description |
如果存在参数则设置蓝牙名称,否则只是读取 |
AT+LENAME - 查询/修改BLE蓝牙名称¶
Command |
AT+LENAME{=Param1{,Param2}} |
|
BLE蓝牙名称(1~25 Bytes ASCII) |
|
使能MAC地址后缀(0/1,default:0)
0: 关闭后缀
1: 开启后缀“-XXXX”(MAC地址后4Byte)
|
Response |
+LENAME=Param |
Description |
如果存在参数则设置蓝牙名称,否则只是读取 |
AT+PROFILE - 查询/修改蓝牙支持的协议¶
Command |
AT+PROFILE{=Param} |
|
BIT0 : SPP协议 (默认支持) BIT1 : GATT协议(默认支持) BIT3 : HID协议 |
Response |
+PROFILE=Param |
Description |
以10进制数配置和显示,设置后需要重启生效 |
AT+DSCA - 断开蓝牙连接¶
Command |
AT+DSCA |
Response |
OK |
Description |
模块断开与蓝牙的连接 |
SPP指令¶
AT+ADDR-查询蓝牙BR/EDR地址码¶
Command |
AT+ADDR |
Response |
+ADDR=Param |
|
模块蓝牙BR/EDR的MAC地址(12 Bytes ASCII) |
Description |
蓝牙地址码只支持查询,不支持设置 |
AT+SSP-查询/修改BT配对模式¶
Command |
AT+SSP{=Param} |
|
0:配对码模式
0:简易配对模式(默认设置)
|
Response |
OK
|
Description |
修改需要重启才会生效 |
AT+PIN-查询/修改BT配对码¶
Command |
AT+PIN{=Param} |
|
配对码
|
Response |
OK
|
Description |
配对码默认为”0000”,数据长度不超过15位,仅在配对码模式下有效即SSP=1
|
AT+COD-查询/修改BT设备类型¶
Command |
AT+COD{=Param} |
|
设备类型(16进制)
|
Response |
OK
|
Description |
默认打印机(0x680)
|
AT+SPPSTAT-读SPP状态¶
Command |
AT+SPPSTAT |
Response |
+SPPSTAT=Param |
|
0:未初始化
1:未连接
2:连接中
3:已连接
|
Description |
查询SPP连接状态 |
AT+PLIST-查询/删除经典蓝牙配对设备¶
Command |
AT+PLIST{=Param} |
|
要删除的配对设备MAC地址(12 Bytes ASCII)或序号 |
Response |
+PLIST=Param1,Param2,Param3,Param4 |
|
配对设备的序号 |
|
配对设备支持的PROFILE |
|
配对设备的MAC地址 |
|
配对设备的设备名 |
Description |
查询时+PLIST=E表示查询结束 |
AT+SPPDISC-断开SPP连接¶
Command |
AT+SPPDISC |
Response |
OK |
Description |
断开当前与远程设备的SPP连接 |
AT+SPPSEND-发送 SPP 数据¶
Command |
AT+SPPSEND=Param1,Param2 |
|
需要发送的数据长度 |
|
需要发送的数据内容 |
Response |
OK:发送完成
ERR002:参数或格式不正确
ERR003:蓝牙未连接
|
Description |
BLE指令¶
AT+LEADDR-查询蓝牙BLE地址码¶
Command |
AT+LEADDR |
Response |
+LEADDR=Param |
|
模块的BLE蓝牙MAC地址(12 Bytes ASCII) |
Description |
蓝牙地址码只支持查询,不支持设置 |
AT+GATTSTAT-查询BLE连接状态¶
Command |
AT+GATTSTAT |
Response |
+GATTSTAT=Param
|
|
0:未初始化
1:未连接
2:连接中
3:已连接
|
Description |
AT+GATTSEND-发送 BLE 数据¶
Command |
AT+GATTSEND=Param1,Param2 |
|
需要发送的数据长度 |
|
需要发送的数据内容 |
Response |
OK:发送完成
ERR002:参数或格式不正确
ERR003:蓝牙未连接
|
Description |
数据长度应小于1000 |
AT+ADVDATA-查询/修改BLE广播数据¶
Command |
AT+ADVDATA=Param |
|
BLE广播内容 |
Response |
OK: 设置完成
ERR002:参数或格式不正确
|
Description |
数据长度应小于30字节,16进制格式 |
AT+ADVCLR-恢复默认BLE广播数据¶
Command |
AT+ADVCLR |
Response |
OK |
Description |
HID指令¶
AT+HIDSTAT - 查询HID状态¶
Command |
AT+HIDSTAT |
Response |
+HIDSTAT=Param |
|
0:未初始化
1:未连接
2:连接中
3:已连接
|
Description |
查询HID的连接状态 |
AT+HIDCONN - 建立HID连接¶
Command |
AT+HIDCONN=Param |
|
目标设备MAC地址(12 Bytes ASCII) |
Response |
+HIDSTAT+OK |
Description |
查询和c地址 |
AT+HIDDISC - 断开HID连接¶
Command |
AT+HIDDISC |
Response |
OK |
Description |
AT+HIDOSK - 弹出/退出键盘¶
Command |
AT+HIDOSK |
Response |
OK |
Description |
弹出/退出键盘,iso有效 |
AT+HIDDLY - 读/写HID发送时间¶
Command |
AT+HIDDLY{=Param} |
|
time in milliseconds, default 10ms |
Response |
OK |
AT+HIDMODE - 读/写HID模式¶
Command |
AT+HIDMODE{=Param} |
|
HID键盘输入模式(0~1), default 0
0: Hex key code
1: Ascii key code (English)
|
Response |
OK |
AT+HIDSEND - 通过HID发送数据¶
Command |
AT+HIDSEND=Param1,Param2 |
|
report length
|
|
report payload
|
Response |
OK |
Note |
For special key code:
0x0D -> ENTER
0x08 -> BACKSPACE
0x09 -> TAB
0x20 -> SPACE
|
Wi-Fi指令¶
AT+ROLE-查询/修改 Wi-Fi 模式¶
Command |
AT+ROLE{=Param} |
|
1: STA 模式
2: AP 模式
3: AP+STA共存模式
|
Response |
+ROLE=Param |
Description |
设置完成后模块会自动重启 |
AT+SCAN-扫描周围设备¶
Command |
AT+SCAN{=Param} |
|
0: 停止扫描操作
1: 扫描经典蓝牙设备
5: 扫描WiFi热点
|
Response |
+SCAN=Param1,Param2,Param3,Param4,Param5,Param6 |
|
扫描序号 |
|
扫描WiFi热点时:固定值 5; 扫描蓝牙设备时:RSSI |
|
扫描WiFi热点时:热点的MAC地址; 扫描蓝牙设备时:设备状态 |
|
扫描WiFi热点时:RSSI; 扫描蓝牙设备时:设备MAC地址 |
|
扫描WiFi热点时:热点名称长度; 扫描蓝牙设备时:设备名称 |
|
扫描WiFi热点时:热点名称; 扫描蓝牙设备时: 蓝牙设备类型 |
Description |
扫描周围WiFi热点时,模块需处于 STA 模式,即+ROLE=1
扫描结束后,会返回+SCAN=E
|
AT+RAP-连接热点¶
Command |
AT+RAP=<Param1>,<Param2>
|
|
热点的名称 |
|
热点的密码 |
Response |
OK |
Description |
1. 需在 STA 模式或共存模式下发送该指令,即+ROLE=1 或 3
2. 若需要连接加密方式为 OPEN 的热点,只设置第一个参数即可,如
AT+RAP=Feasycom
3. 发送 AT+RAP,可查询设置的热点名称
4、企业加密的热点请参考AT+EAPCFG指令
|
AT+LIP-查询模块 IP 地址¶
Command |
AT+LIP |
Response |
+LIP=Param |
|
IP 地址 |
Description |
当模块成功连上热点后,会获取到一个 IP 地址,否则返回”0.0.0.0” |
AT+MDNSEN - 查询/修改MDNS功能¶
Command |
AT+MDNSEN{=Param} |
|
0: 关闭MDNS功能(default)
1: 开启MDNS功能
|
Response |
+MDNSEN=Param |
AT+DHCP - 查询/修改DHCP模式¶
Command |
AT+DHCP{=Param} |
|
0:使用静态IP
1:使用动态IP(default)
|
Response |
+DHCP=Param |
Description |
使用静态IP进行连接时,需设置并保证静态IP、掩码、网关、DNS设置正确,否则网络通信可能存在问题 |
AT+SIP - 查询/修改静态IP¶
Command |
AT+SIP{=Param} |
|
IPV4地址 |
Response |
+SIP=Param |
Description |
只在静态IP模式下生效,即+DHCP=0 |
AT+GW - 查询/修改网关¶
Command |
AT+GW{=Param} |
|
IPV4地址 |
Response |
+GW=Param |
Description |
只在静态IP模式下生效,即+DHCP=0 |
AT+MASK - 查询/修改子网掩码¶
Command |
AT+MASK{=Param} |
|
IPV4地址 |
Response |
+MASK=Param |
Description |
只在静态IP模式下生效,即+DHCP=0 |
AT+DNS - 查询/修改DNS地址¶
Command |
AT+DNS{=Param} |
|
IPV4地址 |
Response |
+DNS=Param |
Description |
只在静态IP模式下生效,即+DHCP=0,如果DNS不匹配将无法访问外网 |
AT+APAC - 查询/修改上电自动连接热点¶
Command |
AT+APAC{=Param} |
|
0:关闭上电自动连接热点
1:开启上电自动连接热点(default)
|
Response |
+APAC=Param |
Description |
该指令在STA模式或STA+AP共存模式下生效,即+ROLE=1或3 |
AT+RSSI - 查询与热点之间的信号强度¶
Command |
AT+RSSI |
Response |
+RSSI=Param |
|
RSSI value (-99 ~ 0) |
Description |
未连接热点时,RSSI的查询结果为0 |
AT+MAC - 查询模块Wi-Fi MAC地址¶
Command |
AT+MAC |
Response |
+MAC=Param |
|
模块的Wi-Fi MAC地址(12 Bytes ASCII) |
Description |
MAC地址只支持查询, 不支持设置 |
AT+SCFG - 快速简易配网¶
Command |
AT+SCFG=Param |
|
1:开始简易配网 |
Response |
OK |
Note |
需搭配特定APP如ESPTOUCH使用 |
AT+LAP - 查询/修改AP模式参数¶
Command |
AT+LAP{=Param1,Param2,Param3} |
|
模块作为热点时的名称 |
|
模块作为热点时的密码 |
|
模块作为热点时的IP |
Response |
+LAP=Param1, Param2, Param3 |
Description |
若要将模块配置成 OPEN 加密方式的热点, 则第二个参数可以不用设置, 如AT+LAP=FSC-BW246-AP,192.168.1.1 |
AT+WLANC - 启动SOCKET/MQTT/WEBSOCKET¶
Command |
AT+WLANC=Param |
|
3:启动TCP/UDP/SSL等
4:连接MQTT或云平台
5:启动WEBSOCKET
|
Response |
OK |
Description |
需要在SOCKET连接或者MQTT连接参数都正确设置后再发此条指令 |
企业加密网络指令¶
AT+WFTYPE - 查询/修改网络连接类型¶
Command |
AT+WFTYPE{=Param} |
|
0: 无线WiFi连接方式,WEP,WPA/WPA2/WPA3 Personnal方式(默认)
1: 以太网连接
2: 无线WiFi连接方式, WPA/WPA2/WPA3 Enterprise方式
|
Response |
OK |
Description |
AT+EAPMODE - 查询/修改企业加密类型¶
Command |
AT+EAPMODE{=Param} |
|
1: EAP-TLS
2: EAP-PEAP
3: EAP-TTLS
|
Response |
OK |
Description |
AT+EAPCFG - 查询/修改企业加密连接参数¶
Command |
AT+EAPCFG{=Param1,Param2,param3,param4} |
|
热点的SSID |
|
EAP-TLS: 此参数不起作用,可任意设置(长度限制64字节)
EAP-PEAP/EAP-TTLS: 用户名(长度限制64字节)
|
|
EAP-TLS: 此参数不起作用,可任意设置(长度限制64字节)
EAP-PEAP/EAP-TTLS: 密码(长度限制64字节)
|
|
identity(长度限制32字节),用于身份校验,大多数情况下可任意设置 |
Response |
OK |
Description |
必须先设置企业加密类型(AT+EAPMODE)后再来查询/修改这个指令参数 |
AT+ROOTCA - 查询/修改服务器证书¶
Command |
AT+ROOTCA{=Param} |
|
证书内容(小于2500字节) |
Response |
OK |
Description |
证书需要是PEM格式,以—–BEGIN CERTIFICATE—–开始
以—–END CERTIFICATE—–结尾
|
AT+CLICERT - 查询/修改客户端证书¶
Command |
AT+CLICERT{=Param} |
|
证书内容(小于2500字节) |
Response |
OK |
Description |
证书需要是PEM格式,以—–BEGIN CERTIFICATE—–开始
以—–END CERTIFICATE—–结尾
|
AT+CLIKEY - 查询/修改客户端证书密钥¶
Command |
AT+CLIKEY{=Param} |
|
证书内容(小于2500字节) |
Response |
OK |
Description |
证书需要是PEM格式,以—–BEGIN RSA PRIVATE KEY—–开始
以—–END RSA PRIVATE KEY—–结尾
|
TCP/UDP指令¶
AT+SOCK - 查询和设置SOCKET¶
Command |
AT+SOCK{=Param1,Param2,Param3,Param4} |
|
协议类型(TCPS,TCPC,UDP,SSL) |
|
模块端口号 |
|
远端地址 |
|
远端端口号 |
Response |
+SOCK=Param1, Param2, Param3, Param4 |
Decription |
模块上电后默认开启TCP SERVER, 默认端口9100
将模块设置成 TCP server 时,Param3 和 Param4 可以缺省
将模块设置成 UDP 时,Param3 和 Param4 可以缺省
设置完成后需要使用指令AT+WLANC=3启动SOCKET
|
Note
可以使用此指令配置SOCKET,也可以根据具体的功能使用AT+TCPCSTART,AT+TCPCSTART,AT+UDPSTART等单独的控制指令
AT+WFSEND - 发送SOCKET数据给远端设备¶
Command |
AT+WFSEND=Param1,Param2,Param3 |
|
TCP/UDP连接的ID |
|
发送数据长度(不超过1460字节) |
|
发送数据内容 |
Response |
OK |
Description |
模块作为 TCP server 时,默认最多可以被 5 个远端 client 连接,则 5路连接的 ID 号分别为 0, 1, 2, 3, 4;
模块作为 TCP client 时,通信的 ID 号默认为5;
模块开启 UDP 时,通信的 ID 号默认为6。
|
AT+TCPSSTART - 开启一个TCP SERVER¶
Command |
AT+TCPSSTART=Param |
|
本地端口号 |
Response |
OK |
Description |
当前只支持开启一个TCP Server,Server默认支持5个Client连接
直接开启服务,不再需要调用AT+WLANC=3
|
AT+TCPSCLOSE - 关闭TCP SERVER¶
Command |
AT+TCPSCLOSE |
Response |
OK |
Description |
关闭需要等待一段时间,至多5s |
AT+TCPSINFO - 查询TCP SERVER的信息¶
Command |
AT+TCPSINFO |
Response |
+TCPSINFO=Param1,Param2,Param3 |
|
0: Server未开启
1: Server已开启
|
|
已连接的Client个数 |
|
当前Server的端口号 |
Description |
AT+TCPSLIST - 查询模块作为TCP Server时已经连接的Client列表¶
Command |
AT+TCPSLIST |
Response |
+TCPSLIST=Param1,Param2,Param3 |
|
序号 |
|
Client的IP地址 |
|
Client的端口号 |
Description |
如果没有设备连接则返回空 |
AT+TCPSSEND - TCP Server发数据¶
Command |
AT+TCPSSEND=Param1,Param2,Param3 |
|
序号(可以通过AT+TCPCLIST查询获取) |
|
数据长度 |
|
数据内容 |
Response |
OK |
Description |
AT+TCPCSTART - 开启一个TCP Client¶
Command |
AT+TCPCSTART=Param1,Param2,Param3 |
|
序号(0~2,默认只支持最多开启3个TCP Client) |
|
远端的IP地址 |
|
远端的端口号 |
Response |
OK |
Description |
同一个序号只能开启一个TCP Client,需要重新开启的话请先关闭当前的TCP Client
直接开启服务,不再需要调用AT+WLANC=3
|
AT+TCPCSEND - TCP Client发数据¶
Command |
AT+TCPCSEND=Param1,Param2,Param3 |
|
序号(可以通过AT+TCPSLIST查询获取) |
|
数据长度 |
|
数据内容 |
Response |
OK |
Description |
AT+TCPCLIST - 查询模块作为TCP Client的连接列表¶
Command |
AT+TCPCLIST |
Response |
+TCPCLIST=Param1,Param2,Param3 |
|
序号 |
|
远端Server的IP地址 |
|
远端Server的端口号 |
Description |
如果没有设备连接则返回空 |
AT+TCPCCLOSE - 关闭TCP Client¶
Command |
AT+TCPCCLOSE=Param |
|
序号 |
Response |
OK |
Description |
关闭需要等待一段时间,至多5s |
AT+UDPSTART - 开启一个UDP¶
Command |
AT+UDPSTART=Param1,Param2,Param3 |
|
序号(0~2,默认只支持最多开启3个UDP) |
|
本地端口号 |
Response |
OK |
Description |
同一个序号只能开启一个UDP,需要重新开启的话请先关闭当前的UDP
直接开启服务,不再需要调用AT+WLANC=3
|
AT+UDPCLOSE - 关闭UDP¶
Command |
AT+UDPCLOSE=Param |
|
序号 |
Response |
OK |
Description |
AT+UDPSEND - UDP发数据¶
Command |
AT+UDPSEND=Param1,Param2,Param3,Param4 |
|
远程IP地址 |
|
远程端口号 |
|
数据长度 |
|
数据内容 |
Response |
OK |
Description |
远程IP地址和远程端口号设置为0则表示发送到最近一次接受到数据的远程地址和端口号 |
WEBSOCKET指令¶
AT+WSURI - 查询/修改WEBSOCKET地址¶
Command |
AT+WSURI=Param |
|
远端Server地址; |
Response |
+WSURI=Param |
Note |
Param地址格式为需要以ws://开头, 如果需要指定端口的话, 在地址后面跟:指定端口 |
Description |
模块暂时不开放wss支持,如有需要请联系技术支持 |
AT+WSSEND - 发送websocket数据¶
Command |
AT+WSSEND=Param1,Param2 |
|
数据长度 |
|
数据 |
Response |
OK |
Description |
向WEBSOCKET服务器发送数据 |
AT+WSCLOSE - 关闭WEBSOCKET¶
Command |
AT+WSCLOSE |
Response |
OK |
Description |
断开跟远程的WEBSOCKET连接 |
AT+WSSTAT - 查询WEBSOCKET状态¶
Command |
AT+WSSTAT |
Response |
+WSSTAT=Param1 |
Description |
返回WEBSOCKET状态 |
HTTP指令¶
AT+HEADER - 查询/修改HTTP请求头¶
Command |
AT+HEADER{=Param} |
Response |
+WSSTAT=Param1 |
Description |
由多个请求头时,以逗号隔开,设置完后需调用AT+CLRHEADER手动清除或下次重启后会自动清除 |
AT+CLRHEADER - 清除HTTP请求头¶
Command |
AT+CLRHEADER |
Response |
OK |
Description |
清除设置的HTTP请求头 |
AT+HTTP - 访问HTTP服务器¶
Command |
AT+HTTP=Param1,Param2,Param3{,Param4} |
|
请求方法, 目前只支持GET和POST |
|
服务器地址(需要包括http://或https://) |
|
GET模式下断点续传支持,可缺省,格式为Range:bytes=起始字节-终止字节,也可以在指令AT+HEADER里设置 |
Response |
OK |
Description |
HTTP服务器默认访问端口为80, HTTPS服务器默认访问端口为443,如果需要修改访问端口, 请在服务器地址后面跟:指定端口, 例如指定端口为778, 则可以用192.168.0.179:778
|
Note
用户可用httpbin.org 进行测试
SSL指令¶
AT+SSLCONN - 查询/开启SSL连接¶
Command |
AT+SSLCONN{=Param1,Param2} |
|
远程服务器地址或域名 |
|
远程服务器端口 |
Response |
+SSLCONN=Param1,Param2 |
Description |
直接开启服务,不再需要调用AT+WLANC=3 |
AT+SSLSEND - 发送SSL数据给远端服务器¶
Command |
AT+SSLSEND=Param1,Param2 |
|
发送数据长度 |
|
发送数据内容 |
Response |
OK |
Description |
AT+SSLSTAT - 查询SSL连接状态¶
Command |
AT+SSLSTAT |
Response |
+SSLSTAT=Param |
|
(0) 未初始化
(1) 未连接
(2) 连接中
(3) 已连接
|
Description |
AT+SSLCLOSE - 关闭SSL连接¶
Command |
AT+SSLCLOSE |
Response |
OK |
Description |
MQTT指令¶
AT+BROKER - 查询/修改MQTT broker地址¶
Command |
AT+BROKER{=Param} |
|
MQTT服务器地址 |
Response |
+BROKER=Param |
Description |
用户可用broker.emqx.io进行测试 |
AT+CLIENTID -查询/修改 MQTT client ID¶
Command |
AT+CLIENTID{=Param} |
|
MQTT Client ID |
Response |
+CLIENTID=Param |
Description |
CLIENTID需要是唯一的以避免跟其它设备冲突 |
AT+USERNAME - 查询/修改MQTT USERNAME¶
Command |
AT+USERNAME{=Param} |
|
MQTT USERNAME |
Response |
+USERNAME=Param |
AT+MQTTPWD - 查询/修改MQTT PASSWORD¶
Command |
AT+MQTTPWD{=Param} |
|
MQTT PASSWORD |
Response |
+MQTTPWD=Param |
AT+SUBTPC - 查询/订阅 MQTT主题¶
Command |
AT+SUBTPC{=Param1,Param2} |
|
Topic |
|
QOS值, 只能为0,1或者2 |
Response |
+SUBTPC=Param1,Param2 |
Note
重复订阅同名TOPIC,指令会返回错误
当前最大支持订阅3个不同Topic,如不满足使用需求,在实际使用中建议用户先搭配通配符使用
AT+UNSUBTPC - 取消订阅 MQTT主题¶
Command |
AT+UNSUBTPC=Param |
|
指定需要取消订阅的Topic |
Response |
OK |
Description |
取消订阅主题不需要指定QOS值 |
AT+UNSUBALL - 取消订阅全部MQTT主题¶
Command |
AT+UNSUBALL |
Response |
OK |
AT+MQTTCONN - 开始连接MQTT服务器¶
Command |
AT+MQTTCONN |
Response |
OK |
Description |
等同于AT+WLANC=4,需要先设置好连接参数后再发此条指令 |
AT+MQTTCLOSE - 关闭MQTT连接¶
Command |
AT+MQTTCLOSE |
Response |
OK |
Description |
AT+MQTTSEND - 发送MQTT数据¶
Command |
AT+MQTTSEND=Param1,Param2,Param3,Param4 |
|
发布主题 |
|
QOS(0,1,2) |
|
数据长度 |
|
数据内容 |
Response |
OK |
AT+MQTTPORT - 查询/修改 MQTT端口¶
Command |
AT+MQTTPORT{=Param} |
|
MQTT端口值, 默认为1883 |
Response |
+MQTTPORT=Param |
Descrirtion |
需要根据服务器实际端口来设置 |
AT+MQTTSTAT - 查询MQTT状态¶
Command |
AT+MQTTSTAT |
Response |
+MQTTSTAT=Param |
|
(0) 未初始化
(1) 未连接
(2) 连接中
(3) 已连接
|
Descrirtion |
AT+MQTTKAI - 查询/修改 MQTT保活心跳时间¶
Command |
AT+MQTTKAI{=Param} |
|
MQTT保活时间, 单位为秒, 默认为120秒 |
Response |
+MQTTKAI=Param |
Note
请根据实际平台的使用限制来设置, 常见平台如阿里云的MQTT保活时间要求为30秒~1200秒
当设备意外断开连接超过{保活心跳时间*1.5}时,服务器会自动断开连接
固件升级(远程OTA)¶
AT+OTA - 远程OTA¶
Command |
AT+OTA=Param |
|
需要升级的固件名 |
Response |
OK |
Description |
固件存放在飞易通服务器,由相关人员提供固件版本,升级成功后模块会返回$OTA=1 |
AT+FOTA - 自定义服务器远程OTA¶
Command |
AT+FOTA=Param |
|
需要升级的固件路径 |
Response |
OK |
Description |
升级成功后模块会返回$OTA=1 |
Note
升级过程中不要操作其它指令或者功能,不然可能会导致升级失败或者意外的情况
Events表¶
MQTT指示¶
+MQTTSTAT - MQTT状态¶
Format |
+MQTTSTAT=Param |
|
(0) 未初始化
(1) 未连接
(2) 连接中
(3) 已连接
|
+MQTTDATA - MQTT接收数据¶
Format |
+MQTTDATA=Param1,Param2,Param3 |
|
Topic |
|
Payload length |
|
Payload |
WEBSOCKET指示¶
+WSSTAT - WEBSOCKET状态¶
Format |
+WSSTAT=Param |
|
CLient状态 | (0) 未初始化 | (1) 未连接 | (2) 连接中 | (3) 已连接 |
+WSDATA - WEBSOCKET接收数据¶
Format |
+WSDATA=Param1,Param2 |
|
Payload length |
|
Payload |
SSL指示¶
+SSLSTAT - SSL Client状态¶
Format |
+SSLSTAT=Param |
|
(0) 未初始化
(1) 未连接
(2) 连接中
(3) 已连接
|
+SSLDATA - SSL接收数据¶
Format |
+SSLDATA=Param1,Param2 |
|
Payload length |
|
Payload |
TCP/UDP指示¶
+TCPCDATA - 模块作为TCP Client接收到的数据¶
Format |
+TCPCDATA=Param1,Param2,Param3 |
|
本地Client连接的序号 |
|
Payload length |
|
Payload |
+TCPSDATA - 模块作为TCP Server接收到的数据¶
Format |
+TCPSDATA=Param1,Param2,Param3 |
|
远端Client连接的序号 |
|
Payload length |
|
Payload |
+UDPDATA - 模块接收到UDP数据¶
Format |
+TCPSDATA=Param1,Param2,Param3,Param4 |
|
远端的IP地址 |
|
远端的端口 |
|
Payload length |
|
Payload |
+VER - 模块上报版本号¶
Format |
+VER=Param |
|
版本号信息 |
GATT指示¶
+GATTSTAT - GATT状态¶
Format |
+GATTSTAT=Param |
|
(0) 未初始化
(1) 未连接
(2) 连接中
(3) 已连接
|
+GATTDATA - GATT接收数据¶
Format |
+GATTDATA=Param1,Param2 |
|
Payload length |
|
Payload |
SPP指示¶
+SPPSTAT - SPP状态¶
Format |
+SPPSTAT=Param |
|
(0) 未初始化
(1) 未连接
(2) 连接中
(3) 已连接
|
+SPPDATA - SPP接收数据¶
Format |
+SPPDATA=Param1,Param2 |
|
Payload length |
|
Payload |
+PAIRREQ - 蓝牙配对请求¶
Format |
+PAIRREQ=Param1,Param2,Param3 |
|
配对码 |
|
配对设备的MAC地址 |
|
设备名 |
+PAIRED - 蓝牙配对结果¶
Format |
+PAIRED=Param1,Param2,Param3 |
|
状态 |
|
配对设备的MAC地址 |
|
设备名 |
HID指示¶
+HIDSTAT - HIDSTAT状态¶
Format |
+HIDSTAT=Param |
|
(0) 未初始化
(1) 未连接
(2) 连接中
(3) 已连接
|
应用场景¶
TCP server 应用¶
Note
说明:若要使用数据透传,在设置 Wi-Fi 模式前发送 AT+TPMODE=1 即可。
TCP Client应用¶

Note
说明:若要使用数据透传,在设置 Wi-Fi 模式前发送 AT+TPMODE=1 即可。
UDP应用¶
Note
若要使用数据透传,在设置 Wi-Fi 模式前发送 AT+TPMODE=1 即可。
SSL Client应用¶
Note
说明:若要使用数据透传,在设置 Wi-Fi 模式前发送 AT+TPMODE=1 即可。
MQTT应用¶
企业加密网络应用¶
已连接模式下透传模式的切换¶
Note
透传模式只在蓝牙、TCP/UDP等已连接的情况下生效,所以退出透传的方法也只在这种情况下生效, 正常情况直接发送指令就行
注意以上收发的数据格式有别于AT正常指令, 正常AT指令是以**<CR><LF>**结尾的, 而以上数据不附带任何结束符
配网及空中升级¶
指令的方式空中升级¶
Note
空中升级固件存于特定服务器上, 并与模块绑定, 可按客户需求更换服务器地址或升级方式
因为要访问特定服务器, 所以需要热点支持访问外网
FeasyWiFi配网及OTA使用说明¶




Note
需要热点支持访问外网
微信小程序配网及OTA使用说明¶





Note
需要热点支持访问外网
附录¶
下载 PDF版本¶
下载PDF版本