DFRobot_Bluetooth_4.1__BLE__User_Guide - jimaobian/DFRobotWikiCn GitHub Wiki

AT指令

AT即Attention,AT指令是用来配置蓝牙参数的通信指令。AT指令以AT开头,**<CR+LF>**回车和换行符结尾。

  • 注意:**<CR+LF>**为回车换行符,请勿把它当做AT指令的一部分

AT指令表

AT指令 功能 参数 描述
AT+ROLE= 设置蓝牙模式 “?”查询当前模式
“ROLE_CENTRAL”设置为中心
“ROLE_PERIPHERAL”设置为节点 返回当前模式
返回OK
返回OK
AT+NETWORK= 设置网络模式 “?”查询当前网络
“P2P”设置为单点连接
“STAR”设置为星型网络 返回当前网络模式
返回OK
返回OK
AT+MIN_INTERVAL= 设置最小通信间隔 “?”查询当前最小通信间隔
设置范围为10~99999ms 返回当前最小通信间隔
返回OK
AT+MAX_INTERVAL= 设置最大通信间隔 “?”查询当前最大通信间隔
设置范围为10~99999ms 返回当前最大通信间隔
返回OK
AT+BIND= 设置BLE芯片绑定蓝牙地址 “?”查询当前绑定的蓝牙MAC地址
0x0017ea9397e1 设置需绑定的蓝牙MAC地址 返回0x000000000000(默认值)
返回OK
AT+CMODE= 设置BLE芯片连接模式 “?”查询当前BLE芯片的连接模式
“UNIQUE”设置为指定连接
“ANYONE”设置为任意连接 返回当前连接模式
返回OK
返回OK
AT+MAC= 查询BLE芯片的蓝牙地址 “?”查询当前BLE芯片的蓝牙地址 返回当前BLE芯片的蓝牙地址
AT+NAME= 设置模块名称 “?”查询当前模块的名称
“DFBLEduino2” 返回设备名称
返回OK
AT+SETTING= 改变或恢复默认设置 “?”查询当前设备的设置状态
“DEFAULT”恢复初始设定
“DEFPERIPHERAL”恢复成从机模式的初始设定
“DEFCENTRAL”恢复成主机模式的初始设定 返回当前设备的设置状态
返回OK
返回OK
返回OK
AT+USB_MONITOR= 设置是否打开USB监控 “?”查询当前USB监控的状态
“ON”打开USB监控
“OFF”关闭USB监控 返回当前USB监控的状态
返回OK
返回OK
AT+HELP= 获取AT帮助 “ALL”查询所有AT指令的帮助 返回AT指令的说明信息
AT+NET_INF= 查看当前网络内的设备信息 “?”查询当前网络内的设备信息 返回当前网络内的设备信息
AT+VERSION= 查询固件版本 “?”查询当前设备的固件版本 返回当前设备的固件版本
AT+RSSI= 查看当前的RSSI值 “?”查询当前的RSSI值 返回当前的RSSI值(未连接状态下返回-000)
AT+P= 查询和设置管脚P(n, n=0,1,2,3...)高低电平 “?”先将IO口设置为输入模式,再检测IO口的高低电平
“1”将管脚设置为输出模式,且输出高电平
“0”将管脚设置为输出模式,且输出低电平 Eg:AT+P47=? (返回0或1)
Eg:AT+P47=1(返回OK)
Eg:AT+P47=0 (返回OK)
AT+WL= 查询或清除白名单 “?”查询白名单
“NONE”清除白名单 返回白名单设备的MAC地址列表
返回OK
AT+LOWPOWER= 查询和设置当前低功耗模式 “?”查询当前低功耗模式
“ON”开启低功耗功能
“OFF”关闭低功耗功能 返回当前状态
返回OK
返回OK
AT+EXIT 退出AT指令模式 退出AT指令模式 返回OK

AT指令一览表

通过AT指令配置BLE设备

1.打开Arduino IDE

2.在菜单->工具-> 串口中选择正确的设备

3.开启串口监视器(点击窗口的右上角的按键)

4.在两个下拉菜单中选择"No line ending"(①)和115200 baud(②)

5.在输入框中(③)输入"+++",并点击发送键(④)

6.如果收到“Enter AT Mode”(⑤),就证明已经进入AT指令模式.

Fig1: +++进去CMD模式

7.在两个下拉菜单中选择"Both NL & CR"(①)和115200 baud(②)

8.在输入框中(③)输入AT指令,并点击发送键(④)

9.如果BLE配置成功,界面将会返回"OK"(⑤)

Fig1: 输入AT指令,记得更改为Both NL & CR

10.如果收到“ERROR CMD”,可以再发一遍。发送多次后如果还是“ERROR CMD”,你需要检查一下指令发送是否正确.(大写字母)

11.可以使用"AT+EXIT"来退出AT指令模式.

12.可以输入AT+HELP=ALL指令,查询所有的AT指令。 Fig1: 进入AT指令,查询所有的AT指令

蓝牙配对

在使用BLE4.1系列产品时,需要对外围硬件有一定了解,几个关键的按键如下:

  • BOOT:蓝牙固件更新/接近连接使能开关;
    • 更新固件:按下BOOT,然后上电(插上USB),进入固件更新模式,参见固件更新版块。
    • 接近连接:在蓝牙正常工作下(上电状态下),按住主机BOOT,靠近从机蓝牙设备,连接蓝牙。
  • WAKEUP:唤醒按键,当使能了BLE4.1设备低功耗后,可以通过这个按键唤醒设备,也可以将该引脚连接到MCU的Pin脚进行唤醒
  • RST:BLE4.1模块复位按键

使用BLE4.1模块时,可参考BLE4.1最小系统参考电路图: Fig1: BLE4.1模块最小系统原理图

手机蓝牙配对方法

BLE4.1模块和手机端进行连接时,因为是BLE设备,和传统蓝牙设备(如蓝牙耳机)有区别,需要指定特征值以及设备服务ID,通过手机的设备管理器进行BLE的连接,会出现通信问题,因此,需要第三方软件。如DFRobot的《BlunoBasicDemo》,TI的《BLE Device Monitor》等等。这里将以DFRobot的《BlunoBasicDemo》为例。

  • 通过AT+ROLE=ROLE_PERIPHERAL指令将BLE4.1模块设置成从机模式。 AT+NETWORK=P2P 设置为点对点模式,设置完成后,重启BLE4.1模块(可以直接断电重启)。
  • 打开手机端BlunoBasicDemo软件,点击SCAN,可以看到扫描到BLE4.1设备:

Fig1: 手机扫描BLE4.1设备

  • 点击该设备进行连接。连接成功后,显示Connected,同时BLE4.1设备LINK灯常亮3秒,之后每3秒闪烁一次。

Fig1: 手机连接BLE4.1设备

  • Data sending Area窗口输入要发送的数据:

Fig1: 手机发送数据到BLE4.1设备

  • 点击Send Data,进行发送。打开Arduino串口助手,可以接收手机端发送的数据。

Fig1: 串口打印接收到的数据

PC蓝牙配对方法

暂不支持通过自带蓝牙直接连接(与手机类似,PC端同样需要一个软件才能支持自带蓝牙的连接,很遗憾,暂时没资源做相关开发,只能暂时搁置)

点对点通信方法

BLE 4.1点对点连接的过程与BLE 4.0类似,只是多了一条设置点对点连接的命令。总共需要两个设备,一个设置成主机(ROLE_CENTRAL);另一个设置成从机(ROLE_PERIPHERAL)。通过AT+ROLE=ROLE_CENTRALAT+ROLE=ROLE_PERIPHERAL设置,主机设置方法如图: Fig1: 将设备设置成中心模式 然后通过AT+NETWORK=P2P命令将两个BLE 4.1设备设置成点对点连接方式(默认就是点对点连接模式)。 Fig1: 将设备设置成点对点连接模式 设置完成后,重启BLE4.1设备(可以直接断电重启),开始接近连接,当两边的LINK灯亮了,所明已经连接上了。

  • 接近连接:按住主机设备的BOOT按钮,靠近要连接的从机设备,直至连接成功,LINK灯亮起。

备注:

  1. 任意两台设备第一次连接时,按住中心设备的BOOT按钮是为了将需要连接的设备录入白名单中。之后再次连接该设备就不需要再按BOOT按钮了
  2. BLE 4.1设备也可以与之前BLE 4.0设备(Bluno 1代)相连接,BLE 4.0只支持点对点连接,所以不用设置P2P命令,但BLE 4.1设备依旧需要设置P2P命令。

蓝牙星形网络链接

星型连接模式与点对点连接模式,在设置上唯一的区别在于,通过AT+NETWORK=STAR。设置完成后,重启设备,用主机(中心设备)连接从机设备(注意连接时需要按住主机的BOOT),当LINK灯亮时,说明已将节点设备录入中心设备的白名单。之后就会自动连接白名单中的设备。

Fig1: 将设备设置成点对点连接模式

warning_yellow.png
注:星型连接模式只针对BLE4.1设备,不包括Bluno一代(BLE4.0)以及其他品牌的BLE设备。

星型连接模式下,蓝牙设备之间的通信采用了特殊的数据包压缩方式,可以通过Arduino库文件,使用Arduino主控进行数据间的交互,点击下arduino库文件,该库文件还需要Arduinojson库文件。设备连接时,先连入中心设备的从机设备ID为1,后面链接进入网络的ID以此叠加。示例代码中,给出了如何获取该设备在网络中的ID,以及收到数据后,数据的来源设备ID。建议在创建星型网络模型时,依次给设备上电。

#include <DFRobot_Bluno2.h>
#include <ArduinoJson.h>

DFRobot_Bluno2 blunoNet;
int blunoID=0;
void setup()
{
  Serial.begin(9600);
  blunoNet.begin(Serial);//获取id
}

void loop()
{
  uint8_t event=blunoNet.getEvent();//queue
  switch(event)
  {
    case EVENT_NETINFO:
    {
      eventNode e = blunoNet.popEvent();

      StaticJsonBuffer<200> jsonBuffer;
      JsonObject& root = jsonBuffer.parseObject((const char *)e.payload);
      if (!root.success()) {
        return;
      }
      int s =  root["r"].size();
      for(int i = 0; i < s; i++){
        if(root["r"][i]["s"].as<int>()){
          blunoID = root["r"][i]["i"].as<int>();
          break;
        }
      break;
      }
    }
    case EVENT_DATA:
    {
      eventNode e = blunoNet.popEvent();
      blunoNet.sendPacket(e.src, blunoID, "hello12345678901234567890",26);
      break;
    }
    default: //no event
    {
      break;
    }
  }
  blunoNet.loop();
  if(Serial.available()){
    char message=Serial.read();
    blunoNet.sendPacket(!blunoID, blunoID, &message,1);
  }
}

蓝牙低功耗

BLE4.1进入低功耗后,功耗<10uA,同时可以进行BLE端的数据交互、设备的广播。通过AT+LOWPOWER=ON指令,使能BLE4.1设备低功耗功能。重启BLE4.1设备,10秒后进入低功耗。需要注意的是,进入低功耗后,如果MCU需要通过UART给BLE4.1设备发送数据,需要先通过WAKEUP唤醒蓝牙设备,否则UART端接收到的数据会出现乱码。 在低功耗模式没有任何操作的情况下,蓝牙会在10s后进入低功耗,这时可以通过中断方法唤醒蓝牙,或者通过蓝牙唤醒ATmega328P:

  • BLE4.1通过P4_2 (D2) 引脚唤醒Arduino控制器(Atmage328P):高电平唤醒
  • Arduino控制器 (ATmega328P) 通过WAKEUP(D3)使能引脚唤醒BLE4.1:低电平唤醒

无线下载

Bluno2的无线下载功能,完全兼容Bluno 1代 (BLE 4.0)。在使用上,只能点对点连接模式下进行,主机(中心设备)对从机设备的Arduino主控进行无线下载。

  • 与P2P连接类似,一个设置成主机,插到电脑端;另一个设置成从机,配对链接后,就可以通过主机给从机下载代码了。

固件升级

DFRobot新出的BLE4.1设备保留原Bluno的固件升级方式,点击链接下载BLE4.1固件升级工具,BLE4.1固件更新地址点击下载Fig1: Bluno2固件升级工具 升级步骤如下:

  • 按住BOOT
  • 将BLE4.1设备连接到电脑,插入USB,直到CHG和LINK灯交替闪烁后松开BOOT按键
  • 打开Bluno2 Firmware软件,选择对应的串口号
  • 选择需要更新的固件,固件格式是**.img**
  • 点击下载,有时会卡在99%,观察CHG,只要CHG开始单闪,证明已经下载完成,可以拔掉USB。

常见问题

| 问: 程序无法下载怎么办?!!! |

  • 答: 程序无法下载的原因有很多:
  1. 基础检查:供电、板型、COM口等是否正确
  2. 由于使用蓝牙串口通信,可能是蓝牙已占用串口,请断开当前所有的蓝牙连接,重新插拔上电,请重新下载
  3. 可能由于设备串口已被占用,请拔掉所有控制器的外设,重新编译下载
  4. 可是由于Arduino IDE本身发生了崩溃,请断开所有蓝牙(包括手机),关掉所有Arduino IDE软件,拔掉USB线。然后重新打开后再测试。(重启大法能解决60%的设备问题)
  5. 可能由于FireBeetle上328P内的Bootloader丢失,请尝试重烧ATmega32p的Bootloader
  6. 可能由于蓝牙BLE 4.1固件问题,请尝试重烧固件,参考上一�

| 问: 插上电脑后,设备管理器中显示为Arduino UNO COM x,我该如何选择板型 |

  • 答: 默认COM名称为Arduino UNO,请根据板子不同的bootloader选择对应的板型,例如:FireBeetle BLE4.1,选择Arduino Pro Mini 3.3V@ 8MHz

| 问: 蓝牙ID号总是随着连接先后变动,无法确定,怎么办 |

  • 答: 目前蓝牙的ID号是根据连接顺序的先后来确定的,依次为ID1、ID2、ID3、ID4,还不支持改动,请按照所需顺序连接,主机(中心设备ID0)

| 问: 有时候,接收到的蓝牙数据会有乱码等现象?为什么?115200的波特率 |

  • 答: FireBeetle BLE4.1 使用3.3V Pro Mini的bootloader,8MHz晶振,高波特率模式下,可能会有问题,这是3.3V Pro Mini本身Bootlaoder的问题,建议更换低波特率,例如9600bps。注意,请用AT指令去同时配置蓝牙的波特率。

| 问: 支持HID、ibeacon、树形网络功能吗? |

  • **答:**HID、ibeacon以及树形网络功能正在开发中,敬起期待。

| 问: 如何给FireBeetle主板供电? |

  • 答: 点击链接,查看FireBeetle萤火虫系列主板供电问题

| 更多问题及有趣的应用,可以 访问论坛 进行查阅或发帖。 |

⚠️ **GitHub.com Fallback** ⚠️