Adafruit Feather 32u4 Bluefruit的使用

概述

羽毛是Adafruit的新开发板，就像它的名字一样，它轻巧，轻巧，可让您飞翔！我们将Feather设计为便携式微控制器内核的新标准。

这是 Adafruit Feather 32u4 Bluefruit -我们的“全能”标准一个‘Arduino兼容+内置USB和电池充电功能的低功耗蓝牙。带有BTLE模块的Adafruit Feather 32u4，随时可以摇滚！ Feather系列中还有其他主板，请在此处查看。

蓝牙低功耗是最热门的新型低功耗，2.4GHz频谱无线协议。特别是，它是唯一可以与iOS一起使用而无需特殊认证的无线协议，并且所有现代智能手机均支持该协议。这使其非常适合在将使用iOS或Android手机或平板电脑的便携式项目中使用。在Mac OS X和Windows 8+中也支持该功能

在Feather 32u4的心脏处，时钟频率为8 MHz，逻辑电压为3.3V的ATmega32u4芯片设计方面，我们在Flora方面拥有丰富的经验。该芯片具有32K闪存和2K RAM，并带有内置USB，因此它不仅具有内置的USB到串行编程和调试功能，而无需类似FTDI的芯片，它也可以像鼠标一样工作，键盘，USB MIDI设备等。

为便于在便携式项目中使用，我们为3.7V锂聚合物电池中的任何一个添加了连接器，并内置了电池充电功能。您不需要电池，它可以直接从micro USB连接器正常运行。但是，如果您确实有电池，可以随身携带，然后插入USB进行充电。当Feather可用时，它将自动切换到USB电源。我们还将电池通过分压器连接到模拟引脚，因此您可以测量和监视电池电压以检测何时需要充电。

这里有一些方便的规格！像所有Feather 32u4一样，您将获得：

尺寸为2.0“ x 0.9” x 0.28“（51mm x 23mm x 8mm），而没有焊接头针。

作为（大？ ）羽毛-5.7克

ATmega32u4 @ 8MHz，具有3.3V逻辑/电源

3.3V稳压器，具有500mA峰值电流输出

USB本地支持，随附USB引导加载程序和串行端口调试

您还将获得大量引脚-20个GPIO引脚

硬件串行，硬件I2C，硬件SPI支持

7个PWM引脚

10个模拟输入

内置100mA锂聚合物充电器，带充电状态指示灯LED

插针＃13红色LED，通用闪烁

电源/启用引脚

4个安装孔

重置按钮

羽毛32u4 Bluefruit LE 使用了多余的空间剩下来添加我们出色的Bluefruit BTLE模块和两个状态指示灯LED

Bluefruit LE的威力

Bluefru它的LE模块是Nordic的nRF51822芯片组，用多功能代码编程，可以完成很多工作！对于大多数人来说，他们将很高兴使用标准的Nordic UART RX/TX连接配置文件。在此配置文件中，Bluefruit充当数据管道，可以“透明”地从您的iOS或Android设备来回传输。您可以使用我们的iOS ApporAndroid应用程序，也可以编写自己的应用程序以与UART服务进行通信。

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

使用Bluefruit App来启动您的项目

使用我们的BluefruitiOS ApporAndroid App，您可以快速获取自己的项目通过使用iOS或Android手机/平板电脑作为控制器原型化的项目。我们有一个彩色选择器，四元数/加速度计/陀螺仪/磁力计或位置（GPS），以及一个8键控制游戏手柄。可以通过BLE读取此数据，然后将其传输到ATmega32u4芯片中进行处理和控制

您还可以做更多的事情！

蓝果还可以像HID键盘一样（对于支持BLE HID的设备）

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

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

内置了无线引导加载功能，因此我们可以为您提供最新的最新固件的最新信息。使用任何Android或iOS设备获取更新并进行安装。这将更新BLE模块上的本机代码，以添加新的无线功能，而不对ATmega芯片进行编程。

已完全组装并经过测试，并带有USB引导加载程序，可让您在Arduino IDE中快速使用它。我们还会折腾一些接头，以便您可以将其焊接并插入无焊面包板上。锂电池，MicroSD卡和USB电缆不包括在内（但如果您要在商店中提供很多选择， d like！）

插脚

Feather 32u4 Bluefruit LE充满了微控制器的优势。还有很多引脚和端口。我们现在将带您参观它们！

DFU引脚在底部意外地标记为GND，对此感到抱歉！它应标记为DFU，请勿将其用作GND

电源引脚

GND -这是所有电源和逻辑的共同点

BAT -这是可选Lipoly电池进出JST插孔的正电压

USB -如果已连接，则是进出Micro USB插孔的正电压

EN -这是3.3V稳压器的使能引脚。它已上拉，因此请接地以禁用3.3V稳压器

3V -这是3.3V稳压器的输出，可提供500mA峰值

逻辑引脚

这是微控制器的通用I/O引脚组。所有逻辑均为3.3V

＃0/RX -GPIO＃0，还接收 Serial1 和中断＃2的（输入）引脚

＃1/TX -GPIO＃1，还传输 Serial1 和中断＃3

＃2/SDA -GPIO＃2，也是I2C（电线）数据引脚。默认情况下，此引脚上没有上拉电阻，因此当与I2C一起使用时，您可能需要2.2K-10K上拉电阻。也是中断＃1

＃3/SCL -GPIO＃3，也是I2C（线）时钟引脚。默认情况下，此引脚上没有上拉电阻，因此当与I2C一起使用时，您可能需要2.2K-10K上拉电阻。可以执行PWM输出并充当中断＃0。

＃5 -GPIO＃5，还可以执行PWM输出

＃6 -GPIO＃6，也可以做PWM输出和模拟输入 A7

＃9 -GPIO＃9，也可以模拟输入 A9 ，并且可以执行PWM输出。该模拟输入已连接至锂聚合物电池的分压器，因此请注意，由于电阻分压器，此引脚自然会“固定”在2VDC左右

＃10 -GPIO＃ 10，也是模拟输入 A10 ，可以进行PWM输出。

＃11 -GPIO＃11，可以进行PWM输出。

＃12 -GPIO＃12，也可以是模拟输入 A11

＃13 -GPIO＃13，可以执行PWM输出并连接到USB插孔旁边的红色LED

A0至A5 -这些都是模拟输入以及数字I/O引脚。

SCK/MOSI/MISO -这些是硬件SPI引脚，也被Bluefruit LE模块使用。您可以将它们用作如果您不激活Bluefruit并保持BLE CS引脚为高电平，则为日常GPIO引脚。但是，我们确实建议让它们免费使用，因为应保留给Bluefruit使用。如果使用它们，请确保将其与可共享SPI总线的设备配合使用！如果需要，还可以使用AVR编程器对芯片进行重新编程。

Bluefruit LE模块+指示灯LED

由于Feather的尺寸较小，由于并非所有引脚都可以引出，因此我们使用它们来控制BLE模块

＃8 -用作Bluefruit CS （片选）引脚

＃7 -用作

＃4 -作为Bluefruit IRQ （中断请求）引脚。 》

由于这些未带出，因此不存在意外使用它们的危险！

其他图钉！

顶侧

RST -这是Reset引脚，与grou相连并手动重置AVR，并手动启动引导加载程序

ARef -模拟参考引脚。通常，参考电压与芯片逻辑电压（3.3V）相同，但是如果您需要替代的模拟参考，请将其连接到此引脚并在固件中选择外部AREF。不能高于3.3V！

DFU -这是用于对Bluefruit模块进行无线更新的force-DFU（设备固件升级）引脚。您可能不需要使用它，但是如果需要升级，可以使用它！请查看 DFU Bluefruit升级页面以了解如何使用它。否则，请保持断开连接。

底侧

后面我们还有 SWDIO/SWCLK/RESET 引脚，这些引脚用于对Bluefruit LE模块本身进行编程。

SWD调试输入

通常，您不应该除非您出于某种原因要擦掉Bluefruit LE模块固件，否则请连接到 SWDIO 和 SWCLK 引脚，尽管这样做会刷新自己编写的完全自定义的固件映像完全自负风险，因为它将擦除Bluefruit固件！刷新固件或使用SWD接口将需要Segger J-Link EDU Mini之类的东西，才能通过nRF51822内部的调试控制器进行通信。/p》 出厂重置

重置按钮（不要与0.1“圆形 RST pin！）是出厂重置引脚，也很少使用，但是如果确实弄乱了它，则可以使用它将模块设置回出厂默认设置。引导设备启动时，将“ 重置”引脚连接到GND，以通过引导加载程序强制通过硬件强制恢复出厂设置。

装配体

我们出厂的Feathers经过了全面测试，但未连接标头-这使您在选择如何使用和配置Feather时更具灵活性

标题选项！

焊接时，有一些选择要考虑！

第一个选择是焊接普通的公头，这使您可以插入羽毛变成无焊面包板

另一种选择是使用插座母头。这不会让您将Feather插入面包板，但可以非常轻松地连接羽翼

我们也有“ slim”母头的版本短一些，并且形状更紧凑

最后，有“ Stacking Header”选项。这是两全其美的。您可以插入无焊面包板 并在顶部插入一个羽翼。但是它有点笨重

以普通标题进行焊接

准备标题栏：

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

添加分线板：

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

然后焊接！

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

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

将另一条带焊接为

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

在女性头上焊接

原位录音

对于插座，您需要将其绑在适当的位置，因此当您翻转电路板时，它们不会掉落

Flip＆Tack Solder Fack＆Tack Solder

After翻转，在每个条上焊接一个或两个点，以将接头“固定”到位

并焊接！

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

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

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

电源管理

电池+ USB电源

我们想制作羽毛连接到计算机以及通过电池轻松供电。羽毛有两种方式供电。您可以使用MicroUSB电缆（只需插入插孔）进行连接，Feather会将5V USB的电压降至3.3V。您也可以将4.2/3.7V锂聚合物（Lipo/Lipoly）或锂离子（LiIon）电池连接到JST插孔。这会使羽毛在可充电电池上运行。 为USB电源供电时，它将自动切换至USB供电，并以100mA的电流开始为电池（如果已连接）充电。 这种情况是“热插拔”式的，因此您始终可以将Lipoly保持为“备份”电源，只有在USB电源断开时才能使用。

JST连接器的极性与Adafruit LiPoly电池匹配。使用极性错误的电池可能会损坏您的羽毛

上面显示的是Micro USB插孔（左），Lipoly JST插孔（左上）以及3.3V稳压器和转换二极管（位于JST的右侧）插孔）和Lipoly充电电路（位于“重置”按钮的右侧）。还有一个 CHG LED，在电池充电时该指示灯会点亮。如果未连接电池，则该LED也会闪烁。

充电LED为由Lipoly充电器电路自动驱动。它将尝试检测电池，并期望将其安装。如果没有电池，则在使用电源时可能会偶尔闪烁一次，因为它正在尝试为（不存在的）电池充电。这不是有害的，而且完全正常！

电源

您在这里有很多电源选择！我们将引出 BAT 引脚（该引脚与lipoly JST连接器相连）以及 USB （如果已连接，则为USB + 5V）。我们还有 3V 引脚，该引脚具有3.3V稳压器的输出。我们使用500mA峰值SPX3819。虽然可以从中获得500mA的电流，但是由于5V会使稳压器过热，因此您不能连续从5V中获得。可以给ESP8266 WiFi芯片或XBee无线电供电是很好的，因为当前消耗是“尖峰”和零星的。

测量电池

如果用完电池，您可能想知道电压是多少！这样，您就可以知道电池何时需要充电。 Lipoly电池在4.2V时“达到极限”，并在3.7V左右保持不变，从而延长了电池的使用寿命，然后缓慢下降至3.2V左右，然后保护电路将其切断。通过测量电压，您可以快速确定何时到达3.7V以下

为方便起见，我们在 BAT 引脚上插入了一个双100K电阻分压器并将其连接到 D9 （又称模拟＃9 A9 ）。您可以读取此引脚的电压，然后将其加倍以获得电池电压。

下载：文件

复制代码

#define VBATPIN A9

float measuredvbat = analogRead（VBATPIN）;

measuredvbat *= 2; // we divided by 2， so multiply back

measuredvbat *= 3.3; // Multiply by 3.3V， our reference voltage

measuredvbat /= 1024; // convert to voltage

Serial.print（“VBat： ” ）; Serial.println（measuredvbat）; #define VBATPIN A9

float measuredvbat = analogRead（VBATPIN）;

measuredvbat *= 2; // we divided by 2， so multiply back

measuredvbat *= 3.3; // Multiply by 3.3V， our reference voltage

measuredvbat /= 1024; // convert to voltage

Serial.print（“VBat： ” ）; Serial.println（measuredvbat）;

当未插入电池时，此电压将在4.2V时“浮动”，由于lipoly充电器的输出，因此它不是检测电池是否已插入的好方法（没有简单的方法可检测电池是否已插入）

启用引脚

如果您想关闭3.3V稳压器，则可以使用 EN （可用）图钉。只需将此引脚连接到 Ground ，它将禁用3V稳压器。 BAT 和 USB 引脚仍将供电

备用电源选项

为羽毛供电的两种主要方法是将3.7/4.2V LiPo电池插入JST端口或 USB电源线。

如果您需要其他方式为Feather供电，则建议这样做：

对于永久性安装，请使用5V 1A USB墙适配器可让您插入USB电缆以提供可靠的电源

对于不希望使用LiPoly的移动设备，请使用USB电池组！

电压电源，请使用5V降压转换器，并将其连接到USB电缆的5V和GND输入端。

这是您不能执行的操作：

请勿使用碱性或镍氢电池并连接到电池端口-这会损坏LiPoly充电器，并且无法禁用充电器

请勿在7.4V的RC电池上使用电池端口 -这会破坏电路板

“羽毛” 不是为外部电源设计的-这是使电路板紧凑且成本低廉的设计决定。不建议使用，但在技术上可行：

将外部3.3V电源连接到3V和GND引脚。不建议这样做，这可能会导致意外行为，并且 EN 引脚将不再存在。而且，这不提供 BAT 或 USB 的电源，某些羽毛/机翼将这些引脚用于高电流使用。您可能最终会损坏Feather。

将外部5V电源连接到USB和GND引脚。不建议这样做，这可能会导致在插入USB端口时发生意外行为，因为您将为USB端口供电，这可能会混淆或损坏您的计算机。

Arduino IDE设置

您需要做的第一件事是下载最新版本的Arduino IDE。下载并安装后，您将需要使用 1.8版或更高版本作为本指南

Arduino IDE下载

strong》最新版本的Arduino IDE ，则需要启动IDE并导航到首选项菜单。您可以通过 Windows 或 Linux 中的 File 菜单或 OS上的 Arduino 菜单访问它X 。

将弹出一个对话框，如下所示。

我们将向新的其他董事会管理器URL 选项中添加一个URL。 URL列表以逗号分隔，您只需添加一次每个URL。新的Adafruit开发板和对现有开发板的更新将在每次打开时由开发板管理器自动提取。这些URL指向Board Manager用来建立可用和已安装板列表的索引文件。

要查找可以添加的URL的最新列表，您可以访问第三方板列表Arduino IDE Wiki上的URL。在此示例中，我们只需要向IDE添加一个URL，但是 您可以通过用逗号分隔 来添加多个URL。将下面的链接复制并粘贴到Arduino IDE首选项中的 Additional Boards Manager URLs 选项中。

https://adafruit.github.io/arduino-board-index/package_adafruit_index.json

以下是简短说明添加URL时，板管理器中将提供的每个Adafruit提供的软件包：

Adafruit AVR板-包括对Flora，Gemma，Feather的支持32u4，Trinket和Trinket Pro。

Adafruit SAMD板-包括对Feather M0和M4，Metro M0和M4，ItsyBitsy M0和M4，Circuit Playground Express，Gemma M0的支持和Trinket M0

Arduino Leonardo和Micro MIDI-USB -使用arcore项目为Flora，Feather 32u4，Micro和Leonardo添加了USB over MIDI支持。

如果要支持多个开发板，例如ESP8266和Adafruit，请在文本框中输入两个URL，并用逗号分隔（ ，）

完成后，单击确定保存新的首选项设置。接下来，我们将研究使用Board Manager安装板。

现在继续下一步，实际安装板支持包！

使用Arduino IDE

由于Feather 32u4使用了以8 MHz运行的ATmega32u4芯片，因此您可以轻松地使其与Arduino IDE一起使用。许多库（包括像NeoPixels和display这样的流行库）在’32u4和8 MHz时钟速度下都可以很好地工作。

现在，您已经在Arduino IDE首选项中添加了适当的URL，您可以打开《导航到工具-》委员会菜单，从而使strong》委员会管理器。

一旦打开“董事会管理器”，请单击窗口左上角的类别下拉菜单，然后选择已贡献。然后，您将能够选择和安装由添加到首选项中的URL提供的板。在下面的示例中，我们正在安装对 Adafruit AVR板 的支持，但是对所有与板管理器一起安装的板也是如此。

下一步，退出并重新打开Arduino IDE 确保所有板卡均已正确安装。现在，您应该可以选择并上传到工具-》委员会菜单中列出的新委员会。

安装驱动程序（仅Windows）

插入Feather时，您可能需要安装驱动程序

单击下方以下载我们的驱动程序安装程序

下载Adafruit驱动程序安装程序

下载并运行安装程序

运行安装程序！由于我们也捆绑了SiLabs和FTDI驱动程序，因此您需要单击许可证

选择要安装的驱动程序：

点击安装进行安装

眨眼

现在，您可以上传第一个眨眼素描了！

在羽化32u4并等待操作系统识别它（只需几秒钟）。它将创建一个串行/COM端口，您现在可以从下拉列表中选择它，甚至将其“指示”为Feather 32u4！

现在加载眨眼示例

下载：文件

复制代码

// the setup function runs once when you press reset or power the board

void setup（） {

// initialize digital pin 13 as an output.

pinMode（13， OUTPUT）;

}

// the loop function runs over and over again forever

void loop（） {

digitalWrite（13， HIGH）; // turn the LED on （HIGH is the voltage level）

delay（1000）; // wait for a second

digitalWrite（13， 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 13 as an output.

pinMode（13， OUTPUT）;

}

// the loop function runs over and over again forever

void loop（） {

digitalWrite（13， HIGH）; // turn the LED on （HIGH is the voltage level）

delay（1000）; // wait for a second

digitalWrite（13， LOW）; // turn the LED off by making the voltage LOW

delay（1000）; // wait for a second

}

然后单击上载！就是这样，您可以在适应 delay（）呼叫时看到LED闪烁速率的变化。

手动引导加载

如果您在引导加载程序中遇到“怪异”的地方，或者您上载的代码崩溃了并且无法自动执行-重新启动进入引导程序，双击RST 按钮返回到引导程序。红色LED会闪烁，因此您知道它处于引导加载程序模式。当Arduino IDE提示其尝试上传草图时，请双击右键，在状态栏中看到黄色箭头亮起并且 Uploading 。.. 文本时

。

不要单击之前的重置按钮，与其他引导加载程序不同，您希望在Arduino尝试上传时启动该引导加载程序

Ubuntu＆Linux问题修复

如果您使用的是Linux，并且看到连接到服务器的延迟时间为几秒钟串行控制台，或者在连接时看到“ AT”和其他乱码，请按照此页面上的步骤进行操作。

安装BLE库

安装Adafruit nRF51 BLE库

要尝试我们的演示，您需要下载基于nRF51的模块（例如Adafruit BLE库）的Adafruit BLE库（又名Adafruit_BluefruitLE_nRF51）

您可以在github上查看代码，但是通过Arduino库管理器下载它可能更容易。

打开Arduino库管理器：

搜索 Adafruit BluefruitLE nRF51 库并安装

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

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

检查您会看到带有示例的库文件夹：

运行第一个示例

让我们从初学者项目开始，我们可以使用它进行基本测试。要打开ATCommand草图，请单击Arduino IDE中的文件》示例》 Adafruit_BluefruitLE_nRF51 文件夹，然后选择 atcommand ：

这将在IDE，如下所示：

还没有上传草图！您必须先更改配置。

转到第二个标签为 BluefruitConfig.h 的标签，找到这些行

下载：文件

复制代码

// SHARED SPI SETTINGS

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

// The following macros declare the pins to use for HW and SW SPI communication.

// SCK， MISO and MOSI should be connected to the HW SPI pins on the Uno when

// using HW SPI. This should be used with nRF51822 based Bluefruit LE modules

// that use SPI （Bluefruit LE SPI Friend）。

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

#define BLUEFRUIT_SPI_CS 8

#define BLUEFRUIT_SPI_IRQ 7

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

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

// The following macros declare the pins to use for HW and SW SPI communication.

// SCK， MISO and MOSI should be connected to the HW SPI pins on the Uno when

// using HW SPI. This should be used with nRF51822 based Bluefruit LE modules

// that use SPI （Bluefruit LE SPI Friend）。

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

#define BLUEFRUIT_SPI_CS 8

#define BLUEFRUIT_SPI_IRQ 7

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

并将最后一行更改为：

下载：文件

复制代码

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

（Bluefruit Feather在数字＃4上已重置不是＃6）

现在返回主选项卡 atcommand ，并查找以下代码行

下载：文件

复制代码

/* 。..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）;

确保第二行没有注释（应该是）

现在好了可以上传到Bluefruit Feather！

如果您使用的是Ubuntu 15.04或其他Linux发行版，并在尝试将程序上传到板上时遇到错误，向上滚动至上一节中的Ubuntu和Linux问题修复程序

上传到羽毛Bluefruit LE

上传非常容易，首先请确保您已经如上所述，在木板下拉菜单中选择了 Adafruit 羽毛32u4 。此外，在 Ports （端口）菜单中，查找标有以下名称的端口：

现在单击Arduino IDE上的上载按钮（或文件菜单-》上载）

如果一切都很好，您将在状态栏中看到完成上传

上载到全新的板上/上载失败

如果您是第一次上载到新板上，或者上载失败，请按下 RESET 迷你按钮当您看到黄色箭头亮起并且状态栏中显示正在上传。.. 文本时，显示Feather 32u4 Bluefruit。当您看到红色LED闪烁时，您就知道引导加载程序正在运行。

在上传前不要单击重置按钮 ，与其他引导加载程序不同，您希望此引导加载程序在Arduino启动时运行尝试上传

运行草图

确定，再次检查是否选择了正确的端口

然后打开串行控制台。您将看到以下内容：

此草图从恢复出厂设置开始，然后查询BLE无线电以获取详细信息。如果您要调试无线电，这些详细信息将很有用。如果您看到上述信息，说明您正在工作！ （请注意，日期和版本号可能会有所不同）

AT命令测试

现在您可以尝试一些 AT命令-查看学习指南的其余部分以获取完整列表。我们将从 AT + HWGETDIETEMP 开始，它将返回BLE芯片组的大致环境温度

确定，现在您知道如何与Feather 32u4 Bluefruit上传/测试/通信了。接下来，我们有一堆教程，您可以按照这些教程来检查蓝牙无线广播和应用程序。

对于以下所有示例，我们在各个模块之间共享相同的代码，因此不要忘记确保在上传之前将每个草图的BluefruitConfig.h中的RESET引脚设置为4，并通过检查

下载：文件

复制代码

/* 。..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）;

配置！

在开始上传任何示例草图之前，您需要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）;

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设备上绑定键盘，请转到t他在手机上设置应用程序，然后单击蓝牙菜单项。

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

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

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

OS X

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

要在配对后解除绑定，请单击 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颜色数据，该模块显示以下颜色选择对话框：

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

下载：文件

复制代码

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进行连接！

AT命令

Bluefruit LE模块使用Hayes AT样式的命令集来配置设备。

AT样式的命令集的优点是它很容易在机器对机器的通信中使用，同时对人类仍然有些用户友好。

测试命令模式‘=？’

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

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

下载：文件

复制代码

AT+BLESTARTADV=？ AT+BLESTARTADV=？

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

下载：文件

复制代码

AT+BLESTARTADV=？

OK

AT+MISSINGCMD=？

ERROR AT+BLESTARTADV=？

OK

AT+MISSINGCMD=？

ERROR

写入命令模式‘= xxx’

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

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

下载：文件

复制代码

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

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

下载：文件

复制C ode

AT+BLEPOWERLEVEL=-8

OK AT+BLEPOWERLEVEL=-8

OK

如果命令出现问题（例如参数无效），您将得到 》‘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

OK

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

下载：文件

复制代码

AT+BLEGETPOWERLEVEL

-4

OK

AT+BLEGETPOWERLEVEL？

-4

OK AT+BLEGETPOWERLEVEL

-4

OK

AT+BLEGETPOWERLEVEL？

-4

OK

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

阅读命令模式‘？’

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

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

下载：文件

复制代码

AT+BLEPOWERLEVEL？ AT+BLEPOWERLEVEL？

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

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

下载：文件

复制代码

AT+BLEPOWERLEVEL？

-4

OK AT+BLEPOWERLEVEL？

-4

OK

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

标准AT

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

AT

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

代码库修订：0.3.0

参数 》：无

输出：无

下载：文件

复制代码

AT

OK AT

OK

ATI

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

代码库修订 ：0.3.0

参数：无

输出：显示以下值：

板名

微控制器/无线电SoC名称

唯一的序列号

核心Bluefruit代码库修订版

项目固件修订版

固件构建日期

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

下载：文件

复制代码

ATI

BLEFRIEND

nRF51822 QFAAG00

FB462DF92A2C8656

0.5.0

0.5.0

Feb 24 2015

S110 7.1.0， 0.0

OK ATI

BLEFRIEND

nRF51822 QFAAG00

FB462DF92A2C8656

0.5.0

0.5.0

Feb 24 2015

S110 7.1.0， 0.0

OK

《强g》更新：

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

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

ATZ

执行系统重置。

代码库修订 ：0.3.0

参数：无

输出：无

下载：文件

复制代码

ATZ

OK ATZ

OK

ATE

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

代码库修订：0.3.0

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

输出：无

下载：文件

复制代码

# Disable echo support

ATE=0

OK

#Enable echo support

ATE=1

OK # Disable echo support

ATE=0

OK

#Enable echo support

ATE=1

OK

+++

在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

0.4.6

Dec 22 2014

OK

+++

OK

OK ATI

BLEFRIEND

nRF51822 QFAAG00

B122AAC33F3D2296

0.4.6

0.4.6

Dec 22 2014

OK

+++

OK

OK

通用

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

AT + FACTORYRESET

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

代码库修订 ：0.3.0

参数：无

输出：无

下载：文件

复制代码

AT+FACTORYRESET

OK AT+FACTORYRESET

OK

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

AT + DFU

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

代码库修订：0.3.0

参数：无

输出：无

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

下载：文件

复制代码

AT+DFU

OK AT+DFU

OK

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+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 + 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

OK

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

OK

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

OK

硬件

以下命令使您可以与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

OK

# Check the current baud rate

AT+BAUDRATE

115200

OK # Set the baud rate to 115200

AT+BAUDRATE=115200

OK

# Check the current baud rate

AT+BAUDRATE

115200

OK

AT + HWADC

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

代码库修订 ：0.3.0

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

输出：ADC转换的结果

下载：文件

复制代码

AT+HWADC=0

178

OK AT+HWADC=0

178

OK

AT + HWGETDIETEMP

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

代码库修订：0.3.0

参数：无

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

下载：文件

复制代码

AT+HWGETDIETEMP

32.25

OK AT+HWGETDIETEMP

32.25

OK

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

OK

# Set pin 14 LOW

AT+HWGPIO=14，0

OK

# Read the current state of pin 14

AT+HWGPIO=14

0

OK

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

AT+HWGPIOMODE=14，0

OK

AT+HWGPIO=14，1

ERROR # Set pin 14 HIGH

AT+HWGPIO=14，1

OK

# Set pin 14 LOW

AT+HWGPIO=14，0

OK

# Read the current state of pin 14

AT+HWGPIO=14

0

OK

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

AT+HWGPIOMODE=14，0

OK

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

OK

# Get the current mode for pin 14

AT+HWPGIOMODE=14

0

OK # Configure pin 14 as an output

AT+HWGPIOMODE=14，0

OK

# Get the current mode for pin 14

AT+HWPGIOMODE=14

0

OK

AT + HWI2CSCAN

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

代码库修订：0.3.0

参数：无

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

下载：文件

复制代码

# I2C scan with two devices detected

AT+HWI2CSCAN

0x23，0x35

OK

# I2C scan with no devices detected

AT+HWI2CSCAN

OK # I2C scan with two devices detected

AT+HWI2CSCAN

0x23，0x35

OK

# I2C scan with no devices detected

AT+HWI2CSCAN

OK

AT + HWVBAT

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

代码库修订：0.3.0

参数：无

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

下载：文件

复制代码

AT+HWVBAT

3248

OK AT+HWVBAT

3248

OK

AT + HWRANDOM

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

代码库修订：0.4.7

参数：无

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

下载：文件

复制代码

AT+HWRANDOM

0x769ED823

OK AT+HWRANDOM

0x769ED823

OK

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

OK

# Change the MODE LED to indicate BLE UART activity

AT+HWMODELED=BLEUART

OK

# Manually toggle the MODE LED

AT+HWMODELED=MANUAL，TOGGLE

OK # Get the curent MODE LED setting

AT+HWMODELED

MODE

OK

# Change the MODE LED to indicate BLE UART activity

AT+HWMODELED=BLEUART

OK

# Manually toggle the MODE LED

AT+HWMODELED=MANUAL，TOGGLE

OK

AT + UARTFLOW

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

代码库修订：0.7.0

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

上

off

0

1

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

下载：file

复制代码

# Check the current flow control state

AT+UARTFLOW

1

OK

# Disable HW flow control

AT+UARTFLOW=off

OK # Check the current flow control state

AT+UARTFLOW

1

OK

# Disable HW flow control

AT+UARTFLOW=off

OK

信标

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

OK

# Reset to change the advertising data

ATZ

OK

# 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

OK

# 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

OK

# Reset to change the advertising data

ATZ

OK

# 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

OK

# Reset to change the advertising data

ATZ

OK

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

OK

# Reset to change the advertising data

ATZ

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

OK

# Reset to change the advertising data

ATZ

OK

如果提供的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

OK

# Check the current Eddystone status on the module

AT+EDDYSTONEENABLE

1

OK # Enable Eddystone support

AT+EDDYSTONEENABLE=1

OK

# Check the current Eddystone status on the module

AT+EDDYSTONEENABLE

1

OK

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

OK

# 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

OK

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

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

OK

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

OK

AT + EDDYSTONESERVICEEN

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

代码库修订：0.7.0

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

on

off

1

0

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

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

下载：文件

复制代码

# Enable Eddystone service

AT+EddyStonServiceEn=on

OK

AT+EddyStonServiceEn=1

OK

# Disable Eddystone service

AT+EddyStonServiceEn=off

OK

AT+EddyStonServiceEn=0

OK # Enable Eddystone service

AT+EddyStonServiceEn=on

OK

AT+EddyStonServiceEn=1

OK

# Disable Eddystone service

AT+EddyStonServiceEn=off

OK

AT+EddyStonServiceEn=0

OK

AT + EDDYSTONEBROADCAST

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

代码库修订：0.7.0

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

on

off

1

0

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

下载：文件

复制代码

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

AT+EddyStoneBroadcast=on

OK

AT+EddyStoneBroadcast=1

OK

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

AT+EddyStoneBroadcast=off

OK

AT+EddyStoneBroadcast=0

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

AT+EddyStoneBroadcast=on

OK

AT+EddyStoneBroadcast=1

OK

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

AT+EddyStoneBroadcast=off

OK

AT+EddyStoneBroadcast=0

OK

BLE通用

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

AT + BLEPOWERLEVEL

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

代码库修订 ：0.3.0

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

-40

-20

-16

-12

-8

-4

0

4

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

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

下载：文件

复制代码

# Get the current TX power level （in dBm）

AT+BLEPOWERLEVEL

0

OK

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

AT+BLEPOWERLEVEL=4

OK

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

AT+BLEPOWERLEVEL=-12

OK

# Set the TX power level to an invalid value

AT+BLEPOWERLEVEL=-3

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

AT+BLEPOWERLEVEL

0

OK

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

AT+BLEPOWERLEVEL=4

OK

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

AT+BLEPOWERLEVEL=-12

OK

# 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

1

OK AT+BLEGETADDRTYPE

1

OK

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

OK

AT + BLEGETPEERADDR

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

代码库修订：0.6.5

参数：无

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

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

下载：文件

复制代码

AT+BLEGETPEERADDR

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

OK AT+BLEGETPEERADDR

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

OK

AT + BLEGETRSSI

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

代码库修订：0.3.0

参数：无

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

下载：文件

复制代码

# Connected to an external device

AT+BLEGETRSSI

-46

OK

# Not connected to an external device

AT+BLEGETRSSI

0

OK # Connected to an external device

AT+BLEGETRSSI

-46

OK

# Not connected to an external device

AT+BLEGETRSSI

0

OK

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

OK

# 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

OK

# 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

OK

# Command results when no data is available

AT+BLEUARTRX

OK # Command results when data is available

AT+BLEUARTRX

Sent from Android

OK

# Command results when no data is available

AT+BLEUARTRX

OK

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

OK

AT+BLEUARTFIFO=TX

1024

OK

AT+BLEUARTFIFO=RX

1024

OK AT+BLEUARTFIFO

1024，1024

OK

AT+BLEUARTFIFO=TX

1024

OK

AT+BLEUARTFIFO=RX

1024

OK

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

OK

ATZ

OK

# Disable BLE keyboard support then reset

AT+BLEKEYBOARDEN=0

OK

ATZ

OK # Enable BLE keyboard support then reset

AT+BLEKEYBOARDEN=1

OK

ATZ

OK

# Disable BLE keyboard support then reset

AT+BLEKEYBOARDEN=0

OK

ATZ

OK

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

OK

# 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

OK

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

AT+BLEKEYBOARD=\？

OK

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

OK

# 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

OK

# Indicate that the keys were released （mandatory！）

AT+BLEKEYBOARDCODE=00-00

OK

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

OK

# Reset so that the changes take effect

ATZ

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

AT+BLEHIDEN=1

OK

# Reset so that the changes take effect

ATZ

OK

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

OK

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

AT+BLEHIDMOUSEMOVE=，，20，

OK

# 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

OK

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

AT+BLEHIDMOUSEMOVE=，，20，

OK

# 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

OK

# 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

OK

AT+BLEHIDMOUSEMOVE=-100，50

OK

AT+BLEHIDMOUSEBUTTON=0

OK

# 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

OK

# 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

OK

AT+BLEHIDMOUSEMOVE=-100，50

OK

AT+BLEHIDMOUSEBUTTON=0

OK

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

AT+BLEHIDMOUSEBUTTON=B，hold，200

OK

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）

SEARCH

HOME

返回

前进

停止

刷新

书签

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

下载：文件

复制代码

# Toggle the sound on the bonded central device

AT+BLEHIDCONTROLKEY=MUTE

OK

# Hold the VOLUME+ key for 500ms

AT+BLEHIDCONTROLKEY=VOLUME+，500

OK

# 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

OK

# Hold the VOLUME+ key for 500ms

AT+BLEHIDCONTROLKEY=VOLUME+，500

OK

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

AT+BLEHIDCONTROLKEY=0x006F

OK

AT + BLEHIDGAMEPADEN

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

代码库修订版：0.7.6

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

on

off

1

0

输出：如果不带参数执行，则为数值将返回指示电池服务是启用（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

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

打开

关闭

0

1

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

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

下载：文件

复制代码

# Check the current state of the MIDI service

AT+BLEMIDIEN

1

OK

# Enable the MIDI Service

AT+BLEMIDIEN=1

OK # Check the current state of the MIDI service

AT+BLEMIDIEN

1

OK

# Enable the MIDI Service

AT+BLEMIDIEN=1

OK

AT + BLEMIDIRX

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

代码库修订：0.7.0

参数：无

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

下载：文件

复制代码

AT+BLEMIDIRX

90-3C-7F

OK AT+BLEMIDIRX

90-3C-7F

OK

》

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

OK

# Send 2 events

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

OK

# 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

OK

# Send 2 events

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

OK

# Send 1 full event + running event

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

OK

AT + BLEBATTEN

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

代码库修订：0.7.0

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

on

off

1

0

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

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

下载：文件

复制代码

# Enable the Battery Service

AT+BLEBATTEN=1

OK # Enable the Battery Service

AT+BLEBATTEN=1

OK

AT + BLEBATTVAL

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

代码库修订版：0.7.0

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

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

下载：文件

复制代码

# Set the battery level to 72%

AT+BLEBATTVAL=72

OK # Set the battery level to 72%

AT+BLEBATTVAL=72

OK

BLE GAP

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

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

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

AT + GAPCONNECTABLE

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

代码库修订：0.7.0

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

是

否

1

0

输出：’connec

Download：file

Copy Code

# Make the device non-connectable （advertising only）

AT+GAPCONNECTABLE=0

OK

# Check the current connectability status

AT+GAPCONNECTABLE

1

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

AT+GAPCONNECTABLE=0

OK

# Check the current connectability status

AT+GAPCONNECTABLE

1

OK

AT + GAPGETCONN

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

代码库修订 ：0.3.0

参数：无

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

下载：文件

复制代码

# Connected

AT+GAPGETCONN

1

OK

# Not connected

AT+GAPGETCONN

0

OK # Connected

AT+GAPGETCONN

1

OK

# Not connected

AT+GAPGETCONN

0

OK

AT + GAPDISCONNECT

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

代码库修订：0.3.0

参数：无

输出：无

下载：文件

复制代码

AT+GAPDISCONNECT

OK AT+GAPDISCONNECT

OK

AT + GAPDEVNAME

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

代码库修订：0.3.0

参数：

无法读取当前设备名称

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

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

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

下载：文件

复制代码

# Read the current device name

AT+GAPDEVNAME

UART

OK

# Update the device name to ‘BLEFriend’

AT+GAPDEVNAME=BLEFriend

OK

# Reset to take effect

ATZ

OK # Read the current device name

AT+GAPDEVNAME

UART

OK

# Update the device name to ‘BLEFriend’

AT+GAPDEVNAME=BLEFriend

OK

# Reset to take effect

ATZ

OK

AT + GAPDELBONDS

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

代码库修订：0.3.0

参数：无

输出：无

下载：文件

复制代码

AT+GAPDELBONDS

OK AT+GAPDELBONDS

OK

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

OK

# 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

OK

# Update only the advertising interval

AT+GAPINTERVALS=，，150，

OK

AT + GAPSTARTADV

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

代码库修订：0.3.0

参数：无

输出：无

下载：文件

复制代码

# Command results when advertising data is not being sent

AT+GAPSTARTADV

OK

# 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

OK

# 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

OK

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）是F滞后值，并声明以下字段（请参见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

OK

此命令的结果可以在下面的截图中看到，该截图取自嗅探器，分析了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

OK

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

OK

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

AT+GATTADDSERVICE=UUID=0x180F

1

OK

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

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

1

OK # Clear any previous custom services/characteristics

AT+GATTCLEAR

OK

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

AT+GATTADDSERVICE=UUID=0x180F

1

OK

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

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

1

OK

下载：文件

复制代码

# Clear any previous custom services/characteristics

AT+GATTCLEAR

OK

# 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

1

OK

# 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

1

OK # Clear any previous custom services/characteristics

AT+GATTCLEAR

OK

# 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

1

OK

# 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

1

OK

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

OK

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

AT+GATTADDSERVICE=UUID=0x180F

1

OK

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

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

1

OK # Clear any previous custom services/characteristics

AT+GATTCLEAR

OK

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

AT+GATTADDSERVICE=UUID=0x180F

1

OK

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

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

1

OK

下载：文件

复制代码

# Clear any previous custom services/characteristics

AT+GATTCLEAR

OK

# 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

1

OK

# 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

1

OK # Clear any previous custom services/characteristics

AT+GATTCLEAR

OK

# 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

1

OK

# 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

1

OK

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

1

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

1

OK

版本 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

OK

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

AT+GATTADDSERVICE=UUID=0x180F

1

OK

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

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

1

OK

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

AT+GATTCHAR=1

0x64

OK

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

AT+GATTCHAR=1，32

OK

# Verify the previous write attempt

AT+GATTCHAR=1

0x20

OK # Clear any previous custom services/characteristics

AT+GATTCLEAR

OK

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

AT+GATTADDSERVICE=UUID=0x180F

1

OK

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

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

1

OK

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

AT+GATTCHAR=1

0x64

OK

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

AT+GATTCHAR=1，32

OK

# Verify the previous write attempt

AT+GATTCHAR=1

0x20

OK

AT + GATTLIST

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

代码库修订：0.3.0

参数：无

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

下载：文件

复制代码

# Clear any previous custom services/characteristics

AT+GATTCLEAR

OK

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

AT+GATTADDSERVICE=UUID=0x180F

1

OK

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

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

1

OK

# 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

2

OK

# 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

2

OK

# 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

OK

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

AT+GATTADDSERVICE=UUID=0x180F

1

OK

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

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

1

OK

# 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

2

OK

# 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

2

OK

# 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

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

OK

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

AT+DBGMEMRD=0x10000000，4，2

55AA55AA 55AA55AA

OK

# 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

OK

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

AT+DBGMEMRD=0x10000000，4，2

55AA55AA 55AA55AA

OK

# 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

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 + DBGSTACKSIZE

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

代码库修订：0.4.7

参数：无

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

下载：文件

复制编码e

AT+DBGSTACKSIZE

1032

OK AT+DBGSTACKSIZE

1032

OK

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

OK

历史记录

此页面根据固件版本号（您可以通过“ 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

首次公开发行

》命令示例

在命令模式下操作以执行特定任务时，可以使用以下代码段。

心率监视器服务

下面的命令列表将向BLEFriend的心率表添加心率服务属性表，具有两个特征：

心率测量

身体传感器位置

下载：文件

复制代码

# Perform a factory reset to make sure we get a clean start

AT+FACTORYRESET

OK

# Add the Heart Rate service entry

AT+GATTADDSERVICE=UUID=0x180D

1

OK

# Add the Heart Rate Measurement characteristic

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

1

OK

# Add the Body Sensor Location characteristic

AT+GATTADDCHAR=UUID=0x2A38， PROPERTIES=0x02， MIN_LEN=1， VALUE=3

2

OK

# Create a custom advertising packet that includes the Heart Rate service UUID

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

OK

# Reset the device to start advertising with the custom payload

ATZ

OK

# Update the value of the heart rate measurement （set it to 0x004A）

AT+GATTCHAR=1，00-4A

OK # Perform a factory reset to make sure we get a clean start

AT+FACTORYRESET

OK

# Add the Heart Rate service entry

AT+GATTADDSERVICE=UUID=0x180D

1

OK

# Add the Heart Rate Measurement characteristic

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

1

OK

# Add the Body Sensor Location characteristic

AT+GATTADDCHAR=UUID=0x2A38， PROPERTIES=0x02， MIN_LEN=1， VALUE=3

2

OK

# Create a custom advertising packet that includes the Heart Rate service UUID

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

OK

# Reset the device to start advertising with the custom payload

ATZ

OK

# Update the value of the heart rate measurement （set it to 0x004A）

AT+GATTCHAR=1，00-4A

OK

》

Python脚本

以下代码执行相同的功能，但已放置使用PySerial在Python包装器中显示如何为AT解析器编写动作脚本。

下载：文件

复制代码

import io

import sys

import serial

import random

from time import sleep

filename = “hrm.py”

ser = None

serio = None

verbose = True # Set this to True to see all of the incoming serial data

def usage（）：

“”“Displays information on the command-line parameters for this script”“”

print “Usage： ” + filename + “ ”

print “For example： ”

print “ Windows ： ” + filename + “ COM14”

print “ OS X ： ” + filename + “ /dev/tty.usbserial-DN009WNO”

print “ Linux ： ” + filename + “ /dev/ttyACM0”

return

def checkargs（）：

“”“Validates the command-line arguments for this script”“”

if len（sys.argv） 《 2：

print “ERROR： Missing serialPort”

usage（）

sys.exit（-1）

if len（sys.argv） 》 2：

print “ERROR： Too many arguments （expected 1）。”

usage（）

sys.exit（-2）

def errorhandler（err， exitonerror=True）：

“”“Display an error message and exit gracefully on ”ERROR “ responses”“”

print “ERROR： ” + err.message

if exitonerror：

ser.close（）

sys.exit（-3）

def atcommand（command， delayms=0）：

“”“Executes the supplied AT command and waits for a valid response”“”

serio.write（unicode（command + “ ”））

if delayms：

sleep（delayms/1000）

rx = None

while rx ！= “OK ” and rx ！= “ERROR ”：

rx = serio.readline（2000）

if verbose：

print unicode（rx.rstrip（“ ”））

# Check the return value

if rx == “ERROR ”：

raise ValueError（“AT Parser reported an error on ’” + command.rstrip（） + “‘”）

if __name__ == ’__main__‘：

# Make sure we received a single argument （comPort）

checkargs（）

# This will automatically open the serial port （no need for ser.open）

ser = serial.Serial（port=sys.argv［1］， baudrate=9600， rtscts=True）

serio = io.TextIOWrapper（io.BufferedRWPair（ser， ser， 1），

newline=’ ‘，

line_buffering=True）

# Add the HRM service and characteristic definitions

try：

atcommand（“AT+FACTORYRESET”， 1000） # Wait 1s for this to complete

atcommand（“AT+GATTCLEAR”）

atcommand（“AT+GATTADDSERVICE=UUID=0x180D”）

atcommand（“AT+GATTADDCHAR=UUID=0x2A37， PROPERTIES=0x10， MIN_LEN=2， MAX_LEN=3， VALUE=00-40”）

atcommand（“AT+GATTADDCHAR=UUID=0x2A38， PROPERTIES=0x02， MIN_LEN=1， VALUE=3”）

atcommand（“AT+GAPSETADVDATA=02-01-06-05-02-0d-18-0a-18”）

# Perform a system reset and wait 1s to come back online

atcommand（“ATZ”， 1000）

# Update the value every second

while True：

atcommand（“AT+GATTCHAR=1，00-%02X” % random.randint（50， 100）， 1000）

except ValueError as err：

# One of the commands above returned “ERROR ”

errorhandler（err）

except KeyboardInterrupt：

# Close gracefully on CTRL+C

ser.close（）

sys.exit（）

import io

import sys

import serial

import random

from time import sleep

filename = “hrm.py”

ser = None

serio = None

verbose = True # Set this to True to see all of the incoming serial data

def usage（）：

“”“Displays information on the command-line parameters for this script”“”

print “Usage： ” + filename + “ ”

print “For example： ”

print “ Windows ： ” + filename + “ COM14”

print “ OS X ： ” + filename + “ /dev/tty.usbserial-DN009WNO”

print “ Linux ： ” + filename + “ /dev/ttyACM0”

return

def checkargs（）：

“”“Validates the command-line arguments for this script”“”

if len（sys.argv） 《 2：

print “ERROR： Missing serialPort”

usage（）

sys.exit（-1）

if len（sys.argv） 》 2：

print “ERROR： Too many arguments （expected 1）。”

usage（）

sys.exit（-2）

def errorhandler（err， exitonerror=True）：

“”“Display an error message and exit gracefully on ”ERROR “ responses”“”

print “ERROR： ” + err.message

if exitonerror：

ser.close（）

sys.exit（-3）

def atcommand（command， delayms=0）：

“”“Executes the supplied AT command and waits for a valid response”“”

serio.write（unicode（command + “ ”））

if delayms：

sleep（delayms/1000）

rx = None

while rx ！= “OK ” and rx ！= “ERROR ”：

rx = serio.readline（2000）

if verbose：

print unicode（rx.rstrip（“ ”））

# Check the return value

if rx == “ERROR ”：

raise ValueError（“AT Parser reported an error on ’” + command.rstrip（） + “‘”）

if __name__ == ’__main__‘：

# Make sure we received a single argument （comPort）

checkargs（）

# This will automatically open the serial port （no need for ser.open）

ser = serial.Serial（port=sys.argv［1］， baudrate=9600， rtscts=True）

serio = io.TextIOWrapper（io.BufferedRWPair（ser， ser， 1），

newline=’ ‘，

line_buffering=True）

# Add the HRM service and characteristic definitions

try：

atcommand（“AT+FACTORYRESET”， 1000） # Wait 1s for this to complete

atcommand（“AT+GATTCLEAR”）

atcommand（“AT+GATTADDSERVICE=UUID=0x180D”）

atcommand（“AT+GATTADDCHAR=UUID=0x2A37， PROPERTIES=0x10， MIN_LEN=2， MAX_LEN=3， VALUE=00-40”）

atcommand（“AT+GATTADDCHAR=UUID=0x2A38， PROPERTIES=0x02， MIN_LEN=1， VALUE=3”）

atcommand（“AT+GAPSETADVDATA=02-01-06-05-02-0d-18-0a-18”）

# Perform a system reset and wait 1s to come back online

atcommand（“ATZ”， 1000）

# Update the value every second

while True：

atcommand（“AT+GATTCHAR=1，00-%02X” % random.randint（50， 100）， 1000）

except ValueError as err：

# One of the commands above returned “ERROR ”

errorhandler（err）

except KeyboardInterrupt：

# Close gracefully on CTRL+C

ser.close（）

sys.exit（）

此脚本的结果可以在下面的“ HRM”应用程序中看到北欧的nR F工具箱应用程序：

请注意，nRF工具箱仅在以下情况下显示HRM数据：值更改，因此在打开HRM应用程序并连接到BLEFriend之后，您至少需要更新一次心率测量特征

SDEP（SPI数据传输）

为了便于在基于UART和SPI的Bluefruit LE模块之间进行切换，Bluefruit LE SPI Friend和Shield在以下位置使用了相同的AT命令集： UART模块（ATI，AT+HELP等）。

这些基于文本的AT命令使用我们称为 SDEP （简单数据交换协议）的简单二进制协议对二进制消息进行编码。

在大多数情况下，您永远不需要直接处理SDEP，但是我们已经在此处记录了该协议，以防您需要深入了解Bluefruit LE SPI界面！

SDEPOverview

SDEP被设计为总线中立协议，以标准，易于扩展的方式处理二进制命令和响应（包括错误响应）。 “总线中性”意味着无论传输机制（USB HID，SPI，I2C，空中无线数据等）如何，我们都可以使用SDEP。

所有SDEP消息都有一个四个字节标头，对于Bluefruit LE模块，最多16个字节有效负载。大型消息被分解为几个4 + 16字节的消息块，这些消息块在传输总线的任一端重建。选择20字节限制（4字节报头+ 16字节有效负载）以考虑到蓝牙低功耗4.0中的最大数据包大小（每个数据包20字节）。

SPI设置

对于Bluefruit LE SPI Friend，SDEP是总线中立的或Shield，使用SPI传输时要遵循以下约束和假设，主要是要考虑nRF51822片上系统的硬件限制：

SPI硬件要求

SPI时钟应运行在《= 4MHz

之间应增加100us的延迟CS线有效的那一刻，以及在SPI总线上传输任何数据之前

对于整个数据包，CS线必须保持有效，而不是在每个字节之间切换CS

但是，可以将CS线置为无效，然后在各个SDEP数据包（每个最多20个字节）之间重新置位。

SPI通讯必须将ands设置为先发送MSB（最高有效位）（而不是先发送LSB）

IRQ引脚

只要在nRF51822的缓冲区中有完整的SDEP数据包，Bluefruit LE SPI Friend/Shield就会断言IRQ线。读取数据包，并在整个事务中保持CS线有效（如上所述）。

只要有一个或多个数据包可用，IRQ线就会保持有效，因此读取后该线可能会保持高电平一个数据包，这意味着SPI从设备侧的FIFO中仍然有更多数据包。

SDEP数据包和SPI错误标识符

一旦声明了CS并经过了强制的100us延迟，应从SPI总线读取一个字节，这将指示SPI上可用负载的类型。 nRF51822（有关SDEP消息的更多信息，请参见下面的消息类型指示器） ge类型）。如果需要继续读取帧的其余部分，则在读取此字节后保持CS置为有效。

如果遇到标准SDEP消息类型指示符（0x10、0x20、0x40或0x80），请继续读取像平常一样。但是，还应考虑其他两个指标，它们指示nRF51822 SPI从设备侧存在问题：

0xFE ：从设备未准备就绪（等待有点，然后再试一次）

0xFF ：从设备读取溢出指示符（您读取的数据多于可用数据）

此表示有六个可能的响应字节读取消息类型指示符（发送SDEP命令后读取的第一个字节）：0x10、0x20、0x40、0x80指示有效的消息类型，或0xFE，0xFF指示错误情况。

示例交易

下图显示了一个示例SDEP响应分布在两个数据包中（因为响应的大小》 20个字节）。请注意，由于在Bluefruit LE SPI端的FIFO中有多个数据包可用，因此在数据包之间IRQ线保持断言：

SDEP（简单数据交换协议）

简单数据交换协议（SDEP）可用于使用任何二进制串行总线（USB HID， USB Bulk，SPI，I2C，无线等），使用四种不同的消息类型（命令，响应，警报和错误消息）之一交换数据。

该协议旨在灵活，可扩展，唯一的要求是单个消息小于等于20个字节，并且每个消息的第一个字节是一个单字节（U8）标识符，用于指示消息类型，该标识符定义了其余消息的格式

字节序

所有大于8位的值均以小字节序格式编码。

div》消息类型指示器

每条消息的第一个字节是8位标识符，称为消息类型指示器。此值指示要发送的消息的类型，并允许我们确定消息其余部分的格式。

消息类型

命令

响应

警告

错误ID（U8）

0x10

0x20

0x40

0x80

SDEP数据事务

尽管某些传输协议对谁可以发起传输施加了限制，但两个连接的设备都可以发起SDEP事务。例如，主设备始终使用低功耗蓝牙或USB发起事务，这意味着从设备只能回复传入的命令。

每个接收到 Command Message 的设备都必须回复响应消息，错误消息或警告消息。

消息类型 命令消息

命令消息（消息类型= 0x10 ）具有以下结构：

名称

消息类型

命令ID

有效载荷长度

有效载荷类型

U8

U16

U8

。..含义

始终为“ 0x10”

唯一命令标识符

［7］更多数据

［6-5］保留

［4-0］有效载荷长度（0..16）

可选命令有效载荷（参数等）

命令ID （字节1-2）和有效载荷长度（字节3）在任何命令中都是必需的信息。消息有效负载是可选的，如果有效负载长度设置为0个字节，则将被忽略。存在消息有效负载时，其长度可以为1..16字节，以保持最大消息长度20字节以内。

长命令（有效负载》 16字节）必须分为多个数据包。为方便起见，更多数据字段（字节3的第7位）用于指示其他数据包是否可用于同一命令。 SDEP接收器必须继续读取数据包，直到找到具有 More data == 0 的数据包，然后在必要时将所有子数据包组合为一个命令。

有效负载是用户定义的，并且可以从一个命令更改为另一个命令。

示例命令消息为：

下载：文件

复制代码

10 34 12 01 FF 10 34 12 01 FF

0：消息类型（U8）

1 + 2：命令ID（U16）

3：有效载荷镜头（U8）

4：有效载荷（。..）0x10

0x34 0x12

0x01

0xFF

第一个字节是消息类型（0x10），它将其标识为命令消息。

第二个和第三个字节为0x1234（little-endian表示法为34 12），这是唯一的命令ID。如果找到匹配的条目，该值将与命令查找表进行比较，并重定向到适当的命令处理程序函数。

第四个字节表示我们的消息有效载荷为1个字节

第五个字节是1个字节的有效负载：0xFF

响应消息

响应消息（消息类型= 0x20）在以下位置生成对传入命令的响应，并具有以下结构：

Name

消息类型

命令ID

有效载荷长度

有效载荷类型

U8

U16

U8

含义

始终“ 0x20’

命令ID，此消息是对

的响应。［7］更多数据

［6-5］保留

［4-0］有效载荷长度（0 。.16）

可选响应有效载荷（参数等）

通过包括与该响应消息相关的命令ID ，收件人可以更轻松地将响应和命令相关联。这在发送多个命令的情况下很有用，并且某些命令的执行时间可能比具有不同命令ID的后续命令要花更长的时间。

响应消息只能在响应命令时生成消息，因此命令ID字段应始终存在。

长响应（有效载荷》 16字节）必须分为多个数据包。与长命令类似，更多数据字段（字节3的第7位）用于指示其他数据包是否可用于同一响应。在跨越一个以上数据包的响应中，最终数据包上的 More data 位将设置为0，以指示这是序列中的最后一个数据包。 SDEP接收器必须在必要时将所有子数据包重新组合为一个有效载荷。

如果需要更精确的命令/响应相关性，则应开发自定义协议，该协议中应包含唯一的消息标识符。每个命令/响应的有效负载，但这不在此高级协议定义的范围内。

示例响应消息为：

下载：文件

复制代码

20 34 12 01 FF 20 34 12 01 FF

0：消息类型（U8）

1 + 2：命令ID（U16）

3：有效载荷镜头（U8）

4：有效载荷0x20

0x34 0x12

0x01

0xFF

第一个字节是消息类型（0x20），它将其标识为响应消息。

第二个和第三个字节为0x1234，这是唯一的命令ID此响应与之相关。

第四个字节表示我们的消息有效负载为1个字节。

第五个字节为1个字节的负载：0xFF

警报消息

每当系统出现警报情况（电池电量低等）时，都会发送警报消息（消息类型= 0x40）以下结构：

《表类=“ editor-table”》

名称

消息类型

警告ID

有效载荷长度

有效载荷

类型

U8

U16

U8

。..

含义

始终为“ 0x40”

警报条件的唯一ID

有效负载长度（0..16）

可选响应有效载荷

示例警报消息为：

下载：文件

复制代码

40 CD AB 04 42 07 00 10 40 CD AB 04 42 07 00 10

0：消息类型（U8）

1 + 2：警报ID（U16）

3：有效负载长度

4 + 5 + 6 + 7：有效载荷 0x40

0xCD 0xAB

0x04

0x42 0x07 0x00 0x10

第一个字节是消息类型（0x40），它将其标识为警报消息。

第二个和第三个字节是0xABCD，这是唯一的警报ID。

第四个字节表示我们有4个字节的消息有效负载。

最后四个字节是实际有效负载：在这种情况下，假设我们正在传输32-字节，则为0x10000742

标准警报ID

范围为0x0000到0x00FF的警报ID保留给标准SDEP警报，并且可能不会被自定义警报使用。

以下警报已定义为协议的标准部分：

ID

0x0000

0x0001

0x0002

0x0003警告

保留

系统重置

电池电量低

电池严重说明

保留供将来使用

系统即将重置

电池电量不足

电池电量严重不足

错误消息

每当系统出现错误情况时，都会返回错误消息（消息类型= 0x80），并具有以下结构：

名称

消息类型

错误ID

保留类型

U8

U16

U8含义

始终为“ 0x80”

错误条件的唯一ID

保留以供将来使用

每当出现错误情况并且系统需要正常运行错误（例如请求失败，尝试访问不存在的资源等）后，系统可能会返回带有适当错误ID的特定错误消息。

示例错误消息为：

下载：文件

复制代码

80 01 00 00 80 01 00 00

《表类=“ editor-table”》

0：消息ID（U8）

1 + 2：错误ID（U16）

3：保留（U8）

0x80

0x01 0x00

0x00

标准错误ID

0x0000到0x00FF范围内的错误ID保留用于标准SDEP错误，并且不能由自定义错误使用。

以下错误已被定义为协议的标准部分：

ID

0x0000

0x0001

0x0003错误

保留

无效CMD ID

无效负载说明

保留供将来使用

在查找表中未找到CMDID

消息有效负载无效

现有命令

目前，在该命令中仅实现了四个SDEP命令Bluefruit SPIFRIEND32固件：

SDEP_CMDTYPE_INITIALIZE = 0xBEEF

SDEP_CMDTYPE_AT_WRAPPER = 0x0A00

SDEP_CMDTYPE_BLE_UARTTX = 0x0A01

li》 SDEP_CMDTYPE_BLE_UARTRX = 0x0A02

SDH_CMDTYPE_INITIALIZE 可用于在硬件RST线路不可用时重置SDEP系统。

两条 SDEP_CMDTYPE_UART * 命令通过BLE UART服务发送数据。

SDEP_CMDTYPE_AT_WRAPPER 是您大部分时间使用的命令，它是一个包装器通过二进制SDEP传输发送AT命令。这并不是非常有效，二进制机制每个命令占用的字节数更少，但是它允许重用所有早期的AT解析器命令，而不必为每个命令实现一个包装器，这将大大增加整体代码的大小。

SDEP AT包装使用

使用SDEP您只需在AT Wrapp中发送正确的标头以及要发送到解析器的AT命令即可。例如：

下载：文件

复制代码

10-00-0A-03-‘a’-‘t’-‘I’ 10-00-0A-03-‘a’-‘t’-‘I’

消息类型：0x10（命令）

命令ID：0x0A00

命令有效载荷长度：3个字节

命令有效载荷：‘a’+‘t’+‘i’

这将导致ATI命令被执行，这将返回基本系统信息。

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服务包括以下特征：

名称

TX

RX必填

是

是UUID

0x0002

0x0003类型

U8 ［20］

U8 ［20］ R

XW

XN

XI

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

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”

。..

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连接的可靠性，因为这两个引脚在另一端告诉设备何时需要等待t要处理现有的缓冲数据。

要启用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和串行引导程序加载。

DFU Bluefruit更新

有关使用Bluefruit LE Connect的最新更新过程的视频，请参见：

iOS：https：//learn。 adafruit.com/introducing-adafruit-ble-bluetooth-low-energy-friend/dfu-on-ios

Android：https://learn.adafruit.com/introducing-adafruit-ble-bluetooth-低能耗朋友/dfu-on-android-4-dot-3-plus

下面的视频已过期，并且适用于Bluefruit LE Connect应用在相应应用商店中的iOS，Android和OS X之前的早期版本。为了使您的设备保持最新状态，只需安装并打开Bluefruit LE Connect应用程序并连接到Bluefruit设备。如果有可用的固件更新，它将自动提出，并且整个更新过程将为您透明地处理。

您可以使用Android或iOS手机/平板电脑对Bluefruit LE模块本身进行无线编程。这不会重新编程Bluefruit Micro中的ATmega32u4，而仅是BLE模块本身。由于这不是一件普通的事情，所以要做起来有些挑战。

您需要断开/断开Bluefruit Micro的电源，暂时在 DFU 引脚和 GND ，然后通过USB或电池为开发板供电。

红色LED指示灯将连续闪烁，以使其处于DFU模式。然后按照我们的指南现场更新固件

下载

GitHub上的PCB文件

MDBT数据表

Adafruit Fritzing库中的Fritzing对象

羽毛32u4 Bluefruit LE引脚排列图

示意图

点击以嵌入

我们已将调节器从SPX3819更改为AP2112-压降较低，但不能处理高于6V的电压

织物印刷

尺寸以英寸为单位

设备恢复

有时，不幸的事情会发生。值得庆幸的是，有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版本

在第一篇文章中提供上述信息将被跳过来回两个回合，您会更快地得到我们的答复，节省了大家的时间和精力！

请务必同时阅读本学习指南的“常见问题解答”部分，该部分回答了许多常见问题！

羽毛帮助！

即使此常见问题解答已标记为羽毛，但仍存在问题

拔出USB时，ItsyBitsy/Feather停止工作！

我们的许多示例草图在setup（）中都有

while （！Serial）;

行，使板子等到USB打开。这使调试程序变得容易得多，因为您可以看到所有USB数据输出。如果您想在没有USB连接的情况下运行Feather，请删除该行或将其注释掉

我的羽毛从未在Arduino IDE中显示为COM或串行端口

A 其数量众多/羽毛“故障”是由于仅充电的USB电缆

我们每天收到5起以上的投诉，这些投诉最终归因于仅充电的电缆！

仅使用您知道用于数据同步的电缆

如果您有任何仅用于充电的电缆，请将其切成两半，将其丢弃。我们是认真的！它们通常质量低劣，只会在以后给您和其他人造成困扰，只是获得了一条优质的数据+充电USB电缆

确认！我“做了些什么”，现在插入Itsy/Feather时，它不再显示为设备，因此我无法上载或修复它。..

没问题！您可以轻松地“修复”错误的代码上传。请注意，如果您设置了看门狗定时器或睡眠模式以停止USB，或任何“破坏”了电路板的草图，则可能会发生这种情况

在计算机中打开详细上传 Arduino IDE偏好设置

插入Itsy或Feather 32u4/M0，它不会显示为可以正常使用的COM/串行端口

打开Blink示例（示例-》基础-》闪烁）

在“工具”菜单中选择正确的板，例如羽毛32u4，羽毛M0，Itsy 32u4或M0 （物理检查以确保您选择了正确的主板！）

编译它（确保可以正常工作）

单击“上载”以尝试上载代码

IDE在尝试上载时将打印出一些COM端口。 在这段时间内，双击重置按钮，您将看到红色的脉冲LED指示您现在处于引导加载模式

该板将显示为Bootloader的COM/串行端口

IDE应该看到Bootloader的COM/串行端口并正确上传

我无法显示Itsy/Feather USB设备-我收到“ USB设备故障”错误！

这似乎发生在人们从Arduino开发板菜单中选择错误的开发板。

如果您有Feather 32u4（在板上看一下以了解其内容），请确保选择 Feather 32u4 基于ATMega32u4的主板！请勿使用其他任何东西，请勿使用32u4分支电路板线。

如果您有羽毛M0（在板上查看以了解其含义），请确保选择羽毛M0 -不要使用32u4或Arduino Zero

如果您有ItsyBitsy M0（在板上看一下它的内容），请确保选择 ItsyBitsy M0 》-不要使用32u4或Arduino零

我遇到了COM端口和我的Ity/Feather 32u4/M0的问题

32u4/M0可以具有两个 COM端口，一个是用户端口，其中之一是引导程序端口。它们不是相同的COM端口号！

上载新用户程序时，它将附带一个用户com端口，特别是如果您在用户程序中使用串行端口。

如果您崩溃了用户程序，或者程序中止或失败，则用户COM端口可以消失。

当用户COM端口消失时，Arduino将无法自动启动Bootloader并上传新软件。

因此，您需要通过执行上载单击过程来重新启动Bootloader并上传一些可以已知像“眨眼”一样工作

我不明白为什么COM端口消失了，这在我的Arduino UNO上不会发生！

UNO类型的Arduinos有一个分开的串行端口芯片（又名“ FTDI芯片”或“ Prolific PL2303”等）w hich与主芯片分开处理所有串行端口功能。这样，如果主芯片出现故障，您可以始终使用COM端口。

基于M0和32u4的Arduinos没有单独的芯片，而是由主处理器为您执行此任务。它可以实现更低的成本，更高的功率设置。..但是需要付出更多的努力，因为您将不时需要手动“踢”入引导程序

我正在尝试上传到我的32u4，并收到“ avrdude：butterfly_recv（）：程序员没有响应”错误

这可能是因为引导加载程序未启动，并且您意外地试图上传到 错误的COM端口

最好的解决方案是上面的详细介绍：通过手动启动引导加载程序手动手动上传Blink或类似的工作草图

我是尝试上传到我的Feather M0上时，出现此错误“连接到程序员：.avrdude：butterfly_recv（）：程序员不是响应”

您可能没有在下拉面板中选择Feather M0 -下。确保选择了Feather M0。

我正在尝试将其上传到我的羽毛中，但出现此错误“ avrdude：ser_recv（）：程序员未响应“

您可能没有在菜单中选择Feather M0/Feather 32u4板下拉菜单。确保选择了Feather M0（或Feather 32u4）。

我在羽毛上安装了一些护翼，现在无法读取电池电压！

请确保您的机翼不使用引脚9，这与脂电池！

我的羽毛上的黄色LED闪烁，但是没有插入电池，为什么？

充电LED由Lipoly充电器电路自动驱动。它将尝试检测电池，并期望将其安装。如果没有电池，则在使用电源时可能会偶尔闪烁一次，因为它正在尝试为（不存在的）电池充电。

这无害，而且完全正常！
        责任编辑：wv