ble_db_discovery.h

/*
 * Copyright (c) 2013 - 2026 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
 */
 
#include <stdint.h>
#include <zephyr/kernel.h>
#include <ble_gattc.h>
#include <bm/bluetooth/ble_gq.h>
#include <bm/bluetooth/ble_gatt_db.h>
 
#ifndef BLE_DB_DISCOVERY_H__
#define BLE_DB_DISCOVERY_H__
 
#define BLE_DB_DISCOVERY_DEF(_name)                                                                \
        static struct ble_db_discovery _name = {.discovery_in_progress = 0,                        \
                                                .conn_handle = BLE_CONN_HANDLE_INVALID};           \
        NRF_SDH_BLE_OBSERVER(_name##_obs, ble_db_discovery_on_ble_evt, &_name, HIGH)
 
enum ble_db_discovery_evt_type {
        BLE_DB_DISCOVERY_COMPLETE,
        BLE_DB_DISCOVERY_SRV_NOT_FOUND,
        BLE_DB_DISCOVERY_AVAILABLE,
        BLE_DB_DISCOVERY_ERROR,
};
 
struct ble_db_discovery_evt {
        enum ble_db_discovery_evt_type evt_type;
        uint16_t conn_handle;
        union {
                const struct ble_gatt_db_srv *discovered_db;
                ble_uuid_t srv_uuid;
                struct {
                        uint32_t reason;
                } error;
        };
};
 
/* Forward declaration. */
struct ble_db_discovery;
 
typedef void (*ble_db_discovery_evt_handler)(struct ble_db_discovery *db_discovery,
                                             struct ble_db_discovery_evt *evt);
 
struct ble_db_discovery_config {
        ble_db_discovery_evt_handler evt_handler;
        const struct ble_gq *gatt_queue;
};
 
struct ble_db_discovery {
        struct ble_gatt_db_srv services[CONFIG_BLE_DB_DISCOVERY_MAX_SRV];
        ble_uuid_t registered_uuids[CONFIG_BLE_DB_DISCOVERY_MAX_SRV];
        ble_db_discovery_evt_handler evt_handler;
        const struct ble_gq *gatt_queue;
        uint32_t num_registered_uuids;
        uint8_t srv_count;
        uint8_t curr_char_idx;
        uint8_t curr_srv_idx;
        uint8_t discoveries_count;
        bool discovery_in_progress;
        uint16_t conn_handle;
        uint32_t pending_usr_evt_idx;
        struct ble_db_discovery_evt pending_usr_evts[CONFIG_BLE_DB_DISCOVERY_MAX_SRV];
};
 
uint32_t ble_db_discovery_init(struct ble_db_discovery *db_discovery,
                               const struct ble_db_discovery_config *db_config);
 
uint32_t ble_db_discovery_start(struct ble_db_discovery *db_discovery, uint16_t conn_handle);
 
uint32_t ble_db_discovery_service_register(struct ble_db_discovery *db_discovery,
                                           const ble_uuid_t *uuid);
 
void ble_db_discovery_on_ble_evt(const ble_evt_t *ble_evt, void *ble_db_discovery);
 
#endif /* BLE_DB_DISCOVERY_H__ */