Adafruit Bluefruit LE UART Friend的简介-电子发烧友网

简介

您想为您的机器人，艺术品或其他电子项目添加功能强大且易于使用的低功耗蓝牙吗？哎呀！ BLE现在包含在现代智能手机和平板电脑中，增加无线连接的乐趣。因此，您真正需要的是新的Adafruit Bluefruit LE UART Friend！

Bluefruit LE UART Friend可以轻松地通过硬件或软件串行端口向任何事物添加Bluetooth Low Energy连接。我们甚至拥有出色的硬件流控制，因此您不必考虑丢失数据。连接到您的Arduino或其他微控制器，甚至仅连接一条标准FTDI电缆即可进行调试和测试。

这个多功能模块可以做很多事情！对于大多数人来说，他们将很高兴使用标准的Nordic UART RX/TX连接配置文件。在此配置文件中，Bluefruit充当数据管道，可以“透明”地从您的iOS或Android设备来回传输。您可以使用我们的iOS应用程序或Android应用程序，也可以编写自己的应用程序与UART服务进行通信。

那么这是Fant PantsWireless UART适配器吗？

该开发板的功能远远不只是通过空中发送字符串！得益于易于学习的AT命令集，您可以完全控制设备的行为，包括定义和操作自己的GATT服务和特性的能力，或更改设备宣传自己的方式以供其他低功耗蓝牙设备查看的能力。您还可以使用AT命令来查询芯片温度，检查电池电压等等，还可以检查连接RSSI或MAC地址等等。真的，在这里列出太久了！

下载我们的免费Android/iOS

使用我们的Bluefruit iOS应用程序或Android应用程序，您可以通过使用iOS或Android手机/平板电脑作为控制器来快速获得项目原型。我们有一个颜色选择器，四元数/加速度计/陀螺仪/磁力计或位置（GPS）和一个8键控制游戏板。

您还可以做更多的事情！

Bluefruit也可以像HID键盘一样工作（对于支持BLE HID的设备）

可以成为BLE心率监视器（BLE的标准配置文件）-您只需要添加脉冲检测电路

将其转换为UriBeacon，这是蓝牙LE信标的Google标准。只需为其供电，“朋友将在安装了UriBeacon应用程序的地方过滤指向附近任何设备的URL。

内置了无线引导加载功能，因此我们可以为您提供最新的最新固件的最新信息。使用任何Android或iOS设备获取更新并进行安装！

为什么使用Adafruit的模块？

有很多BLE模块，硬件设计和固件的质量各不相同。

Adafruit Bluefruit LE系列的最大优势之一是我们从头开始编写了设备上运行的所有固件。

我们控制在我们的模块上运行的每一行代码。。.因此，我们不受任何第三方厂商的摆布，他们可能会或可能不会对保持其代码最新或满足我们客户的需求感兴趣。

因为我们控制了产品的所有方面，所以我们添加了对我们的客户很重要的功能，可以解决出现的任何问题，而无需乞求任何第三方，甚至可以完全更改蓝牙SoC如果有需要！

ARM Cortex M0内核以16MHz运行

256KB闪存

32KB SRAM

峰值电流消耗

传输：具有硬件流控制的UART @ 9600波特（需要CTS + RTS！）

5V安全输入（Arduin o不友好，等等。）

板载3.3V电压调节

引导加载程序，支持安全的OTA固件更新

轻松设置AT命令即可启动并快速运行

插脚

硬件流控制（CTS + RTS）应该始终与nRF51822一起使用。 UART外围模块的设计或多或少要求硬件流控制以实现可靠的UART通信，并且由于SoftDevice架构（Nordic专有的蓝牙低功耗堆栈）而具有很小的内部缓冲区和严格的时序限制。

电源引脚

VIN ：这是模块的电源，提供3.3-16V电源输入。将其降压至3.3V以运行芯片

GND ：电源和逻辑的公共/GND引脚

UART引脚

TXO -这是分支（Bluefruit LE-》 MCU）的UART发送引脚 out ，它处于3.3V逻辑电平。

RXI -这是UART将引脚插入分支（MCU-》 Bluefruit LE）。它上面有一个逻辑电平转换器，可以使用3-5V逻辑。

CTS -清除以将硬件流控制引脚发送到 breakou（MCU-》 Bluefruit LE）。使用该引脚告诉Bluefruit，它可以通过TXO引脚将数据发送回微控制器。默认情况下，此引脚被拉高，并且必须将其设置为接地才能使数据传输出去！如果不需要硬件流量控制，将此引脚接地，它是电平转换引脚，则可以使用3-5V逻辑

RTS -读取并发送流控制引脚到模块之外（Bluefruit LE-》 MCU）。可以将数据发送到Bluefruit时，此引脚将为低电平。通常，在9600波特时，我们没有看到此引脚的需要，但是您可以观看它进行全流控制！此引脚为3.3V输出

其他引脚

MOD ：模式选择。蓝果有两种模式，命令和数据。您可以保持此引脚断开连接，并使用滑动开关选择模式。或者，您可以通过设置此引脚电压来控制模式，它将覆盖开关设置！高=命令模式，低= UART/DATA模式。该引脚经过电平转换，可以使用3-5V逻辑

DFU ：在设备加电时将此引脚设置为低电平将强制Bluefruit LE模块输入特殊的固件更新模式以无线方式更新固件。设备加电后，该引脚也可以用于执行恢复出厂设置。将引脚连接到GND的时间超过5s，直到两个LED开始闪烁，然后释放该引脚（将其设置为5V或逻辑高电平），然后将恢复出厂设置。

反面突破

在背面我们也有一些突破！

Opt VBat：如果愿意，可以在JST 2-PH连接器上焊接，这将使您轻松插入锂离子电池或其他电池组。该连接器垫受二极管保护，因此您可以同时使用Vin和VBat，并且稳压器将自动切换到更高的电压

Opt。 32 KHz：：如果您要进行一些时髦的低功耗工作，我们希望为您提供32khz振荡器中的锡焊选项。我们的固件尚不支持它，但仍然存在！

SWC ：这是SWD时钟引脚，3v逻辑-适用于高级黑客！/p》

SWD ：这是3D逻辑的SWD数据引脚-适用于高级黑客！

3Vo： 3V调节器，用于测试，如果您真的需要3V调节器，则可用的最大电流为250mA。

FCR：这是出厂重置引脚。如果所有其他方法都失败了，而您确实做了一些使模块变得奇怪的事情，则在为模块加电时将此焊盘接地，它将恢复出厂设置。您应该首先尝试DFU重置方法（请参见该教程页面）

程序集

《表class =“ build-table”》

准备标题栏：

如有必要，将条切成一定长度。如果将其插入面包板，则焊接会更容易-长按针脚

添加分线板：

将分线板放在插针上，以使短插针穿过分线垫

还有焊料！

请务必焊接所有引脚以确保可靠的电接触。

先焊接较长的电源/数据条

（有关焊接的技巧，请务必查看我们的优秀焊接指南》）。

您完成了！目视检查焊点，然后继续进行下一步

接线

您可以将Bluefruit LE UART朋友用于任何具有3V或5V逻辑的微控制器。在这里，我们将演示Arduino UNO的软件序列和Arduino MEGA的硬件序列。根据您的微控制器是硬件还是软件UART，根据需要调整引脚！

用于Arduino Uno的接线

要使用示例草图中的默认引脚分配将Bluefruit LE UART Friend连接至Arduino Uno，请按以下方式连接引脚：

MOD 更改为 Pin 12

CTS 更改为 Pin 11

TXO 到 Pin 10

RXI 到 Pin 9

VIN 至 5V

RTS 至 Pin 8

GND 到 GND

下面的接线图显示了在系统上的外观：

所有这些引脚是“灵活的”，您可以在设置好运行程序后根据需要进行更改ng很好，但我们建议您使用默认接线。

为Arduino MEGA接线

这是在Arduino MEGA上推荐的方法。这也适用于Arduino Micro，Leonardo或任何其他具有硬件串行端口的板。要将Bluefruit LE UART Friend连接到Arduino MEGA（在这种情况下为Serial1），请使用以下引脚，并确保已在示例草图中选择了HW UART作为构造函数（它们默认为SW Serial）：

TX1 到 RXI

RX1 到 TXO

+ 5V 至 VIN

GND 至 GND

还将Bluefruit LE模块上的 CTS 连接到 GND

HW串行构造器可以在下面看到，并且应该在示例草图中不加注释：

下载：文件

复制代码

/* 。。.or hardware serial， which does not need the RTS/CTS pins. Uncomment this line */

Adafruit_BluefruitLE_UART ble（BLUEFRUIT_HWSERIAL_NAME， BLUEFRUIT_UART_MODE_PIN）; /* 。。.or hardware serial， which does not need the RTS/CTS pins. Uncomment this line */

Adafruit_BluefruitLE_UART ble（BLUEFRUIT_HWSERIAL_NAME， BLUEFRUIT_UART_MODE_PIN）;

未连接？尝试重启电源

如果示例草图似乎未连接，例如：

然后再次检查接线，并确保滑动开关处于CMD位置。如果一切正常，您也可以尝试重新启动Bluefruit LE UART Friend。只需拔下5V电线一秒钟，然后重新连接即可。然后尝试再次运行草图。希望它会开始响应。

FTDI电缆的接线

UART Friend是一个串行端口，您可以使用FTDI Friend或电缆通过任何串行控制台快速连接。您将不会获得MODE或DFU连接，因此，如果要进入特定模式，请不要忘记按一下模式开关。

只需将FTDI电缆直接插入Bluefruit LE UART中即可。通过使用中间的六个插针来放置朋友接头，请注意将电源插针正确对齐（红色线连接到VIN，黑色线连接到GND）：

恢复出厂设置

如果配置错误，可以使用多种方法对Bluefruit LE模块执行恢复出厂设置，或者删除持久性更改（如UriBeacon或广告）有效负载更改等。

Bluefruit LE的UART和SPI版本这些方法相同

通过DFU引脚恢复出厂设置

如果将DFU引脚保持低电平（将引脚设置为GND）》 5 （秒），一旦释放DFU引脚（将其与GND断开连接），模块旁边的红色和蓝色LED就会开始闪烁，并且设备将恢复出厂设置。

如果有一个DFU按钮而不是别针，只需按住按钮即可。

Factory重置示例草图

Adafruit Bluefruit LE库中有一个FactoryReset示例草图，可以在 File》 Examples》 Adafruit_BluefruitLE_nRF51 文件夹中进行访问（有关安装该工具的说明，请参见本教程的Software部分）。库）：

上载此草图并打开串行监视器，它将为您执行出厂重置：

AT + FACTORYRESET

您还可以通过在您喜欢的终端仿真器中向您的Bluefruit LE模块发送 AT + FACTORYRESET 命令或使用ATCommandexample草图来执行出厂重置。

下载：文件

复制代码

AT+FACTORYRESET

OK AT+FACTORYRESET

此命令还将导致设备重置。

通过FCTR测试板恢复出厂设置

位于Bluefruit LE底部朋友板或屏蔽板上有一个测试垫或引脚，该引脚暴露了模块上的出厂重置引脚（标记为 FCR 或 F.RST ）。在设备加电时将此垫设置为低将在启动时导致恢复出厂设置。

DFU更新

我们一直在研究Bluefruit LE固件，以添加新功能，并及时了解客户的需求。

为确保您及时了解这些更改，我们在所有基于nRF51的Bluefruit LE模块中都包含了易于使用的空中更新程序。

Adafruit Bluefruit LE Connect

将Bluefruit LE设备更新到最新固件就像安装Adafruit的Bluefruit LE Connect一样容易

只要有可用的固件更新，该应用程序就会建议下载最新的二进制文件并妥善保管所有将它们传输到Bluefruit设备的详细信息，如以下视频所示：

电流测量

下表让您了解了Bluefruit LE UART Friend在三种不同操作模式下的平均电流消耗：

快速广告模式（开机后的前30秒）

慢速广告模式（开机后》 30s）

连接模式（在这种情况下，使用UART配置文件）

测试条件

该板由运行于4.2V的充满电的1200mAh 4.2V LIPOcell供电。随着LIPO电池电压的下降，电源效率通常会提高，因此4.2V应该被认为是最坏的情况。

电源：1200mAh 4.2V LIPO电池（在4.2V）

固件：0.6.2

快速广告模式

Bluefruit LE UART Friend开机后的前30秒将进入“快速广告模式”，

平均电流：1.44mA

峰值电流：13.5mA

预计电池寿命：832小时（〜34.6天）

图表底部的三个矩形凸块可以看到MODE LED定期闪烁。

慢广告模式

Bluefruit LE UART Friend将在30秒后进入“慢广告模式”，每546.25ms发送一次广告包。

平均电流：1.25mA

峰值电流：13.5mA

预期的电池寿命：956小时（约40天）

ConnectedMode（UART）

以下测量结果说明了在连接模式下（启用了连接的LED时）的平均电流消耗。 UART模式用作测试用例。

平均电流：1.86mA

峰值电流：15.2mA

预计电池寿命：645小时（〜26.8天）

软件

要试用我们的演示，您需要下载基于nRF51的模块（例如Adafruit_BluefruitLE_nRF51）的Adafruit BLE库。 p》

您可以在github上查看代码，但单击以下代码可能更容易下载：

下载Adafruit_BluefruitLE_nRF51

重命名未压缩的文件夹 Adafruit_BluefruitLE_nRF51 ，并检查 Adafruit_BluefruitLE_nRF51 文件夹是否包含 Adafruit_BLE。 cpp 和 Adafruit_BLE .h （以及其他文件）

将 Adafruit_BluefruitLE_nRF51 库文件夹放在 arduinosketchfolder /libraries/文件夹。

如果您的第一个库是 libraries 子文件夹，则可能需要创建它。重新启动IDE。

我们还提供了有关Arduino库安装的出色教程，网址为：

http://learn.adafruit.com/adafruit-all-about-arduino-libraries-install-use

重新启动后，检查是否看到带有示例的库文件夹：

配置！

在开始上传任何示例草图之前，您需要ll需要配置Bluefruit界面-有很多选项，因此请密切注意！

您拥有哪个板子？

Bluefruit名称下有一些产品：

如果您使用的是Bluefruit LE Shield，则您有一个 SPI连接的NRF51822 模块。您可以将它与 Atmega328 （与Arduino UNO或兼容），ATmega32u4 （与Arduino Leonardo兼容）或 ATSAMD21 （与Arduino Zero相兼容）和可能还有其他。

您的引脚排列为硬件SPI ，CS = 8 ，IRQ = 7 ，RST = 4

Bluefruit Micro或Feather 32u4 Bluefruit

如果您拥有Bluefruit Micro或Feather 32u4 Bluefruit LE，则您的 ATmega32u4 芯片具有硬件SPI ， CS = 8 ，IRQ = 7 ，RST =4

羽毛M0蓝果LE

如果您有羽毛M0蓝果LE，那么您带有硬件SPI 的 ATSAMD21 芯片，CS = 8 ，IRQ = 7 ，RST = 4

Bluefruit LE SPI朋友

如果您有独立模块，则可以灵活布线，但是我们强烈建议您使用硬件SPI ，CS = 8 ，IRQ = 7 ，RST = 4

您几乎可以将其与任何具有5或6个引脚的微控制器一起使用

Bluefruit LE UART Friend或Flora BLE

如果您有独立的UART模块，则可以灵活布线。但是，如果可能，我们建议硬件UART 。如果您不使用硬件UART，则可能需要使用流控制 CTS 引脚。还有一个 MODE 引脚

您可以将其与至少具有3个引脚的任何微控制器一起使用，但最好与具有硬件串行/UART功能的芯片一起使用！

配置使用的引脚

您将需要检查Bluefruit Config来设置将用于UART或SPI的引脚

每个示例草图都有一个带有配置的辅助选项卡细节。设置完成后，您将需要编辑草图并将其保存到自己的文档文件夹中。

常用设置：

您可以设置为通信缓冲区留出多少RAM，以及是否要具有完整的调试输出。调试输出在串行控制台上是“嘈杂的”，但很方便，因为您可以看到micro和BLE之间的所有通信

下载：文件

复制代码

// ----------------------------------------------------------------------------------------------

// These settings are used in both SW UART， HW UART and SPI mode

// ----------------------------------------------------------------------------------------------

#define BUFSIZE 128 // Size of the read buffer for incoming data

#define VERBOSE_MODE true // If set to ‘true’ enables debug output // ----------------------------------------------------------------------------------------------

// These settings are used in both SW UART， HW UART and SPI mode

// ----------------------------------------------------------------------------------------------

#define BUFSIZE 128 // Size of the read buffer for incoming data

#define VERBOSE_MODE true // If set to ‘true’ enables debug output

软件UART

如果您使用的是软件UART，则可以设置将用于RX的引脚， TX和CTS流量控制。某些微控制器只能使用哪些引脚！查看SoftwareSerial库文档以获取更多详细信息

下载：文件

复制代码

// SOFTWARE UART SETTINGS

#define BLUEFRUIT_SWUART_RXD_PIN 9 // Required for software serial！

#define BLUEFRUIT_SWUART_TXD_PIN 10 // Required for software serial！

#define BLUEFRUIT_UART_CTS_PIN 11 // Required for software serial！

#define BLUEFRUIT_UART_RTS_PIN -1 // Optional， set to -1 if unused // SOFTWARE UART SETTINGS

#define BLUEFRUIT_SWUART_RXD_PIN 9 // Required for software serial！

#define BLUEFRUIT_SWUART_TXD_PIN 10 // Required for software serial！

#define BLUEFRUIT_UART_CTS_PIN 11 // Required for software serial！

#define BLUEFRUIT_UART_RTS_PIN -1 // Optional， set to -1 if unused

硬件UART

如果您有硬件串行，则有一个“名称”，通常是Serial1-您可以在此处设置：

下载：文件

复制代码

// HARDWARE UART SETTINGS

#ifdef Serial1 // this makes it not complain on compilation if there‘s no Serial1

#define BLUEFRUIT_HWSERIAL_NAME Serial1

#endif // HARDWARE UART SETTINGS

#ifdef Serial1 // this makes it not complain on compilation if there’s no Serial1

#define BLUEFRUIT_HWSERIAL_NAME Serial1

#endif

模式引脚

对于硬件和软件串行，您可能会要定义MODE引脚。有一些草图不使用它，而是取决于设置/取消模式的命令。如果您有备用的GPIO，最好使用MODE引脚！

下载：文件

复制代码

#define BLUEFRUIT_UART_MODE_PIN 12 // Set to -1 if unused #define BLUEFRUIT_UART_MODE_PIN 12 // Set to -1 if unused

SPI引脚

对于硬件和软件SPI，您都需要设置 CS （片选）行， IRQ （中断请求）行，如果有备用引脚，请 RST （重置）

下载：文件

复制代码

// SHARED SPI SETTINGS

#define BLUEFRUIT_SPI_CS 8

#define BLUEFRUIT_SPI_IRQ 7

#define BLUEFRUIT_SPI_RST 4 // Optional but recommended， set to -1 if unused // SHARED SPI SETTINGS

#define BLUEFRUIT_SPI_CS 8

#define BLUEFRUIT_SPI_IRQ 7

#define BLUEFRUIT_SPI_RST 4 // Optional but recommended， set to -1 if unused

软件SPI引脚

如果没有可用的硬件SPI端口，则可以使用任何三个引脚。。.速度稍慢但非常灵活

下载：文件

复制代码

// SOFTWARE SPI SETTINGS

#define BLUEFRUIT_SPI_SCK 13

#define BLUEFRUIT_SPI_MISO 12

#define BLUEFRUIT_SPI_MOSI 11 // SOFTWARE SPI SETTINGS

#define BLUEFRUIT_SPI_SCK 13

#define BLUEFRUIT_SPI_MISO 12

#define BLUEFRUIT_SPI_MOSI 11

请参考上表确定您有SPI或UART控制的Bluefruits！

选择串行总线

在BluefruitConfig.h文件中配置了引脚设置后，现在就可以检查并修改示例草图。

Adafruit_BluefruitLE_nRF51该库支持四种不同的串行总线选项，具体取决于您使用的硬件：硬件和软件类型均为 SPI ，硬件和软件类型均为 UART 。

基于UART的主板（Bluefruit LE UART Friend和Flora BLE）

这是针对Bluefruit LE UART Friend和Flora BLE板的。您可以使用软件序列或硬件序列。硬件串行具有较高的质量，并且丢失数据的风险较小。但是，您可能没有可用的硬件串行！软件序列确实可以在流控制下正常工作，并且我们只需一个GPIO引脚就可以使用它。

对于软件序列（Arduino Uno，Adafruit Metro），您应该取消注释下面的软件序列构造器，并确保已注释掉其他三个选项（硬件串行和SPI）。

下载：file

复制代码

// Create the bluefruit object， either software serial.。.uncomment these lines

SoftwareSerial bluefruitSS = SoftwareSerial（BLUEFRUIT_SWUART_TXD_PIN， BLUEFRUIT_SWUART_RXD_PIN）;

Adafruit_BluefruitLE_UART ble（bluefruitSS， BLUEFRUIT_UART_MODE_PIN，

BLUEFRUIT_UART_CTS_PIN， BLUEFRUIT_UART_RTS_PIN）; // Create the bluefruit object， either software serial.。.uncomment these lines

SoftwareSerial bluefruitSS = SoftwareSerial（BLUEFRUIT_SWUART_TXD_PIN， BLUEFRUIT_SWUART_RXD_PIN）;

Adafruit_BluefruitLE_UART ble（bluefruitSS， BLUEFRUIT_UART_MODE_PIN，

BLUEFRUIT_UART_CTS_PIN， BLUEFRUIT_UART_RTS_PIN）;

对于需要硬件串行（Adafruit Flora等）的主板，请取消注释硬件串行构造函数，并确保已注释掉其他三个选项

下载：文件

复制代码

/* 。。.or hardware serial， which does not need the RTS/CTS pins. Uncomment this line */

Adafruit_BluefruitLE_UART ble（BLUEFRUIT_HWSERIAL_NAME， BLUEFRUIT_UART_MODE_PIN）; /* 。。.or hardware serial， which does not need the RTS/CTS pins. Uncomment this line */

Adafruit_BluefruitLE_UART ble（BLUEFRUIT_HWSERIAL_NAME， BLUEFRUIT_UART_MODE_PIN）;

基于SPI的板（Bluefruit LE SPI Friend）

对于基于SPI的板，您应取消注释以下硬件SPI构造函数，并确保已注释掉其他构造函数：

下载：文件

复制代码

/* 。。.hardware SPI， using SCK/MOSI/MISO hardware SPI pins and then user selected CS/IRQ/RST */

Adafruit_BluefruitLE_SPI ble（BLUEFRUIT_SPI_CS， BLUEFRUIT_SPI_IRQ， BLUEFRUIT_SPI_RST）; /* 。。.hardware SPI， using SCK/MOSI/MISO hardware SPI pins and then user selected CS/IRQ/RST */

Adafruit_BluefruitLE_SPI ble（BLUEFRUIT_SPI_CS， BLUEFRUIT_SPI_IRQ， BLUEFRUIT_SPI_RST）;

如果某些无法使用硬件SPI的原因，可以通过以下构造函数切换到软件模式以对SPI传输进行位冲击：

下载：文件

复制代码

/* 。。.software SPI， using SCK/MOSI/MISO user-defined SPI pins and then user selected CS/IRQ/RST */

Adafruit_BluefruitLE_SPI ble（BLUEFRUIT_SPI_SCK， BLUEFRUIT_SPI_MISO，

BLUEFRUIT_SPI_MOSI， BLUEFRUIT_SPI_CS，

BLUEFRUIT_SPI_IRQ， BLUEFRUIT_SPI_RST）; /* 。。.software SPI， using SCK/MOSI/MISO user-defined SPI pins and then user selected CS/IRQ/RST */

Adafruit_BluefruitLE_SPI ble（BLUEFRUIT_SPI_SCK， BLUEFRUIT_SPI_MISO，

BLUEFRUIT_SPI_MOSI， BLUEFRUIT_SPI_CS，

BLUEFRUIT_SPI_IRQ， BLUEFRUIT_SPI_RST）;

ATCommand

ATCommand 示例可让您从草图中执行AT命令，并在串行监视器中查看结果。这对于调试或仅测试不同的命令以了解它们在现实世界中的工作方式很有用。这是一个很好的开始！

打开草图

要打开ATCommand草图，请单击Arduino IDE中的文件》示例》 Adafruit_BluefruitLE_nRF51 文件夹，然后选择 atcommand ：

在IDE中打开该示例的新实例，如下所示：

配置

请先检查配置！页面，以设置软件/硬件UART或软件/硬件SPI的草图。默认值为硬件SPI

如果使用软件或硬件串行UART：

本教程不需要使用MODE引脚，请确保您具有该模式如果您未配置并连接MODE引脚，请切换到CMD模式

如果您不使用它，请不要忘记将Bluefruit的CTS引脚接地！（植物群已经做到了）

运行草图

将草图上传到板上（通过箭头形的上传图标），并且上传过程完成后，请通过“工具”》“串行监视器” ，并确保右下角的波特率设置为 115200 ：

要将AT命令发送到Bluefruit LE模块，请输入串行监视器顶部的文本框中的命令和clic k 发送按钮：

对AT命令的响应将显示在串行监视器的主要部分。‘ ATI ’的响应如下所示：

您通过设置AT命令，可以在此提示下执行几乎所有操作。尝试 AT + HELP 获取所有命令的列表，并尝试使用 AT + HWGETDIETEMP （在nRF51822芯片处获得温度）和 AT + HWRANDOM （生成随机数）

BLEUart

BLEUart 示例草图可让您在Arduino和另一个蓝牙接口上的蓝牙低功耗中央设备之间发送和接收文本数据结束（例如您的手机使用UART模式的Android或iOS上的 Adafruit Bluefruit LE Connect 应用程序）。

打开草图

要打开ATCommand草图，请单击文件》示例》 Adafruit_BluefruitLE_nRF51 Arduino IDE中的文件夹，然后选择 bleuart_cmdmode ：

这将在IDE中打开示例的新实例，如下所示：

配置

之前请检查配置！页面以设置软件/硬件UART或软件/硬件SPI的草图。默认值为硬件SPI

如果使用软件或硬件串行UART：

本教程不需要使用MODE引脚，请确保您具有该模式如果您未配置并连接MODE引脚，请切换到CMD模式

如果您不使用它，请不要忘记将Bluefruit的CTS引脚接地！（植物群已经做到了）

运行草图

将草图上传到板上（通过箭头形的上传图标），并且上传过程完成后，请通过“工具”》“串行监视器” ，并确保右下角的波特率设置为 115200 ：

看到请求后，请使用App连接到处于 UART 模式的Bluefruit LE模块，因此您可以获得tex电话上的t框

您在“串行监视器”顶部的框中键入的任何文本都会发送到已连接的电话，并且从电话发送的任何数据都将显示在串行监视器中：

您可以在下面的Adafruit Bluefruit LE Connect应用程序（在本例中为iOS）中看到传入的字符串：

响应文本（“为什么，Arduino！”）如下所示：

HIDKeyboard

HIDKeyboard 示例向您展示如何使用内置的HID键盘AT命令将键盘数据发送到任何启用BLE的Android或iOS手机或其他支持BLE HID外设的设备。

打开草图

要打开ATCommand草图，请单击Arduino IDE中的文件》示例》 Adafruit_BluefruitLE_nRF51 文件夹，然后选择 hidkeyboard 》：

这将在IDE中打开该示例的新实例，如下所示：

配置

请先检查配置！页面，以设置软件/硬件UART或软件/硬件SPI的草图。默认值为硬件SPI

如果使用软件或硬件串行UART：

本教程不需要使用MODE引脚，请确保您具有该模式

别忘了也将如果不使用的话，将Bluefruit上的CTS引脚接地！（植物区系有此功能）已经完成）

正在运行草图

将草图上传到板上（通过箭头形的上传图标），并且上传过程完成后，请通过工具》串行监视器打开串行监视器》，并确保右下角的波特率设置为 115200 ：

要发送键盘数据，请在“串行监视器”顶部的文本框中键入任何内容，然后单击发送按钮。

绑定HID键盘

在使用HID键盘之前，您需要将其“绑定”到手机或电脑绑定过程在两个设备之间建立了永久的连接，这意味着一旦您的手机或PC再次看到Bluefruit LE模块，它将自动连接。

绑定键盘的确切步骤会有所不同。

当您不再需要绑定或希望绑定时将Bluefruit LE模块连接到另一台设备，请确保删除手机或PC上的绑定信息，否则您可能无法在新设备上连接！

Android

要在启用了蓝牙低功耗功能的Android设备上绑定键盘，请转到设置应用程序，然后单击蓝牙图标。

这些屏幕截图基于Nexus 7 2013上运行的Android 5.0。确切的外观可能会有所不同，具体取决于您的设备和操作系统版本。

在“蓝牙”设置面板中，您应该会看到“ Bluefruit LE”模块在“可用设备”列表下以 Bluefruit键盘做广告：

点击设备将启动绑定过程，该过程应以将Bluefruit Keyboard设备移动到新的“ Paired devices”（已配对设备）列表中并在设备名称下方写有“ Connected”（已连接）的方式结束：》

要删除绑定信息，请单击设备名称右侧的齿轮图标，然后单击请点击忘记按钮：

iOS

要在iOS设备上绑定键盘，请转到e 设置应用程序，然后单击蓝牙菜单项。

键盘应出现在其他设备下列表：

绑定过程完成后，设备将被移至我的设备类别，您可以开始将Bluefruit LE模块用作键盘：

要取消绑定设备，请点击“信息”图标，然后在菜单中选择忘记此设备选项：

OS X

要在OS X设备上绑定键盘，请转到蓝牙首选项窗口，然后单击旁边的配对按钮。 Bluefruit Keyboard 设备生成d通过以下示例草图：

要在配对后解除绑定，请单击 Bluefruit键盘旁边的小“ x”图标：

。。.。。.，然后单击删除确认对话框弹出时》按钮：

控制器

控制器草图可让您在手持控制器或外部数据源中启用BLE的iOS或Android设备，您可以利用手机或平板电脑上丰富的传感器。

您可以从手机中获取加速度计或四元数数据，然后通过BLE将其推送到Arduino，或者获取最新的GPS坐标无需购买（或供电！）任何外部硬件。

打开草图

要打开Controllersketch，请单击Arduino IDE中的文件》示例》 Adafruit_BluefruitLE_nRF51 文件夹，然后选择 controller ：

这将在IDE中打开该示例的新实例，如下所示：

配置

检查配置！设置页面，以设置软件/硬件UART或软件/硬件SPI的草图。默认值为硬件SPI

如果使用软件或硬件串行UART：

如果您连接了本教程，本教程也将更易于使用。 MODE引脚，您可以使用任何引脚，但我们的教程默认情况下具有12引脚。您可以将其更改为任何引脚。如果您未设置MODE引脚，那么请确保将模式开关置于CMD 模式

如果您使用的是Flora或不想连接模式引脚，在配置选项卡中将BLUEFRUIT_UART_MODE_PIN设置为-1，以便草图将使用+++方法在命令模式和数据模式之间切换！

不要忘记也连接CTS （植物群已完成此操作）

运行草图

将草图上传到板上（通过箭头形的上传图标），然后上传过程完成，通过工具》串行监视器打开串行监视器，并确保右下角的波特率设置为 115200 ：

在控制器模式下使用Bluefruit LE Connect

草图运行后，您可以打开Adafruit的Bluefruit LE Connect应用程序（适用于Android或iOS）并使用控制器应用程序以与草图交互。（如果您不熟悉Bluefruit LE Connect，请参阅我们专用的Bluefruit LE Connect学习指南。）

在欢迎屏幕上，选择 Adafruit Bluefruit BLE设备列表中的LE 设备：

然后从活动列表中选择控制器：

这将显示可从手机或平板电脑发送到的数据点列表您的Bluefruit LE模块，方法是启用或禁用适当的传感器。

流式传输传感器数据

您可以从手机中获取四元数（绝对方向），加速度计，陀螺仪，磁力计或GPS位置数据，然后通过Controller活动将其直接发送到Arduino。

例如通过启用加速度计字段，您可以会在应用程序中看到加速度计数据更新：

数据将在示例草图中进行解析，并输出到串行监视器，如下所示：

下载：文件

复制代码

Accel 0.20 -0.51 -0.76

Accel 0.22 -0.50 -0.83

Accel 0.25 -0.51 -0.83

Accel 0.21 -0.47 -0.76

Accel 0.27 -0.48 -0.82 Accel 0.20 -0.51 -0.76

Accel 0.22 -0.50 -0.83

Accel 0.25 -0.51 -0.83

Accel 0.21 -0.47 -0.76

Accel 0.27 -0.48 -0.82

请注意，即使我们仅打印2个小数点，其值仍是从应用程序接收的完整的4字节浮点数。

控制面板模块

您也可以使用控制面板模块，通过选择适当的菜单项来捕获按钮的按下和释放：

这将弹出“控制面板”面板，如下所示：

按钮的按下和释放都将使用所用按钮的ID记录到串行监视器中：

下载：文件

复制代码

Button 8 pressed

Button 8 released

Button 3 pressed

Button 3 released Button 8 pressed

Button 8 released

Button 3 pressed

Button 3 released

拾色器模块

您还可以通过拾色器模块发送RGB颜色数据，该模块显示以下颜色选择对话框：

这将为您提供以下格式的十六进制颜色数据：

下载：file

复制代码

RGB #A42FFF RGB #A42FFF

您可以组合颜色选择器和控制器示例草图，以制作由移动应用程序中的按钮触发的可配置颜色的动画-对于可穿戴设备非常方便！下载以下组合的示例代码（已配置为Feather，但易于适应FLORA，BLE Micro等）以开始使用：

feather_bluefruit_neopixel_animation_controller.zip

HeartRateMonitor

HeartRateMonitor 示例可让您定义newGATT服务和关联的GATT特征，并使用标准AT命令更新特征值。

打开草图

要打开ATCommand草图，请单击Arduino IDE中的文件》示例》 Adafruit_BluefruitLE_nRF51 文件夹，然后选择 heartratemonitor ：

这将在IDE，如下所示：

配置

检查配置！页面之前，可以设置软件/硬件UART或软件/硬件SPI的草图。默认值为硬件SPI

或软件UART

本教程不需要使用MODE引脚，如果您未配置并连接MODE引脚，请确保将模式开关置于CMD模式 p》

此演示使用了一些长数据传输字符串，因此即使您使用的是硬件串行，我们也建议定义CTS和RTS并将其连接到引脚。

如果您使用的是Flora或仅不想连接CTS或RTS，请将#define引脚设置为-1，别忘了还将Bluefruit上的CTS引脚接地！（植物群已经做到了）

如果使用RTS和CTS，则可以在下面删除此行，这会减慢数据传输速度

下载：文件

复制代码

// this line is particularly required for Flora， but is a good idea

// anyways for the super long lines ahead！

ble.setInterCharWriteDelay（5）; // 5 ms // this line is particularly required for Flora， but is a good idea

// anyways for the super long lines ahead！

ble.setInterCharWriteDelay（5）; // 5 ms

运行草图

将草图上传到板上（通过箭头形的上传图标），并且上传过程完成后，通过工具》串行监视器打开串行监视器，然后进行确保将右下角的波特率设置为 115200 ：

如果您在移动设备或笔记本电脑上打开支持标准心率监视器服务的应用程序，则应该能够看到心率与看到的更改同步更新在串行监视器中：

nRF Toolbox HRM示例

下图是来自Android上的Nordic的免费nRF Toolbox应用程序的屏幕截图（也适用于iOS），显示了传入的心率监视器数据：

CoreBluetooth HRM示例

下图来自苹果公司免费提供的CoreBluetooth示例应用程序，显示了如何使用低功耗蓝牙服务和特性：

UriBeacon

UriBeacon 示例向您展示如何使用内置的UriBeacon AT命令将Bluefruit LE模块配置为UriBeacon广告商，如下Google的物理Web UriBea规格。

打开草图

要打开ATCommand草图，请单击Arduino IDE中的文件》示例》 Adafruit_BluefruitLE_nRF51 文件夹，然后选择 uribeacon ：

这将打开一个IDE中示例的新实例，如下所示。您可以从默认的 http://www.adafruit.com 编辑信标将指向的URL，也可以直接上传以进行测试

配置

请更早检查配置！页面以设置软件/硬件UART或软件的草图/硬件SPI。默认值为硬件SPI

如果使用软件或硬件串行UART：

本教程不需要使用MODE引脚，请确保您具有该模式如果您未配置并连接MODE引脚，请切换到CMD模式

如果您不使用它，请不要忘记将Bluefruit的CTS引脚接地！（植物群已经做到了）

运行草图

将草图上传到板上（通过箭头形的上传图标），并且上传过程完成后，请通过“工具”》“串行监视器” ，并确保右下角的波特率设置为 115200 ：

这时，您可以打开Android的Physical Web Application或iOS版，您应该会看到一个广告Adafrui的链接t的网站：

帮助！

当将Bluefruit Micro或Bluefruit LE与Flora/Due/Leonardo/Micro一起使用时，示例无法运行？

我们在 setup（）上添加了一条特殊行以使它停止，直到Arduino看到您通过串口控制台连接。这样可以使调试工作变得很棒，但是却可以使您无法运行与计算机断开连接的程序。

解决方案？完成调试后，从setup（）中删除这两行

下载：文件

复制代码

while （！Serial）;

delay（500）; while （！Serial）;

delay（500）;

我似乎无法“找到” Bluefruit LE！

是否正在获取类似内容？

对于UART/串行Bluefruits：

检查CMD中是否有 MODE 开关，如果未使用MODE引脚，则MODE引脚未连接任何东西！

如果正在尝试通过微型计算机控制 MODE ，请确保在草图中设置MODE引脚

确保您具有 RXI 和 TXO 接线正确！它们经常被意外交换

如果您使用硬件串行而不使用CTS，请确保 CTS 已连接到GND

检查MODE红色LED，它在闪烁吗？如果其持续闪烁，则表明您可能处于DFU模式，请重启该模块！

如果您使用的是“硬件串行/软件串行”，请确保知道哪一个并进行了设置

如果使用SPI Bluefruit：

确保已正确连接所有5（或6）根导线。

如果使用硬件SPI，则需要确保您已连接到硬件SPI端口，具体取决于主芯片组。

如果使用Bluefruit Micro：

请确保您更改了将 RESET 引脚固定到任何配置文件中的＃4。另外，请确保您正在使用硬件SPI进行连接！

数据模式

通过将BLEFriend模块置于“ UART数据”模式（将模式选择开关设置为 UART 或将MODE引脚设置为gound），您可以将该模块用作Bluefruit应用程序的“透明UART连接”。这使得数据传输超级简单。在 RXI 引脚上接收到任何9600波特数据，并且通过 TXO 引脚

为了避免微控制器过载，可以使用流量控制引脚。保持CTS引脚为高电平，直到您准备好获取更多数据为止，然后将其接地，以使Bluefruit模块知道您已准备好获取更多数据！

此模式使用硬件流控制！您必须将CTS引脚接地才能启用TXO引脚，因此，如果您想知道为什么它不发送数据，请检查是否正确使用了CTS！

您可以通过查看模式LED来确定您是否处于数据模式。它应该闪烁两次，然后暂停三秒钟，如下所示：

然后您可以以 UART 模式连接该应用并透明地发送/接收数据

通过+++切换命令/数据模式

在连接的任一端（通过Arduino Uno或在您的移动应用中），您都可以动态通过发送“ +++ n ”字符串在命令和数据模式之间切换，如+++命令摘要中所述。

如果您以数据模式启动，则可以使用“ +++ nATI n +++ n”发送文本，这将导致Bluefruit LE模块切换到命令模式，执行ATI命令，然后再切换回数据模式。

可以从任一侧发送+++命令，使其成为po可以从移动应用程序以及Bluefruit LE端执行命令。

下载：文件

复制代码

# Start in Data Mode

》 Hello， World！ Data mode！

# Send command to switch modes

》 +++

# Bluefruit LE module switches to CMD mode

# Send ATI command and wait for the response

》 ATI

《 BLEFRIEND

《 nRF51822 QFAAG00

《 B122AAC33F3D2296

《 0.6.2

《 May 01 2015

《 OK

# Switch back to DATA mode

》 +++

《 OK

# We‘re back in data mode now

Welcome back！ # Start in Data Mode

》 Hello， World！ Data mode！

# Send command to switch modes

》 +++

# Bluefruit LE module switches to CMD mode

# Send ATI command and wait for the response

》 ATI

《 BLEFRIEND

《 nRF51822 QFAAG00

《 B122AAC33F3D2296

《 0.6.2

《 May 01 2015

《 OK

# Switch back to DATA mode

》 +++

《 OK

# We’re back in data mode now

Welcome back！

命令模式

通过将BLEFriend模块置于“命令”模式（将模式选择开关设置为 CMD 或将MODE引脚设置为高电压），您可以输入各种Hayes AT样式的命令来配置设备或检索有关BLE连接模块的基本信息。

为了避免微控制器过载，可以使用流控制针脚。保持CTS引脚为高电平，直到您准备好获取更多数据为止，然后将其接地，以使Bluefruit模块知道您已准备好获取更多数据！

此模式使用硬件流控制！您必须将CTS引脚接地以启用TXO引脚，因此，如果您想知道为什么它不响应命令，请检查是否正确使用了CTS！

您可以通过查看模式LED来确定您是否处于命令模式。它应该闪烁三下，然后是三秒钟的暂停，如下所示：

Hayes/AT命令

在命令模式下运行时，Bluefruit LE Pro模块使用Hayes AT风格的命令集来配置设备。

AT风格的命令集的优点在于，它易于在机器间通信中使用，但仍然对用户友好。

测试命令模式‘=？’

“测试”模式用于检查系统上是否存在指定的命令。

某些固件版本或配置可能包含或不包含特定命令，您可以通过使用命令名称并在其后附加‘=？’来确定该命令是否存在，如下所示

下载：文件

复制代码

AT+BLESTARTADV=？ AT+BLESTARTADV=？

如果存在该命令，设备将通过“确定” 进行回复。如果没有该命令，则设备将以‘错误’进行回复。

下载：文件

复制代码

AT+BLESTARTADV=？

AT+MISSINGCMD=？

ERROR AT+BLESTARTADV=？

AT+MISSINGCMD=？

ERROR

写入命令模式‘= xxx’

‘写入’模式用于为命令分配特定的值，例如

要在命令中写入值，只需在命令后附加‘=’符号，然后再添加anyparamater（ s）您希望编写（除了将被解释为tet模式的孤独‘？’字符）：

下载：文件

复制代码

AT+BLEPOWERLEVEL=-8 AT+BLEPOWERLEVEL=-8

如果写入成功后，通常会在新行上收到“确定” 响应，如下所示：

下载：文件

复制C ode

AT+BLEPOWERLEVEL=-8

OK AT+BLEPOWERLEVEL=-8

如果命令出现问题（例如参数无效），您将得到》‘ERROR’响应，在新行中显示，如下所示：

下载：file

复制代码

AT+BLEPOWERLEVEL=3

ERROR AT+BLEPOWERLEVEL=3

ERROR

注意：生成此特定错误是因为对于AT + BLEPOWERLEVEL命令，“ 3”不是有效值。将成功输入‘-4’，‘0’或‘4’ ，因为这些都是该命令的有效值。

执行模式

“执行”模式将使特定命令“运行”，如果可能的话，

下载：文件

复制代码

AT+FACTORYRESET AT+FACTORYRESET

您可能使用执行模式来执行出厂重置，例如，通过执行AT + FACTORYRESET命令如下：

下载：文件

复制代码

AT+FACTORYRESET

OK AT+FACTORYRESET

注意：许多要读取的命令无论将其发送给谁都将执行相同的操作。 “执行”或“读取”模式下的命令解析器。例如，以下命令将产生相同的结果：

下载：文件

复制代码

AT+BLEGETPOWERLEVEL

-4

AT+BLEGETPOWERLEVEL？

-4

OK AT+BLEGETPOWERLEVEL

-4

AT+BLEGETPOWERLEVEL？

-4

如果该命令不支持执行模式，则响应通常为“错误”

阅读命令模式‘？’

“读取”模式用于读取命令的当前值。

并非每个命令都支持读取模式，但是通常使用它来检索诸如通过在命令后附加一个‘？’来显示当前无线电的发射功率电平，如下所示：

下载：文件

复制代码

AT+BLEPOWERLEVEL？ AT+BLEPOWERLEVEL？

如果命令没有t支持读取模式，或者如果请求有问题，通常会得到一个‘ERROR’响应。

如果命令读取成功，则您可以通常将获得读取结果，然后在新行上按“确定” ，如下所示：

下载：文件

复制代码

AT+BLEPOWERLEVEL？

-4

OK AT+BLEPOWERLEVEL？

-4

注意：对于简单的命令，“读取”模式和“执行”模式的行为相同。

通过+++动态切换模式

在命令模式下操作时，您可以通过+++命令在软件中动态切换到数据模式（然后再次切换）。有关详细信息，请参见完整的命令描述。

标准AT

Bluefruit LE模块上提供以下标准Hayes/AT命令：

充当ping来检查我们是否处于命令模式。如果处于命令模式，则应该收到“确定”响应。

代码库修订：0.3.0

参数》：无

输出：无

下载：文件

复制代码

OK AT

ATI

显示有关Bluefruit模块的基本信息。

代码库修订：0.3.0

参数：无

输出：显示以下值：

板名

微控制器/无线电SoC名称

唯一的序列号

核心Bluefruit代码库修订版

项目固件修订版

固件构建日期

软设备，软设备版本，引导加载程序版本（0.5.0 +）

下载：文件

复制代码

ATI

BLEFRIEND

nRF51822 QFAAG00

FB462DF92A2C8656

0.5.0

Feb 24 2015

S110 7.1.0， 0.0

OK ATI

BLEFRIEND

nRF51822 QFAAG00

FB462DF92A2C8656

0.5.0

Feb 24 2015

S110 7.1.0， 0.0

《强g》更新：

版本 0.4.7 + 的固件在可以检测到芯片名称之后添加芯片修订（例如， ‘nRF51822 QFAAG00’）。

版本 0.5.0 + 会添加新的第七条记录，其中包含软件设备，软件设备版本和引导加载程序版本（例如‘S110 7.1.0 ，0.0’）。

ATZ

执行系统重置。

代码库修订：0.3.0

参数：无

输出：无

下载：文件

复制代码

ATZ

OK ATZ

ATE

使用AT解析器启用或禁用输入字符的回显

代码库修订：0.3.0

参数：‘1’=启用回显，‘0’=禁用回显

输出：无

下载：文件

复制代码

# Disable echo support

ATE=0

#Enable echo support

ATE=1

OK # Disable echo support

ATE=0

#Enable echo support

ATE=1

+++

在DATA和COMMAND模式之间动态切换，而无需更改物理CMD/UART选择开关

在COMMAND模式下，输入‘+++ n’或‘+++ r n’将导致模块切换到DATA模式，并且在控制台中键入的所有内容都会消失

要从DATA模式切换回COMMAND模式，只需再次输入‘+++ n’或‘+++ r n’（确保包括换行符！），并显示一个新的“ OK”响应，让您知道您已回到COMMAND模式（请参见下面的示例代码中的两个“ OK”条目）。

代码库修订：0.4.7

参数：无

输出：无

请注意，+++也可以在移动设备上用于在iOS上发送和接收AT命令或Android，尽管应始终谨慎使用。

请参阅AT + MODESWITCHEN命令以控制+++命令的可用性

下载：文件

复制代码

ATI

BLEFRIEND

nRF51822 QFAAG00

B122AAC33F3D2296

0.4.6

Dec 22 2014

+++

OK ATI

BLEFRIEND

nRF51822 QFAAG00

B122AAC33F3D2296

0.4.6

Dec 22 2014

+++

通用

所有Bluefruit LE模块上均提供以下通用命令：

AT + FACTORYRESET

清除非易失性存储器中的所有用户配置数据，并在重置之前执行出厂重置

代码库修订：0.3.0

参数：无

输出：无

下载：文件

复制代码

AT+FACTORYRESET

OK AT+FACTORYRESET

从固件版本0.5.0+开始，您可以通过按住DFU按钮10秒钟直到蓝色的CONNECTED LED点亮，然后释放按钮来执行出厂重置。

AT + DFU

强制该模块进入DFU模式，允许空中固定使用iOS或Android上的专用DFU应用重新更新。

代码库修订：0.3.0

参数：无

输出：无

输入AT + DFU命令后，AT解析器将不再响应，因为正常的程序执行有效地停止并且执行了完整的系统重置以启动引导加载程序代码

下载：文件

复制代码

AT+DFU

OK AT+DFU

AT + HELP

显示以逗号分隔的列表系统上可用的所有AT解析器命令。

代码库版本：0.3.0

参数：无

输出：系统上可用的所有AT解析器命令的逗号分隔列表。

示例代码为低可能与将来的固件版本不匹配，并且仅用于说明目的

下载：file

复制代码

AT+HELP

AT+FACTORYRESET，AT+DFU，ATZ，ATI，ATE，AT+DBGMEMRD，AT+DBGNVMRD，AT+HWLEDPOLARITY，AT+HWLED，AT+HWGETDIETEMP，AT+HWMODEPINPOLARITY，AT+HWMODEPIN，AT+HWGPIOMODE，AT+HWGPIO，AT+HWI2CSCAN，AT+HWADC，AT+HWVBAT，AT+HWPWM，AT+HWPWRDN，AT+BLEPOWERLEVEL，AT+BLEGETADDRTYPE，AT+BLEGETADDR，AT+BLEBEACON，AT+BLEGETRSSI，AT+GAPGETCONN，AT+GAPDISCONNECT，AT+GAPDEVNAME，AT+GAPDELBONDS，AT+GAPINTERVALS，AT+GAPSTARTADV，AT+GAPSTOPADV，AT+GAPAUTOADV，AT+GAPSETADVDATA，AT+BLEUARTTX，AT+BLEUARTRX，AT+GATTADDSERVICE，AT+GATTADDCHAR，AT+GATTCHAR，AT+GATTLIST，AT+GATTCLEAR，AT+HELP

OK AT+HELP

AT + NVMWRITE

将数据写入256字节用户非易失性存储器（NVM）区域。

代码库版本：0.7.0

参数：

偏移：第一个数字偏移用户NVM中从起始位置开始的字节

数据类型：可以是STRING（1），BYTEARRAY（2）或INTEGER（3）之一

数据：要写入NVM内存的数据（确切的有效负载格式将根据指定的数据类型而变化）。

输出：没事

下载：文件

复制代码

# Write 32768 as an integer starting at byte 16 in user NVM

AT+NVMWRITE=16，INTEGER，32768

OK # Write 32768 as an integer starting at byte 16 in user NVM

AT+NVMWRITE=16，INTEGER，32768

AT + NVMREAD

从256字节用户非易失性存储器（NVM）区域读取数据。

代码库版本：0.7.0

参数：

偏移：第一个数字偏移用户NVM中起始位置的字节数

大小：要读取的字节数

数据类型：使用的类型对于正在读取的数据，需要正确解析数据并将其显示为响应。该值可以是STRING（1），BYTEARRAY（2）或INTEGER（3）之一

输出：回读的数据，根据数据类型进行格式化

下载：文件

复制代码

# Read an integer back from position 16 in user NVM

AT+NVMREAD=16， 4， INTEGER

32768

OK # Read an integer back from position 16 in user NVM

AT+NVMREAD=16， 4， INTEGER

32768

AT + MODESWITCHEN

通过连接的BLE UART一侧的BLE外设上的“ +++”命令启用或禁用模式切换。

代码库版本：0.7 .1

参数：

位置：这可以是字符串，可以是‘ local ”或“ ble ”，指示哪一方应启用或禁用“ +++”命令，“本地”是Bluefruit外围设备，“ ble”是电话或平板电脑。

状态：“ 0 ”以禁用“ +++”模式开关，“ 1 ”以启用它们。

输出：无

默认情况下，“ +++”在本地启用，并在BLE中禁用

下载：文件

复制代码

# Disable reomte ’+++‘ mode switches

AT+MODESWITCHEN=ble，0

OK # Disable reomte ’+++‘ mode switches

AT+MODESWITCHEN=ble，0

硬件

以下命令使您可以与Bluefruit LE模块上的低级硬件交互，例如读取或切换GPIO引脚，执行ADC转换等。。：

AT + BAUDRATE

更改nRF51822上的HW UART外设使用的波特率。请注意，我们不建议使用高于9600的波特率，因为nRF51 UART会丢弃字符！

代码库修订：0.7.0

参数：波特率，必须为以下值之一：

1200

2400

4800

9600

14400

19200

28800

38400

57600

76800

115200

230400

250000

460800

921600

1000000

输出：当前波特率

下载：文件

复制代码

# Set the baud rate to 115200

AT+BAUDRATE=115200

# Check the current baud rate

AT+BAUDRATE

115200

OK # Set the baud rate to 115200

AT+BAUDRATE=115200

# Check the current baud rate

AT+BAUDRATE

115200

AT + HWADC

在指定的ADC引脚上执行ADC转换

代码库修订：0.3.0

参数：ADC通道（0..7）

输出：ADC转换的结果

下载：文件

复制代码

AT+HWADC=0

178

OK AT+HWADC=0

178

AT + HWGETDIETEMP

获取温度BLE模块裸片的摄氏度。可以将其用于调试目的（较高的管芯温度通常意味着较高的电流消耗），但不对应于环境温度，因此不能替代常规温度传感器。

代码库修订：0.3.0

参数：无

输出：模具温度（摄氏度）

下载：文件

复制代码

AT+HWGETDIETEMP

32.25

OK AT+HWGETDIETEMP

32.25

AT + HWGPIO

获取或设置指定的GPIO引脚的值（取决于引脚的模式）。

代码库修订：0.3.0

参数：此命令的参数根据引脚模式而变化。

输出模式：在更新引脚时，可以使用以下逗号分隔的参数设置为输出：

插针编号

插针状态，其中：

0 =清除引脚（逻辑低电平/GND）

1 =设置引脚（逻辑高电平/VCC）

输入模式：要读取输入引脚或已配置为输出的引脚的当前状态，请输入引脚号作为单个参数。

输出：如果您正在读取输入或检查输入引脚的状态（表示仅提供1个参数，即引脚号），则为引脚状态，

0表示该引脚为逻辑低/GND

1表示该引脚为逻辑高/VCC

尝试设置未配置为输出的引脚的值将产生“错误”响应。

某些引脚保留用于Bluefruit模块上的特定功能，不能用作GPIO。如果您尝试使用保留的密码，则会生成“错误”响应。

下载：文件

复制代码

# Set pin 14 HIGH

AT+HWGPIO=14，1

# Set pin 14 LOW

AT+HWGPIO=14，0

# Read the current state of pin 14

AT+HWGPIO=14

# Try to update a pin that is not set as an output

AT+HWGPIOMODE=14，0

AT+HWGPIO=14，1

ERROR # Set pin 14 HIGH

AT+HWGPIO=14，1

# Set pin 14 LOW

AT+HWGPIO=14，0

# Read the current state of pin 14

AT+HWGPIO=14

# Try to update a pin that is not set as an output

AT+HWGPIOMODE=14，0

AT+HWGPIO=14，1

ERROR

AT + HWGPIOMODE

这将为指定的GPIO引脚（输入，输出等）设置模式。

代码库修订：0.3.0

参数：此命令一个或两个值（在两个参数的情况下用逗号分隔）

引脚号

新的GPIO模式，其中：

0 =输入

1 =输出

2 =启用了上拉的输入

3 =启用了上拉的输入

输出：如果传递了单个参数（GPIO引脚号），则会返回当前的引脚模式。

某些引脚保留用于Bluefruit模块和ca上的特定功能n不能用作GPIO。如果您尝试使用保留的密码，则会生成“错误”响应。

下载：文件

复制代码

# Configure pin 14 as an output

AT+HWGPIOMODE=14，0

# Get the current mode for pin 14

AT+HWPGIOMODE=14

OK # Configure pin 14 as an output

AT+HWGPIOMODE=14，0

# Get the current mode for pin 14

AT+HWPGIOMODE=14

AT + HWI2CSCAN

扫描I2C总线以尝试检测任何已连接的I2C设备，并返回以前的设备地址

代码库修订：0.3.0

参数：无

输出：扫描I2C总线上的有效地址范围时找到的任何I2C地址的逗号分隔列表，或者没有找到任何设备。

下载：文件

复制代码

# I2C scan with two devices detected

AT+HWI2CSCAN

0x23，0x35

# I2C scan with no devices detected

AT+HWI2CSCAN

OK # I2C scan with two devices detected

AT+HWI2CSCAN

0x23，0x35

# I2C scan with no devices detected

AT+HWI2CSCAN

AT + HWVBAT

返回主电源电压级别（以毫伏为单位）

代码库修订：0.3.0

参数：无

输出：VBAT电平（以毫伏为单位）

下载：文件

复制代码

AT+HWVBAT

3248

OK AT+HWVBAT

3248

AT + HWRANDOM

生成使用nRF51822上的硬件随机数发生器生成一个32位随机数（基于白噪声）。

代码库修订：0.4.7

参数：无

输出：随机的32位十六进制值（例如’0x12345678‘）

下载：文件

复制代码

AT+HWRANDOM

0x769ED823

OK AT+HWRANDOM

0x769ED823

AT + HWMODELED

允许您覆盖MODE led的默认行为（默认情况下指示运行模式）。

代码库修订：0.6.6

参数：LED运行模式，可以是以下值之一：

禁用或 DISABLE 或 0 -完全禁用MODE LED以省电

模式或 MODE 或 1 -默认行为，指示当前操作模式

hwuart 或 HWUART 或 2 -在硬件UART总线上的任何活动（TX或RX）上切换LED

bleuart 或 BLEUART 或 3 -切换LED上的任何活动BLE UART服务（TX或RX特性）

spi 或 SPI 或 4 -在任何SPI活动上切换LED

手动或手动或 5 -通过第二个逗号分隔的参数手动设置MODE LED的状态，可以打开，关闭或切换。

输出：如果不带参数运行，则从上面的字段中返回一个大写的字符串，表示当前的MODE LED操作模式

下载：文件

复制代码

# Get the curent MODE LED setting

AT+HWMODELED

MODE

# Change the MODE LED to indicate BLE UART activity

AT+HWMODELED=BLEUART

# Manually toggle the MODE LED

AT+HWMODELED=MANUAL，TOGGLE

OK # Get the curent MODE LED setting

AT+HWMODELED

MODE

# Change the MODE LED to indicate BLE UART activity

AT+HWMODELED=BLEUART

# Manually toggle the MODE LED

AT+HWMODELED=MANUAL，TOGGLE

AT + UARTFLOW

在nRF51822的UART外围模块上启用或禁用硬件流控制（CTS + RTS）。/p》

代码库修订：0.7.0

参数：硬件流控制状态，可以是以下之一：

上

off

输出：如果不带参数运行，返回一个数字，该数字表示流控制是启用（1）还是禁用（0）。

下载：file

复制代码

# Check the current flow control state

AT+UARTFLOW

# Disable HW flow control

AT+UARTFLOW=off

OK # Check the current flow control state

AT+UARTFLOW

# Disable HW flow control

AT+UARTFLOW=off

信标

Adafruit的Bluefruit LE模块当前支持以下“信标”技术：

信标（Apple）通过AT + BLEBEACON

UriBeacon（Google）通过AT + BLEURIBEACON（已弃用）

Eddystone（Google）通过AT + EDDYSTONE *

可以使用以下命令将模块配置为充当“信标”：

AT + BLEBEACON

代码库修订：0.3.0

参数：以下逗号-启用信标模式需要使用分隔的参数：

蓝牙制造商ID（uint16_t）

128位UUID

主要值（uint16_t）

次要值（uint16_t）

RSSI @ 1m（int8_t）

输出：无

下载：文件

复制代码

# Enable Apple iBeacon emulation

# Manufacturer ID = 0x004C

AT+BLEBEACON=0x004C，01-12-23-34-45-56-67-78-89-9A-AB-BC-CD-DE-EF-F0，0x0000，0x0000，-59

# Reset to change the advertising data

ATZ

# Enable Nordic Beacon emulation

# Manufacturer ID = 0x0059

AT+BLEBEACON=0x0059，01-12-23-34-45-56-67-78-89-9A-AB-BC-CD-DE-EF-F0，0x0000，0x0000，-59

# Reset to change the advertising data

ATZ

OK # Enable Apple iBeacon emulation

# Manufacturer ID = 0x004C

AT+BLEBEACON=0x004C，01-12-23-34-45-56-67-78-89-9A-AB-BC-CD-DE-EF-F0，0x0000，0x0000，-59

# Reset to change the advertising data

ATZ

# Enable Nordic Beacon emulation

# Manufacturer ID = 0x0059

AT+BLEBEACON=0x0059，01-12-23-34-45-56-67-78-89-9A-AB-BC-CD-DE-EF-F0，0x0000，0x0000，-59

# Reset to change the advertising data

ATZ

AT + BLEBEACON将导致将信标数据存储在Bluefruit LE模块上的非易失性配置存储器中，并且这些值将在系统重置和关机后再启动时保持不变。要删除或清除信标数据，您需要在命令模式下输入“ AT + FACTORYRESET”命令。

使用上面的示例代码输入Nordic Beacon仿真，您可以在下面的Nordic的“信标配置”工具中看到模拟的信标：

AT + BLEURIBEACON 》

将指定的URI转换为UriBeaconadvertising数据包，并将该模块配置为作为UriBeacon（Google物理Web项目的一部分）进行广告。

要查看UriBeacon URI，您可以使用以下移动设备之一应用程序：

Android 4.3+：Google Play商店上的物理Web

iOS：Apple的App Store中的物理Web

代码库修订版：0.4.7

参数：要编码的URI（例如http://www.adafruit.com/blog）

输出：未输入有效的URI（长度为acc

下载：文件

复制代码

AT+BLEURIBEACON=http://www.adafruit.com/blog

# Reset to change the advertising data

ATZ

OK AT+BLEURIBEACON=http://www.adafruit.com/blog

# Reset to change the advertising data

ATZ

如果提供的URI太长，您将获得以下输出：

下载：文件

复制代码

AT+BLEURIBEACON=http://www.adafruit.com/this/uri/is/too/long

URL is too long

ERROR AT+BLEURIBEACON=http://www.adafruit.com/this/uri/is/too/long

URL is too long

ERROR

如果您要编码的URI太长，请尝试使用诸如bit.ly之类的缩短服务，然后对缩短的URI。

UriBeacon应该视为不推荐使用，和EddyStone应该用于将来的任何开发。在UriBeacon周围的Bluefruit LE固件中不会进行进一步的开发。

弃用：AT + EDDYSTONEENABLE

此命令将在Bluefruit LE模块上启用Eddystone支持。必须先启用Eddystone支持，然后才能使用其他相关命令。

代码库修订：0.6.6

参数： 1或0（1 =启用，0 =禁用）

输出：如果未提供任何参数，则Eddystone支持的当前状态（1 =启用，0 =禁用）

此命令已在固件0.7.0中删除，以避免造成混淆。在0.7.0及更高版本中使用AT + EDDYSTONESERVICEEN。

下载：文件

复制代码

# Enable Eddystone support

AT+EDDYSTONEENABLE=1

# Check the current Eddystone status on the module

AT+EDDYSTONEENABLE

OK # Enable Eddystone support

AT+EDDYSTONEENABLE=1

# Check the current Eddystone status on the module

AT+EDDYSTONEENABLE

AT + EDDYSTONEURL

此命令将设置Eddystone-URL协议的URL。

代码库修订：0.6 .6

参数：

要编码的网址（强制性）

可选的第二个参数指示是否继续即使外围设备连接到中央设备，也要发布Eddystone URL。

固件 0.6.7 为RSSI的0米值添加了一个可选的第三个参数。最终用户应通过检查接收设备上1m处的RSSI值，然后在该值上加上41（以补偿超过1m的信号强度损失）来进行测量，因此1m处的RSSI为-62意味着您应该在0m输入-21作为RSSI。默认值为-18dBm。

输出：固件《= 0.6.6：无。如果固件》 = 0.6.7 ，不带任何参数运行此命令，则会返回当前URL。

下载：文件

复制代码

# Set the Eddystone URL to adafruit

AT+EDDYSTONEURL=http://www.adafruit.com

# Set the Eddystone URL to adafruit and advertise it even when connected

AT+EDDYSTONEURL=http://www.adafruit.com，1

OK # Set the Eddystone URL to adafruit

AT+EDDYSTONEURL=http://www.adafruit.com

# Set the Eddystone URL to adafruit and advertise it even when connected

AT+EDDYSTONEURL=http://www.adafruit.com，1

AT + EDDYSTONECONFIGEN

此命令使Bluefruit LE模块在指定的秒数内启用Eddystone URL配置服务。

此命令应与Google的Physical Web应用程序结合使用，可用于Android或iOS。运行此命令，然后从应用程序中选择“编辑URL”选项以空中更改目标URL。

代码库修订：0.6.6

参数：发布配置服务UUID的秒数

输出：无

下载：文件

复制代码

# Start advertising the Eddystone config service for 5 minutes （300s）

AT+EDDYSTONECONFIGEN=300

OK # Start advertising the Eddystone config service for 5 minutes （300s）

AT+EDDYSTONECONFIGEN=300

AT + EDDYSTONESERVICEEN

从GATT添加或删除Eddystone服务表（需要重置才能生效）。

代码库修订：0.7.0

参数：是否应该使用以下值中的一个启用或不启用Eddystone服务：

off

输出：如果命令不带任何参数执行，它将禁用一个数字值，该值指示服务是启用（1）还是禁用（0）。/p》

您必须执行系统重置才能使此命令生效。

下载：文件

复制代码

# Enable Eddystone service

AT+EddyStonServiceEn=on

AT+EddyStonServiceEn=1

# Disable Eddystone service

AT+EddyStonServiceEn=off

AT+EddyStonServiceEn=0

OK # Enable Eddystone service

AT+EddyStonServiceEn=on

AT+EddyStonServiceEn=1

# Disable Eddystone service

AT+EddyStonServiceEn=off

AT+EddyStonServiceEn=0

AT + EDDYSTONEBROADCAST

此命令可用于开始使用存储在非易失性存储器（NVM）中的URL停止播发Eddystone有效载荷。

代码库修订：0.7.0

参数：是否使用以下值之一广播有效载荷：

off

输出：如果不执行任何参数，则当前广播状态将显示为数字值。

下载：文件

复制代码

# Enable broadcasting current setting of EddyStone （stored previously on nvm）

AT+EddyStoneBroadcast=on

AT+EddyStoneBroadcast=1

# Disable broadcasting current setting of EddyStone （still stored on nvm）

AT+EddyStoneBroadcast=off

AT+EddyStoneBroadcast=0

OK # Enable broadcasting current setting of EddyStone （stored previously on nvm）

AT+EddyStoneBroadcast=on

AT+EddyStoneBroadcast=1

# Disable broadcasting current setting of EddyStone （still stored on nvm）

AT+EddyStoneBroadcast=off

AT+EddyStoneBroadcast=0

BLE通用

Bluefruit LE模块上提供以下通用BLE命令：

AT + BLEPOWERLEVEL

获取或设置模块无线电的当前发射功率等级（更高的发射功率等于更好的范围，更低的发射功率等于更长的电池寿命。

代码库修订：0.3.0

参数：TX功率电平（以dBm为单位），可以是以下值之一（从最低到更高的发射功率）：

-40

-20

-16

-12

-8

-4

输出：当前发射功率电平（以dBm为单位）

更新的功率级别将在输入命令后立即生效。如果该设备未连接到其他设备，则广告将暂时停止，然后在新的功率水平生效后重新开始。

下载：文件

复制代码

# Get the current TX power level （in dBm）

AT+BLEPOWERLEVEL

# Set the TX power level to 4dBm （maximum value）

AT+BLEPOWERLEVEL=4

# Set the TX power level to -12dBm （better battery life）

AT+BLEPOWERLEVEL=-12

# Set the TX power level to an invalid value

AT+BLEPOWERLEVEL=-3

ERROR # Get the current TX power level （in dBm）

AT+BLEPOWERLEVEL

# Set the TX power level to 4dBm （maximum value）

AT+BLEPOWERLEVEL=4

# Set the TX power level to -12dBm （better battery life）

AT+BLEPOWERLEVEL=-12

# Set the TX power level to an invalid value

AT+BLEPOWERLEVEL=-3

ERROR

AT + BLEGETADDRTYPE

获取地址类型（用于48位BLE设备地址）

通常这是’1‘（随机），这意味着模块使用48位地址，该地址是在制造过程中随机生成的，并由制造商写入裸片。

随机并不意味着每次都会随机生成设备地址，而只是使用一个随机数。

代码库修订：0.3.0

参数：无

输出：地址类型，可以是以下值之一：

0 =公共

1 =随机

下载：文件

复制代码

AT+BLEGETADDRTYPE

OK AT+BLEGETADDRTYPE

AT + BLEGETADDR

获取48位BLE设备地址。

代码库修订：0.3.0

参数：无

输出：48位BLE设备地址，格式如下：’AA：BB：CC：DD：EE：FF‘

下载：文件

复制代码

AT+BLEGETADDR

E4:C6:C7:31:95:11

OK AT+BLEGETADDR

E4:C6:C7:31:95:11

AT + BLEGETPEERADDR

获取我们连接到的对等（中央）设备的48位地址。

代码库修订：0.6.5

参数：无

输出：连接的中央设备的48位地址（十六进制格式）。如果我们未连接到中央设备，该命令将返回错误。

请注意，中央设备返回的地址几乎始终是随时间变化的随机值，通常不应信任该值。此命令是为某些特殊情况提供的，但在大多数日常情况下没有用。

下载：文件

复制代码

AT+BLEGETPEERADDR

48:B2:26:E6:C1:1D

OK AT+BLEGETPEERADDR

48:B2:26:E6:C1:1D

AT + BLEGETRSSI

获取RSSI值（接收信号强度指示器），可用于估计数据的可靠性在两个设备之间传输（数字越小越好）。

代码库修订：0.3.0

参数：无

输出：如果我们连接到设备，则RSSI级别（以dBm为单位），否则为’0‘

下载：文件

复制代码

# Connected to an external device

AT+BLEGETRSSI

-46

# Not connected to an external device

AT+BLEGETRSSI

OK # Connected to an external device

AT+BLEGETRSSI

-46

# Not connected to an external device

AT+BLEGETRSSI

BLE服务

以下命令允许您在命令模式下运行时与Bluefruit LE模块上存在的各种GATT服务进行交互。

AT + BLEUARTTX

此命令将发送指定的文本消息在命令模式下运行时通过UART服务。

代码库修订：0.3.0

参数：消息有效负载发送。有效载荷最多可以包含240个字符（因为AT命令字符串的总长度限制为最多256个字节）。

输出：此命令将产生错误消息，如果您未连接到中央设备，或者Bluefruit LE模块上的内部TX FIFO已满。

从固件版本开始， 0.6 .2 及更高版本，AT + BLEUARTTX可以接受一组有限的转义码序列：

r =回车符

n =新行

t =选项卡

b =退格

\ =反斜杠

从固件发行版开始 0.6.7 及更高版本，由于AT + BLEUARTTX = ？， AT + BLEUARTTX可以接受以下转义码序列。对AT解析器有特定含义：

？ =发送单个问号

从固件版本 0.7.6 起，AT + BLEUARTTX可以接受以下转义码序列：

+ =传输单个’+‘字符而不必担心`+++’模式开关组合

ESCAPE SEQUENCE注意：如果您尝试通过类似‘ble.print（“ 。。.”）;之类的代码发送转义序列，请注意，您需要发送一个双反斜杠，转义码才能按预期到达AT命令。例如：ble.println（“ AT + BLEUARTTX = Some Test \ r \ n”）;

您必须连接到其他设备才能执行此命令

下载：文件

复制代码

# Send a string when connected to another device

AT+BLEUARTTX=THIS IS A TEST

# Send a string when not connected

AT+BLEUARTTX=THIS IS A TEST

ERROR # Send a string when connected to another device

AT+BLEUARTTX=THIS IS A TEST

# Send a string when not connected

AT+BLEUARTTX=THIS IS A TEST

ERROR

TX FIFO缓冲区处理

从固件版本 0.6.7 开始，当TX FIFO缓冲区已满时，将使用200ms的阻塞延迟来查看返回ERROR之前FIFO中是否有可用空间。下面的流程图详细说明了确切的过程：

注意：每个GATT事务都会进行TX FIFO完全检查（最多20字节的每个数据），因此大型数据传输可能具有多个200ms等待状态。

您可以使用AT + BLEUARTFIFO = TX命令检查TX FIFO的大小在发送数据之前，请确保缓冲区中有足够的可用空间。

TX FIFO的大小取决于所使用的固件版本：

固件《= 0.6.6： 160个字符宽

固件》 = 0.6.7： 1024个字符宽

在进行大型数据传输时，可能会传输部分有效载荷，并且该命令仍会产生如果FIFO在第三个中间时间未及时清空，则发生错误有效载荷传输（因为数据以最大20字节的块传输）。如果需要确保可靠的数据传输，则应在发送数据之前始终检查TX FIFO的大小，这可以使用AT + BLEUARTFIFO命令进行。如果没有足够的空间用于整个有效负载，请添加一个SW延迟，直到有足够的可用空间为止。任何单个AT + BLEUARTTX命令都可以放入FIFO，但是此命令的多个大实例可能会导致FIFO在传输过程中填满。

AT + BLEUARTTXF

这是一种便捷功能，其作用与 AT + BLEUARTTX ，但数据立即在单个BLE数据包（“ force 数据包”中为“ F”）中发送。此命令最多接受 20个字符，这是单个数据包中可以发送的字符数的限制。

代码库修订：0.7。 6

参数：请参见 AT + BLEUARTTX

输出：请参见 AT + BLEUARTTX

AT + BLEUARTRX

如果在命令模式下运行时从UART服务接收到任何数据，此命令会将UART服务的RX缓冲区转储到显示器。一旦使用此命令显示数据，数据就会从缓冲区中删除。

切换回数据模式时，缓冲区中剩余的任何字符都会导致在模式切换后立即显示缓冲的字符。完整（在可用缓冲区空间的限制内，在当前黑色的32KB SRAM器件上为1024字节，对于基于16KB SRAM的蓝色第一代BLEFriend板为160字节）。

代码库修订版：0.3.0

参数：无

输出：RX缓冲区的内容（如果有可用数据）

，您也可以使用AT + BLEUARTFIFO = RX命令进行检查

下载：文件

复制代码

# Command results when data is available

AT+BLEUARTRX

Sent from Android

# Command results when no data is available

AT+BLEUARTRX

OK # Command results when data is available

AT+BLEUARTRX

Sent from Android

# Command results when no data is available

AT+BLEUARTRX

AT + BLEUARTFIFO

此该命令将返回BLE UART TX和RX FIFO中的可用空间。如果要传输大量数据，则可能要在发送前检查TX FIFO中是否有足够的可用空间，请记住，单个GATT数据包每个最多可以包含20个用户字节。

代码库修订：0.6.7

参数：不带参数运行此命令将返回两个逗号分隔的值，指示TX缓冲区中的可用空间，然后是RX缓冲区。要请求特定的缓冲区，可以使用“ TX”或“ RX”值（例如：“ AT + BLEUARTFIFO = TX”）执行命令。

输出：如果不存在任何参数，则TX和RX FIFO缓冲区中剩余的可用空间，否则，指定的FIFO缓冲区中剩余的可用空间。

下载：文件

复制代码

AT+BLEUARTFIFO

1024，1024

AT+BLEUARTFIFO=TX

1024

AT+BLEUARTFIFO=RX

1024

OK AT+BLEUARTFIFO

1024，1024

AT+BLEUARTFIFO=TX

1024

AT+BLEUARTFIFO=RX

1024

AT + BLEKEYBOARDEN

此命令将启用GATT over HID（GoH）键盘支持，使您可以在支持的iOS和Android设备上模拟键盘。默认情况下，HID键盘支持处于禁用状态，因此您需要将BLEKEYBOARDEN设置为1，然后执行系统重置，然后才能枚举键盘并出现在手机的Bluetooth（蓝牙）首选项中，可以将其绑定为BLE键盘。 p》

代码库修订：0.5.0

参数：1或0（1 =启用，0 =禁用）

输出：无

固件版本版本0.6.6，此命令现在是AT + BLEHIDEN的别名

必须先执行系统重置（ATZ），更改才能生效！

i》在通过GATT键盘使用HID之前，您需要将移动设备与Bluetooth偏好面板中的Bluefruit LE模块绑定。

下载：文件

Co py代码

# Enable BLE keyboard support then reset

AT+BLEKEYBOARDEN=1

ATZ

# Disable BLE keyboard support then reset

AT+BLEKEYBOARDEN=0

ATZ

OK # Enable BLE keyboard support then reset

AT+BLEKEYBOARDEN=1

ATZ

# Disable BLE keyboard support then reset

AT+BLEKEYBOARDEN=0

ATZ

AT + BLEKEYBOARD

通过BLE键盘界面发送文本数据（如果以前已经通过AT + BLEKEYBOARDEN启用了该数据）。

任何有效的alpha-可以发送数字字符，并且还支持以下转义序列：

r-回车符

n-换行符

b-Backspace

t-Tab

\-反斜杠

从0.6.7版本开始，您还可以使用以下转义代码发送单个字符时（“ AT + BLEKEYBOARD =？”对于AT解析器具有另一种含义）：

？ -问号

代码库修订：0.5.0

参数：文本字符串（可选，包括转义符）字符）以传输

输出：无

下载：文件

复制代码

# Send a URI with a new line ending to execute in Chrome， etc.

AT+BLEKEYBOARD=http://www.adafruit.com

# Send a single question mark （special use case， 0.6.7+）

AT+BLEKEYBOARD=？

OK # Send a URI with a new line ending to execute in Chrome， etc.

AT+BLEKEYBOARD=http://www.adafruit.com

# Send a single question mark （special use case， 0.6.7+）

AT+BLEKEYBOARD=？

AT + BLEKEYBOARDCODE

将USB HID键码的原始十六进制序列发送到BLE键盘界面，包括键修饰符和最多六个字母数字

此命令接受以下字符串编码的字节数组有效负载，与通过GATT的HID发送键盘数据的方式匹配：

字节0 ：修饰符

字节1 ：保留（应始终为00）

字节2..7 ：十六进制值）对应于HID键（如果不使用任何字符，则可以输入’00‘或将尾随的字符留空）

与AT + BLEKEYBOARDCODE命令一起发送，您必须发送第二个AT + BLEKEYBOARDCODE命令，该命令至少包含两个00个字符，以指示已释放键！

修饰符值

修饰符字节可以设置以下一个或多个位：

位0（0x01）：左控制

位1（0x02）：左移

位2（0x04）：左Alt

位3（0x08）：左窗口

位4（ 0x10）：右控制

第5位（0x20）：右移

第6位（0x40）：右Alt

第7位（0x80）：右窗口

代码库修订：0.5.0

参数：一组用连字符（’-‘）分隔的十六进制值。请注意，这些是HID扫描代码值，而不是标准ASCII值！

输出：无

HID键盘代码

十六进制格式的 HID键盘代码列表可以可以在此处找到（请参阅第7节），为方便起见，在下面列出：

HID键码值与ASCII键码不对应！例如，“ a”的HID密钥代码值为“ 04”，并且由于使用修饰符设置了大写字母值，因此没有大写字母“ A”的密钥代码。有关详细信息，请使用谷歌“ usb隐藏键盘扫描代码”，并查看以下示例。

下载：文件

复制代码

0x00 Reserved （no event indicated）

0x01 Keyboard ErrorRollOver

0x02 Keyboard POSTFail

0x03 Keyboard ErrorUndefined

0x04 Keyboard a and A

0x05 Keyboard b and B

0x06 Keyboard c and C

0x07 Keyboard d and D

0x08 Keyboard e and E

0x09 Keyboard f and F

0x0A Keyboard g and G

0x0B Keyboard h and H

0x0C Keyboard i and I

0x0D Keyboard j and J

0x0E Keyboard k and K

0x0F Keyboard l and L

0x10 Keyboard m and M

0x11 Keyboard n and N

0x12 Keyboard o and O

0x13 Keyboard p and P

0x14 Keyboard q and Q

0x15 Keyboard r and R

0x16 Keyboard s and S

0x17 Keyboard t and T

0x18 Keyboard u and U

0x19 Keyboard v and V

0x1A Keyboard w and W

0x1B Keyboard x and X

0x1C Keyboard y and Y

0x1D Keyboard z and Z

0x1E Keyboard 1 and ！

0x1F Keyboard 2 and @

0x20 Keyboard 3 and #

0x21 Keyboard 4 and $

0x22 Keyboard 5 and %

0x23 Keyboard 6 and ^

0x24 Keyboard 7 and &

0x25 Keyboard 8 and *

0x26 Keyboard 9 and （

0x27 Keyboard 0 and ）

0x28 Keyboard Return （ENTER）

0x29 Keyboard ESCAPE

0x2A Keyboard DELETE （Backspace）

0x2B Keyboard Tab

0x2C Keyboard Spacebar

0x2D Keyboard - and （underscore）

0x2E Keyboard = and +

0x2F Keyboard ［ and {

0x30 Keyboard ］ and }

0x31 Keyboard and |

0x32 Keyboard Non-US # and ~

0x33 Keyboard ; and ：

0x34 Keyboard ’ and “

0x35 Keyboard Grave Accent and Tilde

0x36 Keyboard， and 《

0x37 Keyboard 。 and 》

0x38 Keyboard / and ？

0x39 Keyboard Caps Lock

0x3A Keyboard F1

0x3B Keyboard F2

0x3C Keyboard F3

0x3D Keyboard F4

0x3E Keyboard F5

0x3F Keyboard F6

0x40 Keyboard F7

0x41 Keyboard F8

0x42 Keyboard F9

0x43 Keyboard F10

0x44 Keyboard F11

0x45 Keyboard F12

0x46 Keyboard PrintScreen

0x47 Keyboard Scroll Lock

0x48 Keyboard Pause

0x49 Keyboard Insert

0x4A Keyboard Home

0x4B Keyboard PageUp

0x4C Keyboard Delete Forward

0x4D Keyboard End

0x4E Keyboard PageDown

0x4F Keyboard RightArrow

0x50 Keyboard LeftArrow

0x51 Keyboard DownArrow

0x52 Keyboard UpArrow

0x53 Keypad Num Lock and Clear

0x54 Keypad /

0x55 Keypad *

0x56 Keypad -

0x57 Keypad +

0x58 Keypad ENTER

0x59 Keypad 1 and End

0x5A Keypad 2 and Down Arrow

0x5B Keypad 3 and PageDn

0x5C Keypad 4 and Left Arrow

0x5D Keypad 5

0x5E Keypad 6 and Right Arrow

0x5F Keypad 7 and Home

0x60 Keypad 8 and Up Arrow

0x61 Keypad 9 and PageUp

0x62 Keypad 0 and Insert

0x63 Keypad 。 and Delete

0x64 Keyboard Non-US and |

0x65 Keyboard Application

0x66 Keyboard Power

0x67 Keypad =

0x68 Keyboard F13

0x69 Keyboard F14

0x6A Keyboard F15

0x6B Keyboard F16

0x6C Keyboard F17

0x6D Keyboard F18

0x6E Keyboard F19

0x6F Keyboard F20

0x70 Keyboard F21

0x71 Keyboard F22

0x72 Keyboard F23

0x73 Keyboard F24

0x74 Keyboard Execute

0x75 Keyboard Help

0x76 Keyboard Menu

0x77 Keyboard Select

0x78 Keyboard Stop

0x79 Keyboard Again

0x7A Keyboard Undo

0x7B Keyboard Cut

0x7C Keyboard Copy

0x7D Keyboard Paste

0x7E Keyboard Find

0x7F Keyboard Mute

0x80 Keyboard Volume Up

0x81 Keyboard Volume Down

0x82 Keyboard Locking Caps Lock

0x83 Keyboard Locking Num Lock

0x84 Keyboard Locking Scroll Lock

0x85 Keypad Comma

0x86 Keypad Equal Sign

0x87 Keyboard International1

0x88 Keyboard International2

0x89 Keyboard International3

0x8A Keyboard International4

0x8B Keyboard International5

0x8C Keyboard International6

0x8D Keyboard International7

0x8E Keyboard International8

0x8F Keyboard International9

0x90 Keyboard LANG1

0x91 Keyboard LANG2

0x92 Keyboard LANG3

0x93 Keyboard LANG4

0x94 Keyboard LANG5

0x95 Keyboard LANG6

0x96 Keyboard LANG7

0x97 Keyboard LANG8

0x98 Keyboard LANG9

0x99 Keyboard Alternate Erase

0x9A Keyboard SysReq/Attention

0x9B Keyboard Cancel

0x9C Keyboard Clear

0x9D Keyboard Prior

0x9E Keyboard Return

0x9F Keyboard Separator

0xA0 Keyboard Out

0xA1 Keyboard Oper

0xA2 Keyboard Clear/Again

0xA3 Keyboard CrSel/Props

0xA4 Keyboard ExSel

0xE0 Keyboard LeftControl

0xE1 Keyboard LeftShift

0xE2 Keyboard LeftAlt

0xE3 Keyboard Left GUI

0xE4 Keyboard RightControl

0xE5 Keyboard RightShift

0xE6 Keyboard RightAlt

0xE7 Keyboard Right GUI 0x00 Reserved （no event indicated）

0x01 Keyboard ErrorRollOver

0x02 Keyboard POSTFail

0x03 Keyboard ErrorUndefined

0x04 Keyboard a and A

0x05 Keyboard b and B

0x06 Keyboard c and C

0x07 Keyboard d and D

0x08 Keyboard e and E

0x09 Keyboard f and F

0x0A Keyboard g and G

0x0B Keyboard h and H

0x0C Keyboard i and I

0x0D Keyboard j and J

0x0E Keyboard k and K

0x0F Keyboard l and L

0x10 Keyboard m and M

0x11 Keyboard n and N

0x12 Keyboard o and O

0x13 Keyboard p and P

0x14 Keyboard q and Q

0x15 Keyboard r and R

0x16 Keyboard s and S

0x17 Keyboard t and T

0x18 Keyboard u and U

0x19 Keyboard v and V

0x1A Keyboard w and W

0x1B Keyboard x and X

0x1C Keyboard y and Y

0x1D Keyboard z and Z

0x1E Keyboard 1 and ！

0x1F Keyboard 2 and @

0x20 Keyboard 3 and #

0x21 Keyboard 4 and $

0x22 Keyboard 5 and %

0x23 Keyboard 6 and ^

0x24 Keyboard 7 and &

0x25 Keyboard 8 and *

0x26 Keyboard 9 and （

0x27 Keyboard 0 and ）

0x28 Keyboard Return （ENTER）

0x29 Keyboard ESCAPE

0x2A Keyboard DELETE （Backspace）

0x2B Keyboard Tab

0x2C Keyboard Spacebar

0x2D Keyboard - and （underscore）

0x2E Keyboard = and +

0x2F Keyboard ［ and {

0x30 Keyboard ］ and }

0x31 Keyboard and |

0x32 Keyboard Non-US # and ~

0x33 Keyboard ; and ：

0x34 Keyboard ‘ and ”

0x35 Keyboard Grave Accent and Tilde

0x36 Keyboard， and 《

0x37 Keyboard 。 and 》

0x38 Keyboard / and ？

0x39 Keyboard Caps Lock

0x3A Keyboard F1

0x3B Keyboard F2

0x3C Keyboard F3

0x3D Keyboard F4

0x3E Keyboard F5

0x3F Keyboard F6

0x40 Keyboard F7

0x41 Keyboard F8

0x42 Keyboard F9

0x43 Keyboard F10

0x44 Keyboard F11

0x45 Keyboard F12

0x46 Keyboard PrintScreen

0x47 Keyboard Scroll Lock

0x48 Keyboard Pause

0x49 Keyboard Insert

0x4A Keyboard Home

0x4B Keyboard PageUp

0x4C Keyboard Delete Forward

0x4D Keyboard End

0x4E Keyboard PageDown

0x4F Keyboard RightArrow

0x50 Keyboard LeftArrow

0x51 Keyboard DownArrow

0x52 Keyboard UpArrow

0x53 Keypad Num Lock and Clear

0x54 Keypad /

0x55 Keypad *

0x56 Keypad -

0x57 Keypad +

0x58 Keypad ENTER

0x59 Keypad 1 and End

0x5A Keypad 2 and Down Arrow

0x5B Keypad 3 and PageDn

0x5C Keypad 4 and Left Arrow

0x5D Keypad 5

0x5E Keypad 6 and Right Arrow

0x5F Keypad 7 and Home

0x60 Keypad 8 and Up Arrow

0x61 Keypad 9 and PageUp

0x62 Keypad 0 and Insert

0x63 Keypad 。 and Delete

0x64 Keyboard Non-US and |

0x65 Keyboard Application

0x66 Keyboard Power

0x67 Keypad =

0x68 Keyboard F13

0x69 Keyboard F14

0x6A Keyboard F15

0x6B Keyboard F16

0x6C Keyboard F17

0x6D Keyboard F18

0x6E Keyboard F19

0x6F Keyboard F20

0x70 Keyboard F21

0x71 Keyboard F22

0x72 Keyboard F23

0x73 Keyboard F24

0x74 Keyboard Execute

0x75 Keyboard Help

0x76 Keyboard Menu

0x77 Keyboard Select

0x78 Keyboard Stop

0x79 Keyboard Again

0x7A Keyboard Undo

0x7B Keyboard Cut

0x7C Keyboard Copy

0x7D Keyboard Paste

0x7E Keyboard Find

0x7F Keyboard Mute

0x80 Keyboard Volume Up

0x81 Keyboard Volume Down

0x82 Keyboard Locking Caps Lock

0x83 Keyboard Locking Num Lock

0x84 Keyboard Locking Scroll Lock

0x85 Keypad Comma

0x86 Keypad Equal Sign

0x87 Keyboard International1

0x88 Keyboard International2

0x89 Keyboard International3

0x8A Keyboard International4

0x8B Keyboard International5

0x8C Keyboard International6

0x8D Keyboard International7

0x8E Keyboard International8

0x8F Keyboard International9

0x90 Keyboard LANG1

0x91 Keyboard LANG2

0x92 Keyboard LANG3

0x93 Keyboard LANG4

0x94 Keyboard LANG5

0x95 Keyboard LANG6

0x96 Keyboard LANG7

0x97 Keyboard LANG8

0x98 Keyboard LANG9

0x99 Keyboard Alternate Erase

0x9A Keyboard SysReq/Attention

0x9B Keyboard Cancel

0x9C Keyboard Clear

0x9D Keyboard Prior

0x9E Keyboard Return

0x9F Keyboard Separator

0xA0 Keyboard Out

0xA1 Keyboard Oper

0xA2 Keyboard Clear/Again

0xA3 Keyboard CrSel/Props

0xA4 Keyboard ExSel

0xE0 Keyboard LeftControl

0xE1 Keyboard LeftShift

0xE2 Keyboard LeftAlt

0xE3 Keyboard Left GUI

0xE4 Keyboard RightControl

0xE5 Keyboard RightShift

0xE6 Keyboard RightAlt

0xE7 Keyboard Right GUI

以下示例显示了如何使用此命令：

下载：文件

复制代码

# send ’abc‘ with left shift key （0x02） --》 ’ABC‘

AT+BLEKEYBOARDCODE=02-00-04-05-06-00-00

# Indicate that the keys were released （mandatory！）

AT+BLEKEYBOARDCODE=00-00

OK # send ’abc‘ with left shift key （0x02） --》 ’ABC‘

AT+BLEKEYBOARDCODE=02-00-04-05-06-00-00

# Indicate that the keys were released （mandatory！）

AT+BLEKEYBOARDCODE=00-00

AT + BLEHIDEN

此命令将启用GATT over HID（GoH）支持，使您可以在受支持的iOS，Android，OSX和Windows 10设备上模拟键盘，鼠标或媒体控件。默认情况下，HID支持处于禁用状态，因此您需要将BLEHIDEN设置为1，然后执行系统重置，然后枚举HID设备并出现在中央设备上。

代码库修订》：0.6.6

参数：1或0（1 =启用，0 =禁用）

输出：无

您通常需要“绑定” Bluefruit LE外设才能使用HID命令，确切的绑定过程将从一个操作系统更改为另一个操作系统。

如果您以前已绑定到设备并需要清除绑定，则可以运行AT + FACTORYRESET命令，该命令将删除Bluefruit LE模块上所有已存储的绑定数据。

下载：文件

复制代码

# Enable GATT over HID support on the Bluefruit LE module

AT+BLEHIDEN=1

# Reset so that the changes take effect

ATZ

OK # Enable GATT over HID support on the Bluefruit LE module

AT+BLEHIDEN=1

# Reset so that the changes take effect

ATZ

AT + B LEHIDMOUSEMOVE

移动HID鼠标或滚动指定位置的刻度数。

所有参数均为带符号的8位值（-128至+127）。正值向右或向下移动，原点位于左上角。

代码库修订：0.6.6

参数：X刻度（+/-），Y刻度（+/-），滚轮（+/-），平移轮（+/-）

输出：无

下载：文件

复制代码

# Move the mouse 100 ticks right and 100 ticks down

AT+BLEHIDMOUSEMOVE=100，100

# Scroll down 20 pixels or lines （depending on context）

AT+BLEHIDMOUSEMOVE=，，20，

# Pan （horizontal scroll） to the right （exact behaviour depends on OS）

AT+BLEHIDMOUSEMOVE=0，0，0，100 # Move the mouse 100 ticks right and 100 ticks down

AT+BLEHIDMOUSEMOVE=100，100

# Scroll down 20 pixels or lines （depending on context）

AT+BLEHIDMOUSEMOVE=，，20，

# Pan （horizontal scroll） to the right （exact behaviour depends on OS）

AT+BLEHIDMOUSEMOVE=0，0，0，100

AT + BLEHIDMOUSEBUTTON

通过特定的字符串操作HID鼠标按钮。

代码库修订：0.6.6

参数：按钮掩码字符串［L］［R］［M］［B］［F］，操作［PRESS］［CLICK］［DOUBLECLICK］［HOLD］

L =左按钮

R =右按钮

M =中间按钮

B =后退按钮

F =前进按钮

如果第二个参数（动作）为“ HOLD”，则可以传递一个可选的第三个参数，以指定按钮应保持的时间（以毫秒为单位）。

O utput ：无

下载：文件

复制代码

# Double click the left mouse button

AT+BLEHIDMOUSEBUTTON=L，doubleclick

# Press the left mouse button down， move the mouse， then release L

# This is required to perform ’drag‘ then stop type operations

AT+BLEHIDMOUSEBUTTON=L

AT+BLEHIDMOUSEMOVE=-100，50

AT+BLEHIDMOUSEBUTTON=0

# Hold the backward mouse button for 200 milliseconds （OS dependent）

AT+BLEHIDMOUSEBUTTON=B，hold，200

OK # Double click the left mouse button

AT+BLEHIDMOUSEBUTTON=L，doubleclick

# Press the left mouse button down， move the mouse， then release L

# This is required to perform ’drag‘ then stop type operations

AT+BLEHIDMOUSEBUTTON=L

AT+BLEHIDMOUSEMOVE=-100，50

AT+BLEHIDMOUSEBUTTON=0

# Hold the backward mouse button for 200 milliseconds （OS dependent）

AT+BLEHIDMOUSEBUTTON=B，hold，200

AT + BLEHIDCONTROLKEY

为绑定的设备发送HID媒体控制命令（调整音量，屏幕亮度，歌曲选择等）。

代码库修订：0.6.6

参数：要发送的HID控制键，后跟可选的延迟时间（以毫秒为单位）以按住按钮

控制键字符串可以可以是下列值之一：

您还可以发送’0xABCD‘格式的原始16位十六进制值。可以在此处找到16位“ HID消费者控制密钥代码”的完整列表（请参见第12节）。

输出：通常没有。

系统控件（在大多数系统上都可以使用）

BRIGHTNESS +

BRIGHTNESS-

媒体控件（适用于大多数系统）

PLAYPAUSE

MEDIANEXT

MEDIAPREVIOUS

MEDIASTOP

声音控制（在大多数系统上都可以使用）

音量

静音

低音

TREBLE

BASS_BOOST

VOLUME +

VOLUME-

BASS +

BASS-

TREBLE +

TREBLE-

应用程序启动器（到目前为止仅Windows 10）

EMAILREADER

CALCULATOR

FILEBROWSER

浏览器/文件浏览器控件（仅适用于Windows/Android上的Firefox）

HOME

前进

停止

刷新

书签

如果未绑定并连接到中央设备，此命令将返回ERROR。在运行这些命令之前，请确保已连接并启用了HID支持。

下载：文件

复制代码

# Toggle the sound on the bonded central device

AT+BLEHIDCONTROLKEY=MUTE

# Hold the VOLUME+ key for 500ms

AT+BLEHIDCONTROLKEY=VOLUME+，500

# Send a raw 16-bit Consumer Key Code （0x006F = Brightness+）

AT+BLEHIDCONTROLKEY=0x006F

OK # Toggle the sound on the bonded central device

AT+BLEHIDCONTROLKEY=MUTE

# Hold the VOLUME+ key for 500ms

AT+BLEHIDCONTROLKEY=VOLUME+，500

# Send a raw 16-bit Consumer Key Code （0x006F = Brightness+）

AT+BLEHIDCONTROLKEY=0x006F

AT + BLEHIDGAMEPADEN

在HID服务中启用HID游戏手柄支持。默认情况下，从0.7.6版固件开始禁用游戏手柄，因为它会在iOS和OS X上引起问题，并且只能在基于Android和Windows的设备上使用。

代码库修订版：0.7.6

参数：是否应通过以下值之一启用游戏手柄服务：

off

输出：如果不带参数执行，则为数值将返回指示电池服务是启用（1）还是禁用（0）。

此命令需要系统重置才能生效。

AT + BLEHIDGAMEPAD

通过BLE发送特定的HID游戏手柄有效载荷

代码库修订：0.7.0

参数：以下逗号分隔的参数可用：

x ：左，右：如果X = -1，则按“ LEFT”；如果X = 1，则按“ RIGHT”；如果X = 0，则既不按左，也不按右

y ：上，下：如果Y = -1，则按“ UP”；如果Y = 1，则按“ DOWN”；如果Y = 0，则既不按上，也不按

按钮：0x00-0xFF，这是8个按钮0-7的位掩码

输出：没有任何

HID游戏手柄默认从0.7.6版本开始被禁用，并且必须首先通过AT + BLEHIDGAMEPADEN启用= 1才能使用。

注意：您需要为每个按钮发送’press‘和’release‘事件，否则系统会认为按钮一直处于按下状态，直到收到释放状态为止。

下载：文件

复制代码

# Press ’RIGHT‘ and ’Button0‘ at the same time

AT+BLEHIDGAMEPAD=1，0，0x01

# Press ’UP‘ and ’Button1‘ + ’Button0‘ at the same time

AT+BLEHIDGAMEPAD=0，-1，0x03 # Press ’RIGHT‘ and ’Button0‘ at the same time

AT+BLEHIDGAMEPAD=1，0，0x01

# Press ’UP‘ and ’Button1‘ + ’Button0‘ at the same time

AT+BLEHIDGAMEPAD=0，-1，0x03

AT + BLEMIDIEN

启用或禁用BLE MIDI服务。

代码库修订：0.7。 0

参数：状态，可以是以下之一：

打开

关闭

输出：如果不执行任何参数，它将以整数形式返回MIDI服务的当前状态，指示如果已启用（1）或已禁用（0）。

注意：该命令将需要重置才能生效。

下载：文件

复制代码

# Check the current state of the MIDI service

AT+BLEMIDIEN

# Enable the MIDI Service

AT+BLEMIDIEN=1

OK # Check the current state of the MIDI service

AT+BLEMIDIEN

# Enable the MIDI Service

AT+BLEMIDIEN=1

AT + BLEMIDIRX

从缓冲区读取传入的MIDI字符数组。

代码库修订：0.7.0

参数：无

输出：字节数组格式的midi事件

下载：文件

复制代码

AT+BLEMIDIRX

90-3C-7F

OK AT+BLEMIDIRX

90-3C-7F

》

AT + BLEMIDITX

发送MIDI事件到主机。

代码库修订：0.7.0

参数：十六进制数组格式的MIDI事件，可以是：

一系列完整的MIDI事件（最多4个事件）

恰好是1个完整的MIDI事件+几个无状态的运行事件（最多7个）

输出：无

下载：文件

复制代码

# Send 1 event （middle C with max velocity）

AT+BLEMIDITX=90-3C-7F

# Send 2 events

AT+BLEMIDITX=90-3C-7F-A0-3C-7F

# Send 1 full event + running event

AT+BLEMIDITX=90-3C-7F-3C-7F

OK # Send 1 event （middle C with max velocity）

AT+BLEMIDITX=90-3C-7F

# Send 2 events

AT+BLEMIDITX=90-3C-7F-A0-3C-7F

# Send 1 full event + running event

AT+BLEMIDITX=90-3C-7F-3C-7F

AT + BLEBATTEN

按照Bluetooth SIG的定义启用电池服务。

代码库修订：0.7.0

参数：是否通过以下值中的一个启用电池服务：

off

输出：如果不执行任何参数，则将返回一个数字值，指示电池是否服务已启用（1）或已禁用（0）。

此命令需要一个系统重置才能生效。

下载：文件

复制代码

# Enable the Battery Service

AT+BLEBATTEN=1

OK # Enable the Battery Service

AT+BLEBATTEN=1

AT + BLEBATTVAL

设置电池服务（如果启用）的当前电池电量百分比（0..100）。

代码库修订版：0.7.0

参数：电池百分比在0..100。

输出：如果不执行任何参数，则将当前电池电量存储在特征中。

下载：file

复制代码

# Set the battery level to 72%

AT+BLEBATTVAL=72

OK # Set the battery level to 72%

AT+BLEBATTVAL=72

BLE GAP

GAP代表通用访问配置文件，用于管理与低功耗蓝牙设备的广告和连接。

以下命令可用于配置BLE模块上的GAP设置。

您可以使用这些命令来修改广告数据（例如，广告过程中出现的设备名称），检索有关已在两个设备之间建立的连接或断开连接的信息，如果您不再希望保持连接。

AT + GAPCONNECTABLE

此命令可用于防止设备“可连接”。

代码库修订：0.7.0

参数：设备是否应使用以下值之一将自身宣传为可连接：

是

否

输出：’connec

Download：file

Copy Code

# Make the device non-connectable （advertising only）

AT+GAPCONNECTABLE=0

# Check the current connectability status

AT+GAPCONNECTABLE

OK # Make the device non-connectable （advertising only）

AT+GAPCONNECTABLE=0

# Check the current connectability status

AT+GAPCONNECTABLE

AT + GAPGETCONN

显示当前连接状态（无论是否连接到其他BLE设备）。

代码库修订：0.3.0

参数：无

输出：如果我们已连接，则为1，否则为0

下载：文件

复制代码

# Connected

AT+GAPGETCONN

# Not connected

AT+GAPGETCONN

OK # Connected

AT+GAPGETCONN

# Not connected

AT+GAPGETCONN

AT + GAPDISCONNECT

如果我们当前已连接，请断开与外部设备的连接。

代码库修订：0.3.0

参数：无

输出：无

下载：文件

复制代码

AT+GAPDISCONNECT

OK AT+GAPDISCONNECT

AT + GAPDEVNAME

获取或设置设备名称，该名称包含在Bluefruit LE模块的广告负载中

代码库修订：0.3.0

参数：

无法读取当前设备名称

如果要更改值，则使用新设备名称

输出：如果命令以读取模式执行，则为设备名称

更新设备名称会将新值保留到非易失性存储器中，并且在重置设备时将使用更新的名称。要将设备重置为出厂设置并从内存中清除配置数据，请运行AT + FACTORYRESET命令。

下载：文件

复制代码

# Read the current device name

AT+GAPDEVNAME

UART

# Update the device name to ‘BLEFriend’

AT+GAPDEVNAME=BLEFriend

# Reset to take effect

ATZ

OK # Read the current device name

AT+GAPDEVNAME

UART

# Update the device name to ‘BLEFriend’

AT+GAPDEVNAME=BLEFriend

# Reset to take effect

ATZ

AT + GAPDELBONDS

Bluefruit LE模块上存储的删除和绑定信息。

代码库修订：0.3.0

参数：无

输出：无

下载：文件

复制代码

AT+GAPDELBONDS

OK AT+GAPDELBONDS

AT + GAPINTERVALS

获取或设置Bluefruit LE模块的各种广告和连接间隔。

使用此命令时要格外小心，因为更改间隔很容易引起问题，并且取决于某些移动设备可能选择的值不再识别

代码库修订：0.3.0

参数：如果更新GAP时间间隔，可以输入以下逗号分隔的值：

最小连接间隔（以毫秒为单位）

最大连接间隔（以毫秒为单位）

快速广告间隔（以毫秒为单位）

快速广告超时（以秒为单位）

》 = 0.7.0：低功耗广告间隔（以毫秒为单位），默认= 417.5 ms

为节省电量，Bluefruit模块在投放广告后会自动降低到较低的广告投放率“快速广告超时”秒。默认值为30秒（“快速广告超时”）。在固件《0.7.0中，低功耗广告间隔被硬编码为大约0.6s。通过可选的第五个参数在0.7.0固件版本中增加了对控制低功率间隔的支持。

请注意以下最大和最大限制。 GAP参数：

绝对最小连接间隔：10ms

绝对最大连接间隔：4000ms

绝对最小广告投放间隔：20ms

绝对最大快速广告投放间隔：10240ms

绝对最小低投放低功耗广告间隔：20ms

绝对最大低功耗广告间隔：10240ms

如果您只希望更新一个间隔值，则将其他以逗号分隔的值保留为空（例如，‘，110，只会更新第三个值，广告间隔）。

输出：如果读取当前的GAP间隔设置，则t他将显示以下逗号分隔的信息：

最小连接间隔（以毫秒为单位）

最大连接间隔（以毫秒为单位）

广告间隔（以毫秒为单位）

广告超时（以毫秒为单位）

i》更新GAP间隔会将新值保留在非易失性存储器中，并且在重置设备时将使用更新后的值。要将设备重置为出厂设置并从内存中清除配置数据，请运行AT + FACTORYRESET命令。

下载：文件

复制代码

# Read the current GAP intervals

AT+GAPINTERVALS

20，100，100，30

# Update all values

AT+GAPINTERVALS=20，200，200，30

# Update only the advertising interval

AT+GAPINTERVALS=，，150，

OK # Read the current GAP intervals

AT+GAPINTERVALS

20，100，100，30

# Update all values

AT+GAPINTERVALS=20，200，200，30

# Update only the advertising interval

AT+GAPINTERVALS=，，150，

AT + GAPSTARTADV

如果还没有，则导致Bluefruit LE模块开始传输广告包（假设我们尚未连接到外部设备。）

代码库修订：0.3.0

参数：无

输出：无

下载：文件

复制代码

# Command results when advertising data is not being sent

AT+GAPSTARTADV

# Command results when we are already advertising

AT+GAPSTARTADV

ERROR

# Command results when we are connected to another device

AT+GAPSTARTADV

ERROR # Command results when advertising data is not being sent

AT+GAPSTARTADV

# Command results when we are already advertising

AT+GAPSTARTADV

ERROR

# Command results when we are connected to another device

AT+GAPSTARTADV

ERROR

AT + GAPSTOPADV

阻止广告数据包通过Bluefruit LE模块传输。

代码库修订： 0.3.0

参数：无

Ou tput ：无

下载：文件

复制代码

AT+GAPSTOPADV

OK AT+GAPSTOPADV

AT + GAPSETADVDATA

遵循蓝牙4.0或4.1核心规范中的指导，将原始广告数据有效载荷设置为指定的字节数组（覆盖常规广告数据）。

特别是，核心规范补充（CSS）v4 包含有关常见广告数据字段的详细信息，例如“标志”（A部分，第1.3节）和各种服务UUID列表（A部分，第1.1节）。蓝牙SIG的通用访问配置文件页面上提供了所有可能的GAP数据类型的列表。

广告数据有效负载包含通用访问配置文件数据，该数据以以下格式插入到广告包中：［U8：LEN ］［U8：数据类型值］［n：值］

警告：此该命令要求您具备有关蓝牙4.0或4.1核心规范的低级详细信息的知识，并且只能由专业用户使用。滥用此命令很容易导致您的设备无法被无线电范围内的中央设备检测到。

警告：此命令将覆盖正常的广告有效负载，并可能阻止某些服务按预期方式运行。

要将广告数据恢复为正常的默认值，请使用AT + FACTORYRESET命令。

例如，要插入“标志”数据类型（数据类型值为0x01）并将其值设置为0x06/0b00000110（不支持BR/EDR和LE常规可发现模式），我们将使用以下字节数组：

下载：文件

复制代码

02-01-06 02-01-06

0x02表示条目中的字节数

0x01是“数据类型值”，并表示这是“ 标志’

0x06（0b00000110）是Fl ag值，并声明以下字段（请参见Core Specification 4.0，第3卷，C部分，18.1）：

LE常规可发现模式（即任何人都可以发现此设备）

不支持BR/EDR （即，这是仅适用于低功耗蓝牙的设备）

如果我们还希望在广告数据中包含两个16位服务UUID（以便侦听设备知道我们支持这些服务），则可以将以下数据附加到字节数组：

下载：文件

复制代码

05-02-0D-18-0A-18 05-02-0D-18-0A-18

0x05表示条目（5）中的字节数

0x02是“数据类型值”，并表示这是“ 16位服务类UUID的不完整列表”

0x0D 0x18是第一个16位UUID（转换为 0x180D ，对应于

0x0A 0x18是另一个16位UUID（转换为 0x180A ，与设备信息服务相对应）。

包括服务UUID非常重要，因为某些移动应用程序仅适用于在广告数据包中广告特定服务UUID的设备。例如，Nordic Semiconductors的大多数应用程序都是如此。

代码库修订：0.3.0

参数：应该插入广告包的广告数据部分的原始字节数组，请注意不要超出蓝牙核心规范定义的空间限制。

响应：无

下载：文件

复制代码

# Advertise as Discoverable and BLE only with 16-bit UUIDs 0x180D and 0x180A

AT+GAPSETADVDATA=02-01-06-05-02-0d-18-0a-18

OK # Advertise as Discoverable and BLE only with 16-bit UUIDs 0x180D and 0x180A

AT+GAPSETADVDATA=02-01-06-05-02-0d-18-0a-18

此命令的结果可以在下面的截图中看到，该截图取自嗅探器，分析了Wireshark中的广告数据包。广告数据有效负载在图像底部的原始字节数组中以蓝色高亮显示，而数据包分析在上部：

BLE GATT

GATT是通用ATTribute配置文件的标准，用于管理连接设备之间的数据组织和数据交换。一台设备（外围设备）充当GATT服务器，将数据存储在 Attribute 记录中，连接中的第二台设备（中央设备）充当GATT客户端，在必要时向服务器请求数据

以下命令可用于在BLEFriend上创建自定义GATT服务和特征，用于存储和交换数据。

请注意，您在此处定义的任何特征会自动保存到设备上的非易失性FLASH配置存储器中，并在下次设备启动时重新初始化。

您需要通过“ ATZ”执行系统重置，然后以下大多数命令才会生效！

GATT限制

由于SRAM和资源可用性，以下命令具有以下限制：创建或使用custo时应牢记mer GATT服务和特性。

这些值适用于固件0.7.0及更高版本：

最大服务数量：10

最大服务数量特性：30

每个特性的最大缓冲区大小：32字节

CCCD的最大数量：16

如果要清除以前的任何配置值，请在进行新的外围设备配置之前输入“ AT + FACTORYRESET ”命令。

AT + GATTCLEAR

清除设备上定义的所有自定义GATT服务和特征。

代码库修订：0.3.0

参数：无

响应：无

下载：文件

复制代码

AT+GATTCLEAR

OK AT+GATTCLEAR

AT + GATTADDSERVICE

添加新的自定义服务

代码库修订：0.3.0

参数：此命令接受一组用逗号分隔的命令用于定义服务属性的键值对。可以使用以下键值对：

UUID ：用于此服务的16位UUID。 16位值应为十六进制格式（0x1234）。

UUID128 ：用于此服务的128位UUID。 128位值应采用以下格式：00-11-22-33-44-55-66-77-88-99-AA-BB-CC-DD-EE-FF

响应：自定义GATT服务查找表中服务的索引值。（重要的是要跟踪这些索引值以便以后与服务一起使用。）

注意：键值不区分大小写

仅可以为服务输入一种UUID类型（UUID或UUID128）

下载：文件

复制代码

# Clear any previous custom services/characteristics

AT+GATTCLEAR

# Add a battery service （UUID = 0x180F） to the peripheral

AT+GATTADDSERVICE=UUID=0x180F

# Add a battery measurement characteristic （UUID = 0x2A19）， notify enabled

AT+GATTADDCHAR=UUID=0x2A19，PROPERTIES=0x10，MIN_LEN=1，VALUE=100

OK # Clear any previous custom services/characteristics

AT+GATTCLEAR

# Add a battery service （UUID = 0x180F） to the peripheral

AT+GATTADDSERVICE=UUID=0x180F

# Add a battery measurement characteristic （UUID = 0x2A19）， notify enabled

AT+GATTADDCHAR=UUID=0x2A19，PROPERTIES=0x10，MIN_LEN=1，VALUE=100

下载：文件

复制代码

# Clear any previous custom services/characteristics

AT+GATTCLEAR

# Add a custom service to the peripheral

AT+GATTADDSERVICE=UUID128=00-11-00-11-44-55-66-77-88-99-AA-BB-CC-DD-EE-FF

# Add a custom characteristic to the above service （making sure that there

# is no conflict between the 16-bit UUID and bytes 3+4 of the 128-bit service UUID）

AT+GATTADDCHAR=UUID=0x0002，PROPERTIES=0x02，MIN_LEN=1，VALUE=100

OK # Clear any previous custom services/characteristics

AT+GATTCLEAR

# Add a custom service to the peripheral

AT+GATTADDSERVICE=UUID128=00-11-00-11-44-55-66-77-88-99-AA-BB-CC-DD-EE-FF

# Add a custom characteristic to the above service （making sure that there

# is no conflict between the 16-bit UUID and bytes 3+4 of the 128-bit service UUID）

AT+GATTADDCHAR=UUID=0x0002，PROPERTIES=0x02，MIN_LEN=1，VALUE=100

AT + GATTADDCHAR

为自外围设备（通过AT + GATTADDSERVICE）添加的最后一个服务添加自定义特征。

AT + GATTADDCHAR必须在AT + GATTADDSERVICE之后运行，并将新特性添加到最后添加的服务定义。

从Bluefruit LE固件的0.6.6版本开始，您现在可以在此命令中使用自定义的128位UUID。请参阅此命令说明底部的示例。

代码库修订：0.3.0

Parameters ：此命令接受一组逗号分隔的键值对，用于定义特征属性。可以使用以下键值pais：

UUID ：用于特征的16位UUID（将插入到第3和第4个字节中父服务的128位UUID）。此值应以十六进制格式输入（例如‘UUID = 0x1234’）。此值必须唯一，并且不得与父服务的128位UUID的字节3 + 4冲突。

PROPERTIES ：8位特征属性字段，已定义由Bluetooth SIG提供。可以使用以下值：

0x02-读取

0x04-写入无响应

0x08-写入

0x10 -通知

0x20-指示

MIN_LEN ：此特征值的最小大小（以字节为单位，最小值= 1，最大值= 20，默认= 1）

MAX_LEN ：特征值的最大大小（以字节为单位，最小值= 1，最大值= 20，默认值= 1）

VALUE ：分配给该特性的初始值（在‘MIN_LEN’和‘MAX_LEN’的范围内）。值可以是整数（“ -100”，“ 27” ），十六进制值（“ 0xABCD”），字节数组（“ aa-bb-cc-dd”）或字符串（“ GATT！”）。

》 = 0.7.0 -DATATYPE ：此参数指示存储在特征中的数据类型，用于帮助正确解析数据。它可以是以下值之一：

自动（0，默认值）

STRING（1）

BYTEARRAY（2）

INTEGER（3）

》 = 0.7.0-description ：将指定的字符串添加为特征描述条目

》 = 0.7.0-演示：将指定的值添加为特征表示格式条目

响应：广告的索引值自定义GATT特征查询表中的特征。（重要的是要跟踪这些特征索引值，以便以后使用该特征。）

注意：键值不区分大小写

确保16位UUID是唯一的，并且与128位服务UUID的字节3 + 4不冲突

下载：文件

复制代码

# Clear any previous custom services/characteristics

AT+GATTCLEAR

# Add a battery service （UUID = 0x180F） to the peripheral

AT+GATTADDSERVICE=UUID=0x180F

# Add a battery measurement characteristic （UUID = 0x2A19）， notify enabled

AT+GATTADDCHAR=UUID=0x2A19，PROPERTIES=0x10，MIN_LEN=1，VALUE=100

OK # Clear any previous custom services/characteristics

AT+GATTCLEAR

# Add a battery service （UUID = 0x180F） to the peripheral

AT+GATTADDSERVICE=UUID=0x180F

# Add a battery measurement characteristic （UUID = 0x2A19）， notify enabled

AT+GATTADDCHAR=UUID=0x2A19，PROPERTIES=0x10，MIN_LEN=1，VALUE=100

下载：文件

复制代码

# Clear any previous custom services/characteristics

AT+GATTCLEAR

# Add a custom service to the peripheral

AT+GATTADDSERVICE=UUID128=00-11-00-11-44-55-66-77-88-99-AA-BB-CC-DD-EE-FF

# Add a custom characteristic to the above service （making sure that there

# is no conflict between the 16-bit UUID and bytes 3+4 of the 128-bit service UUID）

AT+GATTADDCHAR=UUID=0x0002，PROPERTIES=0x02，MIN_LEN=1，VALUE=100

OK # Clear any previous custom services/characteristics

AT+GATTCLEAR

# Add a custom service to the peripheral

AT+GATTADDSERVICE=UUID128=00-11-00-11-44-55-66-77-88-99-AA-BB-CC-DD-EE-FF

# Add a custom characteristic to the above service （making sure that there

# is no conflict between the 16-bit UUID and bytes 3+4 of the 128-bit service UUID）

AT+GATTADDCHAR=UUID=0x0002，PROPERTIES=0x02，MIN_LEN=1，VALUE=100

Bluefruit LE固件的版本 0.6.6 添加了使用新的“ UUID128 ”标志添加与父服务无关的自定义128位UUID的功能。 UUID（在传递16位‘ UUID ’标志时使用）。

要为您的客户特征指定128位UUID，请输入类似于以下内容的值语法：

下载：文件

复制代码

Bluefruit LE固件的# Add a custom characteristic to the above service using a

# custom 128-bit UUID

AT+GATTADDCHAR=UUID128=00-11-22-33-44-55-66-77-88-99-AA-BB-CC-DD-EE-FF，PROPERTIES=0x02，MIN_LEN=1，VALUE=100

OK # Add a custom characteristic to the above service using a

# custom 128-bit UUID

AT+GATTADDCHAR=UUID128=00-11-22-33-44-55-66-77-88-99-AA-BB-CC-DD-EE-FF，PROPERTIES=0x02，MIN_LEN=1，VALUE=100

版本 0.7.0 添加了新的 DESCRIPTION 和 PRESENTATION 按键，对应于GATT特征用户描述和GATT特征表示格式描述符。

DESCRIPTION 字段是一个字符串，其中包含特征的简短文本描述。某些应用程序可能不会显示此数据，但可以使用类似Nordic在iOS和Android上的“主控制面板”应用程序看到。

PRESENTATION 字段包含7字节封装特征表示格式数据的有效负载。它需要一组特定的字节和值才能正常工作。有关如何格式化有效负载的详细信息，请参见以下链接：https：//developer.bluetooth.org/gatt/descriptors/Pages/DescriptorViewer.aspx？u = org.bluetooth.descriptor.gatt.characteristic_presentation_format.xml

以下示例显示了如何使用这两个新字段：

下载：文件

复制代码

AT+GATTADDCHAR=UUID=0x2A37， PROPERTIES=0x10， MIN_LEN=2， MAX_LEN=3， VALUE=00-40，

DESCRIPTION=HRM Measurement， PRESENTATION=17-00-AC-27-01-00-00 AT+GATTADDCHAR=UUID=0x2A37， PROPERTIES=0x10， MIN_LEN=2， MAX_LEN=3， VALUE=00-40，

DESCRIPTION=HRM Measurement， PRESENTATION=17-00-AC-27-01-00-00

对于特征表示格式，我们有：

格式= IEEE-11073 32位FLOAT（十进制23，十六进制0x17）

指数= 0/无

单位=热力学温度：华氏度（0x27AC）-蓝牙LE单元列表

命名空间= Bluetooth SIG分配的编号（0x01）

描述=无（0x0000）

Nordic的主控制面板应用程序的结果可以在下面看到：

AT + GATTCHAR

获取或获取设置指定的自定义GATT特征的值（基于通过AT + GATTADDCHAR将特征添加到系统时返回的索引ID）。

代码库修订：0.3.0

参数：此函数采用一个或两个逗号分隔的函数（一个参数=读取，两个参数=写入）。

第一个参数是从AT + GATTADDCHAR函数返回的特征索引值。此参数始终是必需的，如果未输入第二个参数，则将返回该特性的当前值。

第二个（可选）参数是分配给该特性的新值（在MIN_SIZE和

响应：如果该命令在读取模式下使用（仅提供特征索引作为值），则响应将显示特征的当前值。如果在写模式下使用该命令（提供了两个逗号分隔的值），则将更新特征以使用提供的值。

下载：文件

复制代码

# Clear any previous custom services/characteristics

AT+GATTCLEAR

# Add a battery service （UUID = 0x180F） to the peripheral

AT+GATTADDSERVICE=UUID=0x180F

# Add a battery measurement characteristic （UUID = 0x2A19）， notify enabled

AT+GATTADDCHAR=UUID=0x2A19，PROPERTIES=0x10，MIN_LEN=1，VALUE=100

# Read the battery measurement characteristic （index ID = 1）

AT+GATTCHAR=1

0x64

# Update the battery measurement characteristic to 32 （hex 0x20）

AT+GATTCHAR=1，32

# Verify the previous write attempt

AT+GATTCHAR=1

0x20

OK # Clear any previous custom services/characteristics

AT+GATTCLEAR

# Add a battery service （UUID = 0x180F） to the peripheral

AT+GATTADDSERVICE=UUID=0x180F

# Add a battery measurement characteristic （UUID = 0x2A19）， notify enabled

AT+GATTADDCHAR=UUID=0x2A19，PROPERTIES=0x10，MIN_LEN=1，VALUE=100

# Read the battery measurement characteristic （index ID = 1）

AT+GATTCHAR=1

0x64

# Update the battery measurement characteristic to 32 （hex 0x20）

AT+GATTCHAR=1，32

# Verify the previous write attempt

AT+GATTCHAR=1

0x20

AT + GATTLIST

列出设备上已定义的所有自定义GATT服务和特征。

代码库修订：0.3.0

参数：无

响应》：设备上定义的所有自定义服务和特征的列表。

下载：文件

复制代码

# Clear any previous custom services/characteristics

AT+GATTCLEAR

# Add a battery service （UUID = 0x180F） to the peripheral

AT+GATTADDSERVICE=UUID=0x180F

# Add a battery measurement characteristic （UUID = 0x2A19）， notify enabled

AT+GATTADDCHAR=UUID=0x2A19，PROPERTIES=0x10，MIN_LEN=1，VALUE=100

# Add a custom service to the peripheral

AT+GATTADDSERVICE=UUID128=00-11-00-11-44-55-66-77-88-99-AA-BB-CC-DD-EE-FF

# Add a custom characteristic to the above service （making sure that there

# is no conflict between the 16-bit UUID and bytes 3+4 of the 128-bit service UUID）

AT+GATTADDCHAR=UUID=0x0002，PROPERTIES=0x02，MIN_LEN=1，VALUE=100

# Get a list of all custom GATT services and characteristics on the device

AT+GATTLIST

ID=01，UUID=0x180F

ID=01，UUID=0x2A19，PROPERTIES=0x10，MIN_LEN=1，MAX_LEN=1，VALUE=0x64

ID=02，UUID=0x11， UUID128=00-11-00-11-44-55-66-77-88-99-AA-BB-CC-DD-EE-FF

ID=02，UUID=0x02，PROPERTIES=0x02，MIN_LEN=1，MAX_LEN=1，VALUE=0x64

OK # Clear any previous custom services/characteristics

AT+GATTCLEAR

# Add a battery service （UUID = 0x180F） to the peripheral

AT+GATTADDSERVICE=UUID=0x180F

# Add a battery measurement characteristic （UUID = 0x2A19）， notify enabled

AT+GATTADDCHAR=UUID=0x2A19，PROPERTIES=0x10，MIN_LEN=1，VALUE=100

# Add a custom service to the peripheral

AT+GATTADDSERVICE=UUID128=00-11-00-11-44-55-66-77-88-99-AA-BB-CC-DD-EE-FF

# Add a custom characteristic to the above service （making sure that there

# is no conflict between the 16-bit UUID and bytes 3+4 of the 128-bit service UUID）

AT+GATTADDCHAR=UUID=0x0002，PROPERTIES=0x02，MIN_LEN=1，VALUE=100

# Get a list of all custom GATT services and characteristics on the device

AT+GATTLIST

ID=01，UUID=0x180F

ID=01，UUID=0x2A19，PROPERTIES=0x10，MIN_LEN=1，MAX_LEN=1，VALUE=0x64

ID=02，UUID=0x11， UUID128=00-11-00-11-44-55-66-77-88-99-AA-BB-CC-DD-EE-FF

ID=02，UUID=0x02，PROPERTIES=0x02，MIN_LEN=1，MAX_LEN=1，VALUE=0x64

AT + GATTCHARRAW

此只读命令从特征读取二进制（而不是ASCII）数据。它不可打印，但开销较小，并且在Arduino中编写库时更容易。

代码库修订：0.7.0

参数：用于显示数据的特征的数字ID

输出：与指定特征对应的二进制数据。

注意：这是一个专用命令，命令末尾没有NEWLINE！

调试

以下调试命令在Bluefruit LE模块上可用：

谨慎使用这些命令，因为它们很容易导致ARM内核出现HardFault错误，这将导致设备停止响应。

AT + DBGMEMRD

显示原始内存

代码库修订：0.3.0

参数：可以将以下逗号分隔的参数设置为：与此命令一起使用：

从中读取内存的起始地址（十六进制形式，带或不带开头的“ 0x”）

字长（可以为1 、、 2、4或8）

要读取的字数

输出：使用指定的十六进制格式的原始内存内容长度和字长（有关详细信息，请参见下面的示例）

下载：文件

复制代码

# Read 12 1-byte values starting at 0x10000009

AT+DBGMEMRD=0x10000009，1，12

FF FF FF FF FF FF FF 00 04 00 00 00

# Try to read 2 4-byte values starting at 0x10000000

AT+DBGMEMRD=0x10000000，4，2

55AA55AA 55AA55AA

# Try to read 2 4-byte values starting at 0x10000009

# This will fail because the Cortex M0 can‘t perform misaligned

# reads， and any non 8-bit values must start on an even address

AT+DBGMEMRD=0x10000009，4，2

MISALIGNED ACCESS

ERROR

# Read 12 1-byte values starting at 0x10000009

AT+DBGMEMRD=0x10000009，1，12

FF FF FF FF FF FF FF 00 04 00 00 00

# Try to read 2 4-byte values starting at 0x10000000

AT+DBGMEMRD=0x10000000，4，2

55AA55AA 55AA55AA

# Try to read 2 4-byte values starting at 0x10000009

# This will fail because the Cortex M0 can’t perform misaligned

# reads， and any non 8-bit values must start on an even address

AT+DBGMEMRD=0x10000009，4，2

MISALIGNED ACCESS

ERROR

AT + DBGNVMRD

显示非以下内容的配置数据部分的原始内容：易失性内存

代码库修订：0.3.0

属性：无

输出：来自非易失性存储器的原始配置数据

下载：文件

复制代码

AT+DBGNVMRD

FE CA 38 05 00 03 00 00 01 12 01 00 55 41 52 54 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 14 00 64 00 64 00 1E 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 01 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 BA FF 00 00

OK AT+DBGNVMRD

AT + DBGSTACKSIZE

返回当前堆栈大小，以在优化系统内存使用时帮助检测堆栈溢出或检测堆栈内存使用情况。

代码库修订：0.4.7

参数：无

输出：当前的大小堆栈内存（以字节为单位）

下载：文件

复制编码e

AT+DBGSTACKSIZE

1032

OK AT+DBGSTACKSIZE

1032

AT + DBGSTACKDUMP

转储当前堆栈内容。堆栈存储器中未使用的部分填充有“ 0xCAFEFOOD”，以帮助确定堆栈使用的停止位置。

此命令仅用于调试和开发目的。

代码库修订strong》：0.4.7

参数：无

输出：整个堆栈区域的内存内容

下载：文件

复制代码

AT+DBGSTACKDUMP

0x20003800： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003810： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003820： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003830： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003840： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003850： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003860： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003870： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003880： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003890： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200038A0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200038B0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200038C0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200038D0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200038E0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200038F0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003900： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003910： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003920： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003930： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003940： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003950： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003960： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003970： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003980： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003990： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200039A0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200039B0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200039C0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200039D0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200039E0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200039F0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003A00： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003A10： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003A20： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003A30： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003A40： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003A50： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003A60： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003A70： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003A80： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003A90： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003AA0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003AB0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003AC0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003AD0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003AE0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003AF0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003B00： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003B10： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003B20： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003B30： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003B40： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003B50： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003B60： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003B70： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003B80： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003B90： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003BA0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003BB0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003BC0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003BD0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003BE0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003BF0： CAFEF00D CAFEF00D 00000000 CAFEF00D

0x20003C00： 00000004 20001D04 CAFEF00D FFFFEF68

0x20003C10： CAFEF00D 00001098 CAFEF00D CAFEF00D

0x20003C20： CAFEF00D CAFEF00D 00001006 200018D8

0x20003C30： 00000001 200018D8 20001C50 00000004

0x20003C40： 20001BB0 000134A5 0000100D 20001D28

0x20003C50： 00000006 00000006 20001C38 20001D44

0x20003C60： 20001C6C 20001D44 00000006 00000005

0x20003C70： 20001D38 00000005 20001D38 00000000

0x20003C80： 00000001 00012083 200018C8 000013D3

0x20003C90： 00550000 00000001 80E80000 4FC40000

0x20003CA0： 000080E8 00000009 60900000 000080E8

0x20003CB0： 60140000 20002764 0009608F 000080E8

0x20003CC0： 80000000 000080E8 00000000 00129F5F

0x20003CD0： 00000000 0001E4D9 80E80000 200018C8

0x20003CE0： 200018D4 00000000 80E80000 000000FF

0x20003CF0： 0000011C 0001BCE1 0000203A 0001BC1D

0x20003D00： 00000000 0001BC1D 80E80000 0001BCE1

0x20003D10： 0000011C 0001BDA9 80E80000 0001BDA9

0x20003D20： 0000011C FFFFFFF9 008B8000 0001BC1D

0x20003D30： 00000048 00000010 0000A000 00000009

0x20003D40： 0001E326 00000001 80E80000 51538000

0x20003D50： 000080E8 0001E9CF 00000000 00000009

0x20003D60： 61C78000 000080E8 00000048 00000504

0x20003D70： 0000A1FC 0002125C 00000000 000080E8

0x20003D80： 00000000 0012A236 00000000 0001E4D9

0x20003D90： 000080E8 00000009 00004998 000080E8

0x20003DA0： 622C8000 0012A29B 00000042 0001E479

0x20003DB0： 40011000 000185EF 00006E10 00000000

0x20003DC0： 00000000 00000004 0000000C 00000000

0x20003DD0： 62780000 00018579 2000311B 0001ACDF

0x20003DE0： 00000000 20003054 20002050 00000001

0x20003DF0： 20003DF8 0002085D 00000001 200030D4

0x20003E00： 00000200 0001F663 00000001 200030D4

0x20003E10： 00000001 2000311B 0001F631 00020A6D

0x20003E20： 00000001 00000000 0000000C 200030D4

0x20003E30： 2000311B 00000042 200030D4 00020AD7

0x20003E40： 20002050 200030D4 20002050 00020833

0x20003E50： 20002050 20003F1B 20002050 0001FF89

0x20003E60： 20002050 0001FFA3 00000005 20003ED8

0x20003E70： 20002050 0001FF8B 00000010 00020491

0x20003E80： 00000001 0012A54E 00000020 00022409

0x20003E90： 00000000 20002050 200030D4 0001FF8B

0x20003EA0： 00021263 00000005 0000000C 20003F74

0x20003EB0： 20003ED8 20002050 200030D4 00020187

0x20003EC0： 20003ED4 20003054 00000000 20003F75

0x20003ED0： 00000008 20003F64 00000084 FFFFFFFF

0x20003EE0： FFFFFFFF 00000008 00000001 00000008

0x20003EF0： 20302058 2000311B 0001F631 00020A6D

0x20003F00： 20002050 00000000 0000000C 200030D4

0x20003F10： 32002050 32303032 00323330 000258D7

0x20003F20： 20002050 200030D4 20002050 00020833

0x20003F30： 00000000 20002050 00000020 000001CE

0x20003F40： 20003F40 200030D4 00000004 0001ED83

0x20003F50： 200030D4 20003F60 000001D6 000001D7

0x20003F60： 000001D8 00016559 0000000C 00000000

0x20003F70： 6C383025 00000058 200030D4 FFFFFFFF

0x20003F80： 1FFF4000 00000028 00000028 000217F8

0x20003F90： 200020C7 000166C5 000166AD 00017ED9

0x20003FA0： FFFFFFFF 200020B8 2000306C 200030D4

0x20003FB0： 200020B4 000180AD 1FFF4000 200020B0

0x20003FC0： 200020B0 200020B0 1FFF4000 0001A63D

0x20003FD0： CAFEF00D CAFEF00D 200020B4 00000002

0x20003FE0： FFFFFFFF FFFFFFFF 1FFF4000 00000000

0x20003FF0： 00000000 00000000 00000000 00016113

OK AT+DBGSTACKDUMP

0x20003800： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003810： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003820： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003830： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003840： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003850： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003860： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003870： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003880： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003890： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200038A0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200038B0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200038C0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200038D0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200038E0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200038F0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003900： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003910： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003920： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003930： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003940： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003950： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003960： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003970： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003980： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003990： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200039A0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200039B0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200039C0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200039D0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200039E0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x200039F0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003A00： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003A10： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003A20： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003A30： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003A40： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003A50： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003A60： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003A70： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003A80： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003A90： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003AA0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003AB0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003AC0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003AD0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003AE0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003AF0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003B00： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003B10： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003B20： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003B30： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003B40： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003B50： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003B60： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003B70： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003B80： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003B90： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003BA0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003BB0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003BC0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003BD0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003BE0： CAFEF00D CAFEF00D CAFEF00D CAFEF00D

0x20003BF0： CAFEF00D CAFEF00D 00000000 CAFEF00D

0x20003C00： 00000004 20001D04 CAFEF00D FFFFEF68

0x20003C10： CAFEF00D 00001098 CAFEF00D CAFEF00D

0x20003C20： CAFEF00D CAFEF00D 00001006 200018D8

0x20003C30： 00000001 200018D8 20001C50 00000004

0x20003C40： 20001BB0 000134A5 0000100D 20001D28

0x20003C50： 00000006 00000006 20001C38 20001D44

0x20003C60： 20001C6C 20001D44 00000006 00000005

0x20003C70： 20001D38 00000005 20001D38 00000000

0x20003C80： 00000001 00012083 200018C8 000013D3

0x20003C90： 00550000 00000001 80E80000 4FC40000

0x20003CA0： 000080E8 00000009 60900000 000080E8

0x20003CB0： 60140000 20002764 0009608F 000080E8

0x20003CC0： 80000000 000080E8 00000000 00129F5F

0x20003CD0： 00000000 0001E4D9 80E80000 200018C8

0x20003CE0： 200018D4 00000000 80E80000 000000FF

0x20003CF0： 0000011C 0001BCE1 0000203A 0001BC1D

0x20003D00： 00000000 0001BC1D 80E80000 0001BCE1

0x20003D10： 0000011C 0001BDA9 80E80000 0001BDA9

0x20003D20： 0000011C FFFFFFF9 008B8000 0001BC1D

0x20003D30： 00000048 00000010 0000A000 00000009

0x20003D40： 0001E326 00000001 80E80000 51538000

0x20003D50： 000080E8 0001E9CF 00000000 00000009

0x20003D60： 61C78000 000080E8 00000048 00000504

0x20003D70： 0000A1FC 0002125C 00000000 000080E8

0x20003D80： 00000000 0012A236 00000000 0001E4D9

0x20003D90： 000080E8 00000009 00004998 000080E8

0x20003DA0： 622C8000 0012A29B 00000042 0001E479

0x20003DB0： 40011000 000185EF 00006E10 00000000

0x20003DC0： 00000000 00000004 0000000C 00000000

0x20003DD0： 62780000 00018579 2000311B 0001ACDF

0x20003DE0： 00000000 20003054 20002050 00000001

0x20003DF0： 20003DF8 0002085D 00000001 200030D4

0x20003E00： 00000200 0001F663 00000001 200030D4

0x20003E10： 00000001 2000311B 0001F631 00020A6D

0x20003E20： 00000001 00000000 0000000C 200030D4

0x20003E30： 2000311B 00000042 200030D4 00020AD7

0x20003E40： 20002050 200030D4 20002050 00020833

0x20003E50： 20002050 20003F1B 20002050 0001FF89

0x20003E60： 20002050 0001FFA3 00000005 20003ED8

0x20003E70： 20002050 0001FF8B 00000010 00020491

0x20003E80： 00000001 0012A54E 00000020 00022409

0x20003E90： 00000000 20002050 200030D4 0001FF8B

0x20003EA0： 00021263 00000005 0000000C 20003F74

0x20003EB0： 20003ED8 20002050 200030D4 00020187

0x20003EC0： 20003ED4 20003054 00000000 20003F75

0x20003ED0： 00000008 20003F64 00000084 FFFFFFFF

0x20003EE0： FFFFFFFF 00000008 00000001 00000008

0x20003EF0： 20302058 2000311B 0001F631 00020A6D

0x20003F00： 20002050 00000000 0000000C 200030D4

0x20003F10： 32002050 32303032 00323330 000258D7

0x20003F20： 20002050 200030D4 20002050 00020833

0x20003F30： 00000000 20002050 00000020 000001CE

0x20003F40： 20003F40 200030D4 00000004 0001ED83

0x20003F50： 200030D4 20003F60 000001D6 000001D7

0x20003F60： 000001D8 00016559 0000000C 00000000

0x20003F70： 6C383025 00000058 200030D4 FFFFFFFF

0x20003F80： 1FFF4000 00000028 00000028 000217F8

0x20003F90： 200020C7 000166C5 000166AD 00017ED9

0x20003FA0： FFFFFFFF 200020B8 2000306C 200030D4

0x20003FB0： 200020B4 000180AD 1FFF4000 200020B0

0x20003FC0： 200020B0 200020B0 1FFF4000 0001A63D

0x20003FD0： CAFEF00D CAFEF00D 200020B4 00000002

0x20003FE0： FFFFFFFF FFFFFFFF 1FFF4000 00000000

0x20003FF0： 00000000 00000000 00000000 00016113

历史记录

此页面根据固件版本号（您可以通过“ ATI”命令获得）跟踪对AT命令集的添加或更改：

版本0.7.7

在0.7.7发行版中添加了以下AT命令和功能：

添加了 AT + BLEUARTTXF （强制使用F）以立即在BLE中发送指定的数据UART数据包（最大20个字节），绕过任何FIFO延迟，避免了可能在两个事务中传输数据包。

调整后的BLE UART服务使用最小连接间隔作为发送间隔

AT + DFUIRQ ，以在nRF51822上存在支持的事件时启用将DFU引脚用于IRQ

为Bluefruit SPI板启用CS引脚上的内部上拉电阻

添加了 AT + MODESWITCHEN ，以启用/禁用从本地（串行或S PI）或BLE UART端。默认情况下，本地=启用，布尔=禁用，这意味着默认情况下只能通过本地接口执行命令。

实施了‘ +’转义码以立即发送‘+’字符而不触发++ +延迟等待进一步的相似输入

添加了 AT + BLEHIDGAMEPADEN 以分别启用HID游戏手柄，因为iOS/OSX与游戏手柄设备发生冲突，导致HID键盘无法正常工作。

以下错误已在0.7.7版中修复：

修复了当app_error_handler（）出现长时间延迟时的出厂重置问题

修复了在UART中字符串被截断为64个字符的问题

修复了HID键盘支持，不适用于iOS 9和10

》

版本0.7.0

0.7中添加了以下AT命令。 0版本：

AT + BAUDRATE

更改HWUART波特率

AT + UARTFLOW

启用或禁用硬件UARTflow控制

AT + BLEMIDIEN =打开/关闭/0/1

启用/禁用MIDI服务，需要重置才能生效

AT + BLEMIDITX

发送MIDI事件

AT + BLEMIDIRX

接收可用的MIDI事件

AT + GATTCHARRAW

添加了此只读命令，以从特征读取二进制（而不是ASCII）数据。它是不可打印的，但开销较小，并且更容易在Arduino中编写库

AT + NVMWRITE = offset，datatype，data

将数据写入256字节用户NVM。数据类型必须为STRING（1），BYTEARRAY（2）或INTEGER（3）

AT + NVMREAD = offset，size，datatype

从256个字节的用户NVM中读取数据

AT + NVMREADRAW = offset，size二进制数据

返回二进制数据（而不是ASCII），以“ OK r n”结尾。它是不可打印的，但开销较小，在某些情况下更易于使用。

AT + BLEHIDGAMEPAD = x，y，按钮

X是左，右：X =按下-1 LEFT，按下X = 1 RIGHT，按下X = 0，没有按下

Y是UP，DOWN：Y = -1 i UP，Y = 1是按下，Y = 0，没有按下

按钮［0x00-0xFF］是8个按钮0-7的位掩码

AT + GAPCONNECTABLE = on/off/1/0

允许/禁止连接到设备

AT + EDDYSTONESERVICEEN

将EddyStone服务添加/删除到GATT表（需要重置）

AT + EDDYSTONEBROADCAST = on/off/0/1

使用NVM中的设置开始/停止广播url

AT + BLEBATTEN = on/off/1/0

启用电池服务。由于服务更改而需要重置。

AT + BLEBATTVAL = percent

更新电池电量，百分比为0到100

以下命令已更改： 0.7.0版本：

AT + GATTADDCHAR

添加了DATATYPE选项以指示GATT特征有效负载的数据类型。有效选项为：AUTO（ 0，默认值），STRING（1），BYTEARRAY（2），INTEGER（3）

通过Description标志添加了特征用户描述选项

通过PRESENTATION添加了特征表示格式支持标志

AT + GAPINTERVALS

添加了新的“ adv_lowpower_interval”参数，默认值为417.5 ms。现在，当前参数为：min_conn，max_conn，adv_interval，adv_timeout，adv_lowpower_interval

此版本中的主要错误修复和更改：

重要的BTLE UART速度和可靠性改进

为以下项添加了回调支持（正在进行中）：

BLE UART RX

GATT特性RX

MIDI RX

连接/断开

每个特性的MAX_LEN从20字节增加到32字节

更改了默认的GAP参数：

广告间隔= 20ms

最小连接间隔= 20 ms

最大连接间隔= 40 ms

增加了默认情况下，保存为Flash的CCCD的最大数量从8减少到16

Eddystone配置服务

删除了AT + EDDYSTONEENABLE以避免混淆

将Eddystone的广告超时更改为‘unlimited’

修复了写-无响应特征属性，该属性未得到正确处理

修复了时序限制，无法满足App le设计指南

将系统固定到ms计算

使用google eddystone验证器固定所有测试，但写入tx_power = 1 dB（在nrf51上无效）

已固定一个错误，其中从中央进行写入无法正确更新特征上的值

修复了HID示例的问题，当与中央进行配对时，断开连接然后重新连接就无法再发送HID报告了

版本0.6.7

0.6.7版本中添加了以下AT命令：

AT + BLEUARTFIFO

返回蓝牙UART服务的TX和RX FIFO中可用的可用字节数。

在0.6.7版本中更改了以下命令：

AT + BLEUARTTX

如果TX FIFO已满，则该命令将等待最多200ms，以查看由于FIFO已满而在退出并返回错误响应之前FIFO大小是否减小。

AT + BLEURIBEACON

Th命令将返回使用旧的（不建议使用的）UriBeacon UUID（0xFED8），并且只有AT + EDDYSTONEURL命令将使用较新的Eddystone UUID（0xFEAA）。

AT + BLEKEYBOARD和AT + BLEUARTTX

这些命令现在接受‘？’因为‘AT + BLEKEYBOARD =？对于AT解析器还有另一个含义。要发送单个问号，应使用以下命令：’AT + BLEKEYBOARD = ？‘或’AT + BLEUARTTX = ？‘

AT + EDDYSTONEURL

此命令现在接受RSSI的第三个可选参数，值为0m（默认值为-18dBm）。

不带此命令运行此命令参数（’AT + EDDYSTONEURL r n‘）现在将返回当前URL。

此版本中的主要错误修复：

FIFO处理改进了UART UART服务的速度和稳定性，并且TX和RF FIFO分别增加到1024字节。

解决了计时器溢出每4小时左右导致工厂重置的问题。

修复了GATT服务器的一个问题，其中错误地为’max_len‘》 4

版本0.6.6

0.6中添加了以下AT命令.6版本：

AT + EDDYSTONEURL

更新信标的URL并切换到信标模式

AT + EDDYSTONEENABLE

启用/禁用信标mod e使用已配置的url

AT + EDDYSTONECONFIGEN

在指定的秒数内为Eddystone配置服务启用广告

AT + HWMODELED

允许用户覆盖默认MODE LED行为，具有以下选项之一：DISABLE，MODE，HWUART，BLEUART，SPI，MANUAL

AT + BLECONTROLKEY

允许将HID媒体控制值发送到绑定的中央设备（音量，屏幕亮度等）。

AT + BLEHIDEN

启用或禁用Bluefruit LE固件（鼠标，键盘和媒体控件）中的BLE HID支持

AT + BLEMOUSEMOVE

移动HID鼠标

AT + BLEMOUSEBUTTON

设置HID鼠标按钮的状态

在0.6中更改了以下命令。 6版本：

此版本中的主要错误修复：

此发行版的已知问题：

AT + BLEKEYBOARDEN-现在是AT + BLEHIDEN的别名

AT + GATTADDCHAR-添加了一个新的UUID128字段以允许自定义UUID

修复了带有长信标URL的问题

修复了at + blebeacon中主要号码和次要号码的大端序问题

Windows 10似乎支持以下特征的有限数量DIS服务。我们必须禁用序列号特性才能在Windows 10中启用HID支持。

版本0.6.5

在0.6.5版本中添加了以下AT命令：

AT + BLEGETPEERADDR

在0.6.5版本中更改了以下命令：

（在nRF51上）将UART缓冲区大小从128字节增加到256字节

+++现在以当前操作模式做出响应

修复了有时未保存到NVM的AT + GATTCHAR值的错误

修复了AT + GATTCHAR的错误重置后未考虑值（重新填充值时始终使用min_len）

版本0.6.2

这是第一个针对 32KB SRAM部件（QFAC）的发行版。由于内存管理问题，此固件无法使用16KB SRAM部件，而应使用早期的0.5.0固件。

在0.6.2版本中更改了以下AT命令：

AT + BLEUARTTX

添加了用于新行，制表符和退格键的基本转义码

AT + BLEKEYBOARD

现在也适用于OS X，并且可以功能与其他支持BLE HID键盘的操作系统

版本0.5.0

在0.5.0版本中添加了以下AT命令：

AT + BLEKEYBOARDEN

AT + BLEKEYBOARD

AT + BLEKEYBOARDCODE

在0.5.0版本中更改了以下AT命令：

ATI

SoftDevice，SoftDevice版本和Bootloader版本被添加为新记录（第7个）。例如：“ S110 7.1.0，0.0”表示S110软设备的7.1.0版本与0.0引导程序一起使用（将来的板将使用较新的0.1引导程序）。

其他说明关于0.5.0：

从版本0.5.0开始，可以通过按住DFU按钮的任意位置（无需终端仿真器）在任意位置执行 AT + FACTORYRESET 命令保持10秒钟，直到蓝色的CONNECTED LED开始闪烁，然后释放它。

版本0.4.7

在0.4.7版本中添加了以下AT命令：

+++

AT + HWRANDOM

AT + BLEURIBEACON

AT + DBGSTACKSIZE

AT + DBGSTACKDUMP

以下命令在0.4中进行了更改。 7版本：

ATI

在芯片名称之后添加了芯片修订版。 ATI以前会报告’nRF51822‘，但现在会添加特定的硬件版本（如果可以检测到的话）（例如’nRF51822 QFAAG00‘）

版本0.3.0

首次公开发行

》 GATT服务详细信息

Bluetooth Low Energy中的数据围绕名为“ GATT服务”和“ GATT特性”的单位进行组织。要将数据公开给另一台设备，您必须在该设备上实例化至少一个服务。

Adafruit的Bluefruit LE Pro模块支持某些“标准”服务，如下所述（将来可能会添加更多）。/p》

UART服务

UART服务是在连接的设备之间发送和接收数据的标准方法，它模拟了熟悉的两线UART接口（一根线用于传输数据，另一线用于接收数据）。

专用UART服务页面上有详细信息。

UART服务

基本UUID： 6E40 0001 -B5A3-F393-E0A9-E50E24DCCA9E

此服务模拟TXD和RXD两行上的基本UART连接。

它基于Nordic Semiconductors专有的UART服务规范。可以使用Nordic Semiconductors用于Android和iOS的nRFUART应用查看与该服务之间发送和发送的数据。

此服务在每个Bluefruit LE模块上均可用，并在加电序列中自动启动。

特征

Nordic的UART服务包括以下特征：

名称

RX必填

是

是UUID

0x0002

0x0003类型

U8 ［20］

U8 ［20］ R

R =读取； W =写N =通知； I =指示

从中央设备的角度分配特性名称

TX（0x0002）

此特征用于将数据发送回传感器节点，并且可以由连接的中央设备（移动电话，平板电脑等）写入。

RX（0x0003）

此特征用于将数据发送到连接的中央设备。通知可以由连接的设备启用，以便每次更新TX通道时都会发出警报。

软件资源

为帮助您使Bluefruit LE模块与其他Central设备进行通信，我们为大多数支持主要平台的平台汇集了许多开源工具低功耗蓝牙。

Bluefruit LE Client Apps和库

Adafruit已将以下移动或桌面应用和库组合在一起，以使您的Bluefruit LE模块与移动设备或笔记本电脑进行通讯变得尽可能容易，并尽可能提供完整的源代码：/p》

Bluefruit LE Connect（Android/Java）

从Android 4.3开始，已向Android添加了蓝牙低功耗支持（尽管从4.4开始才非常稳定），并且我们已经将Bluefruit LE Connect发布到Play商店。

Github上也提供了适用于Android的Bluefruit LE Connect的完整代码，可帮助您g et从您自己的Android应用开始。您需要使用最新版本的Android Studio才能使用此项目。

Bluefruit LE Connect（iOS/Swift ）

苹果公司很早就采用低功耗蓝牙技术，并且苹果的应用程序商店中也有iOS版的Bluefruit LE Connectapp。

Bluefruit LE的完整快速源代码Github也提供适用于iOS的Connect。您需要XCode并访问Apple的developerper程序才能使用此项目：

版本1.x源代码：https：//github.com/adafruit/Bluefruit_LE_Connect

版本2.x源代码：https：//github.com/adafruit/Bluefruit_LE_Connect_v2

该应用程序的2.x版是一个完整的重写，在单个代码库中包含iOS，OS X GUI和OS X命令行工具。

OS X（Swift）的Bluefruit LE Connect

此OS X桌面应用程序基于相同的V2.x代码库作为iOS应用程序，并允许您从笔记本电脑或Mac的便利性访问BLE UART，基本的Pin I/O和OTA DFU固件更新。

这是在本地记录传感器数据并进行记录的理想选择将其导出为CSV，JSON或XML文件以在另一个应用程序中进行解析，并使用nati

Github上也提供了完整的源代码。

用于OS X的Bluefruit LE命令行更新程序（Swift）

此实验性命令行工具不受支持，仅作为概念证明提供，但可用于允许从命令行对Bluefruit设备进行固件更新。

此实用程序通过检查Bluefruit设备上的固件版本（通过设备信息服务）来执行类似于GUI应用程序的自动固件更新，并将其与在线可用的固件版本进行比较，并在适当的情况下在后台下载文件。

只需通过DMG文件安装预编译的工具，然后将其放置在系统路径中的某个位置，或在本地运行该文件通过“ 。/bluefruit”查看帮助菜单：

下载：文件

复制代码

$ 。/bluefruit

bluefruit v0.3

Usage：

bluefruit

［options.。。］

Commands：

Scan peripherals： scan

Automatic update： update ［--enable-beta］［--uuid ］

Custom firmware： dfu --hex ［--init ］［--uuid ］

Show this screen： --help

Show version： --version

Options：

--uuid If present the peripheral with that uuid is used. If not present a list of peripherals is displayed

--enable-beta If not present only stable versions are used

Short syntax：

-u = --uuid， -b = --enable-beta， -h = --hex， -i = --init， -v = --version， -？ = --help $ 。/bluefruit

bluefruit v0.3

Usage：

bluefruit

［options.。。］

Commands：

Scan peripherals： scan

Automatic update： update ［--enable-beta］［--uuid ］

Custom firmware： dfu --hex ［--init ］［--uuid ］

Show this screen： --help

Show version： --version

Options：

--uuid If present the peripheral with that uuid is used. If not present a list of peripherals is displayed

--enable-beta If not present only stable versions are used

Short syntax：

-u = --uuid， -b = --enable-beta， -h = --hex， -i = --init， -v = --version， -？ = --help

已弃用：Bluefruit Buddy（OS X）

此本地OS X应用程序是概念验证的基本应用程序，可让您使用最新的Macbook或iMac连接到Bluefruit LE模块。您可以获取有关模块的基本信息，并使用UART服务发送和接收数据。

该应用程序的完整源代码可在github存储库中的Adafruit_BluefruitLE_OSX中找到。

ABLE（跨平台/节点+电子）

ABLE（Adafruit Bluefruit LE Desktop）是一个跨平台的桌面应用程序基于Sandeep Misty的贵族库和Github的Electronproject（由Atom使用）。

它可在OS X，Windows 7+和精选Linux上运行（Ubuntu已在本地测试）。 Windows 7支持特别有趣，因为Windows 7没有对低功耗蓝牙的本机支持，但是贵族库直接与受支持的蓝牙4.0 USB dongle对话，在系统上模拟BLE（尽管目前仍处于BETA早期，并且断开了连接并采取了

此应用程序可让您收集传感器数据或执行移动Bluefruit LE Connect应用程序所提供的许多相同功能，但只能在台式机上进行。

该应用程序仍处于测试阶段，但除了易于使用的预编译二进制文件之外，还提供了完整的源代码。

div》 Bluefruit LE Python包装器

作为概念证明，我们在使Python与OS X上的本机Bluetooth API以及某些Linux目标上的最新版Bluez一起工作方面做了一些努力。/p》

当前有一些示例草图显示了h由于获取了BLE UART数据以及来自设备信息服务（DIS）的一些基本详细信息。

这不是一个积极支持的项目，而只是一个实验，但是如果您有最新的Macbook或Raspberry Pi并了解Python，您可能想在我们的github帐户中查看Adafruit_Python_BluefruitLE。

调试工具

如果您的冒险意识变得更好，并且您的Bluefruit LE模块陷入了困境，那么以下工具可能会有用

这些调试工具纯粹是为高级用户提供的便利出于设备恢复目的，不建议您这样做，除非您对可能的开发板感到满意。使用它们需要您自担风险。

AdaLink（Python）

此命令行工具是基于python的包装程序，可使用Segger J-Link或STLink/V2对ARM MCU进行编程。您可以使用它重新刷新Bluefruit LE模块

在Github上Adafruit_Adalinkrepo主文件上的readme.md文件中提供了有关如何使用该工具的详细信息。

使用AdaLink完全重新编程Bluefruit LE模块将需要四个文件，并且看起来像这样（使用JLink）：

下载：文件

复制代码

adalink nrf51822 --programmer jlink --wipe

--program-hex “Adafruit_BluefruitLE_Firmware/softdevice/s110_nrf51_8.0.0_softdevice.hex”

--program-hex “Adafruit_BluefruitLE_Firmware/bootloader/bootloader_0002.hex”

--program-hex “Adafruit_BluefruitLE_Firmware/0.6.7/blefriend32/blefriend32_s110_xxac_0_6_7_150917_blefriend32.hex”

--program-hex “Adafruit_BluefruitLE_Firmware/0.6.7/blefriend32/blefriend32_s110_xxac_0_6_7_150917_blefriend32_signature.hex” adalink nrf51822 --programmer jlink --wipe

--program-hex “Adafruit_BluefruitLE_Firmware/softdevice/s110_nrf51_8.0.0_softdevice.hex”

--program-hex “Adafruit_BluefruitLE_Firmware/bootloader/bootloader_0002.hex”

--program-hex “Adafruit_BluefruitLE_Firmware/0.6.7/blefriend32/blefriend32_s110_xxac_0_6_7_150917_blefriend32.hex”

--program-hex “Adafruit_BluefruitLE_Firmware/0.6.7/blefriend32/blefriend32_s110_xxac_0_6_7_150917_blefriend32_signature.hex”

您也可以使用AdaLink工具获取有关模块的一些基本信息，例如通过--info命令当前正在编程哪个SoftDevice或IC版本（16KB SRAM或32KB SRAM）：

下载：文件

复制代码

$ adalink nrf51822 -p jlink --info

Hardware ID ： QFACA10 （32KB）

Segger ID ： nRF51822_xxAC

SD Version ： S110 8.0.0

Device Addr ： **：**：**：**：**：**

Device ID ： **************** $ adalink nrf51822 -p jlink --info

Hardware ID ： QFACA10 （32KB）

Segger ID ： nRF51822_xxAC

SD Version ： S110 8.0.0

Device Addr ： **：**：**：**：**：**

Device ID ： ****************

Adafruit nRF51822 Flasher（Python）

Adafruit的nRF51822 Flasheris是我们在生产中使用的内部Python工具来烧写电路板当他们通过测试程序并下线时，或者只是在调试时针对不同的固件版本进行测试。

它依赖于表面下的AdaLink或OpenOCD（请参见上文），但是您可以使用此命令行

该工具目前支持使用特定的SoftDevice，Bootloader和Bluefruit固件组合来刷新nRF51822。

该工具目前支持通过AdaLink使用Segger J-Link或STLink/V2，或者在Raspberry Pi上使用GPIO可以访问传统的ARM SWD调试器。（该存储库中包含用于RPi的OpenOCD的预构建版本，因为在原始RPi上从头开始构建它需要很长时间。）

由于该工具的纯粹是一个内部项目，但将其公开，以防万一它可以帮助冒险的客户自行清理木板。

下载：文件

复制代码

$ python flash.py --jtag=jlink --board=blefriend32 --softdevice=8.0.0 --bootloader=2 --firmware=0.6.7

jtag ： jlink

softdevice ： 8.0.0

bootloader ： 2

board ： blefriend32

firmware ： 0.6.7

Writing Softdevice + DFU bootloader + Application to flash memory

adalink -v nrf51822 --programmer jlink --wipe --program-hex “Adafruit_BluefruitLE_Firmware/softdevice/s110_nrf51_8.0.0_softdevice.hex” --program-hex “Adafruit_BluefruitLE_Firmware/bootloader/bootloader_0002.hex” --program-hex “Adafruit_BluefruitLE_Firmware/0.6.7/blefriend32/blefriend32_s110_xxac_0_6_7_150917_blefriend32.hex” --program-hex “Adafruit_BluefruitLE_Firmware/0.6.7/blefriend32/blefriend32_s110_xxac_0_6_7_150917_blefriend32_signature.hex”

。。. $ python flash.py --jtag=jlink --board=blefriend32 --softdevice=8.0.0 --bootloader=2 --firmware=0.6.7

jtag ： jlink

softdevice ： 8.0.0

bootloader ： 2

board ： blefriend32

firmware ： 0.6.7

Writing Softdevice + DFU bootloader + Application to flash memory

。。.

BLE FAQ

我可以和带有Bluefruit LE模块的Classic蓝牙设备通话吗？

否。低功耗蓝牙和“经典”蓝牙都是由蓝牙SIG定义和维护的同一蓝牙核心规范的一部分，但是它们是完全不同的协议，具有不同的物理约束和要求。这两个协议不能直接互相通信。

我的Bluefruit LE模块能否连接到其他Bluefruit LE外设

否，Adafruit的Bluefruit LE固件目前仅是外围设备，并且无法在中央模式下运行导致该模块的行为类似于您的手机或启用BLE的笔记本电脑。

如果需要中央支持，则应查看基于nRF52832的较新产品，例如Adafruit Feather nRF52 Bluefruit LE，其中包含一个SoftDevice，能够在中央或外围模式下运行。基于nRF518322的产品（例如本学习指南中使用的产品）不不能在中央模式下运行，因为它们使用的软设备不支持该产品，并且无法更新

我刚得到我的Bluefruit板，当我运行草图时，它会永远挂在“ Connecting 。。.”阶段！/strong》

此处有几种可能的解释，但是首先要尝试的是：

断开连接并关闭Bluefruit LE Connect应用程序（如果打开的话）

在移动设备上禁用BLE

重新启动Bluefruit草图和硬件

（在移动设备上）重新打开BLE

再次打开Bluefruit LE Connect移动应用并尝试重新连接

如果问题仍然存在，尝试执行恢复出厂设置

为什么都不是重置示例草图后，我的更改是否仍然存在？

Bluefruit LE模块处于Adafruit演示草图的已知状态，其中大多数在草图开始时执行出厂重置。

这对于确保草图正常运行很有用，但是具有每次板退出复位并运行草图时，都会擦除NVM中的所有自定义用户数据并将所有设置都恢复为出厂默认值的副作用。

要禁用恢复出厂设置，请打开演示草图并找到 FACTORYRESET_ENABLE 标志并将其设置为“ 0”，这将防止启动时恢复出厂设置。

如果您不会在.ino草图文件中看到’FACTORYRESET_ENABLE‘标志，您可能具有较旧的草图版本，并且可能需要通过Arduino库管理器更新为最新版本。

我在基于UART的Bluefruit LE模块上需要CTS和RTS吗？

在使用HW串行时并不一定要使用CTS和RTS，但是它们都应与SW串行一起使用，或者在任何传输大量数据的时间使用。

之所以需要CTS和RTS，是因为nRF51822上的UART模块不是很健壮，并且该芯片的早期版本具有非常小的FIFO，这意味着UART外设很快就不堪重负了。

使用CTS和RTS大大提高了UART连接的可靠性，因为这两个引脚在另一端告诉设备何时需要等待要处理现有的缓冲数据。

要启用CTS和RTS支持，请进入草图文件夹中的BluefruitConfig.h文件，并为这些功能专用的宏分配一个适当的引脚（可以将它们设置为

同时启用这两个引脚应该可以解决大型命令或连续传输多个命令时遇到的任何数据可靠性问题。

如何更新到最新的Bluefruit LE固件？

使Bluefruit LE模块保持最新状态的最简单方法是使用适用于Android的Bluefruit LE Connect应用程序或适用于iOS的Bluefruit LE Connect。这两个应用程序均具有固件更新功能，可让您自动下载最新固件并以尽可能安全，轻松的方式刷新Bluefruit LE设备。如果需要在先前版本上进行一些测试，您还可以使用这些应用程序回滚到较旧版本的Bluefruit LE固件。

支持的固件版本’xxx‘？

我们会定期发布带有错误修复和新功能的Bluefruit LE固件映像特征。本学习指南中的每个AT命令都列出了使用该命令所需的最低固件版本，但是要获得从一个固件版本到另一个固件版本的更改的更高层次概述，请查阅固件历史记录页面。

我的Bluefruit LE设备是否支持ANCS？

ANCS在我们的路线图上（很可能在0.7.x版本家族中），但是我们目前不支持它，因为在将其作为服务实现时存在一些异常情况。

我的Bluefruit LE设备卡在DFU模式下，该怎么办？

如果您的设备由于某种原因而处于DFU模式，并且固件已损坏，则有几种选择。

首先，按住DFU按钮约10秒钟，直到CONN LED开始闪烁，然后尝试尝试恢复出厂设置，然后释放DFU按钮以执行恢复出厂设置。

如果此操作无效，则可能需要从DFU模式开始刷新固件，可以通过以下方式之一进行刷新：

Bluefruit LE Connect（Android）

将模块置于DFU模式（恒定LED闪烁）

打开Bluefruit LE Connect

连接到“ DfuTarg”设备

连接后，您将看到一个包含一些基本设备信息的屏幕。点击右上角的“ 。。.”，然后选择固件更新

点击使用自定义固件按钮

为BLEFRIEND32固件版本0.6.7选择适当的.hex和.init文件（从Bluefruit LE固件存储库复制）。。.，该文件将是：

十六进制文件：blefriend32_s110_xxac_0_6_7_150917_blefriend32。 hex

初始化文件：blefriend32_s110_xxac_0_6_7_150917_blefriend32_init.dat

单击开始更新

不幸的是，iOS应用尚未支持DFU模式下的自定义固件更新，但我们会将其更新到下一个版本中。

北欧nRF工具箱

您还可以使用Nordic的nRF工具箱应用来使用OTA引导加载程序更新固件。

在 Android 上：

打开nRF Toolbox（使用最新版本）

单击 DFU 图标

单击选择文件按钮

选择应用程序，然后单击确定

找到适当的.hex文件（例如“ blefriend32_s110_xxac_0_6_7_150917_blefriend32.hex”）

“ 初始化数据包”，指示是，然后选择适当的* _init.dat文件（例如：“ blefriend32_s110_xxac_0_6_7_150917_blefriend32_init.dat”）。

点击主屏幕底部的选择设备按钮，找到 DfuTarg 设备，点击该设备

点击上传按钮，现在应该在主屏幕上启用该按钮

这将开始DFU更新过程，这将导致在Bluefruit LE模块上更新或恢复固件

在 iOS 上：

创建一个.zip文件，其中包含用于固件更新的.hex文件和init.dat文件。例如：

将’blefriend32_s110_xxac_0_6_7_150917_blefriend32.hex‘重命名为 application.hex

重命名’blefriend32_s110_xxac_0_6_7_15017_blefriend32_init.dat‘为 application.dat

使用uTunes将包含application.hex和application.dat文件的 .zip文件上传到iPhone，如此处所述

打开nRF工具箱应用程序（使用最新版本）

单击 DFU 图标

单击选择文件文本标签

切换到用户文件以查看您在上方上传的.zip文件

选择.zip文件（例如blefriend32_065.zip）

在主屏幕上选择选择文件类型

选择应用程序

在主屏幕上选择选择设备

选择 DfuTarg

单击上传按钮，该按钮现在应该已启用

这将开始DFU程序，并且更新完成后，您的Bluefruit LE模块将重置。

如果您获得正常的2或3脉冲闪烁模式，则更新有效！

Adafruit_nRF51822_Flasher

作为最后的选择，如果您可以访问Raspberry Pi，Segger J-Link或STLink/V2，则也可以尝试手动刷新整个设备，如上面的FAQ中所述，并提供更多详细信息在“软件资源”页面上。

如何通过SWD重新刷新Bluefruit LE模块？

通过SWD重新刷新Bluefruit LE模块（例如切换到嗅探器固件并返回）的风险由您自己承担，并且可能会导致设备变砖，并且我们无法为该操作提供任何支持！不幸的是，有1，000，000处可能出错的东西，这就是为什么我们提供两个单独的Bluefruit LE Friend板-嗅探器和带有非嗅探器固件的普通Bluefruit LE Friend板，这提供了具有故障保护功能的引导加载程序，可防止您

AdaLink（SWD/JTAG调试器包装）

在两种类型的板（嗅探器和Bluefruit LE模块）之间转换不幸的是，这不是无风险的操作，并且需要外部硬件，软件和专有技术来解决问题，这就是为什么我们的支持团队不对此进行覆盖。

那。。.确定要走那条孤独的路，而您拥有Segger J-Link（这是我们内部用于生产和开发的J-Link），或者已经拥有升级Bluefruit LE设备后，您应该查看AdaLink，这是我们内部使用的工具，用于刷新恢复Bluefruit LE模块所需的四个文件。（注意：最新版本的AdaLink还支持便宜的STLink/V2，但是如果您要购买调试器以长期使用，则J-Link通常更健壮。）

必需的Intel Hex文件可在Bluefruit LE固件库中找到。您需要刷新：

适当的引导程序映像

适当的SoftDevice映像

Bluefruit LE固件映像

包含CRC检查的匹配签名文件，以便引导程序接受上面的固件映像（与固件映像位于同一文件夹中）

适当的文件通常列在固件存储库中的版本控制.xml文件中。

如果您尝试刷新嗅探器固件（后果自负！），则只需刷新单个.hex文件，您可以在这里找到。嗅探器不需要SoftDevice映像，也不需要使用故障安全的引导加载程序-这就是为什么如果没有受支持的SWD调试器，则更改是一种单向操作且冒险的操作。

Adafruit_nF51822_Flasher

我们还提供了一个内部python工具，该工具比AdaLink（上面引用）高出一个级别，并且可以更轻松地将特定版本的官方固件闪存到Bluefruit LE模块。有关详细信息，请参见Adafruit_nRF51822_Flasherrepo。

我可以访问BETA固件版本吗？

适用于iOS和Android的Bluefruit LE Connect应用程序的最新版本使您可以选择使用预发行版本或BETA固件更新Bluefruit LE模块。

此功能主要是作为论坛中支持问题的调试和测试机制提供的，仅应在尝试识别和解决模块中的特定问题时使用！

在iOS上启用BETA版本

确保您至少具有版本1.7.1 的Bluefruit LE Connect

Go到“设置”页面

滚动到“设置”页面底部，直到找到 Bluefruit LE

单击Bluefruit LE图标并启用显示beta版本开关

使用Bluefruit LE Connect时，您现在应该可以在固件存储库中看到所有可用的Beta版本。

在Android上启用BETA版本

确保您具有最新版本的Bluefruit LE Connect

打开Bluefruit LE Connect应用程序

点击应用程序主屏幕右上角的“ 。。.”图标

选择设置

向下滚动到软件更新部分并启用显示测试版

您应该可以看到任何测试版现在，当您使用Bluefruit LE Connect

为什么升级到Android 6.0后看不到我的Bluefruit LE设备

在Android 6.0中，有一些重要的安全更改会影响低功耗蓝牙设备。如果无法使用定位服务（这意味着GPS已关闭），您也将无法看到蓝牙低功耗设备的广告。有关详细信息，请参见此问题。

请确保在Android 6.0上启用定位服务将Bluefruit LE Connect或其他Bluetooth Low Energy应用程序与Bluefruit LE模块配合使用时。

BLE的理论速度限制是什么？

这取决于多种因素，并且取决于中央设备的功能（

考虑到nR51822的硬件限制（每个连接间隔最多6个数据包，最小连接间隔7.5ms），您最终会以下是各种移动操作系统的理论限制：

iPhone 5/6 + IOS 8.0/8.1

6个数据包* 20个字节* 1/0.030 s = 4 kB/s = 32 kbps

iPhone 5/6 + IOS 8.2/8.3

3个数据包* 20字节* 1/0.030 s = 2 kB/s = 16 kbps

带nRF8001的iPhone 5/6 + IOS 8.x

1个数据包* 20字节* 1/0.030 s = 0.67 kB/s = 5.3 kbps

Nexus 4

4个数据包* 20字节* 1/0.0075 s = 10.6 kB/s = 84 kbps

带有nRF51822 0.9.0的北欧主仿真器固件（MEFW）1个数据包* 20字节* 1/0.0075 = 2.67 kB/s = 21.33 kbps

带有nRF51822的北欧主仿真器固件（MEFW）0.11.0

6个数据包* 20字节* 1/0.0075 = 16 kB/s = 128 kbps

Bluefruit LE固件还存在一些限制，但是我们正在积极努力以显着提高即将在2016年第二季度发布的即将发布的0.7.0版本的吞吐量。以上数据可作为理论上的最大值，用于确定是否BLE是否适合您的项目。

UPDATE ：有关各种 Android 版本和手机的限制的更多详细信息，请参阅Nordic Semiconductors的这篇有用的文章。

我的Bluefruit板可以检测到其他Bluefruit板或Central设备吗？

否。目前，我们所有的Bluefruit LE模块都在外围模式下运行，这意味着它们只能通过广告有效载荷来广告自己的存在。中央设备（通常是手机或笔记本电脑）负责侦听这些广告数据包，启动连接过程以及启动设备之间的任何交易。 Bluefruit模块无法检测范围内的其他Bluefruit模块或中央设备，它们只能发送自己的广告数据并等待连接请求进入。

如何确定以m/ft为单位的Bluefruit模块和手机之间的距离？

简单的答案是：您不能。

RF设备通常使用RSSI来测量信号强度，RSSI代表接收信号强度指示器，单位为dBm。设备越接近RSSI值通常就越强（例如，-90dBm比-60dBm弱得多），但是现实中，以dBm为单位的RSSI值与距离之间没有可靠的关系。如果设备之间存在隔离墙，RSSI将掉落。如果在相同的2.4GHz频带上存在很多干扰，RSSI将下降。根据设备的不同，如果仅更改天线方向，RSSI将会下降。您可以使用AT+BLEGETRSSI命令读取两个连接的设备之间的RSSI值，但是从该值中得出的关于距离的信息没有有意义且可重复的结论，而在非常松散的情况下可能不是“更远”或“更近”

我的Bluefruit LE模块可以距手机多远？

这取决于模块本身以外的许多因素，例如天线方向，手机上的天线设计，发送时的发射功率节点，相同2.4GHz带宽内的竞争流量，端点之间的障碍物等。

它的低至几米，最高可达10米的视线，但通常设计为低功耗蓝牙假设Bluefr正常，则在非常短的范围内工作，并且在5-6米或更小的范围内最有效以实现可靠的通信uit固件设置。

我可以创建多少个GATT服务和特征？

对于固件0.7.0及更高版本，存在以下限制：

最大服务数量：10

最大特征数：30

每个特征的最大缓冲区大小：32字节

CCCD的最大数：16

是否可以修改或禁用内置的GATT服务和特征（DIS，DFU等）？

不，不幸的是你不能。我们依靠设备信息服务（DIS）的内容来了解您正在运行的固件和引导程序版本，并且在不能够信任此信息的情况下无法提供固件更新，这就是为什么它既是必需的又是只读的。

类似地，DFU服务是强制性的，用于维护空中更新，并且禁用它会创建它所带来的更多问题。

如何将BlueZ和gatttool与Bluefruit模块一起使用？

BlueZ有一个与之相关的一点学习曲线，但是您可以在下面的某个选项中找到一些注意事项，以使用我们所有Bluefruit LE模块和板卡中内置的BLE UART服务发送和接收数据。

这些命令可能随BlueZ的不同版本进行更改。以下使用版本5.21。

下载：文件

复制代码

# Initialise the USB dongle

$ sudo hciconfig hci0 up

# Scan for the UART BLE device

$ sudo hcitool lescan

D6:4E:06:4F:72:86 UART

# Start gatttool， pointing to the UART device found above

$ sudo gatttool -b D6:4E:06:4F:72:86 -I -t random --sec-level=high

［D6:4E:06:4F:72:86］［LE］》 connect

Attempting to connect to D6:4E:06:4F:72:86

Connection successful

# Scan for primary GATT Services

［D6:4E:06:4F:72:86］［LE］》 primary

attr handle： 0x0001， end grp handle： 0x0007 uuid： 00001800-0000-1000-8000-00805f9b34fb

attr handle： 0x0008， end grp handle： 0x0008 uuid： 00001801-0000-1000-8000-00805f9b34fb

attr handle： 0x0009， end grp handle： 0x000e uuid： 6e400001-b5a3-f393-e0a9-e50e24dcca9e

attr handle： 0x000f， end grp handle： 0xffff uuid： 0000180a-0000-1000-8000-00805f9b34fb

# Get the handles for the entries in the UART service （handle 0x0009）

［D6:4E:06:4F:72:86］［LE］》 char-desc

handle： 0x0001， uuid： 00002800-0000-1000-8000-00805f9b34fb

handle： 0x0002， uuid： 00002803-0000-1000-8000-00805f9b34fb

handle： 0x0003， uuid： 00002a00-0000-1000-8000-00805f9b34fb

handle： 0x0004， uuid： 00002803-0000-1000-8000-00805f9b34fb

handle： 0x0005， uuid： 00002a01-0000-1000-8000-00805f9b34fb

handle： 0x0006， uuid： 00002803-0000-1000-8000-00805f9b34fb

handle： 0x0007， uuid： 00002a04-0000-1000-8000-00805f9b34fb

handle： 0x0008， uuid： 00002800-0000-1000-8000-00805f9b34fb

handle： 0x0009， uuid： 00002800-0000-1000-8000-00805f9b34fb

handle： 0x000a， uuid： 00002803-0000-1000-8000-00805f9b34fb

handle： 0x000b， uuid： 6e400002-b5a3-f393-e0a9-e50e24dcca9e

handle： 0x000c， uuid： 00002803-0000-1000-8000-00805f9b34fb

handle： 0x000d， uuid： 6e400003-b5a3-f393-e0a9-e50e24dcca9e

handle： 0x000e， uuid： 00002902-0000-1000-8000-00805f9b34fb

handle： 0x000f， uuid： 00002800-0000-1000-8000-00805f9b34fb

handle： 0x0010， uuid： 00002803-0000-1000-8000-00805f9b34fb

handle： 0x0011， uuid： 00002a27-0000-1000-8000-00805f9b34fb

# 6e400002 （handle 0x000b） = TX characteristic

# 6e400003 （handle 0x000d） = RX characteristic

# Optional （but maybe helpful）。。. scan for CCCD entries

［D6:4E:06:4F:72:86］［LE］》 char-read-uuid 2902

handle： 0x000e value： 00 00

# Enable notifications on the RX characteristic （CCCD handle = 0x000e）

# 0100 = get notifications

# 0200 = get indications

# 0300 = get notifications + indications

# 0000 = disable notifications + indications

［D6:4E:06:4F:72:86］［LE］》 char-write-req 0x000e 0100

Characteristic value was written successfully

# Just to make sure it was updated

［D6:4E:06:4F:72:86］［LE］》 char-read-hnd 0x000e

Characteristic value/descriptor： 01 00

# Writing “test” in the Serial Monitor of the Arduino sketch should

# cause this output not that notifications are enabled：

Notification handle = 0x000d value： 74 65 73 74

# Write something to the TX characteristic （handle = 0x000b）

# This should cause E F G H to appear in the Serial Monitor

［D6:4E:06:4F:72:86］［LE］》 char-write-cmd 0x000b 45

［D6:4E:06:4F:72:86］［LE］》 char-write-cmd 0x000b 46

［D6:4E:06:4F:72:86］［LE］》 char-write-cmd 0x000b 47

［D6:4E:06:4F:72:86］［LE］》 char-write-cmd 0x000b 48

# To send multiple bytes

［D6:4E:06:4F:72:86］［LE］》 char-write-cmd 0x000B 707172737475

# If you are running the callbackEcho sketch and notifications

# are enabled you should get this response after the above cmd：

Notification handle = 0x000d value： 70 71 72 73 74 75

--------------

# If you just want to enable constant listening， enter the following command from the CLI：

$ sudo gatttool -b D6:4E:06:4F:72:86 -t random --char-write-req -a 0x000e -n 0100 --listen

# This should give us the following output as data is written on the Uno，

# though we can’t send anything back：

Characteristic value was written successfully

Notification handle = 0x000d value： 74 65 73 74

Notification handle = 0x000d value： 6d 6f 72 65 20 74 65 73 74

# Initialise the USB dongle

$ sudo hciconfig hci0 up

# Scan for the UART BLE device

$ sudo hcitool lescan

D6:4E:06:4F:72:86 UART

# Start gatttool， pointing to the UART device found above

$ sudo gatttool -b D6:4E:06:4F:72:86 -I -t random --sec-level=high

［D6:4E:06:4F:72:86］［LE］》 connect

Attempting to connect to D6:4E:06:4F:72:86

Connection successful

# Scan for primary GATT Services

［D6:4E:06:4F:72:86］［LE］》 primary

attr handle： 0x0001， end grp handle： 0x0007 uuid： 00001800-0000-1000-8000-00805f9b34fb

attr handle： 0x0008， end grp handle： 0x0008 uuid： 00001801-0000-1000-8000-00805f9b34fb

attr handle： 0x0009， end grp handle： 0x000e uuid： 6e400001-b5a3-f393-e0a9-e50e24dcca9e

attr handle： 0x000f， end grp handle： 0xffff uuid： 0000180a-0000-1000-8000-00805f9b34fb

# Get the handles for the entries in the UART service （handle 0x0009）

［D6:4E:06:4F:72:86］［LE］》 char-desc

handle： 0x0001， uuid： 00002800-0000-1000-8000-00805f9b34fb

handle： 0x0002， uuid： 00002803-0000-1000-8000-00805f9b34fb

handle： 0x0003， uuid： 00002a00-0000-1000-8000-00805f9b34fb

handle： 0x0004， uuid： 00002803-0000-1000-8000-00805f9b34fb

handle： 0x0005， uuid： 00002a01-0000-1000-8000-00805f9b34fb

handle： 0x0006， uuid： 00002803-0000-1000-8000-00805f9b34fb

handle： 0x0007， uuid： 00002a04-0000-1000-8000-00805f9b34fb

handle： 0x0008， uuid： 00002800-0000-1000-8000-00805f9b34fb

handle： 0x0009， uuid： 00002800-0000-1000-8000-00805f9b34fb

handle： 0x000a， uuid： 00002803-0000-1000-8000-00805f9b34fb

handle： 0x000b， uuid： 6e400002-b5a3-f393-e0a9-e50e24dcca9e

handle： 0x000c， uuid： 00002803-0000-1000-8000-00805f9b34fb

handle： 0x000d， uuid： 6e400003-b5a3-f393-e0a9-e50e24dcca9e

handle： 0x000e， uuid： 00002902-0000-1000-8000-00805f9b34fb

handle： 0x000f， uuid： 00002800-0000-1000-8000-00805f9b34fb

handle： 0x0010， uuid： 00002803-0000-1000-8000-00805f9b34fb

handle： 0x0011， uuid： 00002a27-0000-1000-8000-00805f9b34fb

# 6e400002 （handle 0x000b） = TX characteristic

# 6e400003 （handle 0x000d） = RX characteristic

# Optional （but maybe helpful）。。. scan for CCCD entries

［D6:4E:06:4F:72:86］［LE］》 char-read-uuid 2902

handle： 0x000e value： 00 00

# Enable notifications on the RX characteristic （CCCD handle = 0x000e）

# 0100 = get notifications

# 0200 = get indications

# 0300 = get notifications + indications

# 0000 = disable notifications + indications

［D6:4E:06:4F:72:86］［LE］》 char-write-req 0x000e 0100

Characteristic value was written successfully

# Just to make sure it was updated

［D6:4E:06:4F:72:86］［LE］》 char-read-hnd 0x000e

Characteristic value/descriptor： 01 00

# Writing “test” in the Serial Monitor of the Arduino sketch should

# cause this output not that notifications are enabled：

Notification handle = 0x000d value： 74 65 73 74

# Write something to the TX characteristic （handle = 0x000b）

# This should cause E F G H to appear in the Serial Monitor

［D6:4E:06:4F:72:86］［LE］》 char-write-cmd 0x000b 45

［D6:4E:06:4F:72:86］［LE］》 char-write-cmd 0x000b 46

［D6:4E:06:4F:72:86］［LE］》 char-write-cmd 0x000b 47

［D6:4E:06:4F:72:86］［LE］》 char-write-cmd 0x000b 48

# To send multiple bytes

［D6:4E:06:4F:72:86］［LE］》 char-write-cmd 0x000B 707172737475

# If you are running the callbackEcho sketch and notifications

# are enabled you should get this response after the above cmd：

Notification handle = 0x000d value： 70 71 72 73 74 75

--------------

# If you just want to enable constant listening， enter the following command from the CLI：

$ sudo gatttool -b D6:4E:06:4F:72:86 -t random --char-write-req -a 0x000e -n 0100 --listen

# This should give us the following output as data is written on the Uno，

# though we can‘t send anything back：

Characteristic value was written successfully

Notification handle = 0x000d value： 74 65 73 74

Notification handle = 0x000d value： 6d 6f 72 65 20 74 65 73 74

当BLE UART数据可用时，我可以使用IRQ引脚将MCU从睡眠状态唤醒吗？

否，在基于SPI的板上，IRQ引脚用于指示SDEP响应可用于SDEP命令。例如，当您以SDEP消息形式发送“ AT + BLEUARTRX”命令时，运行在nRF51822上的Bluefruit固件将解析该消息，准备SDEP响应，并触发IRQ引脚以告知MCU响应已准备就绪。这完全独立于目前没有中断功能的BLE UART服务。

我是否还可以使用Bluefruit更新在设备上运行的草图LE Connect？

不，只能通过空中更新核心固件。草图需要使用Arduino IDE和串行引导程序加载。

设备恢复

有时，不幸的事情会发生。值得庆幸的是，有99％的时间纯粹是软件问题，并且Bluefruit设备具有强大的引导加载程序以及一些故障保险柜，几乎可以随时恢复设备。

如何恢复蓝果板 1。在启动时强制DFU模式

第一步是强制您的板进入特殊的引导加载程序模式，这将防止任何错误的用户草图或损坏的配置数据引起问题。

使用跳线电缆将DFU引脚连接到GND，或者如果板上有DFU按钮，则在为板上电路板供电（连接USB电缆等）时，请按住该按钮。

通电后，您应该会看到一个更快的DFU MODE闪烁模式，让您知道自己处于引导加载程序模式。

现在卸下DFU和GND之间的跨接电缆（以防止进入DFU重置时的模式）

拔下DFU和一旦进入DFU模式，便可以在下次重置时退出GND！

2。更新Bluefruit固件

下一步，使用Bluefruit LE Connect应用程序将设备更新到最新的Bluefruit固件。我们会定期修复错误，因此，始终在最新版本中发布是一个好主意。

您可以在DFU模式下执行固件更新，尽管Bluefruit板可能在其中显示为 DfuTarg 。

由于引导加载程序模式是一种故障安全模式，并且具有Bluefruit功能的一小部分，因此，我们可以为Bluefruit LE Connect应用程序选择合适的固件“系列”。

告诉Bluefruit LE Connect应用程序有关我们硬件的很多详细信息。因此，您需要指明要刷新的固件类型，尤其是是否要刷新基于SPI固件的UART。请确保根据您的产品和下表选择正确的固件：

BLEFRIEND32固件（UART，32KB SRAM）

Bluefruit UART Friend V2

Bluefruit LE UART Friend

BLESPIFRIEND固件（SPI）

Bluefruit LE SPI朋友

Bluefruit LE Shield

Bluefruit LE Micro

羽毛32u4 Bluefruit LE

羽毛M0 Bluefruit LE

3。刷新测试草图

一旦更新了Bluefruit核心固件，请从Arduino IDE刷新测试草图至设备，例如以下闪烁代码：

下载：文件

复制代码

// the setup function runs once when you press reset or power the board

void setup（） {

// initialize digital pin LED_BUILTIN as an output.

pinMode（LED_BUILTIN， OUTPUT）;

}

// the loop function runs over and over again forever

void loop（） {

digitalWrite（LED_BUILTIN， HIGH）; // turn the LED on （HIGH is the voltage level）

delay（1000）; // wait for a second

digitalWrite（LED_BUILTIN， LOW）; // turn the LED off by making the voltage LOW

delay（1000）; // wait for a second

} // the setup function runs once when you press reset or power the board

void setup（） {

// initialize digital pin LED_BUILTIN as an output.

pinMode（LED_BUILTIN， OUTPUT）;

}

// the loop function runs over and over again forever

void loop（） {

digitalWrite（LED_BUILTIN， HIGH）; // turn the LED on （HIGH is the voltage level）

delay（1000）; // wait for a second

digitalWrite（LED_BUILTIN， LOW）; // turn the LED off by making the voltage LOW

delay（1000）; // wait for a second

}

4。执行出厂重置

一旦Bluefruit核心固件已更新，最后一步就是执行出厂重置。

在电路板上电的情况下，连接 DFU 引脚连接到 GND

将该引脚设置为GND（或按住DFU按钮不放）超过5秒钟，直到蓝色状态LED开始闪烁

拔下DFU跳线或释放DFU按钮

这将导致恢复出厂设置，这将清除所有配置数据，并应还原您的电路板，让您恢复原状在大多数情况下恢复到正常状态！

还是有问题吗？

跳到我们的支持论坛，清楚地说明您的问题以及以下信息，我们将很乐意为您提供帮助：

您的产品名称和理想的产品ID

您正在使用的Bluefruit固件版本（在大多数示例草图中的“串行监视器”输出的顶部提供） es）

您正在使用的操作系统

您正在使用的Arduino IDE版本

在第一篇文章中提供上述信息将被跳过来回两个回合，您会更快地得到我们的答复，节省了大家的时间和精力！

请务必同时阅读本学习指南的“常见问题解答”部分，该部分回答了许多常见问题！

下载

文件

MDBT数据表

GitHub上的EagleCAD PCB文件

Adafruit Fritzing库中的Fritzing对象

示意图

面板布局

所有尺寸均以英寸为单位。

责任编辑：wv

声明：本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人，不代表电子发烧友网立场。文章及其配图仅供工程师学习之用，如有内容侵权或者其他违规问题，请联系本站处理。举报投诉

开发板

开发板

+关注

关注
25

文章
4943

浏览量
97188

搜索历史

Adafruit Bluefruit LE UART Friend的简介

评论

当豆包与耳机相遇:Ola Friend智能体耳机的独特体验

字节豆包发布AI智能耳机Ola Friend

uart波特率和传输频率的关系 UART串口的常用波特率为多少

使用MSP430 MCU简化USB到UART桥应用简介

LE OTA APP崩溃的原因？

第3章_UART 开发基础

请问如何设置CYW20835 LE的发射功率？

请问如何设置CYW20835 LE的发射功率？

请问如何增加CYW43455的最大LE连接数？

常见的UART收发方式

如何让Adafruit 320x240 IPS TFT显示屏在PSoC上运行？

uart与usart区别 usart可以当uart用吗

最详细的UART通讯协议分析在这里

1le0002和1le0003的区别是什么？

1le0003电机型号的含义