FSC-BT910x 通用数传应用 AT 命令集

描述

本设计指南适用于工程师开发 FSC-BT910x 系列蓝牙模组。

模块默认参数

Name	FSC-BT9101
LE-Name	FSC-BT9101-LE
Pin Code	0000
Secure Simple Pairing Mode	Off
Service UUID	FFF0
Write UUID	FFF2
Notify UUID	FFF1
UART Baudrate	115200/8/N/1

指令说明

规范说明

适用于整个文档

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

指令格式

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

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

Example：读取模块蓝牙名称

发送: <<AT+NAME<CR><LF>
响应: >><CR><LF>+NAME=FSC-BT9101<CR><LF>
响应：>><CR><LF>OK<CR><LF>

写入不支持的波特率

发送: <<AT+BAUD=0<CR><LF>
响应: >><CR><LF>ERROR<CR><LF>

Event格式

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

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

Example: 指令模式下返回当前SPP连接状态

响应: >><CR><LF>+SPPSTAT=3<CR><LF>

指令表

通用指令

AT+HELP - 查询固件功能和命令说明

Command	AT+HELP
Response	<MODULE DEFAULT PARAMETER> <COMMAND SUMMARY: DESCRIPTION: PROFILE CATEGORY>
Description	使用help命令获取基本摘要信息

AT - 串口通信测试

Command	AT
Response	OK
Description	当上电或更改波特率时，测试主机和模块之间的UART通讯

Example:
<< AT
>> 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+BTEN - 读/写当前蓝牙工作模式

Command	AT+BTEN{=Param}
`Param`	使能蓝牙(0/1,default:0) 0: 断开所有连接，禁用可发现/可连接 1: 启用发现/接入
Response	+BTEN=Param
Description	读/写当前蓝牙工作模式

AT+NAME - 读/写BR/EDR蓝牙名称

Command	AT+NAME{=Param{,Param1}}
`Param`	BR/EDR蓝牙名称(1~29 Bytes ASCII)
`Param1`	使能MAC地址后缀(0~2,default:0) 0: 关闭后缀 1: 开启后缀“XXXX”(MAC地址后4Byte) 2: 开启后缀“XXXXXX”(MAC地址后6Byte)
Response	+NAME=Param
`Param`	蓝牙名称
Description	设置蓝牙BR/EDR蓝牙名称,使用子参数来显示地址后缀

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

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

读取BR/EDR蓝牙名称
<< AT+NAME
>> +NAME=ABC-XXXX
>> OK

AT+LENAME - 读/写BLE蓝牙名称

Command	AT+LENAME{=Param{,Param1}}
`Param`	BLE蓝牙名称(1~29 Bytes ASCII)
`Param1`	使能MAC地址后缀(0~2,default:0) 0: 关闭后缀 1: 开启后缀“-XXXX”(MAC地址后4Byte) 2: 开启后缀“-XXXXXX”(MAC地址后6Byte)
Response	+LENAME=Param
`Param`	蓝牙名称
Description	设置蓝牙BLE蓝牙名称,使用子参数来显示地址后缀

AT+PIN - 读/写配对密码

Command	AT+PIN{=Param}
`Param`	配对密码(4~15 Bytes ASCII, default:0000)
Response	+PIN=Param
Description	当+SSP=0时,配对密码有效

Example:
查询配对密码
<< AT+PIN
>> +PIN=0000
>> OK

修改配对密码为 1234
<< AT+PIN=1234
>> OK

AT+PLIST - 读取/清除配对记录

Command	AT+PLIST{=Param}
`Param`	(0 / 1~8) (0) 清除所有配对记录 (1~8) 清除指定索引的配对记录
Response1	+PLIST=Param, Param1
`Param`	(1~8) 配对设备序号
`Param1`	(MAC)配对设备的MAC地址
Response2	+PLIST= 配对记录查询完成
Description	如果存在参数则删除对应配对信息，否则只是读取配对列表

Example:读模块的配对记录
<< AT+PLIST
>> +PLIST=1,1C5CF226D773
+PLIST=2,A0BC30075421
>> OK

Example:清除模块的所有配对记录
<< AT+PLIST=0
>> OK

AT+BAUD - 读/写串口波特率

Command	AT+BAUD{=Param}
`Param`	波特率(9600/19200/38400/57600/115200/ 230400/460800/921600/256000/512000/1000000, default:115200)
Response	+BAUD=Param
`Param`	波特率
Description	模块将在接收到这条指令后，切换波特率
Note	发送完设置波特率指令后,请切换设置的串口波特率再与模块通信

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

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

AT+VER - 读取固件版本

Command	AT+VER
Response	+VER{=Param,Param1}
`Param`	固件版本
`Param1`	模块型号

Example:
<< AT+VER
>> +VER=8.0.0,FSC-BT9101
>> OK

AT+ADDR - 读BR/EDR蓝牙MAC地址

Command	AT+ADDR
Response	+ADDR=Param
`Param`	模块的BR/EDR蓝牙MAC地址(12 Bytes ASCII)

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

AT+LEADDR - 读BLE蓝牙MAC地址

Command	AT+LEADDR
Response	+LEADDR=Param
`Param`	模块的BLE蓝牙MAC地址(12 Bytes ASCII)

AT+COD: 读/写设备类型

Command	AT+COD=Param
`Param`	设备类型(6 bytes ASCII, default:240404 Handsfree device)
Response	+COD=Param
Note	修改COD后需要重启模块，用于重置COD

AT+TPMODE - 打开/关闭透传模式

Command	AT+TPMODE{=Param}
`Param`	模式（0~1，默认0） 0: 指令模式 1: 透传模式
Response	+TPMODE=Param
Description	当在SPP/GATT协议下连接并且打开透传模式时，AT指令将会被禁用，通过UART接收的每个字节将被发送到远端

AT+FLOWCTL - 开启/关闭串口流控

Command	AT+FLOWCTL{=Param}
`Param`	参数（0~1，default0） 0: 关闭流控 1: 开启流控
Response	+FLOWCTL=Param
Description	打开/关闭串口流控

AT+SSP - 开启/关闭简易配对

Command	AT+SSP{=Param}
`Param`	PROFILE mode (0~1, default:0) 0: 关闭SSP 1: 开启SSP
Response	+SSP=Param
Note	重启生效

AT+MODE - 读/写蓝牙PROFILE

Command	AT+MODE{=Param}
`Param`	Pairing mode (0~4, default:4) (0) NONE PROFILE (1) SPP PROFILE (2) HID PROFILE (3) BLE PROFILE (4) ALL PROFILE
Response	+MODE=Param

AT+AUTOCONN - 设置蓝牙上电重连

Command	AT+AUTOCONN{=Param}
`Param`	0: 关闭自动重连 1: 开启自动重连
Response	+AUTOCONN=Param
Description	上电后，模块将根据设置PROFILE尝试与配对列表中的设备建立连接

AT+PIOCFG - 开启/关闭IO口控制模块

Command	AT+PIOCFG{=Param,Param1}
`Param`	0: 禁用命令/传输模式切换功能 1: 启用命令/传输模式切换功能
`Param1`	0: 禁用蓝牙断开功能 1: 启用蓝牙断开功能
Response	+PIOCFG=Param
Description	用引脚控制传输模式和连接状态
Note	改变状态重启生效

AT+DSCA - 断开所有连接

Command	AT+DSCA
Description	模块断开与远程设备的所有蓝牙连接，在指令模式下使用

AT+SCAN - 搜索附近的设备

Command	AT+SCAN{=Param{,Param1}}
`Param0`	扫描方式（0~2） 0: 停止扫描 1: 扫描附近BR/EDR设备 2: 扫描附近BLE设备
`Param1`	(1~48)扫描时间. unit:1.28s, default:12.8s
Description	格式说明参考: +SCAN - 扫描结果

AT+SECURITY - 打开/关闭安全验证

Command	AT+SECURITY{=Param}
`Param`	模式（0~1，default：0） 0: 未开启安全验证 1: 开启安全验证
Response	+SECURITY=Param
Description	打开/关闭安全验证
Note	重启生效

Example:
设置开启安全验证
<< AT+SECURITY=1
>> OK

获取安全验证信息
<< AT+SECURITY
>> +SECURITY=1
OK

AT+TXPOWER - 读/写发射功率

Command	AT+TXPOWER{=Param}
`Param`	发射功率（0~6,default：3） 0: -12dBm 1: -8dBm 2: -4dBm 3: 0dBm 4: 4dBm 5: 8dBm 6: 10dBm
Response	+TXPOWER=Param
`Param`	发射功率
Description	修改发射功率,命令设置后重启生效

Example:
读取发射功率
<< AT+TXPOWER
>> +TXPOWER=3
>> OK

设置发射功率10dbm
<< AT+TXPOWER=6
>> OK

AT+UARTCFG - 读/写串口配置

Command	AT+UARTCFG{=Param}
`Param`	配置 (0~5，default：0) bit0: 0 - 1位停止位 1 - 2位停止位 bit2~bit1: 00 - None 01 - Odd 10 - Even
Response	+UARTCFG=Param
`Param`	配置 (0~5)
Description	修改串口配置(停止位和校验位)

Example:
获取当前UART配置
<< AT+UARTCFG=0
>> OK

设置串口奇校验
<< AT+UARTCFG=2
>> OK

AT+LINKCFG - 自动搜索链接配置

Command	AT+LINKCFG{=Param}
`Param`	配置 (0~2，default：0) 0:关闭自动搜索链接 1:spp自动搜索链接 2:ble自动搜索链接
Description	若配置该指令模块会根据配置自动搜索链接

AT+RSSICFG - 读/写RSSI配置

Command	AT+RSSICFG{=Param{,Param1}}
`Param`	高rssi值
`Param1`	低rssi值
Description	信号强度大于 `Param` 时PIN34脚置低信号强度小于 `Param1` 时PIN34脚置高信号强度处于 `Param` ~ `Param1` 时电平不变

Example:配置-30~-60信号强度提示
<< AT+RSSICFG=30,60
>> OK

SPP指令

AT+SPPSTAT - 读SPP状态

Command	AT+SPPSTAT
Response	+SPPATAT=Param
Description	格式说明参考: +SPPSTAT - SPP状态

AT+SPPCFG - 读/写SPP配置

Command	AT+SPPCFG{=Param}
`Param`	配置(0~1, default:0) 0:关闭spp动态注册 0:开启spp动态注册
Response	+SPPCFG=Param
Description	开启动态注册后模块会在连接时注册spp服务断开时注销spp服务

AT+SPPCONN - 建立SPP连接

Command	AT+SPPCONN{=Param}
`Param`	目标设备MAC地址(12 Bytes ASCII)

Example:向112233445566地址的蓝牙发起连接
<< AT+SPPCONN=112233445566
>> OK

AT+SPPDISC - 断开SPP连接

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

AT+SPPSEND - 通过SPP发数据

Command	AT+SPPSEND{=Param{,Param1}}
`Param`	Payload length (1~236)
`Param1`	Payload (1~236 Bytes UTF8)
Description	如果透传模式开启，该指令将会被禁用

Example: 通过SPP给远程设备发送数据 “1234567890”
<< AT+SPPSEND=10,1234567890
>> OK

GATT指令

AT+GATTSTAT - 读GATT状态

Command	AT+GATTSTAT
Response	+GATTATAT=Param
Description	格式说明参考: +GATTSTAT - 连接状态上报

AT+ADVADDR - 打开/关闭广播地址

Command	AT+ADVADDR{=Param}
`Param`	模式（0~1，default:1） 0: 关闭广播地址 1: 开启广播地址
Response	+ADVADDR=Param
Description	打开/关闭广播地址

AT+IBEACON - 打开/关闭ibeacon广播

Command	AT+IBEACON{=Param}
`Param`	模式（0~1，default:0） 0: 关闭ibeacon广播 1: 开启ibeacon广播
Response	+IBEACON=Param
Description	打开/关闭ibeacon广播

AT+ADVDATA - 读/写BLE广播0xFF的数据

Command	AT+ADVDATA{=Param}
`Param`	厂商自定义广播数据(数据长度不超过26)
Response	+ADVDATA=Param
`Param`	tag为0xFF的广播数据
Description	厂商自定义广播数据tag为0xFF
Note	需要模块广播自定义数据请设置AT+IBEACON=1后设置自定义广播数据

Example:
查询厂商自定义广播数据内容，\x为十六进制数据
<< AT+ADVDATA
>> +ADVDATA=\x03\x01\x02
>> OK

查询厂商自定义广播数据内容，\x为十六进制数据
<< AT+ADVDATA=\x03\x01\x02
>> OK

AT+ADBLE - 打开/关闭AndroidBLE

Command	AT+ADBLE{=Param}
`Param`	模式（0~1，default:1） 0: 关闭AndroidBLE 1: 开启AndroidBLE
Response	+ADBLE=Param
Description	开启后SPP和BLE地址会是两个地址 \| 关闭 SPP和BLE地址会一个地址

AT+UUIDCFG - 读/写UUID

Command	AT+UUIDCFG{=Param{,Param1}{,Param2}}
`Param`	service UUID (defalut: 0000)
`Param1`	write UUID (defalut: 0000)
`Param2`	notify UUID (defalut: 0000)
Response	+UUIDCFG=Param1,Param2,Param3
Description	自定义数据传输复位的UUID,支持32/128位UUID. 为默认参数时： service UUID = 0xFFF0 write UUID = 0XFFF2 notify UUID = 0XFFF1

AT+GATTSEND - 通过GATT发数据

Command	AT+GATTSEND{=Param{,Param1}}
`Param`	Payload length (1~236)
`Param1`	Payload (1~236 Bytes UTF8)
Description	如果透传模式开启，该指令将会被禁用

Example: 通过GATT给远程设备发送数据 “1234567890”
<< AT+GATTSEND=10,1234567890
>> OK

AT+LESTAT - 读LE状态

Command	AT+LESTAT
Response	+LEATAT=Param
Description	格式说明参考: +LESTAT - 连接状态上报

AT+LECCONN - 向指定地址发起连接

Command	AT+LECCONN{=Param{,Param1}{,Param2}{,Param3}}
`Param`	12字节设备地址+1字节地址类型
`Param1`	通信服务UUID
`Param2`	通信写权限特征值UUID
`Param3`	通信通知权限特征值UUID
Response	OK
Description	向指定设备发起连接，参数由12字节（设备地址）和1字节（地址类型）组成，一般情况下地址类型为“0”或者“1”。地址地址类型获取方式：使用 AT+SCAN 扫描返回的第二个参数，例： +SCAN=0,0,DC0D30001ED4,-65,10,FSC-BT946 连接命令： AT+LECCONN=DC0D30001ED40

Example:
连接指定设备,0为地址类型
<< AT+LECCONN=DC0D3000039E0
>> OK

向指定地址发起连接，使用FFF0，FFF2，FFF1进行通信
<< AT+LECCONN=DC0D3000039E0,FFF0,FFF2,FFF1
>> OK

AT+LESEND - 发送数据到远端设备

Command	AT+LESEND=Param1,Param2
`Param1`	Payload length (1~236)
`Param2`	Payload (1~236 Bytes UTF8)
Response	OK
Description	如果透传模式开启，该指令将会被禁用

Example:
向远端BLE设备发送数据“1234567890”
<< AT+LESEND=10,1234567890
>> OK

HID指令

AT+HIDSTAT - 读HID状态

Command	AT+HIDSTAT
Response	+HIDATAT=Param
Description	格式说明参考: +HIDSTAT - HID状态

AT+HIDCONN - 建立HID连接

Command	AT+HIDCONN{=Param}
`Param`	目标设备MAC地址(12 Bytes ASCII)

AT+HIDDISC - 断开HID连接

Command	AT+HIDDISC
Description	断开当前与远程设备的HID连接

AT+HIDOSK - 弹出/退出键盘

Command	AT+HIDOSK
Description	弹出/退出键盘 ios有效

AT+HIDMODE - 读/写HID模式

Command	AT+HIDMODE{=Param}
`Param`	HID键盘输入模式(0~1), default 1 (0) Hex key code (1) Ascii key code (English)
Note	模块可以通过特定的固件支持各种键盘语言，例如: TURKEY SPAIN PORTUGAL FRANCE GERMANY ITALY CZECH JAPAN

AT+HIDDLY - 读/写HID发送时间

Command	AT+HIDDLY{=Param}
`Param`	HID report period in millisecond, default 10 ms

AT+HIDSEND - 通过HID发数据

Command	AT+HIDSEND{=Param{,Param1}}
`Param`	Report length
`Param1`	Report payload
Note	For special key code: 0x0D -> ENTER 0x08 -> BACKSPACE 0x09 -> TAB 0x20 -> SPACE
Description	如果透传模式开启，该指令将会被禁用

Example: 发送字符 ‘A’ 到远端设备 (on AT+HIDMODE=1)
>> AT+HIDSEND=1,A
<< OK
Example: 发送字符 ‘A’ 到远端设备 (on AT+HIDMODE=0)
<< AT+HIDSEND=4, xA1 x01 x00 x04
>> OK
Note: 数据为hex,对应的实际数据如下:
41 54 2B 48 49 44 53 45 4E 44 3D 34 2C A1 01 00 04 0d 0a
Where:
A1 : report start
01 : page id 1
00 : modifier
04 : key code
模块将自动发送弹起键

通知列表

+SPPSTAT - SPP状态

Format	+SPPSTAT=Param
`Param`	(0) Unsupported (1) Standby (2) Connecting (3) Connected

+SCAN - 扫描结果

Format1	+SCAN={ : 开始扫描
Format2	+SCAN =Param,Param1,Param2,Param3,Param4,Param5
`Param`	列表序号
`Param1`	地址类型（1字节）
`Param2`	地址（12字节）
`Param3`	RSSI
`Param4`	设备名长度
`Param5`	设备名
Format3	+SCAN=} : 停止扫描

Example:
搜索设备
<< AT+SCAN=1
>> +SCAN={
>> +SCAN=0,1,70CFC9A98840,-43,24,LE-Bose QuietControl 30
>> +SCAN=1,1,DC0D30001ED4,-65,10,WEWQ-45AE
>> +SCAN=}

+GATTSTAT - 连接状态上报

Indication	+GATTSTAT=Param
`Param`	(0) Unsupported (1) Standby (2) Connecting (3) Connected
Description	指令模式下，模组的连接状态发生变化，通过+GATTSTAT主动上报

Example:
连接成功
>> +GATTSTAT=3

+LESTAT - 连接状态上报

Indication	+LESTAT=Param
`Param`	(0) Unsupported (1) Standby (2) Connecting (3) Connected
Description	指令模式下，模组的连接状态发生变化，通过+LESTAT主动上报

Example:
连接成功
>> +LESTAT=3

+HIDSTAT - HID状态

Format	+HIDSTAT=Param
`Param`	(0) Unsupported (1) Standby (2) Connecting (3) Connected

开发与应用

参阅 FSC-BT910x系列用户指南

本指南详细介绍了 FSC-BT910x 系列模块的硬件说明、功能说明、数传通讯原理、快速开发套件、快速测试、典型应用开发示例、以及固件升级方法和FAQs。

附录

下载 PDF版本

下载PDF版本