static void on_disconnect(ble_cd_t * p_cd, ble_evt_t const * p_ble_evt) { UNUSED_PARAMETER(p_ble_evt); p_cd->conn_handle = BLE_CONN_HANDLE_INVALID; }

这是一个在 BLE 库中的回调函数，用于处理设备与中心设备（手机等）连接断开的情况。其中，p_cd 是一个指向连接描述符的指针，p_ble_evt 是一个指向 BLE 事件的指针。

在函数体中，首先使用 UNUSED_PARAMETER 宏将 p_ble_evt 参数标记为未使用，然后将连接句柄设置为 BLE_CONN_HANDLE_INVALID，表示设备当前未连接任何中心设备。

相关问题

void sl_notify_gap_evt_to_porting_layer(sl_bt_msg_t *evt) { sl_status_t sc; bd_addr address; uint8_t address_type; struct ble_gap_event event; memset(&event, 0, sizeof(event)); switch (SL_BT_MSG_ID(evt->header)) { // ------------------------------- // This event is generated when an advertisement packet or a scan response // is received from a responder case sl_bt_evt_scanner_legacy_advertisement_report_id: memset(&event, 0, sizeof(event)); event.type = BLE_GAP_EVENT_DISC; event.disc.event_type = convert_to_nimble_adv_type(evt->data.evt_scanner_legacy_advertisement_report.event_flags); event.disc.length_data = evt->data.evt_scanner_legacy_advertisement_report.data.len; event.disc.data = evt->data.evt_scanner_legacy_advertisement_report.data.data; event.disc.addr.type = evt->data.evt_scanner_legacy_advertisement_report.address_type; memcpy(event.disc.addr.val, evt->data.evt_scanner_legacy_advertisement_report.address.addr, 6); event.disc.rssi = evt->data.evt_scanner_legacy_advertisement_report.rssi; notify_ble_event_to_listeners(&event); break; // ------------------------------- // This event indicates that a new connection was opened. case sl_bt_evt_connection_opened_id: event.type = BLE_GAP_EVENT_CONNECT; event.connect.conn_handle = evt->data.evt_connection_opened.connection; app_log_info("BLE connected, conn_id:%d\n", event.connect.conn_handle); notify_ble_event_to_listeners(&event); break; // ------------------------------- // This event indicates that a connection was closed. case sl_bt_evt_connection_closed_id: event.type = BLE_GAP_EVENT_DISCONNECT; event.disconnect.conn.conn_handle = evt->data.evt_connection_closed.connection; event.disconnect.reason = evt->data.evt_connection_closed.reason; app_log_info("BLE disconnected, conn_id:%d, reason:0x%02x\n", event.disconnect.conn.conn_handle, event.disconnect.reason); notify_ble_event_to_listeners(&event); break; case sl_bt_evt_gatt_mtu_exchanged_id: event.type = BLE_GAP_EVENT_MTU; event.mtu.conn_handle = evt->data.evt_gatt_mtu_exchanged.connection; event.mtu.value = evt->data.evt_gatt_mtu_exchanged.mtu; app_log_info("exchange mtu req: %d\n", event.mtu.value); notify_ble_event_to_listeners(&event); break; default: break; } }

这是一个函数的具体实现，实现了将 GAP 事件通知到 porting layer 的功能。函数接收一个 `sl_bt_msg_t` 类型的指针作为参数，根据不同的 GAP 事件类型，将事件转换成 nimble 的 BLE GAP 事件，然后通知给监听器进行处理。其中，不同的 GAP 事件类型包括扫描响应、连接建立、连接断开、MTU 交换等。通过这个函数，可以将不同的 GAP 事件转换成标准的 BLE GAP 事件，方便上层应用进行处理。具体实现细节可以参考代码注释。

详细讲解如何根据以下api和数据结构将数据发送给手机端void ble_controller_init(uint8_t task_priority) int hci_driver_init(void) int bt_enable(bt_ready_cb_t cb)int bt_le_adv_start(const struct bt_le_adv_param *param,const struct bt_data *ad, size_t ad_len, const struct bt_data *sd, size_t sd_len)int bt_le_adv_update_data(const struct bt_data *ad, size_t ad_len,const struct bt_data *sd, size_t sd_len)int bt_le_adv_stop(void)int bt_le_scan_start(const struct bt_le_scan_param *param, bt_le_scan_cb_t cb)int bt_le_scan_stop(void)int bt_le_whitelist_add(const bt_addr_le_t *addr)int bt_le_whitelist_rem(const bt_addr_le_t *addr)int bt_le_whitelist_clear(void)int bt_le_set_chan_map(u8_t chan_map[5])int bt_unpair(u8_t id, const bt_addr_le_t *addr)int bt_conn_get_info(const struct bt_conn *conn, struct bt_conn_info *info)int bt_conn_get_remote_dev_info(struct bt_conn_info *info)int bt_conn_le_param_update(struct bt_conn *conn,const struct bt_le_conn_param *param)int bt_conn_disconnect(struct bt_conn *conn, u8_t reason)struct bt_conn *bt_conn_create_le(const bt_addr_le_t *peer,const struct bt_le_conn_param *param)int bt_conn_create_auto_le(const struct bt_le_conn_param *param)int bt_conn_create_auto_stop(void)int bt_le_set_auto_conn(const bt_addr_le_t *addr,const struct bt_le_conn_param *param)struct bt_conn *bt_conn_create_slave_le(const bt_addr_le_t *peer,const struct bt_le_adv_param *param)int bt_conn_set_security(struct bt_conn *conn, bt_security_t sec)bt_security_t bt_conn_get_security(struct bt_conn *conn)u8_t bt_conn_enc_key_size(struct bt_conn *conn)void bt_conn_cb_register(struct bt_conn_cb *cb)void bt_set_bondable(bool enable)int bt_conn_auth_cb_register(const struct bt_conn_auth_cb *cb)int bt_conn_auth_passkey_entry(struct bt_conn *conn, unsigned int passkey)int bt_conn_auth_cancel(struct bt_conn *conn)int bt_conn_auth_passkey_confirm(struct bt_conn *conn)int bt_conn_auth_pincode_entry(struct bt_conn *conn, const char *pin)int bt_le_read_rssi(u16_t handle,int8_t *rssi)int bt_get_local_address(bt_addr_le_t *adv_addr)int bt_set_tx_pwr(int8_t power)bt_le_adv_parambt_databt_le_scan_parambt_le_conn_parambt_conn，给出一个详细的例程和注释

首先，这一系列的 API 涉及到了 BLE 控制器的初始化、广播、扫描、连接等操作，可以用于实现 BLE 设备与手机端的通信。

以下是一个简单的例程，演示如何使用这些 API 发送数据给手机端：

#include <zephyr.h>
#include <bluetooth/bluetooth.h>
#include <bluetooth/hci.h>

#define DEVICE_NAME "My_BLE_Device"
#define DEVICE_NAME_LEN (sizeof(DEVICE_NAME) - 1)
#define ADV_LEN 3

// 广播数据
static struct bt_data adv_data[] = {
    BT_DATA_BYTES(BT_DATA_FLAGS, (BT_LE_AD_GENERAL | BT_LE_AD_NO_BREDR)),
    BT_DATA_BYTES(BT_DATA_NAME_COMPLETE, DEVICE_NAME, DEVICE_NAME_LEN),
    BT_DATA_BYTES(BT_DATA_MANUFACTURER_DATA, 0x01, 0x02, 0x03),
};

// 扫描回调函数
static void scan_callback(const bt_addr_le_t *addr, s8_t rssi, u8_t adv_type,
                          struct net_buf_simple *buf) {
    // TODO: 处理扫描到的数据
}

void main(void) {
    int err;
    struct bt_le_adv_param adv_param = BT_LE_ADV_PARAM_INIT(
        BT_LE_ADV_OPT_CONNECTABLE | BT_LE_ADV_OPT_USE_NAME,
        BT_GAP_ADV_FAST_INT_MIN, BT_GAP_ADV_FAST_INT_MAX, NULL);
    struct bt_le_scan_param scan_param = BT_LE_SCAN_PARAM_INIT(
        BT_LE_SCAN_TYPE_PASSIVE, BT_LE_SCAN_OPT_NONE, 0, 0);

    // 初始化 BLE 控制器
    err = ble_controller_init(K_PRIO_COOP(2));
    if (err) {
        printk("Failed to initialize BLE controller (err %d)\n", err);
        return;
    }

    // 初始化 HCI 驱动
    err = hci_driver_init();
    if (err) {
        printk("Failed to initialize HCI driver (err %d)\n", err);
        return;
    }

    // 启用 BLE 栈
    err = bt_enable(NULL);
    if (err) {
        printk("Failed to enable Bluetooth (err %d)\n", err);
        return;
    }

    // 开始广播
    err = bt_le_adv_start(&adv_param, adv_data, ARRAY_SIZE(adv_data), NULL, 0);
    if (err) {
        printk("Failed to start advertising (err %d)\n", err);
        return;
    }

    // 开始扫描
    err = bt_le_scan_start(&scan_param, scan_callback);
    if (err) {
        printk("Failed to start scanning (err %d)\n", err);
        return;
    }

    // TODO: 发送数据给手机端

    // 停止扫描
    bt_le_scan_stop();

    // 停止广播
    bt_le_adv_stop();

    // 关闭 BLE 栈
    bt_disable();
}

上面的例程中，我们首先定义了一些常量和变量，包括设备名称、广播数据、扫描参数等。在 `main` 函数中，我们依次调用了 BLE 控制器初始化、HCI 驱动初始化、启用 BLE 栈、开始广播和扫描等操作。然后，我们可以在 TODO 注释处添加发送数据的代码。最后，我们停止扫描、停止广播和关闭 BLE 栈。

需要注意的是，在使用这些 API 之前，我们需要在设备的 DTS 文件中配置好蓝牙硬件的信息，并在 Kconfig 中启用蓝牙支持。此外，还需要在 `prj.conf` 文件中添加以下配置：

CONFIG_BT=y
CONFIG_BT_HCI=y
CONFIG_BT_CONN=y
CONFIG_BT_L2CAP=y
CONFIG_BT_SMP=y
CONFIG_BT_GATT=y
CONFIG_BT_SCAN=y
CONFIG_BT_OBSERVER=y
CONFIG_BT_PERIPHERAL=y
CONFIG_BT_CENTRAL=y
CONFIG_BT_WHITELIST=y
CONFIG_BT_PRIVACY=y

这样，我们才能正确地使用这些 API 来实现 BLE 设备与手机端的通信。