NRF5 SDK的函数 sd_ble_gatts_characteristic_add

函数名称：sd_ble_gatts_characteristic_add

功 能：添加GATT服务的特征

参 数：

uint16_t service_handle：服务句柄

ble_gatts_char_md_t const * p_char_md：特征元数据指针

ble_gatts_attr_t const * p_attr_char_value：特征值指针

uint16_t * p_handles：特征句柄指针

返回值：返回一个错误代码，用于表明函数是否执行成功

函数描述：该函数用于向GATT数据库添加特征。特征是GATT服务的一个组成部分，用于描述服务中的某个特定值。在添加特征时，应先创建服务，然后添加特征。

注意事项：

1.特征元数据中应包含特征的属性（如读、写、通知等）。

2.特征值的长度应小于等于GATT MTU（最大传输单元）的长度。

3.特征句柄指针将用于存储添加特征后返回的特征句柄。

4.特征句柄用于标识一个特征，以便后续操作。

5.特征句柄的值应大于等于服务句柄，小于等于服务句柄+服务中特征的数量。

6.如果在添加特征时指定了写权限，则在写入特征值时应使用sd_ble_gatts_value_set函数。

相关问题

请给出Nordic nRF5 SDK中创建新的BLE服务的详细示例

好的，下面是使用Nordic nRF5 SDK创建新的BLE服务的详细示例：

1. 首先，在nRF5 SDK中打开“examples\ble_peripheral\ble_app_template”示例。

2. 在“ble_app”文件夹中，打开“ble_srv_common.h”文件。此文件包含了一些常用的BLE服务定义，你可以通过阅读该文件来了解BLE服务的实现方式。

3. 在“ble_app”文件夹中，打开“ble_srv_common.c”文件。此文件包含了一些常用的BLE服务实现代码，你可以通过阅读该文件来了解BLE服务的实现方式。

4. 在“ble_app”文件夹中，创建一个新的文件夹，命名为“my_service”。

5. 在“my_service”文件夹中，创建一个新的文件，命名为“my_service.h”。在该文件中，你需要定义你的自定义BLE服务的UUID，以及相关的特性和属性等信息。例如：

#ifndef MY_SERVICE_H
#define MY_SERVICE_H

#include "ble.h"
#include "ble_srv_common.h"

#define BLE_UUID_MY_SERVICE 0x1234 // 自定义服务的UUID

// 自定义服务的特性UUID
#define BLE_UUID_MY_SERVICE_CHARACTERISTIC 0x5678

// 自定义服务的特性值结构体
typedef struct
{
    uint8_t value;
} ble_my_service_characteristic_t;

// 自定义服务的事件结构体
typedef struct
{
    ble_my_service_characteristic_t char_value;
} ble_my_service_evt_t;

// 自定义服务的事件句柄类型
typedef void (*ble_my_service_evt_handler_t) (ble_my_service_evt_t * p_evt);

// 自定义服务的初始化函数
uint32_t ble_my_service_init(void);

// 自定义服务的事件注册函数
void ble_my_service_evt_handler_register(ble_my_service_evt_handler_t evt_handler);

#endif // MY_SERVICE_H

6. 在“my_service”文件夹中，创建一个新的文件，命名为“my_service.c”。在该文件中，你需要实现你的自定义BLE服务的初始化、事件处理等功能。例如：

#include "my_service.h"

static uint16_t m_service_handle; // 自定义服务的句柄
static ble_gatts_char_handles_t m_char_handles; // 自定义服务的特性句柄
static ble_my_service_evt_handler_t m_evt_handler; // 自定义服务的事件处理函数

// 自定义服务的事件回调函数
static void my_service_evt_handler(ble_evt_t const * p_ble_evt)
{
    switch (p_ble_evt->header.evt_id)
    {
        case BLE_GAP_EVT_CONNECTED:
            break;
            
        case BLE_GAP_EVT_DISCONNECTED:
            break;
            
        case BLE_GATTS_EVT_WRITE:
            if (p_ble_evt->evt.gatts_evt.params.write.handle == m_char_handles.value_handle)
            {
                ble_my_service_evt_t evt;
                evt.char_value.value = p_ble_evt->evt.gatts_evt.params.write.data[0];
                m_evt_handler(&evt);
            }
            break;
            
        default:
            break;
    }
}

// 自定义服务的事件注册函数
void ble_my_service_evt_handler_register(ble_my_service_evt_handler_t evt_handler)
{
    m_evt_handler = evt_handler;
}

// 自定义服务的初始化函数
uint32_t ble_my_service_init(void)
{
    uint32_t err_code;
    ble_uuid_t ble_uuid;
    ble_uuid128_t base_uuid = {BLE_UUID_MY_SERVICE_BASE};
    
    // 生成自定义服务的UUID
    err_code = sd_ble_uuid_vs_add(&base_uuid, &ble_uuid.type);
    VERIFY_SUCCESS(err_code);
    ble_uuid.uuid = BLE_UUID_MY_SERVICE;
    
    // 添加自定义服务
    err_code = sd_ble_gatts_service_add(BLE_GATTS_SRVC_TYPE_PRIMARY, &ble_uuid, &m_service_handle);
    VERIFY_SUCCESS(err_code);
    
    // 添加自定义服务的特性
    ble_gatts_char_md_t char_md;
    memset(&char_md, 0, sizeof(char_md));
    char_md.char_props.read = 1;
    char_md.char_props.write = 1;
    
    ble_gatts_attr_md_t attr_md;
    memset(&attr_md, 0, sizeof(attr_md));
    attr_md.read_perm = BLE_GAP_CONN_SEC_MODE_OPEN;
    attr_md.write_perm = BLE_GAP_CONN_SEC_MODE_OPEN;
    attr_md.vloc = BLE_GATTS_VLOC_STACK;
    
    ble_uuid_t char_uuid;
    char_uuid.uuid = BLE_UUID_MY_SERVICE_CHARACTERISTIC;
    char_uuid.type = ble_uuid.type;
    
    ble_gatts_attr_t attr;
    memset(&attr, 0, sizeof(attr));
    attr.p_uuid = &char_uuid;
    attr.p_attr_md = &attr_md;
    attr.init_len = sizeof(ble_my_service_characteristic_t);
    attr.max_len = sizeof(ble_my_service_characteristic_t);
    attr.p_value = NULL;
    
    err_code = sd_ble_gatts_characteristic_add(m_service_handle, &char_md, &attr, &m_char_handles);
    VERIFY_SUCCESS(err_code);
    
    // 注册事件回调函数
    err_code = sd_ble_gap_appearance_set(BLE_APPEARANCE_GENERIC_TAG);
    VERIFY_SUCCESS(err_code);
    err_code = sd_ble_gap_device_name_set(&sec_mode, (const uint8_t *) DEVICE_NAME, strlen(DEVICE_NAME));
    VERIFY_SUCCESS(err_code);
    err_code = sd_ble_gap_tx_power_set(BLE_GAP_TX_POWER_ROLE_ADV, m_adv_handle, TX_POWER);
    VERIFY_SUCCESS(err_code);
    err_code = sd_ble_gap_tx_power_set(BLE_GAP_TX_POWER_ROLE_SCAN_INIT, 0, TX_POWER);
    VERIFY_SUCCESS(err_code);
    err_code = sd_ble_gap_tx_power_set(BLE_GAP_TX_POWER_ROLE_CONN, 0, TX_POWER);
    VERIFY_SUCCESS(err_code);
    err_code = sd_ble_gap_ppcp_set(&ppcp);
    VERIFY_SUCCESS(err_code);
    
    return NRF_SUCCESS;
}

7. 在“main.c”文件中，包含“my_service.h”头文件，并在初始化函数中调用“ble_my_service_init()”函数来初始化你的自定义BLE服务。例如：

#include "my_service.h"

int main(void)
{
    uint32_t err_code;
    
    // 初始化BLE协议栈
    ble_stack_init();
    
    // 初始化GAP参数
    gap_params_init();
    
    // 初始化GATT参数
    gatt_init();
    
    // 初始化自定义服务
    err_code = ble_my_service_init();
    APP_ERROR_CHECK(err_code);
    
    // 启动广播
    advertising_start();
    
    // 进入主循环
    for (;;)
    {
        idle_state_handle();
    }
}

到此为止，我们已经完成了一个简单的自定义BLE服务的创建实例。你可以根据自己的需要修改“my_service.h”和“my_service.c”文件，来实现更加复杂的自定义BLE服务。

NRF52832如何给新建的characteristic创建UUID

1. 在 Nordic SDK 中找到 nrf_ble_gatt.h 头文件，找到以下代码段：

typedef struct
{
    uint16_t    uuid;       /**< UUID type, see @ref BLE_UUID_TYPES. */
    union
    {
        uint8_t     uuid128[16];    /**< 128-bit UUID value. */
        uint16_t    uuid16;         /**< 16-bit UUID value. */
    } uuid;                 /**< UUID value. */
} ble_uuid_t;

2. 根据需要创建一个新的 UUID，UUID 的值可以是 16 位或 128 位。可以使用在线 UUID 生成器生成新的 UUID。

3. 根据需要设置 characteristic 的 UUID 类型，可以是 16 位或 128 位。

4. 使用上面的代码段中的 ble_uuid_t 结构体，将新 UUID 的值设置为 uuid 成员的值，并将 UUID 类型设置为 uuid_type。

5. 使用新的 UUID 创建新的 characteristic。可以使用以下代码示例：

ble_uuid_t char_uuid;
char_uuid.uuid_type = BLE_UUID_TYPE_BLE; //设置 UUID 类型
char_uuid.uuid.uuid16 = 0x1234; //设置 UUID 值
err_code = sd_ble_gatts_characteristic_add(p_service->service_handle,
                                           &char_md,
                                           &attr_char_value,
                                           &p_service->char_handles);

其中，char_md 是包含 characteristic 属性的结构体，attr_char_value 是包含 characteristic 值的结构体，p_service->service_handle 是服务的句柄，p_service->char_handles 是 characteristic 的句柄。