Skip to content

手把手教你:BLE从机如何发送指示给到手机APP ​

一、前言

本篇开始讲解ble从机如何发指示给到手机(APP),什么叫做指示,指示是从机发送消息类型的一种,这个是需要手机APP进行回复的消息,也就是带确认的消息。

二、阅读说明

1、泰凌微芯片学习者,前期使用过该芯片。

2、能够知道怎么进行创建工程,下载代码。

3、有一块开发板,板上的芯片可以是8251,8253或者8258。

4、需使用蓝牙抓包工具52840 Sniffer和协议分析软件Wireshark

三、正文

1、使用的SDK

手把手教你:BLE如何发送消息给手机APP

使用的SDK为该篇文章描述的

2、给电池服务增加指示特性

在app_att.c的文件中找到电池服务,之后找到my_batCharVal这个数组,如下图所示,增加一个指示的特征

javascript
//// Battery attribute values
static const u8 my_batCharVal[5] = {
    CHAR_PROP_READ | CHAR_PROP_NOTIFY | CHAR_PROP_INDICATE,
    U16_LO(BATT_LEVEL_INPUT_DP_H), U16_HI(BATT_LEVEL_INPUT_DP_H),
    U16_LO(CHARACTERISTIC_UUID_BATTERY_LEVEL), U16_HI(CHARACTERISTIC_UUID_BATTERY_LEVEL)
};

只有增加这个指示的特性之后,发送电池电量的值给到手机APP的时候才能使用指示消息,否则只能使用通知消息,不过一般情况下我们都是使用的通知,只有对消息的丢包率有比较高的要求的时候,我们才能使用指示来发消息

3、使用指示API进行发送电量通知的消息

cpp
void send_battery_value_to_app()
{
    static unsigned int clock_cnt = 0;
    static unsigned char value = 0;
    if(clock_time_exceed(clock_cnt, 1000000)){
        clock_cnt = clock_time();
        value++;
        // blc_gatt_pushHandleValueNotify (BLS_CONN_HANDLE, BATT_LEVEL_INPUT_DP_H, (u8 *)&value, 1);
        blc_gatt_pushHandleValueIndicate(BLS_CONN_HANDLE, BATT_LEVEL_INPUT_DP_H, (u8 *)&value, 1);
    }
}

上述的代码,将通知的API更改为了指示的API,其余的保持不变.

代码解释:

  • 函数功能为一秒钟增加一次value的值,然后发送给主机(手机APP)
  • blc_gatt_pushHandleValueIndicate为发送指示的api,将value的值发送给主机app

备注:send_battery_value_to_app()函数需要放入主函数里面,不然无法发出数据

3、blc_gatt_pushHandleValueIndicate函数详细解释

java
/**
 * @brief      This function is used to indicate the Characteristic Value from a server to a client.
 * @param[in]  connHandle -  connection handle
 * @param[in]  attHandle - attribute handle.
 * @param[in]  p -  data buffer pointer
 * @param[in]  len - data byte number
 * @return     Status - 0x00: command succeeded; 0x01-0xFF: command failed
 */
ble_sts_t   blc_gatt_pushHandleValueIndicate(u16 connHandle, u16 attHandle, u8 *p, int len);
  • connHandle:连接句柄,如下说明
cpp
/**
 * @brief   LE connection handle for slave & master role
 *          Telink single connection SDK support only one ACL Slave or only one Master connection,
 *          We use constant connection handle value for them in controller to simplify design and development,
 *          so user can use these two connection handle directly.
 *          attention: If using Telink multiple connection SDK, connection handle must be managed dynamically !!!
 */
#define         BLM_CONN_HANDLE                                 0x0080  //ACL Master connection handle
#define         BLS_CONN_HANDLE                                 0x0040  //ACL Slave connection handle
  • attHandle:属性句柄,我们这里要填写的是my_batVal属性的句柄,如何查找my_batVal的句柄,请看4小节
  • p:数据指针,也就是我们需要传入数据的指针
  • len:数据的长度

4、my_batVal的句柄

如上图所示,我们需要知道红框里面的句柄值,通过查看该特征属性值的特征声明就可以知道红框里面的句柄为多少,那么特征属性值的特征声明在哪里呢,如下图所示

此时需要查找my_batCharVal数组里面句柄值,如下图所示

由上图可以看到句柄值为BATT_LEVEL_INPUT_DP_H,如果对这个数组的结构定义有疑问的话,请看我的这篇文章手把手教你:BLE特征声明与特征值代码抓包全解析

备注:该特征的值支持读和通知,读的意思是允许主机读取我的数值,通知的意思是我可以通过通知的方式将数据发送给主机,不需要主机的回复,参见第2小节,我使用的是通知。

5、如何确认手机APP有回复确认消息

需要在应用层里面增加一个事件的标志,在主机回复确认信息的时候,回调会发生,并且进入该事件里面,如下是详细的介绍

5.1、打开app.c文件,找到user_init_normal函数,增加如下的宏

GAP_EVT_GATT_HANDLE_VLAUE_CONFIRM的解释如下所示:

5.2、在app_host_event_callback回调函数中找到GAP_EVT_GATT_HANDLE_VLAUE_CONFIRM的条件分支,然后在下面增加一个变量,并且使该变量一直进行累加

备注:关于rec_confirm_inf_cnt变量的定义和声明,读者自行选择,下面一小节会以串口消息的形式将指示发送的次数,和确认接收的次数打印出来

6、串口打印发送和确认消息的次数

6.1、更改串口引脚定义

cs
#if (UART_PRINT_DEBUG_ENABLE)
    #define DEBUG_INFO_TX_PIN               GPIO_PB2
    #define PULL_WAKEUP_SRC_PB2             PM_PIN_PULLUP_10K
    #define PB2_OUTPUT_ENABLE               1
    #define PB2_DATA_OUT                    1
#endif

我这里使用的GPIO_PB2,注意UART_PRINT_DEBUG_ENABLE这个宏要打开

6.2、改写send_battery_value_to_app函数

cpp
unsigned char rec_confirm_inf_cnt = 0;
void send_battery_value_to_app()
{
    static unsigned int clock_cnt = 0;
    static unsigned char value = 0;
    if(clock_time_exceed(clock_cnt, 1000000)){
        clock_cnt = clock_time();
        if(blc_ll_getCurrentState() == BLS_LINK_STATE_CONN)
        {
            printf("send cnt = %d,rec cnt = %d\n",value,rec_confirm_inf_cnt);
            value++;
            blc_gatt_pushHandleValueIndicate(BLS_CONN_HANDLE, BATT_LEVEL_INPUT_DP_H, (u8 *)&value, 1);
        }
    }
}

该函数增加了关于当前连接状态的判断,并在判断里面打印出来发送的次数,和接收到确认消息的次数,下面对重点的函数进行说明

  • blc_ll_getCurrentState(),当前状态的判断,如下是该函数的解释,总共有5种状态,这里的函数判断的是,当前是否在连接状态
java
/**
 * @brief      this function is used to get LE stack current state
 * @param[in]  none.
 * @return     BLE link layer state:
 *                  BLS_LINK_STATE_IDLE
 *                  BLS_LINK_STATE_ADV
 *                  BLS_LINK_STATE_SCAN
 *                  BLS_LINK_STATE_INIT
 *                  BLS_LINK_STATE_CONN
 */
u8          blc_ll_getCurrentState(void);
  • printf:打印函数,用于打印发送和接收的次数

6.3、串口日志截图

由上图可以看出,接收和发送的次数错位了,也就是丢了一包,下一篇将结合对丢包的情况进行分析

7、手机上使用nRF Connect工具进行查看BLE发送过来的数据信息

7.1、查找vSample广播包,并点击CONNECT

7.2、查看服务列表,点开Battery Service,查看Battery Level的值

8、使用开发板实物图片介绍

上面三根线是下载端口,下面的一根线是串口打印端口

四、结尾

本篇介绍了BLE如何发送指示消息给到手机,并且通过串口打印出了发送和确认的次数,但发现接收和确认出现了数据不一致的情况,下一篇将分析该问题发生的原因并进行解决