FSC-BW236 指令手册

介绍

描述

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

模组默认参数

Bluetooth Mode	LE-Peripheral
Bluetooth Name	FSC-BW236-LE
Wi-Fi Mode	STA Mode
Local AP SSID	FSC-BW236-AP
Local AP Password	12345678
Local AP IP Address	192.168.1.1
UART Baudrate	115200/8/N/1

硬件说明

引脚图

引脚描述

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

支持蓝牙协议

GATTS (Generic Attribute Profile LE-Peripheral role)
GATTC (Generic Attribute Profile LE-Central role)

支持Wi-Fi协议

TCP (Transmisson Control Protocol)
UDP (USER Datagram Protocol)
HTTP (Hypertext Transfer Protocol)
MQTT (Message Queuing Telemetry Transport)
WEB SOCKET

指令说明

规范说明

适用于整个文档

{} : 包括与{…}中的内容为可选项
<< : 主机发给模组的 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
>> +VER=FSC-BW236,V4.2.5
>> OK

当在蓝牙没有连接的情况下通过蓝牙发数据
<< AT+GATTSEND=3,123
>> ERR003

Event格式

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

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

Example:
手机端通过GATT协议发送”1234567890”
>> +GATTDATA=10,1234567890

指令表

通用指令

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+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, 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
>> {具体数据}

访问内部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

应用场景

TCP Server应用

@startuml
hide footbox
skinparam sequenceMessageAlign center

box #LightBlue
actor “ ” as person
participant “USER MCU” as mcu
participant MODULE as module
participant " " as nu
participant "TCP Client" as client
end box

person ->> mcu: 开始操作
mcu -> module: AT+ROLE=1
note left
切换到STA模式
end note
module --> mcu: OK
mcu -> module: AT+RAP=SSID,PASSWORD
note left
连接热点
end note
module --> mcu: OK
group LOOP查询直到获取到IP地址
mcu -> module: AT+LIP
note left
查询模块IP地址
end note
module --> mcu: +LIP=0.0.0.0
note right
没有连上热点
end note
end
module --> mcu: +LIP=192.168.0.87
note right
连上热点
end note
mcu --> module: AT+SOCK=TCPS,9100
note left
将模块设置
成TCP Server
end note
module --> mcu: OK
mcu --> module: AT+WLANC=3
note left
模块启动TCP Server
end note
module --> mcu: OK

client -> nu: 客户端发起连接
nu -> module: 模块被连接
client -> nu: 客户端发数\n据:1234567890
module --> mcu: +WFDATA=0,10,1234567890
note right
模块将接收到
的数据输出
end note
mcu --> module: AT+WFSEND=0,3,abc
note left
模块发数据给远端
end note
module --> mcu: OK
nu -> client: abc
@enduml

具体指令流程说明
1、切换到STA模式, 如果已经处于STA模式, 则可以省略这条指令
<< AT+ROLE=1
>> OK

2、开始连接热点
<< AT+RAP=ssid,password
>> OK

3、查询IP判断是否连上热点,如果能获取到IP则表示已经连上
<< AT+LIP
>> +LIP=192.168.0.87

4、将模块配置为TCP Server,并设置端口号9100
<< AT+SOCK=TCPS,9100
>> OK

5、启动TCP Server
<< AT+WLANC=3
>> OK

6、发送数据
<< AT+WFSEND=0,3,123
>> OK

7、接收数据

<< +WFDATA=0,10,1234567890

Note

若要使用数据透传，在设置 Wi-Fi 模式前发送 AT+TPMODE=1 即可
模块默认处于STA模式,步骤1可省略
模块默认会开启一个端口号为9100的TCP server,步骤4和5可省略

TCP Client应用

具体指令流程说明
1、切换到STA模式, 如果已经处于STA模式, 则可以省略这条指令
<< AT+ROLE=1
>> OK

2、开始连接热点
<< AT+RAP=ssid,password
>> OK

3、查询IP判断是否连上热点,如果能获取到IP则表示已经连上
<< AT+LIP
>> +LIP=192.168.0.87

4、将模块配置为TCP Client,并设置模块端口号9100,同时配置远端Server地址和端口号
<< AT+SOCK=TCPC,9100,192.168.0.100,6000
>> OK

5、启动TCP Client
<< AT+WLANC=3
>> OK

6、发送数据
<< AT+WFSEND=3,3,123
>> OK

7、接收数据

<< +WFDATA=3,10,1234567890

Note

若要使用数据透传，在设置 Wi-Fi 模式前发送 AT+TPMODE=1 即可
模块默认处于STA模式,步骤1可省略
模块连接远端服务器时, 需要保证远端服务器端口可访问, 如关闭网络防火墙等

UDP应用

具体指令流程说明
1、切换到STA模式, 如果已经处于STA模式, 则可以省略这条指令
<< AT+ROLE=1
>> OK

2、开始连接热点
<< AT+RAP=ssid,password
>> OK

3、查询IP判断是否连上热点,如果能获取到IP则表示已经连上
<< AT+LIP
>> +LIP=192.168.0.87

4、将模块配置为UDP
<< AT+SOCK=UDP,4000
>> OK

5、启动UDP
<< AT+WLANC=3
>> OK

6、发送数据
<< AT+WFSEND=4,3,123
>> OK

7、接收数据

<< +WFDATA=4,10,1234567890

Note

若要使用数据透传，在设置 Wi-Fi 模式前发送 AT+TPMODE=1 即可

MQTT应用

具体指令流程说明
1、切换到STA模式, 如果已经处于STA模式, 则可以省略这条指令
<< AT+ROLE=1
>> OK

2、开始连接热点
<< AT+RAP=ssid,password
>> OK

3、查询IP判断是否连上热点,如果能获取到IP则表示已经连上
<< AT+LIP
>> +LIP=192.168.0.87

4、设置MQTT服务器地址,可以是网址或者IP地址
<< AT+BROKER=gpssensor.ddns.net
>> OK

5、设置MQTT服务器端口
<< AT+MQTTPORT=1883
>> OK

6、设置CLIENTID
<< AT+CLIENTID=BW236
>> OK

7、设置用户名
<< AT+USERNAME=admin
>> OK

8、设置密码
<< AT+MQTTPWD=12345678
>> OK

9、订阅MQTT主题
<< AT+SUBTPC=topic,0
>> OK

10、启动MQTT
<< AT+WLANC=4
>> OK

11、接收数据

<< +MQTTDATA=topic,10,1234567890

12、发送数据

<< AT+MQTTSEND=topic,0,3,abc

Note

需要先订阅主题再发起连接
需要MQTTMODE=0,即普通MQTT服务器模式
如果服务器开启了SSL/TLS, 在连接前需要增加设置指令AT+MQTTS=1
其它设置请参考MQTT指令部分说明

阿里云平台应用

具体指令流程说明
1、切换到STA模式, 如果已经处于STA模式, 则可以省略这条指令
<< AT+ROLE=1
>> OK

2、开始连接热点
<< AT+RAP=ssid,password
>> OK

3、查询IP判断是否连上热点,如果能获取到IP则表示已经连上
<< AT+LIP
>> +LIP=192.168.0.87

5、将模块配置连接阿里云
<< AT+MQTTMODE=1
>> OK

6、设置三元组之Device Name
<< AT+DEVNAME=name
>> OK

7、设置三元组之ProductKey
<< AT+PROKEY=key
>> OK

8、设置三元组之DeviceSecret
<< AT+DEVSECRET=secret
>> OK

9、订阅主题,可订阅多个
<< AT+SUBTPC=topic,qos
>> OK

10、发起连接
<< AT+WLANC=4
>> OK

11、发送数据
<< AT+MQTTSEND=topic,3,abc
>> OK

12、接收数据

<< +MQTTDATA=topic,10,1234567890

Note

MQTT正式连接AT+WLANC=4之前, 必须至少先订阅一个主题
模块默认处于STA模式,步骤1可省略

已连接模式下透传模式的切换

具体指令流程说明
当透传模式开启时, 任何指令都会被当作数据传输, 模块提供了一种方法退出透传模式以发送指令
首先给模块发送+++,此时模块会应答一个a, 再收到模块应答的a之后, 再给模块发送一个a, 就可以暂时退出透传模式了

<< +++
<< a
>> a
>> +ok

Note

透传模式只在蓝牙、TCP/UDP等已连接的情况下生效,所以退出透传的方法也只在这种情况下生效, 正常情况直接发送指令就行
注意以上收发的数据格式有别于AT正常指令, 正常AT指令是以**<CR><LF>**结尾的, 而以上数据不附带任何结束符

配网及空中升级

指令的方式空中升级

具体指令流程说明
1、切换到STA模式, 如果已经处于STA模式, 则可以省略这条指令
<< AT+ROLE=1
>> OK

2、开始连接热点
<< AT+RAP=ssid,password
>> OK

3、查询IP判断是否连上热点,如果能获取到IP则表示已经连上
<< AT+LIP
>> +LIP=192.168.0.87

4、开始升级,固件名由工程师或相关人员提供
<< AT+OTA=Feasycom_V555
>> OK
>> $OTA=1

Note

空中升级固件存于特定服务器上, 并与模块绑定, 可按客户需求更换服务器地址或升级方式
因为要访问特定服务器, 所以需要热点支持访问外网

FeasyWiFi配网及OTA使用说明

具体流程说明

1、在APP STORE或者应用商城下载FeasyWiFi APP

2、进入APP界面, 搜索连接目标模块蓝牙

2、正确连接后会跳转到如下界面, 先点击蓝牙配网

3、在蓝牙配网界面输入热点名称和密码, 点击开始配网

4、配网成功后返回到上一界面, 选择OTA升级, 此时应可以查询到IP地址, 输入需要升级的点升级即可

Note

需要热点支持访问外网

微信小程序配网及OTA使用说明

具体流程说明

1、微信搜索打开小程序”蓝牙串口”小程序，界面如下,点击下面的设置按钮

2、设置界面如下, 点击WiFi模块设置 (其中蓝牙指令工具用于发送空中指令, 即以蓝牙的方式发送AT指令,对模块进行配置)

3、先进行蓝牙配网

4、蓝牙连接需要升级的设备, 进入到配网界面，输入需要来连接的热点和密码后，点击确定

5、配网成功后, 返回到上一界面, 选择空中升级, 输入需要升级的固件, 点击确定, 等待升级结束

Note

需要热点支持访问外网

附录

下载 PDF版本

下载PDF版本