ble_bas_client.h

/*
 * Copyright (c) 2012 - 2026 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
 */
#ifndef BLE_BAS_CLIENT_H__
#define BLE_BAS_CLIENT_H__
 
#include <stdint.h>
#include <ble.h>
#include <bm/bluetooth/ble_db_discovery.h>
#include <bm/bluetooth/ble_gq.h>
#include <bm/softdevice_handler/nrf_sdh_ble.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define BLE_BAS_CLIENT_DEF(_name)                                                                  \
        static struct ble_bas_client _name;                                                        \
        NRF_SDH_BLE_OBSERVER(_name##_obs, ble_bas_client_on_ble_evt, &_name, HIGH)
 
enum ble_bas_client_evt_type {
        BLE_BAS_CLIENT_EVT_DISCOVERY_COMPLETE,
        BLE_BAS_CLIENT_EVT_BATT_NOTIFICATION,
        BLE_BAS_CLIENT_EVT_BATT_READ_RESP,
        BLE_BAS_CLIENT_EVT_ERROR,
};
 
struct ble_bas_client_handles {
        uint16_t bl_cccd_handle;
        uint16_t bl_handle;
};
 
struct ble_bas_client_evt {
        enum ble_bas_client_evt_type evt_type;
        uint16_t conn_handle;
        union {
                struct {
                        struct ble_bas_client_handles handles;
                } discovery_complete;
                struct {
                        uint8_t level;
                } battery;
                struct {
                        uint32_t reason;
                } error;
        };
};
 
struct ble_bas_client;
 
typedef void (*ble_bas_client_evt_handler_t)(struct ble_bas_client *bas_client,
                                             const struct ble_bas_client_evt *evt);
 
struct ble_bas_client {
        uint16_t conn_handle;
        struct ble_bas_client_handles peer_bas_handles;
        ble_bas_client_evt_handler_t evt_handler;
        const struct ble_gq *gatt_queue;
};
 
struct ble_bas_client_config {
        ble_bas_client_evt_handler_t evt_handler;
        const struct ble_gq *gatt_queue;
        struct ble_db_discovery *db_discovery;
};
 
uint32_t ble_bas_client_init(struct ble_bas_client *bas_client,
                             const struct ble_bas_client_config *bas_client_config);
 
void ble_bas_client_on_ble_evt(const ble_evt_t *ble_evt, void *ble_bas_client);
 
uint32_t ble_bas_client_bl_notif_enable(struct ble_bas_client *bas_client);
 
uint32_t ble_bas_client_bl_notif_disable(struct ble_bas_client *bas_client);
 
uint32_t ble_bas_client_bl_read(struct ble_bas_client *bas_client);
 
void ble_bas_on_db_disc_evt(struct ble_bas_client *bas_client,
                            const struct ble_db_discovery_evt *evt);
 
uint32_t ble_bas_client_handles_assign(struct ble_bas_client *bas_client, uint16_t conn_handle,
                                       const struct ble_bas_client_handles *peer_handles);
 
#ifdef __cplusplus
}
#endif
 
#endif /* BLE_BAS_CLIENT_H__ */