Zephyr 中 bt_gatt_indicate_params 数据结构

原创于 2025-08-20 00:45:00 发布 · 604 阅读

12 ·

CC 4.0 BY-SA版权

文章标签：

#zhphyr #Nordic #嵌入式硬件

Nordic MCU系列笔记同时被 2 个专栏收录

67 篇文章

订阅专栏

zephyr架构蓝牙应用笔记

54 篇文章

订阅专栏

概述

1 bt_gatt_indicate_params 数据结构介绍

1.1 结构定义

1.2 成员详解

1.2.1 func - 指示完成回调

1.2.2 destroy - 析构函数（可选）

概述

bt_gatt_indicate_params 是 Zephyr 蓝牙协议栈中用于配置 GATT 指示操作的核心数据结构。指示（Indication）是一种需要客户端确认的可靠数据传输机制，适用于关键数据更新和控制操作。该数据结构是 Zephyr 蓝牙协议栈中实现可靠数据传输的关键数据结构。通过合理管理其生命周期、正确处理回调函数并优化资源使用，可以构建高效可靠的蓝牙应用系统，特别适用于需要确认的关键操作和数据传输场景。

1 bt_gatt_indicate_params 数据结构介绍

1.1 结构定义

struct bt_gatt_indicate_params {
    // 指示操作完成时的回调函数
    void (*func)(struct bt_conn *conn,
                 struct bt_gatt_indicate_params *params,
                 uint8_t err);
    
    // 指示参数析构函数（可选）
    void (*destroy)(struct bt_gatt_indicate_params *params);
    
    // 指向要指示的特征属性的指针
    const struct bt_gatt_attr *attr;
    
    // 要发送的数据指针
    const void *data;
    
    // 数据长度
    uint16_t len;
    
    // 内部使用字段（协议栈管理）
    struct bt_att_req _req;
};

1.2 成员详解

`1.2.1 func` - 指示完成回调

void (*func)(struct bt_conn *conn,
             struct bt_gatt_indicate_params *params,
             uint8_t err);

功能：当指示被确认或失败时调用的回调函数

参数：

conn：目标连接句柄（发送指示的连接）

params：指向当前指示参数结构的指针

err：错误代码（0 表示成功）

典型实现：

static void indicate_cb(struct bt_conn *conn,
                       struct bt_gatt_indicate_params *params,
                       uint8_t err)
{
    if (err) {
        printk("Indication failed: 0x%02x\n", err);
    } else {
        printk("Indication confirmed\n");
    }
    
    // 释放资源
    k_free(params);
}

1.2.2 `destroy` - 析构函数（可选）

void (*destroy)(struct bt_gatt_indicate_params *params);

功能：指示完成后用于清理资源的回调

使用场景：

释放动态分配的内存

重置状态标志

示例：

static void params_destroy(struct bt_gatt_indicate_params *params)
{
    struct custom_context *ctx = CONTAINER_OF(params, struct custom_context, params);
    ctx->busy = false;
}

1.2.3 `attr` - 目标特征属性

const struct bt_gatt_attr *attr;

功能：指向要指示的特征值属性

获取方式：

// 在服务定义中获取属性指针
BT_GATT_SERVICE_DEFINE(my_service,
    BT_GATT_PRIMARY_SERVICE(...),
    BT_GATT_CHARACTERISTIC(...) // 索引0: 服务声明, 索引1: 特征声明, 索引2: 特征值
);

// 使用索引获取特征值属性
const struct bt_gatt_attr *char_value_attr = &my_service.attrs[2];

1.2.4 `data` - 数据指针

const void *data;

功能：指向要发送的数据缓冲区的指针
注意事项：
- 数据在发送期间必须保持有效
- 设置为 NULL 将使用特征当前值

典型用法：

uint8_t alert_data = ALERT_HIGH;
params.data = &alert_data;

1.2.5 `len` - 数据长度

uint16_t len;

功能：要发送的数据长度（字节）

注意事项：

设置为 0 且 data 为 NULL 时将使用特征值长度

不能超过 MTU 限制（bt_gatt_get_mtu(conn) - 3）

1.2.6 `_req` - 内部请求结构

struct bt_att_req _req;

功能：协议栈内部使用的请求管理结构

开发者注意事项：

不要直接访问或修改此字段

由协议栈在指示生命周期内管理