FSC-BT690 指令手册

介绍

[English]

描述

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

模组默认配置

Name

Feasycom

Service UUID

FFF0

Write UUID

FFF2

Notify UUID

FFF1

UART Baudrate

115200/8/N/1

硬件说明

引脚图

_images/BT690%E5%BC%95%E8%84%9A.png

引脚描述

Pin

Pin Name

Type

Pin Descriptions

1

GND

GND

GND

2

RESET

I

低电平复位

3

UART_RX

I

串口数据脚

4

UART_TX

O

串口数据脚

10

RF_OUT

RF

射频输出,阻抗50欧姆

20

VDD

Power

3.3V供电,建议使用LDO供电

硬件设计说明

  • 模组只需要连接VDD/GND/UART_RX/UART_TX即可使用

  • 画完原理图后请发给飞易通进行审核,避免蓝牙距离达不到最佳效果

功能说明

工作模式

透传模式

蓝牙未连接,串口收到的数据按照AT指令进行解析;蓝牙连接后串口收到的数据全
部原样发送到远端蓝牙。

指令模式

蓝牙未连接,串口收到的数据按照AT指令进行解析;蓝牙连接后串口收到的数据仍
然按照AT指令进行解析。需要发送数据到远端的时候,发送AT+LESEND指令。

GATT透传服务

类型

UUID

权限

描述

Service

0xFFF0

透传服务

Write

0xFFF2

Write,Write Without Response

APP发给模组

Notify

0xFFF1

Notify

模组发给APP

AT指令说明

规范说明

适用于整个文档

  • {} : 包括与{…}中的内容为可选项

  • << : 主机发给模组的 COMMAND

  • >> : 模组回复主机的 RESPONSE

PS:BT690所有指令均不支持掉电保存,客户使用模块前请注意初始化配置参数

指令

指令是主机主动发给模组的控制命令,模组在收到指令后需要回复 <CR><LF>OK<CR><LF> 作为应答。

指令格式

AT+Command{=Param1{,Param2{,Param3…}}}<CR><LF>
  • 所有的指令使用 AT 开头,使用 <CR><LF> 结尾

  • <CR> 代表回车符,对应 HEX 为 0x0D

  • <LF> 代表换行符,对应 HEX 为 0x0A

  • 若指令包含参数,参数应使用 = 分隔

  • 若指令包含多项参数,参数应使用 , 分隔

  • 若指令有响应返回,响应使用 <CR><LF> 开始,使用 <CR><LF> 结束

  • 模组应当总是返回指令执行的结果 (成功返回 OK,失败时返回 ERROR)

Example:
读取模块蓝牙名称
<< AT+VER
>> +VER=1.0.0,FSC-BT690
>> OK

写入不支持的波特率
<< AT+BAUD=0
>> ERROR

通知

通知是模组主动发给主机的数据。一般用来指示状态的变化或收到的数据。

通知格式

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

  • 若通知包含参数, 参数应位于 “=” 后面

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

Example:
指令模式下收到APP发来的数据
>> +DATA=0,10,1234567890

指令列表

AT - 串口通信测试

Command

AT

Response

OK

Description

当上电或更改波特率时,测试主机和模块之间的UART通讯

Example:
<< AT
>> OK

AT+NAME - 读/写蓝牙名称

Command

AT+NAME{=Param1{,Param2}}

Param1

蓝牙名称(1~29 Bytes ASCII)

Param2

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

Response

+NAME=Param

Param

蓝牙名称

Description

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

Example:
读取蓝牙名称
<< AT+NAME
>> +NAME=Feasycom
>> OK

设置蓝牙名称
<< AT+NAME=ABC
>> OK

设置蓝牙名称为“ABC”并自动在广播包中添加地址后缀
<< AT+NAME=ABC,1
>> OK

AT+VER - 读取固件版本

Command

AT+VER

Response

+VER=Param

Param

固件版本

Description

读取版本号

Example:
<< AT+VER
>> +VER=1.0.0,FSC-BT690
>> OK

AT+ADDR - 读取蓝牙MAC地址

Command

AT+ADDR

Response

+ADDR=Param

Param

模块的蓝牙MAC地址(12 Bytes ASCII)

Description

读取蓝牙MAC地址

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

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

Command

AT+BAUD{=Param}

Param

波特率(2400/4800/9600/14400/19200/28800/38400/
57600/115200/230400/460800/500000/921600/1000000,
default:115200)

Response

+BAUD=Param

Param

波特率

Description

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

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

设置波特率
<< AT+BAUD=9600
>> 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+TXPOWER - 读/写发射功率

Command

AT+TXPOWER{=Param}

Param

发射功率(0~11 default:8)
0~11分别对应发射功率为:-19.5db,-13.5dB,-10.0db,-7.0db,
-5.0db,-3.5db,-2.0db,-1.0db,0db,1.0db,1.5db,2.5db

Response

+TXPOWER=Param

Param

发射功率

Description

修改发射功率

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

设置发射功率0dbm
<< AT+TXPOWER=8
>> OK

AT+LPM - 开启/关闭低功耗模式

Command

AT+LPM{=Param}

Param

低功耗模式 (0/1/2, default: 0)
0: 关闭
1: 串口唤醒模式

Response

+LPM=Param

Param

低功耗模式

Description

查询修改低功耗模式

Example:
读取低功耗模式
<< AT+LPM
>> +LPM=0
>> OK

设置串口唤醒模式
<< AT+LPM=1
>> OK

AT+ADVIN - 读/写广播间隔

Command

AT+ADVIN{=Param}

Param

广播间隔 (100~10000 ms, 默认: 152ms)

Response

+ADVIN=Param

Param

广播间隔

Description

查询修改广播间隔

Example:
读取广播间隔
<< AT+ADVIN
>> +ADVIN=687
>> OK

设置广播间隔100ms
<< AT+ADVIN=100
>> OK

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

Command

AT+ADVDATA{=Param}

Param

tag为0xFF的广播数据(len <= 25)

Response

+ADVDATA=Param

Param

tag为0xFF的广播数据

Description

查询修改蓝牙广播数据

Example:
查询tag 0xFF的广播数据内容,\x为十六进制数据
<< AT+ADVDATA
>> +ADVDATA=\x03\x01\x02
>> OK

查询tag 0xFF的广播数据内容,\x为十六进制数据
<< AT+ADVDATA=\x03\x01\x02
>> OK

AT+ADVTYPE - 读/写广播类型

Command

AT+ADVTYPE{=Param}

Param

广播类型: 0:无定向可连接 1:不可连接广播

Response

+ADVTYPE=Param

Param

广播类型

Description

查询修改广播类型

Example:
读取广播类型
<< AT+ADVTYPE
>> +ADVIN=0
>> OK

设置广播类型为不可连接广播
<< AT+ADVTYPE=1
>> OK

AT+DISC - 断开指定连接

Command

AT+DISC

Response

OK

Description

断开蓝牙连接

Example:
断开设备
<< AT+DISC
>> OK

AT+TPMODE - 读/写连接状态下的工作模式

Command

AT+TPMODE{=Param}

Param

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

Response

+TPMODE=Param

Param

模式

Description

指令模式:
蓝牙没有连接串口数据按照指令解析,蓝牙连接后串口收到
的数据按照指令解析
透传模式:
蓝牙没有连接串口数据按照指令解析,蓝牙连接后串口收到
的数据全部发到远端蓝牙
Example:
透传模式
<< AT+TPMODE=1
>> OK

指令模式
<< AT+TPMODE=0
>> OK

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

Command

AT+LESEND{=Param1,Param2}

Param1

数据长度

Param2

数据

Response

OK

Description

此指令仅在指令模式下使用,指令模式模块串口接收数据默
认做 AT 指令解析,需要发送到远端需要使用指令发送
Example:
向连接设备发送数据
<< AT+LESEND=4,2022
>> OK

通知列表

+GATTSTAT - 连接状态上报

Indication

+GATTSTAT=Param1

Param1

连接状态 (1~3)
1: 未连接
2: 连接中
3: 已连接

Description

指令模式下,模组的连接状态发生变化,通过+GATTSTAT主动上报

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

应用场景

查询/修改模组默认参数

模组在蓝牙没有连接的状态下,会将串口数据按照AT指令解析。 主机可以对模组的默认参数进行查询和修改,下图展示了:

  1. 修改设备名为 ABC

  2. 查询设备名

  3. 查询蓝牙地址

@startuml
hide footbox
skinparam sequenceMessageAlign center

box "local" #LightBlue
participant Host as host
participant Module as bt
end box


rnote over host, bt: 修改设备名为 ABC

host -> bt: AT+NAME=ABC\\r\\n
bt -> host: \\r\\nOK\\r\\n"

rnote over host, bt: 查询设备名

host -> bt: AT+NAME\\r\\n
bt -> host: \\r\\n+NAME=ABC\\r\\n\\r\\nOK\\r\\n"

rnote over host, bt: 查询蓝牙地址

host -> bt: AT+ADDR\\r\\n
bt -> host: \\r\\n+ADDR=DC0D30010203\\r\\n\\r\\nOK\\r\\n

@enduml

发送数据的流程

模组上电会持续向外发送广播数据,远端蓝牙(手机)可以通过搜索获取到广播包, 并向模组发起连接请求。连接成功后模组会拉高连接状态脚通知主机蓝牙连接成功。 主机可以通过蓝牙模组将数据发送给远端蓝牙,远端蓝牙也可以把数据发送给主机。

@startuml
hide footbox
skinparam sequenceMessageAlign center

box "local" #LightBlue
participant Host as host
participant Module as bt
end box

box "remote" #LightBlue
participant ”Remote BT“ as remote
end box

rnote over host, remote: 建立连接

        bt --> remote: 广播包
        bt <-  remote: 扫描
        bt --> remote: 广播包
        bt <-  remote: 请求建立连接

rnote over host, remote: 连接成功

host <- bt: 拉高连接状态脚

rnote over host, remote: 发送数据

host -> bt: 串口发送 ABC
        bt ->  remote: 蓝牙发送 ABC
        bt <-  remote: 蓝牙发送 DEF
host <- bt: 串口输出 DEF

        bt <-  remote: 断开蓝牙

host <- bt: 连接断开

host <- bt: 拉低连接状态脚
        bt --> remote: 广播包

@enduml

模组做主机连接远端设备

模组可以作为主设备去连接从设备,主机可以发送指令控制模组进行扫描连接和断开。下图展示了连接其他设备的过程:

@startuml

hide footbox
skinparam sequenceMessageAlign center

box "local" #LightBlue
participant Host as host
participant Module as bt
end box

box "remote" #LightBlue
participant ”Remote BT“ as remote
end box

host -> bt: AT+SCAN=1\\r\\n
host <- bt: \\r\\nOK\\r\\n
        bt ->  remote: 扫描
        bt <-- remote: 广播包
host <- bt: \\r\\n+SCAN=0,1,DC0D30001ED4,-65,10,FSC-BT946\\r\\n
host -> bt: AT+LECCONN=DC0D30001ED41\\r\\n
host <- bt: \\r\\nOK\\r\\n
        bt ->  remote: 请求建立连接

rnote over host, remote: 连接成功

host <- bt: 拉高连接状态脚

rnote over host, remote: 发送数据

host -> bt: 串口发送 ABC
        bt ->  remote: 蓝牙发送 ABC
        bt <-  remote: 蓝牙发送 DEF
host <- bt: 串口输出 DEF

host -> bt: AT+LEDISC\\r\\n
host <- bt: \\r\\nOK\\r\\n
        bt ->  remote: 断开蓝牙

rnote over host, remote: 连接断开

host <- bt: 拉低连接状态脚
        bt --> remote: 广播包

@enduml

附录

下载 PDF版本

下载PDF版本