Bluetooth® Low Energy AT 命令集

[English]

注意

ESP32C2-4MB AT 固件支持 BluFi，而 ESP32C2-2MB AT 固件不支持 BluFi。如果您需要 ESP32C2-2MB 支持 BluFi 功能，请自行 编译 ESP-AT 工程，在第五步配置工程里选择：

  • Component config -> Bluetooth -> Bluetooth -> Host -> NimBLE - BLE only

  • Component config -> Bluetooth -> NimBLE Options -> Enable blufi functionality

AT+BLUFI：开启或关闭 BluFi

查询命令

功能：

查询 BluFi 状态

命令：

AT+BLUFI?

响应：

若 BluFi 未开启，则返回：

+BLUFI:0

OK

若 BluFi 已开启，则返回：

+BLUFI:1

OK

设置命令

功能：

开启或关闭 BluFi

命令：

AT+BLUFI=<option>[,<auth floor>]

响应：

OK

参数

  • <option>：

    • 0: 关闭 BluFi；

    • 1: 开启 BluFi。

  • <auth floor>：Wi-Fi 认证模式阈值，ESP-AT 不会连接到认证模式低于此阈值的 AP：

    • 0: OPEN（默认）；

    • 1: WEP；

    • 2: WPA_PSK；

    • 3: WPA2_PSK；

    • 4: WPA_WPA2_PSK；

    • 5: WPA2_ENTERPRISE；

    • 6: WPA3_PSK；

    • 7: WPA2_WPA3_PSK。

示例

AT+BLUFI=1

AT+BLUFINAME：查询/设置 BluFi 设备名称

查询命令

功能：

查询 BluFi 名称

命令：

AT+BLUFINAME?

响应：

+BLUFINAME:<device_name>
OK

设置命令

功能：

设置 BluFi 设备名称

命令：

AT+BLUFINAME=<device_name>

响应：

OK

参数

  • <device_name>：BluFi 设备名称。

说明

  • 如需设置 BluFi 设备名称，请在运行 AT+BLUFI=1 命令前设置，否则将使用默认名称 BLUFI_DEVICE。

  • BluFi 设备名称最大长度为 29 字节。

示例

AT+BLUFINAME="BLUFI_DEV"
AT+BLUFINAME?

AT+BLUFISEND: 发送 BluFi 用户自定义数据

设置命令

功能：

发送 BluFi 用户自定义数据给手机端

命令：

AT+BLUFISEND=<length>

Response:

>

符号 > 表示 AT 准备好接收串口数据，此时您可以输入数据，当数据长度达到参数 <length> 的值时，开始传输数据。

若数据传输成功，则提示：

OK

参数

  • <length>：数据长度，单位：字节。

说明

  • 自定义数据的长度不能超过 600 字节。

  • 如果 ESP 收到手机发来的用户自定义数据，那么会以 +BLUFIDATA:<len>,<data> 格式打印。

示例

AT+BLUFISEND=4
// 提示 ">" 符号后，输入 4 字节的数据即可，如 "1234"，然后数据会被自动发送给手机

提供有关此文档的反馈