FSC-BT1036 AT 命令集

[English]

介绍

描述

本设计指南适用于工程师开发 FSC-BT1036 系列蓝牙模组,同样也适合BT6001、BT955、BT936B、BT909C、BT906系列模组

模组默认参数

Name

FSC-BT1036-XXXX

LE-Name

FSC-BT1036-LE-XXXX

Pin Code

0000

Secure Simple Pairing Mode

On

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,失败时返回 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-BT1036-XXXX
>> OK

当没有来电时接听电话
<< AT+HFPANSW
>> ERR003

Event格式

<CR><LF>+Indication{=Param1{,Param2{,Param3…}}}<CR><LF>
  • 所有的事件使用<CR><LF>开始, 使用<CR><LF>结束

  • 若事件包含参数, 参数应位于 “=” 后面

  • 若事件包含多项参数, 参数应使用 “,” 分割

  • 使用命令AT+SEP替换默认分隔符以防止冲突

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

拨打电话10086
>> +HFPSTAT=4
>> +HFPAUDIO=1
>> +HFPSTAT=6,10086

指令表

通用指令

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

Command

AT+HELP

Response

<FIRMWARE FUNCTION: appropriate working scenario >
<OTA PATH: latest suitable firmware path on server for upgrade On-The-Air>
<ENABLED PROFILES: LINKS: ON/OFF>
<COMMAND SUMMARY: DESCRIPTION: PROFILE CATEGORY>

Description

使用help命令获取基本摘要信息

Note

如需升级最新版本请参考 空中升级说明

AT+SEP - 读/写Event分隔符

Command

AT+SEP{=Param}

Param

设置范围0x01~0xFF,默认: ‘,’ , 其中‘0’表示0xFF

Response

返回当前分隔符

Description

events/responses的参数可能包含与默认分隔符相同的值,
使用此命令替换默认分隔符以防止冲突。
(通常将默认分隔符“,”替换为十六进制值“xFF”)
Example:读模块的配对记录
<< AT+PLIST
>> +PLIST=1,32808,1C5CF226D773, Tony, iPhone12
>> +PLIST=2,40, A0BC30075421, Samsung S8
>> +PLIST=E
>> OK
Example: 设置分隔符为‘0xFF’
<< AT+SEP=0
>> OK
Example: 再读模块的配对记录
<< AT+PLIST
>> +PLIST=1<FF>32808<FF>1C5CF226D773<FF>Tony, iPhone12
>> +PLIST=2<FF>40<FF> A0BC30075421<FF>Samsung S8
>> +PLIST=E
>> OK

AT+VER - 读取固件版本

Command

AT+VER

Response

+VER=Param1,Param2,Param3

Param1

模块类型

Param2

固件版本

Param3

生产日期

Note

升级固件后,生产日期不会变化

Example:
<< AT+VER
>> +VER=BT1036,V2.8.7,20250922
>> OK

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

Command

AT+BAUD{=Param}

Param

2400/4800/9600/19200/38400/57600/115200(default)/128000/
230400/256000/460800/512000/921600/1382400

Response

+BAUD=Param1,Param2,Param3

Param

返回当前所有支持的波特率

Description

模块将在接收到这条指令后,马上切换波特率

Example:
读取波特率
<< AT+BAUD
>> +BAUD=2400,4800,9600,19200,38400,57600,115200,128000,230400,256000,
460800,512000,921600,1382400
>> OK

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

AT+I2CREG - 读/写I2C寄存器

Command

AT+I2CREG=Param1, Param2, Param3 {,Param4}

Param1

i2c bus address, 2 byes hex string

Param2

i2c register address, 2/4 byes hex string

Param3

bytes to read/write (1~64)

Param4

value to write

Response

+I2CREG=Param

Param

返回当前I2C读取的值

Description

只有在禁用模块的内置编解码器时,才能使用命令,
默认情况下,i2c总线是主总线。个别程序不支持该命令
Example:读外部I2C从设备, address:0x34, register 0003, bytes:2; 并修改 0xA13B
<< AT+I2CREG= 34,0003,2
>> +I2CREG=805F
>> OK
<< AT+I2CREG= 34,0003,2,A13B
>> OK

AT+I2SCFG - 设置I2S格式

Command

AT+I2SCFG{=Param}

Param

以10进制位字段表示,每位表示

BIT[0]

0:disable; 1:enable

BIT[1]

0:master; 1:slave

BIT[2]

0:FS=48000Hz;1:FS=44100Hz

BIT[3-4]

00: I2S standard format
10: PCM short frame format

BIT[5-6]

00: bit depth=16bits
10: bit depth=32bits (only 16bits of MSB effective)
11: bit depth=32bits (only used for PCM mode)

Response

+I2SCFG=Param

Description

默认情况下,BT90X模块支持多个外部编解码器,例如ES8388、TLV320AIC3204等。
如果+I2SCFG=0,模块将在启动时自动检测其中的一个

Note

使用命令AT+HFPSR设置HFP语音通话采样率,BT1036/BT955内置codec

Example:常用组合配置如下:

0

模拟模式,模块将在启动时通过I2C检测内部/外部编解码器,并上报+CODEC=id

1

I2S Master; Sample rate=48000Hz; Resolution=16bits; Bit clock= 48000*16*2ch=1.536Mhz

3

I2S Slave; Sample rate=48000Hz; Resolution=16bits; Bit clock= 48000*16*2ch=1.536Mhz

65

I2S Master; Sample rate=48000Hz; Resolution=32bits; Bit clock= 48000*32*2ch=3.072Mhz

67

I2S Slave; Sample rate=48000Hz; Resolution=32bits; Bit clock= 48000*32*2ch=3.072Mhz

113

PCM Master; Sample rate=48000Hz; Resolution=16bits; Bit clock= 48000*16*2ch=1.536Mhz

AT+MICGAIN - 设置麦克风音量

Command

AT+MICGAIN{=Param}

Param

Gain (0~15, default:8)

Description

调整Codec模拟输入音量,I2S模式设置无效

AT+SPKVOL - 设置扬声器音量

Command

AT+SPKVOL{=Param1,Param2}

Param1

A2DP的音量 (0~15, default:8)

Param2

HFP的音量 (0~15, default:8)

Description

调整Codec模拟输出音量,I2S模式设置无效

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-打开蓝牙

AT+PROFILE - 蓝牙Profile配置

Command

AT+PROFILE{=Param}

Param

以10进制位字段表示,每位表示

BIT[0]

SPP (Serial Port Profile)

BIT[1]

GATT Server (Generic Attribute Profile)

BIT[2]

GATT Client (Generic Attribute Profile)

BIT[3]

HFP-HF (Hands-Free Profile Handsfree)

BIT[4]

HFP-AG (Hands-Free Profile Audio Gateway)

BIT[5]

A2DP Sink (Advanced Audio Distribution Profile)

BIT[6]

A2DP Source (Advanced Audio Distribution Profile)

BIT[7]

AVRCP Controller (Audio/Video remote controller Profile)

BIT[8]

AVRCP Target (Audio/Video remote controller Profile)

BIT[9]

HID Keyboard (Human Interface Profile)

BIT[10]

PBAP Server (Phonebook Access Profile)

BIT[15]

iAP2 (For iOS devices)

Response

+PROFILE=Param

Description

无法同时启用GATT Server and Client, HFP Sink and Source,
A2DP Sink and Source,AVRCP Controller and Target
Example:读取当前Profile
<< AT+PROFILE
>> +PROFILE=1195
Example:只使能A2DP Sink, HFP Sink,其他不使能
<< AT+PROFILE=160
>> OK
Example:只使能A2DP Source,HFP Source,其他不使能
<< AT+PROFILE=80
>> OK

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

Command

AT+AUTOCONN{=Param}

Param

以10进制位字段表示, 格式参考:AT+PROFILE

Response

+AUTOCONN=Param

Description

上电后,模块将根据设置PROFILE尝试与配对列表中的设备建立连接

AT+STAT - 读所有Profile状态

Command

AT+STAT

Response

+STAT=Param1, Param2, Param3…

Description

查询所有使能Profile的当前状态

Example:读取当前Profile
<< AT+PROFILE
>> +PROFILE=83
Example:读Profile的状态
<< AT+STAT
+STAT=3,1,2,5
>> OK
_images/profile_state.png

AT+DEVSTAT - 读设备状态

Command

AT+DEVSTAT

Response

+DEVSTAT=Param

Param

以10进制位字段表示,

BIT[0]

0: Power Off; 1: Power On

BIT[1]

0: BR/EDR Not Discoverable; 1: BR/EDR Discoverable

BIT[2]

0: BLE Not Advertising; 1: BLE Advertising

BIT[3]

0: BR/EDR Not Scanning; 1: BR/EDR Scanning

BIT[4]

0: BLE Not Scanning; 1: BLE Scanning

Example:常用组合和描述

0

Device power off

1

Device power on

3

Device power on, BR/EDR Discoverable

5

Device power on, BR/EDR Not Discoverable, BLE Advertising

7

Device power on, BR/EDR Discoverable, BLE Advertising

13

Device power on, BR/EDR Not Discoverable, BLE Advertising, Scanning nearby BR/EDR devices

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+NAME - 读/写BR/EDR蓝牙名称

Command

AT+NAME{=Param1{,Param2}}

Param1

BR/EDR蓝牙名称(1~31 Bytes ASCII)

Param2

使能MAC地址后缀(0/1,default:1)
0: 关闭后缀
1: 开启后缀“-XXXX”(MAC地址后4Byte)

Response

+NAME=Param

Param

蓝牙名称

Description

如果存在参数则设置蓝牙名称,否则只是读取

Example:
读取BR/EDR蓝牙名称
<< AT+NAME
>> +NAME=FSC-BT1036-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:1)
0: 关闭后缀
1: 开启后缀“-XXXX”(MAC地址后4Byte)

Response

+LENAME=Param

AT+SSP - 读/写BR/EDR配对模式

Command

AT+SSP{=Param}

Param

Pairing mode (0~3, default:2)
(0) Legacy pairing, use pin code for pairing
(1) Secure simple pairing, auto pairing
(2) Secure simple pairing, display yes/no in pairing
(3) Secure simple pairing, passkey compare,
user need to accept/reject pair request with command AT+CFM

Response

+SSP=Param

Note

重启生效

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+CFM - 接受/拒绝远端的配对请求

Command

AT+CFM=Param1, Param2

Param1

远端设备的MAC地址(12Bytes)

Param2

0-拒绝远端的配对请求
1-接受远端的配对请求

Description

当+SSP=3时,CFM命令有效

AT+COD: 读/写设备类型

Command

AT+COD=Param

Param

设备类型(6 bytes ASCII, default:240408 Handsfree device)

Response

+COD=Param

相关配置参考 COD.

AT+PAIR: 读/写BR/EDR/BLE可发现模式

Command

AT+PAIR=Param

Param

Mode(0-3)
0: Leave BR/EDR/BLE discoverable mode (stop advertising/broadcasting)
1: Enter BR/EDR discoverable mode (start broadcasting)
2: Enter BLE discoverable mode (start advertising)
3: Enter BR/EDR/BLE discoverable mode (start advertising/broadcasting)

Description

如果未连接设备(BR/EDR或BLE),模块将始终可被发现;
如果与远程设备连接,模块将不可被发现,除非收到此命令

AT+PAGE: 读/写BR/EDR可连接模式

Command

AT+PAGE=Param

Param

Mode(0-1)
0: Leave BR/EDR connectable mode (stop paging)
1: Enter BR/EDR connectable mode (start paging)

Description

如果未连接设备,模块将始终处于可连接模式,
如果与远程设备连接,模块将不可连接,除非收到此命令

AT+SCAN - 搜索附近的设备

Command

AT+SCAN=Param1{,Param2{,Param3}}

Param1

扫描方式(0~2)
0: 停止扫描
1: 扫描附近BR/EDR设备
2: 扫描附近BLE设备(部分程序不支持)
3: 扫描附近BR/EDR/BLE设备(部分程序不支持)

Param2

(1~48)扫描时间. unit:1.28s, default:12.8s

Param3

(1~25 Bytes ASCII)过滤名称.

Description

格式说明参考: +SCAN - 扫描结果

AT+RSSI: 读BR/EDR信号强度

Command

AT+RSSI=Param

Param

当前连接设备的MAC地址

Response

+PIN=Param

Param

RSSI value (-127 ~ 0)

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

Command

AT+PLIST{=Param}

Param

(0/1~8/12 Bytes MAC address)
(0) 清除所有配对记录
(1~8) 清除指定索引的配对记录
(MAC) 清除指定地址的配对记录

Response1

+PLIST=Param1, Param2, Param3{,Param4}

Param1

(1~8) 配对设备序号

Param2

以10进制位字段,设备连接的profile,参考AT+PROFILE

Param3

(MAC)配对设备的MAC地址

Param4

(UTF8)配对设备的蓝牙名称

Response2

+PLIST=E 配对记录查询完成

Example:读模块的配对记录
<< AT+PLIST
>> +PLIST=1,32808,1C5CF226D773, iPhone12
+PLIST=2,40, A0BC30075421, Samsung S8
+PLIST=E
>> OK

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

AT+DSCA - 断开所有连接

Command

AT+DSCA

Description

模块断开与远程设备的所有蓝牙连接

AT+AUDROUTE - 音频路由管理

Command

AT+AUDROUTE{=Param}

Param

Note: HF1 & HF2 means peer Bluetooth headphones
0 Stop audio routing
1 Route music (a2dp streaming) from Module to HP1/HP2 simultaneously
2 Route voice call (hfp sco) between Module and HP1
3 Route voice call (hfp sco) between Module and HP2
4 Route voice call (hfp sco) between HP1 and HP2 (intercom mode)
5 Route voice call (hfp sco) from Module to HP1/HP2 simultaneously
6 Route music (a2dp streaming) from Module to HP1 only
7 Route music (a2dp streaming) from Module to HP2 only

Description

某些路由模式需要指定固件版本

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

Command

AT+TPMODE{=Param}

Param

模式(0~1,默认0) 0: 指令模式 1: 透传模式

Response

+TPMODE=Param

Description

当在SPP/GATT协议下连接并且打开透传模式时,AT指令将会被禁用,
通过UART接收的每个字节将被发送到远端

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

Command

AT+LINKCFG{=Param}

Param

参考AT+PROFILE指令

Description

若配置该指令模块会自动根据配置的profile自动搜索链接

Example:配置A2DP自动搜索链接
<< AT+PROFILE=64
>> OK

AT+TXPOWER - 发射功率配置

Command

AT+TXPOWER{=Param}

Param

(value:0-15, 默认15)

Value

Power(dBm)

0

-36.1

1

-8.2

2

-2.9

3

0.5

4

2.3

5

4.1

6

5.4

7

6.5

8

7.2

9

8.0

10

8.6

11

9.1

12

9.4

13

9.8

14

10.0

15

10.2

HFP指令

AT+HFPSTAT - 读HFP状态

Command

AT+HFPSTAT

Response

+HFPSTAT=Param1{,Param2{,Param3}}

Description

格式说明参考: +HFPSTAT - HFP状态

AT+HFPSR - 读/写HFP采样率

Command

AT+HFPSR{=Param}

Param

HFP通话时的采样率, 可配置: 0/8000/16000/48000 默认0

Response

+HFPSR=Param

Description

该参数将覆盖AT+I2SCFG中的语音通话设置,并以该参数设置HFP I2S的采样率

AT+HFPCFG - 读/写HFP配置

Command

AT+HFPCFG{=Param}

Param

以10进制位字段表示,default:2

BIT[0]

0-HFP异常断开时,不回链最后断开的设备,1-HFP异常断开时,回链最后断开的设备

BIT[1]

0-关闭消回音功能, 1-打开消回音功能

BIT[2]

0-关闭三方通话功能, 1-打开三方通话功能 (需固件支持三方功能)

AT+HFPCONN - 建立HFP连接

Command

AT+HFPCONN{=Param}

Param

目标设备MAC地址(12 Bytes ASCII)

Description

如果参数不存在,模块将重新连接到最后一个HFP配对过的设备

Example:连接最后一个配对过的设备
<< AT+HFPCONN
>> OK
Example:连接指定MAC地址的设备
<< AT+HFPCONN=1C5CF226D773
>> OK

AT+HFPDISC - 断开HFP连接

Command

AT+HFPDISC

Description

断开当前与远程设备的HFP连接

AT+HFPDIAL - 重拨/拨打电话号码

Command

AT+HFPDIAL{=Param}

Param

电话号码 (1~25 Bytes ASCII)

Description

如果存在参数,请拨打指定号码,否则重拨

Example:重拨
<< AT+HFPDIAL
>> OK
Example:拨打号码 “075527924639”
<< AT+HFPDIAL=075527924639
>> OK

AT+HFPDTMF - 发送DTMF

Command

AT+HFPDTMF{=Param}

Param

DTMF (0~9/#/*)

Example:通话时发送DTMF “#”
<< AT+HFPDTMF=#
>> OK

AT+HFPANSW - 来电接听

Command

AT+HFPANSW

Description

来电接听

AT+HFPCHUP - 来电去电拒接/挂断

Command

AT+HFPCHUP

Description

拒绝来电或挂断去电/通话

AT+HFPMCAL - 三方通话控制

Command

AT+HFPMCAL=Param

Param

0: Release held call or reject waiting call
1: Release active call and accept another call
2: Hold active call and accept another call

AT+HFPADTS - 语音切换

Command

AT+HFPADTS=Param

Param

1: 将语音音频从模块传输到远程设备
2: 将语音音频从远程设备传输到模块

Description

如果参数缺省,则交替切换

AT+HFPVR - 开始/停止远程设备的语音识别

Command

AT+HFPVR=Param

Param

0-停止 1-开始

Description

开始/停止远程设备的语音识别(例如iOS设备的Siri)

AT+HFPINFO - 读HFP当前的信息

Command

AT+HFPINFO

Description

返回当前HFP的状态,信号强度,电池,设备名等信息

AT+MICMUTE - 静音麦克风

Command

AT+MICMUTE=Param

Param

0-不静音 1-静音

Description

通话时静音本地麦克风

A2DP/AVRCP指令

AT+A2DPSTAT - 读A2DP状态

Command

AT+A2DPSTAT

Response

+A2DPSTAT=Param

Description

格式说明参考: +A2DPSTAT - A2DP状态

AT+A2DPCONN - 建立A2DP连接

Command

AT+A2DPCONN{=Param}

Param

目标设备MAC地址(12 Bytes ASCII)

Description

如果参数不存在,模块将重新连接到最后一个A2DP配对过的设备

AT+A2DPDISC - 断开A2DP连接

Command

AT+A2DPDISC

Description

断开当前与远程设备的A2DP连接

AT+A2DPINFO - 读A2DP当前的信息

Command

AT+A2DPINFO

Description

返回当前A2DP的状态,远端设备名等信息

AT+AVRCPSTAT - 读AVRCP状态

Command

AT+AVRCPSTAT

Response

+AVRCPSTAT=Param

Description

格式说明参考: +AVRCPSTAT - AVRCP状态

AT+AVRCPCFG - 读/写AVRCP配置

Command

AT+AVRCPCFG{=Param}

Param

以10进制位字段表示,default:3,每位表示:

BIT[0]

自动获取音乐ID3信息(标题,艺术家,专辑).默认:1

BIT[1-3]

如果大于0,则自动获取音乐状态(播放进度)。 默认:1(second)

BIT[4]

播放器浏览功能启用/禁用

BIT[5]

指定文件夹自动拉取媒体封面图片

Example: 读AVRCP配置
<< AT+AVRCPCFG
>> +AVRCPCFG=1
OK
Example: 设置成5秒上报播放进度
<< AT+AVRCPCFG=9
>> OK

AT+PLAYPAUSE - 播放/暂停

Command

AT+PLAYPAUSE

Description

根据当前播放状态将播放或暂停命令发送到远端媒体播放器

AT+PLAY - 播放

Command

AT+PLAY

Description

发送播放命令到远端媒体播放器

AT+PAUSE - 暂停

Command

AT+PAUSE

Description

发送暂停命令到远端媒体播放器

AT+STOP - 停止

Command

AT+STOP

Description

发送停止命令到远端媒体播放器

AT+FORWARD - 下一曲

Command

AT+FORWARD

Description

发送下一曲命令到远端媒体播放器

AT+BACKWARD - 上一曲

Command

AT+BACKWARD

Description

发送上一曲命令到远端媒体播放器

AT+REPEAT - 设置媒体播放器重复模式

Command

AT+REPEAT{=Param}

Param

Repeat mode (0/1) 0-关闭 1-打开

Response

+PLAYMODE=Param1,Param2

Param

格式说明参考: +PLAYMODE - 媒体播放器重复播放/随机播放模式

AT+SHUFFLE - 设置媒体播放器随机播放模式

Command

AT+SHUFFLE{=Param}

Param

Shuffle mode (0/1) 0-关闭 1-打开

Response

+PLAYMODE=Param1,Param2

Param

格式说明参考: +PLAYMODE - 媒体播放器重复播放/随机播放模式

AT+GETMP - 获取远端设备的媒体播放器

Command

AT+GETMP

Response

+BROWDATA=Param1,Param2,Param3,Param4

Param

格式说明参考: +BROWDATA - 媒体播放器文件系统浏览数据

Description

获取远程设备的媒体播放器,只有设置了可浏览标志的播放器支持浏览。
对于某些手机(如iOS设备),用户可能需要首次在手机端启动播放器

AT+SETMP - 选择媒体播放器

Command

AT+SETMP=Param

Param

媒体播放器索引

Response

+BROWDATA=Param1,Param2

Param

格式说明参考: +BROWDATA - 媒体播放器文件系统浏览数据

Description

选择要浏览的媒体播放器,必须设置播放器的可浏览标志,
选择播放器后我们将进入根目录。

AT+GETFD - 列出选定文件夹的子文件夹/曲目

Command

AT+GETFD=Param1,Param2

Param1

起始位置, (1~65535)

Param2

结束位置, (1~65535), Param2 >= Param1

Description

列出当前文件夹中的子文件夹或媒体项目。

AT+SETFD - 选择并进入文件夹

Command

AT+SETFD=Param

Param

0:Enter up level folder other:Enter selected folder

Description

选择并输入要浏览的文件夹。

AT+GETNP - 在“正在播放”列表中列出曲目

Command

AT+GETNP=Param1,Param2

Param1

(1~65535),起始位置

Param2

(1~65535),结束位置, Param2 >= Param1

Response

+BROWDATA=M,Param1,Param2,Param3

Param

格式说明参考: +BROWDATA - 媒体播放器文件系统浏览数据

AT+ADDMP - 将曲目添加到媒体播放器

Command

AT+ADDMP=Param

Param

Track ID

Description

将选定曲目添加到媒体播放器并开始播放

PBAP指令

AT+PBSTAT - 读PBAP状态

Command

AT+PBSTAT

Response

+PBATAT=Param

Description

格式说明参考: +PBSTAT - PBAP状态

AT+PBCONN - 建立PBAP连接

Command

AT+PBCONN{=Param}

Param

目标设备MAC地址(12 Bytes ASCII)

Description

如果参数不存在,模块将使用当前HFP的地址连接.
一些固件支持,发送AT+PBDOWN时自动连接PBAP

AT+PBDISC - 断开PBAP连接

Command

AT+PBDISC

Description

断开当前与远程设备的PBAP连接

AT+PBDOWN - 下载电话本

Command

AT+PBDOWN=Param1{,Param2}

Param1

电话本类型(0-5)
(0) Phonebook (SIM Storage)
(1) Phonebook (Phone Storage)
(2) Received call log
(3) Dialed call log
(4) Missed call log
(5) All call log

Param2

下载数量 (1~65535, default:3000 for phonebook; 50 for call log)

Description

对于某些手机(例如iPhone),必须在手机的蓝牙设置中打开联系人下载权限

AT+PBABORT - 取消电话本下载

Command

AT+PBABORT

Description

取消电话本下载

SPP指令

AT+SPPSTAT - 读SPP状态

Command

AT+SPPSTAT

Response

+SPPATAT=Param

Description

格式说明参考: +SPPSTAT - SPP状态

AT+SPPCONN - 建立SPP连接

Command

AT+SPPCONN{=Param}

Param

目标设备MAC地址(12 Bytes ASCII)

AT+SPPDISC - 断开SPP连接

Command

AT+SPPDISC

Description

断开当前与远程设备的SPP连接

AT+SPPSEND - 通过SPP发数据

Command

AT+SPPSEND=Param1,Param2

Param1

Payload length (1~492)

Param2

Payload (1~492 Bytes UTF8)

Description

如果透传模式开启,该指令将会被禁用

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

GATT指令

AT+GATTSTAT - 读GATT状态

Command

AT+GATTSTAT

Response

+GATTATAT=Param

Description

格式说明参考: +GATTSTAT - GATT状态

AT+GATTDISC - 断开GATT连接

Command

AT+GATTDISC

Description

断开当前与远程设备的GATT连接

AT+GATTSEND - 通过GATT发数据

Command

AT+GATTSEND=Param1,Param2

Param1

Payload length (1~492)

Param2

Payload (1~492 Bytes UTF8)

Description

如果透传模式开启,该指令将会被禁用

Example: 通过GATT给远程设备发送数据 “1234567890”
<< AT+SPPSEND=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+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=Param1,Param2

Param1

Report length

Param2

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
模块将自动发送弹起键

AT+HIDCMD - 通过HID发命令

Command

AT+HIDCMD=Param

Param

2 bytes hid user report
e.g., for iPhone:
Play/Pause: 00 CD
Stop: 00 B7
Forward: 00 B5
Backward: 00 B6
Fast Forward: 00 B3
Rewind:00 B4
Record:00 B2
VolumpUp:00 E9
VolumpDn:00 EA
Mute:00 E2
On screen keyboard Toggle:01 AE

Description

如果透传模式开启,该指令将会被禁用

Example: 发送音量+给手机
<< AT+HIDCMD= x00 xE9
>> OK
Note: 数据为hex,对应的实际数据如下:
41 54 2B 48 49 44 43 4D 44 3D 00 E9 0D 0A

Events表

通用指示

+PWRSTAT - 上电状态

Format

+PWRSTAT=Param

Param

0-Powering off 1-Powering on(booting)

Description

在上下电状态下,不建议使用AT命令

+SCAN - 扫描结果

Format1

+SCAN =Param1,Param2,Param3, Param4,Param5,Param6

Param1

索引

Param2

RSSI (-127 ~ -1)

Param3

设备地址类型 (0~3)
(0) BR/EDR address
(1) LE public address
(2) LE random address
(3) iOS device with Carplay support

Param4

MAC地址 (12 Bytes ASCII)

Param5

BR/EDR设备名称或者LE设备广播数据

Param6

设备类型(6 Bytes ASCII)

Format2

+SCAN=E: 停止扫描

Example: 扫描BR/EDR附近设备
<< AT+SCAN=1
>> OK
+SCAN=1,-32,3,B019C66209FA,wt-iphone,7A020C
+SCAN=2,-74,0,DC0D30000053,BW226,040680
+SCAN=3,-43,0,00158354F994,LAPTOP-3L,120104
+SCAN=E

+PAIRREQ - 配对请求

Format

+PAIRREQ=Param1,Param2{,Param3}

Param1

Passkey (000000~999999)

Param2

当前配对设备的MAC地址(12 Bytes ASCII)

Param3

当前配对设备的名称

+PAIRED - 配对结果

Format

+PAIRED=Param1,Param2

Param1

配对结果 (0)-成功 (1~255)-失败原因

Param2

当前配对设备的MAC地址(12 Bytes ASCII)

+CODEC - Codec ID

Format

+CODEC=Param

Param

Code id
(1) NAU88L25B
(2) TI TLV32AIC3204
(3) ES8388

Description

固件集成了多个编解码器的I2C驱动程序,如NAU88L25B/TLV32AIC3204/ES8388,
并在启动时探测其中一个。BT1036、BT955、BT6001、BT936芯片内置Codec,不上
报Codec指示

HFP指示

+HFPSTAT - HFP状态

Format

+HFPSTAT=Param1{,Param2{,Param3}}

Param1

(0~10)
(0) Unsupported
(1) Standby
(2) Connecting
(3) Connected
(4) Outgoing call
(5) Incoming call
(6) Active call
(7) Active held (3-way-calling)
(8) First call active, second call waiting (3-way-calling)
(9) First call active, second call held (3-way-calling)
(10) First call outgoing, second call held (3-way-calling)

Param2

电话号码, 当状态>3

Param3

电话号码(三方通话)

Example: 拨打10086
<< AT+HFPDIAL=10086
>> +HFPSTAT=3
>> +HFPSTAT=4,10086
>> +HFPAUDIO=1
Example: 来电且号码是13265463800
>> +HFPSTAT=5, 13265463800
>> +HFPAUDIO=1

+HFPDEV - HFP远端设备信息

Format

+HFPDEV=Param1{,Param2}

Param1

(12 Bytes ASCII), 当前HFP连接远端设备的MAC地址

Param2

(UTF8), 当前HFP连接远端设备的名称

Example: HFP连接成功
>> +HFPDEV=1C5CF226D774, iPhone

+HFPAUDIO - HFP语音音频状态

Format

+HFPAUDIO=Param

Param

(0) HFP语音音频断开连接,音频输入/输出切换到远端设备
(1) HFP语音建立连接,音频输入/输出切换到模块

+HFPSIG - HFP远端设备网络信号强度

Format

+HFPSIG=Param

Param

(0~5) 远端设备的网络信号强度

+HFPROAM - HFP远端设备漫游状态

Format

+HFPROAM=Param

Param

(0/1) 远端设备的漫游状态

+HFPBATT - HFP远端设备电池电量

Format

+HFPBATT=Param

Param

(0~5) 远程设备的电池电量

+HFPNET - HFP远端设备网络运营商

Format

+HFPNET=Param

Param

(UTF8)远程设备的网络运营商选择

+HFPMANU - HFP远端设备制造商

Format

+HFPMANU=Param

Param

(UTF8)远程设备制造商

+HFPNUM - HFP远端设备本机号码

Format

+HFPNUM=Param

Param

(ASCII)远端设备的本机号码

+HFPIBR - HFP远端设备支持来电铃声

Format

+HFPIBR=Param

Param

0-不支持 1-支持

Description

指示当前连接的手机是否支持来电铃声

+HFPRING - HFP远端设备来电铃声指示

Format

+HFPRING=Param

Param

0-不支持in-bang-ring 1-支持in-band-ring

Description

来电时手机正在响铃,如果远程手机不支持in-band-ring,模块播放本地铃声

A2DP/AVRCP指示

+A2DPSTAT - A2DP状态

Format

+A2DPSTAT=Param

Param

(0) Unsupported
(1) Standby
(2) Connecting
(3) Connected
(4) Paused
(5) Streaming

+A2DPDEV - A2DP远端设备信息

Format

+A2DPDEV=Param1{,Param2}

Param1

(12 Bytes ASCII), 当前A2DP连接远端设备的MAC地址

Param2

(UTF8), 当前A2DP连接远端设备的名称

+AVRCPSTAT - AVRCP状态

Format

+AVRCPSTAT=Param

Param

(0) Unsupported
(1) Standby
(2) Connecting
(3) Connected

+PLAYSTAT - 媒体播放器播放状态

Format

+PLAYSTAT=Param

Param

(0) Stopped
(1) Playing
(2) Paused
(3) Fast Forwarding
(4) Fast Rewinding

+PLAYMODE - 媒体播放器重复播放/随机播放模式

Format

+PLAYMODE=Param1,Param2

Param1

Repeat Mode (1~4)
(1) Off
(2) Single Track
(3) All Tracks
(4) Group

Param2

Shuffle Mode (1~3)
(1) Off
(2) All Tracks
(3) Group

+TRACKSTAT - 媒体播放器播放进度

Format

+TRACKSTAT=Param1,Param2,Param3

Param1

(0~4), 媒体播放器状态

Param2

(Decimal ASCII),当前音乐播放的时间(秒)

Param3

(Decimal ASCII),当前音乐的总时间(秒)

+TRACKINFO - 媒体音乐信息

Format

+TRACKINFO=Param1,Param2,Param3

Param1

标题

Param2

艺术家

Param3

专辑

Example: 手机播放歌曲“Creep-Radio Head”
>> +TRACKINFO=Creep , Radiohead , Pablo Honey

+BROWSTAT - 媒体浏览状态

Format

+BROWSTAT=Param

Param

(0) Unsupported
(1) Standby
(2) Connecting
(3) Connected
(4) Browsing

+BROWDATA - 媒体播放器文件系统浏览数据

Format

+BROWDATA=Param1, Param2 {, Param3{, Param4}}

Param1

浏览类型,对于每种类型,以下数据表示:

P

Parame1: media player information
Parame2: 0 – support browsing; 1- not support browsing
Parame3: media player id
Parame4: media player name

R

Parame1: root dictionary name
Parame2: root dictionary name

F

Parame1: folder ID and name
Parame2: folder ID
Parame3: folder name

M

Parame1: media track ID and name
Parame2: media track ID
Parame3: media track name

E

Parame1: browsing operation result code
Parame2: 0 - browsing success; other - browsing error code

+BIPSTAT - BIP状态

Format

+BIPSTAT=Param

Param

(0) Unsupported
(1) Standby
(2) Connecting
(3) Connected
(4) Downloading

Description

BIP配置文件现在仅用于媒体播放器封面图片下载

+COVERART - 媒体曲目封面下载成功

Format

+COVERART=Param

Param

Image ID

Description

封面图片放在名为ImageID.jpg的指定文件夹中

PBAP指示

+PBSTAT - PBAP状态

Format

+PBSTAT=Param

Param

(0) Unsupported
(1) Standby
(2) Connecting
(3) Connected
(4) Downloading

+PBCNT - 远端设备的电话簿条目

Format

+PBCNT=Param

Param

远端设备的电话簿条目

+PBDATA - 电话本数据

Format1

+PBDATA=Param1,Param2,Param3{,Param4}

Param1

类型
(0) Phonebook (SIM Storage)
(1) Phonebook (Phone Storage)
(2) Received call log
(3) Dialed call log
(4) Missed call log

Param2

电话名称

Param3

电话号码

Param4

(15 Bytes ASCII), 当前下载通话记录,则有此参数
Format:
Year(4Bytes) Month(2Bytes) Day(2Bytes) T(1Byte) Hour(2Bytes)
Minute(2Bytes) Second(2Bytes). e.g. 20161012T152826 represents
2016/10/12/15/28/26

Format2

+PBDATA=E 下载完成

Description

某些手机可能没有通话时间

Example: 下载所有电话本
<< AT+PBDOWN=1
>> +PBCNT=234
+PBDATA=1 , Jack , 18219146201
+PBDATA=1 , kenan , 8613771972680
……
+PBDATA=E

Example: 下载10条已拨电话
<< AT+PBDOWN=3,10
>> +PBDATA=3 , China Mobile , 10086 , 20171013T103516
+PBDATA=3 , Jerry , 18688967507 , 20171012T152826
……
+PBDATA=E

SPP指示

Note

由于IAP2(Apple Accessory Protocol)和AAP(Android Auto Protocol)的指示和SPP几乎相同,分别是:

+IAPSTAT, +IAPDATA for iAP2 profile

+AAPSTAT, +AAPDATA for AAP profile

文档将忽略这些指示说明, 默认BT1036、BT955不支持该指令.

+SPPSTAT - SPP状态

Format

+SPPSTAT=Param

Param

(0) Unsupported
(1) Standby
(2) Connecting
(3) Connected

+SPPDATA - SPP接收数据

Format

+SPPDATA=Param1,Param2

Param1

Payload length

Param2

Payload

Example: 通过SPP从远端设备接收到数据“ 1234567890”
<< +SPPDATA=10,1234567890

GATT指示

+GATTSTAT - GATT状态

Format

+GATTSTAT=Param

Param

(0) Unsupported
(1) Standby
(2) Connecting
(3) Connected

+GATTDATA - GATT接收数据

Format

+SPPDATA=Param1,Param2

Param1

Payload length

Param2

Payload

Example: 通过GATT从远端设备接收到数据“ 1234567890”
<< +GATTDATA=10,1234567890

HID指示

+HIDSTAT - HID状态

Format

+HIDSTAT=Param

Param

(0) Unsupported
(1) Standby
(2) Connecting
(3) Connected

附录

下载 PDF版本

下载PDF版本