使用nRF51822/nRF51422创建一个简单的BLE应用 ---入门实例手册(中文)之四

最新推荐文章于 2024-07-05 22:40:35 发布
最新推荐文章于 2024-07-05 22:40:35 发布
阅读量2.2k 收藏 2
点赞数
分类专栏： nrf51822

转自：http://www.cnblogs.com/tan-v/p/4277889.html

4  LED Button 应用实例

LED Button 应用示例是为了让你学习如何在nRF51822上开发BLE应用，它是一个简单的演示通过BLE的指示功能进行通信的BLE应用。当它运行时，你可以通过集中器触发nRF51822上LED的输出，并且当在nRF51822上的按键被按下时集中器将会收到一个通知。

这个应用通过一个服务被建立，这个服务包括2个特性：LED特性和按键特性。LED特性：通过没有回应的写远程操作LED的亮灭。按键特性：当按键被按下或释放时，将会发送一个通知。

4.1 代码简介

下面的章节将对这个应用是如何工作的进行一个简单的介绍，以帮助你理解和使用这些代码。

4.1.1 代码结构

这个示例代码分为3个文件：

l  main.c

l  ble_lbs.c

l  ble_lbs.h

这个结构和SDK中其他的示例是一样的，在main.c中实现了应用的行为，分离的服务文件（ble_lbs.c，ble_lbs.h）实现了服务本身和它的行为。所有的输入输出的处理都是在应用层中进行的。

一个运行在nRF51822上的应用能够与以下几个部分进行交互：

l  硬件寄存器

寄存器在nrf51.h中定义，用到的常量在nrf51_bitfields.h中定义。在LED BUTTON应用中没有关于使用它们的示例。

l  SDK模块

SDK模块包含了所有BLE开发的所有文件，从封装了硬件寄存器的基本头文件如nrf_gpio.h，到提供给应用层的复杂的功能函数如app_timer或者ble_conn_params。

l  协议栈Softdevice 函数

用来配置或触发Softdevice中的行为，所有Softdevice函数的前缀都是以“sd_”开头。

4.1.2 代码流程

在nRF51822上运行一个标准的BLE应用的基本流程是：初始化所有需要的部分，开始广播，进入省电模式，等待BLE事件发生。当接收到一个事件发生时，它将会被发送到BLE的服务和模块中，这个事件是但不仅限于以下一种事件：

l  当一个对等设备连接到nRF51822时

l  当一个对等设备写入到一个特性时

l  广播超时事件通知

这种流程让应用变得模块化，一个服务通常可以通过初始化加入一个应用之中，并且保证当事件发生时事件的句柄被调用。

4.1.3  在KEIL工程中进行导航和检测

建议在你开始查看示例代码之前先对它进行编译。编译之后，你可以在任何函数、变量、类型、定义上点击鼠标右键，通过选择Go To Definition Of（跳转到定义体）或者Go To Reference To（跳转到引用体）选项跳转到目标定义所在的地方。

Go To Definition Of跳转到真正的实现方法（即源代码文件），Go To Reference To跳转到它的头文件内的声明中，这意味着你不能跳转到SoftDevice 中函数的定义体中，因为这些函数没有源码。但是，你可以跳转到他们的引用体，那里可以告诉你有关如何使用的方法说明。你可以使用这个有用的功能熟悉API函数和示例工程。

 

4.2 代码获取

这个应用笔记介绍了如何建立一个LED Button应用的步骤，另外，完整的示例代码在GitHub上的Git资源库中提供，你可以看到代码的历史版本以及它是如何被开发的。每一部分都有它自己的标签，在本文的末尾将告诉你如何查阅这些代码。

在GitHub上可以找到本工程的代码：https://github.com/NordicSemiconductor/nrf51-ble-app-lbs

4.3 创建

本应用例程需要使用nRF51822 Evaluation Kit开发板，当然，可以经过适当的修改也可以在Development Kit.开发板上运行。

4.3.1 设置Evaluation开发板

因为nRF51822 Evaluation Kit开发板上已经有板载SEGGER芯片，因此你可以使用USB线就能直接开始工作。

4.3.2 设置应用

有很多模式样板代码需要用于开始创建一个应用和服务，所以第一步就是从SDK中复制代码：

1. 进入Board\nrf6310\s110\ble_app_template文件夹

2. 把这个文件夹复制到Board\pca10001\s110\，并重新命名为：ble_app_lbs

3. 进入文件夹ble_app_lbs中的arm文件夹，把工程文件名从ble_app_template 改为 ble_app_lbs。

4.3.3 设置服务

SDK没有一个服务的模板，但是有一个现成的电池服务，这个服务是一个简单的首要服务，非常适合开始创建一个服务的模板。因此需要进行如下步骤：

1. 从Source/ble/ble_services复制ble_bas.c到Board/pca10001/ble/ble_app_lbs/

2. 从Include/ble/ble_services复制ble_bas.h到Board/pca10001/ble/ble_app_lbs/

3. 把ble_bas.c重命名为ble_lbs.c，把ble_bas.h重命名为ble_lbs.h

4. 在Keil左边的工程窗口中双击Services文件夹，选择添加ble_lbs.c文件。这样就把ble_lbs.c文件添加到了你的keil工程中。

因为这个是一个定制的服务，最好把它放在应用层文件夹中，以代替放在SDK 的服务文件夹中。

4.4 实现服务

这个服务采用通用的方式实现，因此可以很容易重用于其他应用。它能够使应用程序通过初始化就能使用这个服务、处理事件、提供输入输出的实现。实现其他预定义服务的方法也是类似的。

4.4.1 API设计

ble_lbs.h头文件实现了各种数据结构、应用需要实现的事件句柄和以下3个API函数：

uint32_t ble_bas_init(ble_bas_t * p_bas, const ble_bas_init_t * p_bas_init);

void ble_bas_on_ble_evt(ble_bas_t * p_bas, ble_evt_t * p_ble_evt);

uint32_t ble_bas_battery_level_update(ble_bas_t * p_bas, uint8_t battery_level);

注意：本文档中代码片段的注释已经被去掉

在上面的代码中，ble_bas_t用于引用这个服务实例，在后面还会用到。而ble_bas_init_t用于初始化参数，后面不会再用到。所有的API函数使用一个指向服务实例的指针作为第一个输入参数。

LED Button服务的API 函数也是同样的设计，步骤如下：

  1. 在对应的头文件和源文件中，执行Find and Replace All功能，把所有出现ble_bas的地方替换成ble_lbs；把所有出现BLE_BAS的地方替换成BLE_LBS；把所有出现p_bas的地方替换成p_lbs。
  2. 在对应的头文件和源文件中，把ble_lbs_battery_level_update()函数都移除。
  3. 在ble_lbs.c文件中，使用#if 0 在第一个函数之前，使用#endif 在初始化函数ble_lbs_init（）之上注释掉所有的函数，不要完全删除它们，因为后面建立函数还需要用到它们。
  4. 在对应的头文件和源文件中，把battery_level_update函数都移除。
  5. 在初始化函数ble_lbs_init（）的末尾，删除battery_level_char_add()函数，用return NRF_SUCCESS进行代替。
  6. 考虑到服务要符合应用的需求，LED Button服务需要知道什么时候按键状态改变了，才能把状态发送到集中器设备，因此，你需要增加一个函数当按键状态改变的时候应用程序能够调用它。

uint32_t ble_lbs_init(ble_lbs_t * p_lbs, const ble_lbs_init_t * p_lbs_init);

void ble_lbs_on_ble_evt(ble_lbs_t * p_lbs, ble_evt_t * p_ble_evt);

uint32_t ble_lbs_on_button_change(ble_lbs_t * p_lbs, uint8_t button_state);

这里有2个数据结构需要实现：ble_lbs_t 和 ble_lbs_init_t。

4.4.2 实现数据结构体

在第25页4.4.1节“API设计”中，有一些用到的数据结构还没有定义：ble_lbs_t 和 ble_lbs_init_t.，我们可以基于电池服务的数据结构体实现类似的结构体，电池服务的数据结构体如下：

typedef struct

{

ble_bas_evt_handler_t        evt_handler;

bool                         support_notification;

ble_report_ref_t              * p_report_ref;

uint8_t                       initial_batt_level;

ble_cccd_security_mode_t     battery_level_char_attr_md;

ble_gap_conn_sec_mode_t    battery_level_report_read_perm;

} ble_bas_init_t;

 

typedef struct ble_bas_s

{

ble_bas_evt_handler_t          evt_handler;

uint16_t                       service_handle;

ble_gatts_char_handles_t       battery_level_handles;

uint16_t                       report_ref_handle;

uint8_t                        battery_level_last;

uint16_t                       conn_handle;

bool                          is_notification_supported;

} ble_bas_t;

以上的代码中的初始化结构体包含服务的事件句柄，一些选项参数，初始化值，安全模式，服务结构体包含服务的声明，如句柄，当前电量值，通知功能是否打开等。

电池服务使用一个通用的事件句柄让应用程序知道什么时候开始和停止读取电池电量。LED Button 服务不依赖于任何启动或停止，所以只使用一个函数作为回调函数，当LED特性被写入时被调用。

这个句柄是初始化中唯一有效的参数，也是初始化结构体中唯一的成员。

typedef struct

{

ble_lbs_led_write_handler_t   led_write_handler;

} ble_lbs_init_t;

在这个结构体中，函数类型的定义如下(在头文件中必须在ble_lbs_init_t定义之前添加，代替之前已经存在的事件句柄定义):

typedef void (*ble_lbs_led_write_handler_t) (ble_lbs_t * p_lbs, uint8_t new_state);

然而，下面的参数参数还需要定义：

l  服务的句柄

l  特性的句柄

l  连接的句柄

l  UUID类型

l  LED写的回调函数

服务结构体定义如下:

typedef struct ble_lbs_s

{

uint16_t                     service_handle;

ble_gatts_char_handles_t     led_char_handles;

ble_gatts_char_handles_t     button_char_handles;

uint8_t                      uuid_type;

uint16_t                     conn_handle;

} ble_lbs_t;

可以删除ble_lbs.h文件中有关电池服务事件的定义。

4.4.3 服务初始化

进入服务初始化函数services_init()，函数ble_lbs_init（）被调用。参数你不需要改变。

  1. 删除evt_handler, is_notification_supported和 battery_level_last.
  2. 在服务初始化结构体和服务结构体中，都要把evt_handler重命名为led_write_handler。

p_lbs->led_write_handler = p_lbs_init->led_write_handler;

UUID需要重新设置，因为本服务中将要使用一个定制（私有）的UUID，以代替蓝牙技术联盟所定义的UUID。

首先，先定义一个基本UUID，一种方式是采用nRFgo Studio来生成：

  1. 打开nRFgo Studio
  2. 在nRF8001 Setup菜单中，选择Edit 128-bit UUIDs选项，点击Add new。

这就产生了一个随机的UUID，可以用于你的定制服务中。

新产生的基本UUID必须以数组的形式包含在源代码中，但是只需要在一个地方用到：

  1. 为了可读性，在头文件ble_lbs.h中以宏定义的方式添加，连同用于服务和特性的16位UUID也一起定义：

#define LBS_UUID_BASE { 0x23, 0xD1, 0xBC, 0xEA, 0x5F, 0x78, 0x23, 0x15, 0xDE, 0xEF,0x12, 0x12, 0x00, 0x00, 0x00, 0x00 }

#define LBS_UUID_SERVICE        0x1523

#define LBS_UUID_LED_CHAR      0x1525

#define LBS_UUID_BUTTON_CHAR  0x1524

在服务初始化中：

  1. 添加基本UUID到协议栈列表中，就设置了服务使用这个基本UUID。在ble_lbs_init()中只添加一次：

ble_uuid128_t base_uuid = LBS_UUID_BASE;

err_code = sd_ble_uuid_vs_add(&base_uuid, &p_lbs->uuid_type);

if (err_code != NRF_SUCCESS)

{

return err_code;

}

以上代码段为加入一个定制的基本UUID到协议栈中，并且保存了返回的UUID类型。

  1. 当为LED Button服务设置UUID时，使用这个UUID类型，它在ble_lbs:init()中：

ble_uuid.type = p_lbs->uuid_type;

ble_uuid.uuid = LBS_UUID_SERVICE;

err_code = sd_ble_gatts_service_add( BLE_GATTS_SRVC_TYPE_PRIMARY, &ble_uuid,

&p_lbs->service_handle);

if (err_code != NRF_SUCCESS)

{

return err_code;

}

以上代码只是添加了一个空的服务，所以还必须添加特性到服务中，下面的章节将介绍如何添加特性。

4.4.3.1  实现按键特性

本服务将要实现2个特性，一个是控制LED的状态，一个是反馈按键的状态。这两个功能需要创建并增加2个特性到ble_lbs.c中实现，我们先从按键特性说起。

  按键特性在有按键状态改变的时候有通知事件，同时也允许对等设备读取这个按键状态。这非常类似于在电池服务中电量特性的特征，因此你可以采用以下方式实现：

  1. 找到battery_level_char_add()函数并重命名为button_char_add()。
    button_char_add()期望找到一个参数说明是否支持通知功能，在这个示例中我们希望只支持通知功能。
  2. 删除检测参数is_notification_supported的if语句，但是保留if语句中的内容。
  3. 确保char_md中对应字段设置为支持通知功能。
  4. 删除所有与报告参考相关的代码和参数p_report_ref（每次执行到if语句都检查p_report_ref是否设置）。

在电池服务的初始化中有一个标志设置了CCCD的安全模式，它存储在ble_gap_conn_sec_mode_t结构体中，这个结构体使用在头文件ble_gap.h中定义的宏BLE_GAP_CONN_SEC_MODE来设置，根据不同的安全等级定义了不同的宏，你可以根据属性的需要进行选择。

1. 使用宏BLE_GAP_CONN_SEC_MODE_SET_OPEN把CCCD设置成对任何连接和加密都是可读可写的模式。

  1. 如果对于按键状态特性我们想让每一个连接都可读但不能写，可以使用BLE_GAP_CONN_SEC_MODE_SET_NO_ACCESS代替BLE_GAP_CONN_SEC_MODE_SET_OPEN。

BLE_GAP_CONN_SEC_MODE_SET_OPEN(&cccd_md.read_perm);

BLE_GAP_CONN_SEC_MODE_SET_OPEN(&cccd_md.write_perm);

...

memset(&attr_md, 0, sizeof(attr_md));

BLE_GAP_CONN_SEC_MODE_SET_OPEN(&attr_md.read_perm);

BLE_GAP_CONN_SEC_MODE_SET_NO_ACCESS(&attr_md.write_perm);

  1. 确保你不要删除字段vloc的设置，它决定了变量是使用协议栈的内存还是用户空间的内存。
  2. 设置UUID的类型和UUID的值：

ble_uuid.type = p_lbs->uuid_type;

ble_uuid.uuid = LBS_UUID_BUTTON_CHAR;

  1. 初始化值不重要，你可以把p_initial_value设置为NULL。
  2. 确保把返回的特性句柄button_char_handles保存在正确的地方，最后调用的函数如下：

return ble_gatts_characteristic_add( p_lbs->service_handle,

&char_md,

&attr_char_value,

&p_lbs->button_char_handles );

删除#endif以上的内容后，你就可以编译工程了，根据编译的警告删除没有用到的变量(initial_battery_level,encoded_report_ref, init_len, err_code)。

4.4.3.2  实现LED特性

LED状态特性需要能够可读可写，但没有任何通知功能：

  1. 复制按键特性函数，重命名为led_char_add。
  2. 删除与cccd_md有关的代码。
  3. 增加写的性质代替通知性质（给这个特性使能写性质）。

char_md.char_props.write = 1;

  1. 更改使用的16位UUID为LBS_UUID_LED_CHAR：

ble_uuid.type = p_lbs->uuid_type;

ble_uuid.uuid = LBS_UUID_LED_CHAR;

保存返回的变量led_char_handles（LED特性的句柄），代替button_char_handles的位置，最后调用的函数如下：

return ble_gatts_characteristic_add( p_lbs->service_handle,

&char_md,

&attr_char_value,

&p_lbs->led_char_handles );

编译之后，你会发现有一些参数没有使用，删除它们。

4.4.3.3增加特性

创建了增加特性的函数之后，你可以在服务初始化的末尾调用它们，如下面的例子：

// Add characteristics

err_code = button_char_add(p_lbs, p_lbs_init);

if (err_code != NRF_SUCCESS)

{

return err_code;

}

err_code = led_char_add(p_lbs, p_lbs_init);

if (err_code != NRF_SUCCESS)

{

return err_code;

}

return  NRF_SUCCESS;

因为任何错误都会导致函数提前退出，因此当你到达函数的末尾时可以认为初始化成功了。

如果你想现在就进行测试，你可以跳到第37页第4.5.1节“为evaluation kit开发板修改模块”和第40页第4.5.3节“包含服务”，完成之后，最后的测试在第47页第5章“应用测试”中介绍。测试时你会发现，你可以连接到这个设备并且可以发现所有的服务，但是其他的功能不能工作，因此还需要在这个服务中实现处理协议栈事件和按键处理。

4.4.4处理协议栈事件

当协议栈需要通知应用程序一些有关它的事情的时候，协议栈事件就发生了，例如当写入特性或是描述符时。对应于本应用，你需要写入LED特性，为了让通知功能更好地工作，你需要保存连接句柄，通过这个句柄，你可以在连接事件和断开事件中实现某些操作。

作为API的一部分，你可以定义一个函数ble_lbs_on_ble_evt用来处理协议栈事件，可以使用简单的switch-case语句通过返回事件头部的id号来区分不同的事件，并进行不同的处理。

 4.4.4.1 保存连接句柄

电池服务已经保存了连接句柄，但没有改变之前采用Find and Replace来查找时需要注意一些。

4.4.4.2参数CCCD写的处理

现有的事件句柄监听CCCD写的操作并把它发送应用层的电池服务的事件句柄，但是，在本应用中，不需要这样。

原有的代码中实现了发送通知的方法，但是如果CCCD没有使能，sd_ble_gatts_hvx()（通知或者指示回调函数）将不允许发送通知，因此你不需要在应用层中进行检测，而是交给协议栈SoftDevice中去检测。

在on_write()函数中，你可以删除与通知功能相关的代码。

4.4.4.3处理LED特性写

当LED特性被写入的时候，你添加到数据结构的函数指针将会通知到应用层，你可以在on_write()函数中实现这样的功能。

当接收到一个写事件时，验证这个写事件是发生在对应的特性上是一个基本的任务，包括验证数据的长度，回调函数是否已设置。如果所有这些都是正确的，则回调函数将会调用，并且把已经写入的值作为输入参数。因此，on_write()函数的内容将会是这样：

ble_gatts_evt_write_t * p_evt_write = &p_ble_evt->evt.gatts_evt.params.write;

if ((p_evt_write->handle == p_lbs->led_char_handles.value_handle) &&

(p_evt_write->len == 1) &&

(p_lbs->led_write_handler != NULL))

{

p_lbs->led_write_handler(p_lbs, p_evt_write->data[0]);

}

       真正触发LED的操作在于应用层，这样的设计让服务很容易重用，虽然这只是针对于LED和按键的服务。

4.4.5处理按键事件

你已经添加了一个回调API函数让服务知道按键何时被按下，但还没有全部实现，因此你需要从头文件中通过复制来添加，在处理按键按下的时候，你需要给对等设备发送一个通知以告知它新的按键状态。协议栈SoftDeviceAPI函数sd_ble_gatts_hvx来完成这个事情，它需要连接句柄和结构体ble_gatts_hvx_params_t作为输入参数，它管理一个值被通知的整个过程。

在结构体ble_gatts_hvx_params_t中，你需要设置为通知模式还是指示模式，用哪一个属性的句柄用来进行通知（本例中使用值的句柄），新的值以及值的长度。方法如下：

uint32_t ble_lbs_on_button_change(ble_lbs_t * p_lbs, uint8_t button_state)

{

ble_gatts_hvx_params_t params;

uint16_t len = sizeof(button_state);

memset(&params, 0, sizeof(params));

params.type = BLE_GATT_HVX_NOTIFICATION;

params.handle = p_lbs->button_char_handles.value_handle;

params.p_data = &button_state;

params.p_len = &len;

return  sd_ble_gatts_hvx(p_lbs->conn_handle, &params);

}

也可以使用sd_ble_gatts_value_set()函数一次性设置特性的值，当通知的时候调用sd_ble_gatts_hvx()不需要设置值和值的长度。但是，没必要使用sd_ble_gatts_hvx()做任何事情，它不过类似于一个清洁工的角色。使用函数sd_ble_gatts_value_set()更新一个可读(但不能通知)的值，因为这个函数不通过空中发送数据包。

按照本服务的实现方法，本例子可以应用在其他应用中。

4.5 应用层实现

4.5.1 修改模板适应于evaluationkit开发板

需要使用模板进行一些修改以适应于evaluation kit开发板，以代替Development Kit开发板。

 首先，你需要更改定义板子的宏定义：

1. 打开工程文件，进入到“Target options”标签和“C/C++”标签。

2. 把BOARD_NRF6310更改为BOARD_PCA10001，如下图所示：

注意：如果你用development kit开发板代替evaluationkit开发板，跳到步骤4和步骤5，并且把ble_app template拷贝到Board\nrf6310\s110\ble_app_lbs下，你便建立了一个工程。

 

你需要在main.c中删除一些引脚定义，因为在evaluation kit开发板上，没有一个单独的LED用于言断。

  1. 在main.c中删除所有有关ASSERT_LED_PIN_NO的代码(宏定义，在app_error_handler()中使用，在leds_init()中设置为输出引脚)。
  2. 你需要一个LED用于LED Button服务，因此你需要在main.c的顶部添加定义LED引脚的宏定义。

#define LEDBUTTON_LED_PIN_NO        LED_0

  1. 在In leds_init()中配置引脚为作为LED引脚：

nrf_gpio_cfg_output(LEDBUTTON_LED_PIN_NO);

  1. 在SDK 4.1.0以后，当错误发生时，默认的应用层错误处理是复位，但是对于开发，更有用的是使用提供的debug模块，你需要确保取消注释debug言断的处理，注释掉复位的处理：

void app_error_handler(uint32_t error_code, uint32_t line_num, const uint8_t *

p_file_name)

{

// [Comment removed from snippet for brevity]

ble_debug_assert_handler(error_code, line_num, p_file_name);

// On assert, the system can only recover with a reset.

//NVIC_SystemReset();

}

当你运行程序在调试模式下的时候，如果出现错误你可以停止cpu，并能够发现文件中哪一行发生了错误。你可用SoftDevice中的APP_ERROR_CHECK()宏来检测返回的错误代码得到有关错误的信息。如图5所示的例子.

在实际的产品中，通常使用复位来恢复错误，但在开发中，日记更重要。

建议在工程中更改蓝牙设备的名字，可以通过改变main.c中的宏DEVICE_NAME来实现，例如可以改成“LedButtonDemo”。

4.5.2使用调度

SDK提供了调度模块，这个模块提供了把事件处理和中断处理转移到main函数中进行的机制，它保证了所有的中断处理都能快速被执行。

      在开始使用的模板中，默认使能了调度功能。如果你不想使用它，你可以删除它的初始化和main循环中对它的调用（scheduler_init(),app_sched_execute()），设置SDK的模块初始化函数中相关的标识使用调度的参数为假（softdevice_handler,app_timer,app_button)。

      关于调度的更多详情，请查阅nRF51 SDK文档。

4.5.3包含服务

为了使用你创建的服务，你需要在模板中添加一些代码。

在mian.c文件中，必须出现调用services_init()函数来初始化LED Button 服务：

  1. 在main.c中包含ble_lbs.h头文件：

#include  "ble_lbs.h"

2. 如果没有添加源文件，则添加源文件到工程中：在工程窗口的左边在Services文件上点击右键，单击Add file，选择ble_lbs.c文件。

3. 在main.c中添加服务的数据结构作为全局静态变量：

static ble_lbs_t     m_lbs;

注意：事件通过在main.c中使用静态变量的方式被保存，m_lbs作为指针指向的变量经常会出现，指向它的指针为p_lbs。

  1. 现在你可以初始化你的服务：

static void services_init(void)

{

uint32_t   err_code;

ble_lbs_   init_t init;

init.led_write_handler = led_write_handler;

err_code = ble_lbs_init(&m_lbs, &init);

APP_ERROR_CHECK(err_code);

}

       在第35页4.4.4.3节“处理LED特性写”中，我们在服务结构体中设置了led_write_handler，当LED特性被写入的时候将会调用。这个回调函数通过上面的初始化结构体被设置，但这个回调函数还没有实现。

  1. 在services_init()函数之上，添加回调函数led_write_handler()，以实现声明。
  2. 设置LED输出状态值，它是函数的一个输入参数：

Static void led_write_handler(ble_lbs_t * p_lbs, uint8_t led_state)

{

if (led_state)

{

nrf_gpio_pin_set(LEDBUTTON_LED_PIN_NO);

}

else

{

nrf_gpio_pin_clear(LEDBUTTON_LED_PIN_NO);

}

}

  1. 最后，添加服务事件的处理函数到应用层事件调度函数(回调函数)

static void ble_evt_dispatch(ble_evt_t * p_ble_evt)

{

on_ble_evt(p_ble_evt);

ble_conn_params_on_ble_evt(p_ble_evt);

ble_lbs_on_ble_evt(&m_lbs, p_ble_evt);

}

4.5.4测试

现在你可以进行测试了，见第47页第5章“应用测试”，使用MasterControl Panel，你可以写“1”到LED特性中来点亮LED。

4.5.5按键处理

为了完成本应用，你需要定义如何处理按键按下，你可以使用SDK提供的app_button模块，这个模块将会提供当按键按下和释放时的一个回调函数。

在按键初始化buttons_init()里，设置你需要的按键，在这个示例中使用了evaluationkit开发板上的button1。

  1. 添加一个新的宏定义，只是为了让代码具有可读性：

#define  LEDBUTTON_BUTTON_PIN_NO      BUTTON_1

  1. 在buttons_init()里配置按键的引脚，添加按键配置数组如下：

static app_button_cfg_t buttons[] =

{

{WAKEUP_BUTTON_PIN, false, NRF_GPIO_PIN_PULLUP, NULL},

{LEDBUTTON_BUTTON_PIN_NO, false, NRF_GPIO_PIN_PULLUP, button_event_handler},

};

APP_BUTTON_INIT( buttons, sizeof(buttons) / sizeof(buttons[0]),

BUTTON_DETECTION_DELAY, true);

       在evaluation kit开发板上的按键是低电平有效，所以第2个参数为false，但它没有外部上拉电阻，因此你需要使用NRF_GPIO_PIN_PULLUP来使能内部上拉电阻。唤醒按键wakeup_button没有声明，所以它的回调函数设置为NULL。完成之后，你就已经完成按键模块的初始化了。

  1. 取消对函数button_event_handler()的注释，app_button模块将通过参数传递当前的按键状态，因此你可以通过服务API函数直接传递这个按键状态：

static void button_event_handler(uint8_t pin_no, uint8_t button action)

{

uint32_t err_code;

switch(pin_no)

{

case LEDBUTTON_BUTTON_PIN_NO:

err_code = ble_lbs_on_button_change(&m_lbs, button_action);

if (err_code != NRF_SUCCESS &&

err_code != BLE_ERROR_INVALID_CONN_HANDLE &&

err_code != NRF_ERROR_INVALID_STATE)

{

APP_ERROR_CHECK(err_code);

}

break;

default:

APP_ERROR_HANDLER(pin_no);

break;

}

}

在上面的代码中，我们忽略可能客户端CCCD还没有被写入，或者我们没有正确连接所带来的错误。

    为了添加已经定义的函数，你需要确定按键模块已经被使能。默认情况下，应用模板建议连接事件和断开连接事件中来完成使能和禁止，这里我们也使用这种方式。取消对app_button_enable()和 app_button_disable()的注释：

switch (p_ble_evt->header.evt_id)

{

case BLE_GAP_EVT_CONNECTED:

…

/* … */

err_code = app_button_enable();

break;

case BLE_GAP_EVT_DISCONNECTED:

…

/* … */

err_code = app_button_disable();

if (err_code == NRF_SUCCESS)

{

advertising_start();

}

break;

现在你可以进行测试了，见第47页第5章“应用测试”的描述，然而为了让集中器在扫描的时候能够更容易区分不同的设备，有必要在广播数据包中加入本服务的UUID。

4.5.6 加入本服务的UUID到广播数据包中

在广播数据包中包含服务UUID，可以使集中器利用这个信息决定是否进行连接。在第8页第2.1.2节“广播”中所提到，一个广播数据包最多可携带31字节，如果需要更多的数据需要传输，可以使用扫描回应发送。

你需要增加一个定制的16位的UUID到扫描回应数据包中，因为广播数据包已经没有可用的空间了。

广播数据的设置在main.c的advertising_init()中，设置广播数据结构体，并调用ble_advdata_set()来设置，它使用2个相同的数据类型的参数，一个是广播数据包，一个是扫描回应数据包。你必须添加一个数据结构作为扫描回应的参数。

服务UUID设置为LBS_UUID_SERVICE，类型使用结构体ble_lbs_t中的uuid_type，广播数据包的初始化如下：

static void advertising_init(void)

{

uint32_t          err_code;

ble_advdata_t     advdata;

ble_advdata_t     scanrsp;

uint8_t   flags = BLE_GAP_ADV_FLAGS_LE_ONLY_LIMITED_DISC_MODE;

 

// YOUR_JOB: Use UUIDs for service(s) used in your application.

ble_uuid_t adv_uuids[] = {{LBS_UUID_SERVICE, m_lbs.uuid_type}};

 

// Build and set advertising data

memset(&advdata, 0, sizeof(advdata));

 

advdata.name_type           = BLE_ADVDATA_FULL_NAME;

advdata.include_appearance   = true;

advdata.flags.size             = sizeof(flags);

advdata.flags.p_data          = &flags;

 

memset(&scanrsp, 0, sizeof(scanrsp));

scanrsp.uuids_complete.uuid_cnt  =  sizeof(adv_uuids) / sizeof(adv_uuids[0]);

scanrsp.uuids_complete.p_uuids  =  adv_uuids;

 

err_code = ble_advdata_set(&advdata, &scanrsp);

APP_ERROR_CHECK(err_code);

}

因为m_lbs结构体的uuid_type在这里被使用，所以确保它在services_init()中已经被设置，并保证它在advertising_init()之前被调用,在main中：

int main(void)

{

…

services_init();

advertising_init();

…

到此，这个应用已经建立完成。


内陆的咸水鱼
关注
  • 0
    点赞
  • 踩
  • 2
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
nrf51822中文参考手册
10-12
nrf51822中文参考手册，nRF51822 是一款集成nRF51x系列无线收发器的超低功耗的片上系统 (Soc) ， 包含一个32位ARM Cortex-M0 CPU ， flash 存储器和模拟、数字外设。NORDIC SEMICONDUCTOR nRF51822 Product Specification v1.3 Liability disclaimer Nordic Semiconductor ASa reserves the right to make changes without further notice to the product to improve reliability, function or design. Nordic Semiconductor asa does not assume any liability arising out of the application or use of any product or circuits described herein ife support applications Nordic Semiconductor's products are not designed for use in life support appliances, devices, or systems where malfunction of these products can reasonably be expected to result in personal injury. Nordic Semiconductor ASa customers using or selling these products for use in such applications do so at their own risk and agree to fully indemnify Nordic Semiconductor ASA for any damages resulting from such improper use or sale Contact details Foryournearestdistributorpleasevisitwww.nordicsemi.com Information regarding product updates, downloads, and technical support can be accessed through your My Page account on our home page Main office: Otto Nielsens veg 12 Mailing address: Nordic Semiconductor 7052 Trondheim P.O. Box 2336 Norway 7004 Trondhe Phone:+4772898900 Norway 4772898989 画N远 NS-EN ISO 9001 CERTIFICATEDFIRM RoHS and reach statement Nordic semiconductor's products meet the requirements of Directive 2002/95/EC of the European Parliament and of the Council on the restriction of Hazardous Substances(roHS)and the requirements of the reach regulation(EC 1907/2006)on Registration, Evaluation, Authorization and Restriction of Chemicals. The SvHC(Substances of Very High Concern) candidate list is continually being updated Complete hazardous substance reports material composition reports and latest version of nordics reach statementcanbefoundonourwebsitewww.nordicsemicom Page 2 of 67 NORDIC SEMICONDUCTOR nRF51822 Product Specification v1.3 Datasheet status Status Description Objective Pro
（原创）使用nRF51822/nRF51422创建一个简单的BLE应用 ---入门实例手册(中文)之二...
weixin_30371875的博客
02-04 453
2 BLE介绍 本章将介绍BLE协议不同的层，包括各个层的部件和它们的概念。 2.1 通用访问规范（Generic Access Profile，GAP） GAP是应用层能够直接访问BLE协议栈的最底层，它包括管理广播和连接事件的有关参数。 注意:GAP的更多详细介绍见《Bluetooth Core Specification》（蓝牙核心规范）的第3卷C部分。 2.1...
nRF52832-Bluefruit52学习之蓝牙BLE开发（2）-- 蓝牙BLE主函数分析
solar_Lan的博客
08-03 7680
nRF52832技术交流群：680723714 nRF52832-Bluefruit52核心板详细介绍： https://blog.csdn.net/solar_Lan/article/details/88688451 蓝牙 BLE 之主函数分析 工程...
已经量产的产品，不是玩具。 Nordic公司nRF51822芯片开发，芯片集成BLE蓝牙4.0协议。
最新发布
OeraQNrK的博客
07-05 409
总的来说，Nordic公司nRF51822芯片开发的智能手环具备运动计步、睡眠监测、时间显示、久坐提醒、来电提醒、闹钟、手机防丢、遥控拍照和手机解锁等多种功能。nRF51822芯片是一款集成了BLE蓝牙4.0协议的芯片，它具有低功耗、高性能和稳定的特点，非常适合用于智能手环的开发。蓝牙射频电路是手环中非常重要的部分，它能够实现与手机之间的通信，实现来电提醒、手机防丢等功能。另外，手环还具备手机防丢功能，可以通过与手机的双向防丢实现对手机的保护。除了蓝牙功能，手环中的加速度传感器也是非常重要的组成部分。
（原创）使用nRF51822/nRF51422创建一个简单的BLE应用 ---入门实例手册(中文)之四...
weixin_30362801的博客
02-06 401
4 LED Button 应用实例 LED Button 应用示例是为了让你学习如何在nRF51822上开发BLE应用，它是一个简单的演示通过BLE的指示功能进行通信的BLE应用。当它运行时，你可以通过集中器触发nRF51822上LED的输出，并且当在nRF51822上的按键被按下时集中器将会收到一个通知。 这个应用通过一个服务被建立，这个服务包括2个特性：LED特性和按键特性。LED特性：...
BLE-nRF51822学习（2）-芯片手册阅读
星克曼的专栏
11-21 4571
ARM芯片已经hen
NRF51822-code_nrf51822demo_nrf51822_ble_51822DFU_
10-04
这些例子对于初学者理解如何与NRF51822交互非常有帮助，同时也为开发者提供了一个起点，以便进一步开发自己的应用。 "ble"代表了蓝牙低功耗技术，BLE的核心在于其高效的数据传输和极低的功耗设计。在NRF51822的应用...
NRF51822-master_NRF51822-串口_nrf51822master_nrf51822_mission2fm_m
09-29
在BLE系统中，通常有一个主设备（Central）和一个或多个从设备（Peripheral）。在这个案例中，NRF51822可能作为从设备，通过串口与主设备进行数据交换。 7. **BLE堆栈集成**：NRF51822的SDK包含了完整的BLE协议栈，...
电子-nrf51822创建一个简单ble例程.pdf
09-05
这篇文章主要介绍了如何在nRF51822芯片上创建一个低功耗蓝牙（BLE）应用程序，并通过一个具体的例程——LED Button服务，来展示如何编写和实现BLE应用。 首先，文章强调了创建BLE应用程序需要一定的嵌入式C语言编程...
NRF51822 中文资料
03-25
2.4 GHz 无线收发器 低功耗模式下灵敏度： -93 dBm 数据传输速率： 250 kbps, 1 Mbps, 2 Mbps TX Power -20 to +4 dBm in 4 dB steps 省电模式下发射功率： -30 dBm 峰值电流，接收时：13 mA, 发射时(0 dBm)： 10.5 mA RSSI (分辨率： 1 dB) #接收信号的强度指示 ARM? Cortex?-M0 32 bit processor 275 μA/MHz running from flash memory 150 μA/MHz running from RAM Serial Wire Debug (SWD)
NRF51422和NRF51822产品介绍（超低功耗蓝牙4.0）.ppt
08-25
NRF51422和NRF51822产品介绍,两个芯片的参数对比，包括功耗，灵敏度等对比，这两个北欧比较有名气 的蓝牙多协议芯片。
电子-nrf51822创建一个简单的BLE例程英文版.pdf
09-05
这份文件是一份关于使用nRF51822芯片创建蓝牙低能量(BLE)应用程序的技术文档，主要针对希望开始编程BLE应用程序的读者。文档提供了BLE功能的概述，并通过一个简单的示例程序——LEDButton服务来展示如何实现自定义...
NRF51822蓝牙服务（3）——电池电量采集
SammySum的博客
12-04 2677
前言 由于蓝牙BLE就是为低功耗手持设备存在的，那电池电量的监测服务就不可或缺了。由于电量服务是蓝牙兴趣小组指定的服务，不需要用户去创建私有服务，所以这个实验我们直接使用官方提供的驱动文件即可。 实验分析 由于我的开发板没有提供AD口检测电量，所以实验直接使用一个全局变量代表电量值，每隔一秒更新一次。 首先，我们需要把官方驱动例程添加到我们的工程目录里面： 路径是：工程目录\com...
蓝牙芯片nRF51822开发系列（一）：环境搭建和GPIO使用（点亮LED）
weixin_50622833的博客
08-01 3718
蓝牙芯片nRF51822开发系列（一）：环境搭建和GPIO使用（点亮LED）简介新的改变功能快捷键合理的创建标题，有助于目录的生成如何改变文本的样式插入链接与图片如何插入一段漂亮的代码片生成一个适合你的列表创建一个表格设定内容居中、居左、居右SmartyPants创建一个自定义列表如何创建一个注脚注释也是必不可少的KaTeX数学公式新的甘特图功能，丰富你的文章UML 图表FLowchart流程图导出与导入导出导入 简介 nRF51822是一款性价比较高的低功耗蓝牙（BLE）SoC，搭载ARM Cotex-M
（原创）使用nRF51822/nRF51422创建一个简单的BLE应用 ---入门实例手册(中文)之五...
weixin_30239339的博客
02-06 248
5应用测试 需要一个USB dongle与开发板evaluation kit，并配合Master Control Panel软件，以用于测试BLE应用。前期的准备工作在《nRF51822 Evaluation Kit User Guide》中的“Quick Start”章节有详细的介绍，打开Master Control Panel软件，你可以测LED Button应用如以下步骤： 打开Ma...
nRF51822 S110 用户指南
littleflypig的博客
05-01 1604
1.SoftDevice结构 SoftDevice是nRF公司实现的一个BLE蓝牙协议栈，只提供HEX文件，可以实现从机角色（Peripheral role）或广播者角色（Broadcaster role） 1.1使用前阅读 S110 nRF51822 SoftDevice Specification nRF51822 Product Specification nRF51 Se
BLE主机端通过点击Characterstic “read”，从机端发送消息原理及方法介绍
weixin_44921705的博客
02-20 1132
** 前言： ** 1.主机端通过NRF Connect App连接蓝牙设备 2.芯片为NRF52840 3.程序为Nordic官方提供程序 1.问题描述：手机（主机）连接蓝牙从机后，需要读取从机的信息，在自定义服务/标准服务下，通过操作Characterstic 下“read”按键，读取从机端的信息。 2.原理介绍： 主机read是在SD（softdevice）中获取数据的，而在APP层，是通过函数库sd_ble_gatts_value_set() 这个函数更新信息到SD的，read的动作并没有在APP
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值