ble_bas.h

/*
 * Copyright (c) 2012 - 2024 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
 */
#ifndef BLE_BAS_H__
#define BLE_BAS_H__
 
#include <stdint.h>
#include <stdbool.h>
#include <ble.h>
#include <bm/bluetooth/ble_common.h>
#include <bm/softdevice_handler/nrf_sdh_ble.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define BLE_BAS_DEF(_name)                                                                         \
        static struct ble_bas _name;                                                               \
        NRF_SDH_BLE_OBSERVER(_name##_obs, ble_bas_on_ble_evt, &_name, HIGH)
 
#define BLE_BAS_CONFIG_SEC_MODE_DEFAULT                                                            \
        {                                                                                          \
                .battery_lvl_char = {                                                              \
                        .read = BLE_GAP_CONN_SEC_MODE_OPEN,                                        \
                        .cccd_write = BLE_GAP_CONN_SEC_MODE_OPEN,                                  \
                },                                                                                 \
                .battery_report_ref.read = BLE_GAP_CONN_SEC_MODE_OPEN,                             \
        }
 
#define BLE_BAS_BATTERY_LEVEL_LAST ((uint8_t)0xFF)
 
enum ble_bas_evt_type {
        BLE_BAS_EVT_NOTIFICATION_ENABLED,
        BLE_BAS_EVT_NOTIFICATION_DISABLED,
        BLE_BAS_EVT_ERROR,
};
 
struct  ble_bas_evt {
        enum ble_bas_evt_type evt_type;
        uint16_t conn_handle;
        union {
                struct {
                        uint32_t reason;
                } error;
        };
};
 
/* Forward declaration */
struct ble_bas;
 
typedef void (*ble_bas_evt_handler_t)(struct ble_bas *bas, const struct ble_bas_evt *evt);
 
struct ble_bas_config {
        ble_bas_evt_handler_t evt_handler;
        struct {
                uint8_t report_id;
                uint8_t report_type;
        } *report_ref;
        bool can_notify;
        uint8_t battery_level;
        struct {
                struct {
                        ble_gap_conn_sec_mode_t read;
                        ble_gap_conn_sec_mode_t cccd_write;
                } battery_lvl_char;
                struct {
                        ble_gap_conn_sec_mode_t read;
                } battery_report_ref;
        } sec_mode;
};
 
struct ble_bas {
        ble_bas_evt_handler_t evt_handler;
        uint16_t service_handle;
        uint16_t report_ref_handle;
        ble_gatts_char_handles_t battery_level_handles;
        uint8_t battery_level;
        bool can_notify;
};
 
uint32_t ble_bas_init(struct ble_bas *bas, const struct ble_bas_config *bas_config);
 
uint32_t ble_bas_battery_level_update(struct ble_bas *bas, uint16_t conn_handle,
                                      uint8_t battery_level);
 
void ble_bas_on_ble_evt(const ble_evt_t *ble_evt, void *ble_bas);
 
#ifdef __cplusplus
}
#endif
 
#endif /* BLE_BAS_H__ */