ble_hrs_client.h

/*
 * Copyright (c) 2012 - 2026 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
 */
#ifndef BLE_HRS_CLIENT_H__
#define BLE_HRS_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_HRS_CLIENT_DEF(_name)                                                                  \
        static struct ble_hrs_client _name;                                                        \
        NRF_SDH_BLE_OBSERVER(_name##_obs, ble_hrs_client_on_ble_evt, &_name, HIGH)
 
enum ble_hrs_client_evt_type {
        BLE_HRS_CLIENT_EVT_DISCOVERY_COMPLETE,
        BLE_HRS_CLIENT_EVT_HRM_NOTIFICATION,
        BLE_HRS_CLIENT_EVT_BSL_UPDATE,
        BLE_HRS_CLIENT_EVT_ERROR,
};
 
struct ble_hrs_measurement {
        uint16_t hr_value;
        uint8_t rr_intervals_cnt;
        uint16_t rr_intervals[CONFIG_BLE_HRS_CLIENT_RR_INTERVALS_MAX_COUNT];
};
 
struct ble_hrs_handles {
        uint16_t hrm_cccd_handle;
        uint16_t hrm_handle;
        uint16_t bsl_handle;
};
 
struct ble_hrs_client_evt {
        enum ble_hrs_client_evt_type evt_type;
        uint16_t conn_handle;
        union {
                struct {
                        struct ble_hrs_handles handles;
                } discovery_complete;
                struct ble_hrs_measurement hrm_notification;
                struct {
                        uint8_t body_sensor_location;
                } bsl_update;
                struct {
                        uint32_t reason;
                } error;
        };
};
 
struct ble_hrs_client;
 
typedef void (*ble_hrs_client_evt_handler_t)(struct ble_hrs_client *hrs_client,
                                             const struct ble_hrs_client_evt *evt);
 
struct ble_hrs_client {
        uint16_t conn_handle;
        struct ble_hrs_handles handles;
        ble_hrs_client_evt_handler_t evt_handler;
        const struct ble_gq *gatt_queue;
};
 
struct ble_hrs_client_config {
        ble_hrs_client_evt_handler_t evt_handler;
        const struct ble_gq *gatt_queue;
        struct ble_db_discovery *db_discovery;
};
 
uint32_t ble_hrs_client_init(struct ble_hrs_client *hrs_client,
                             const struct ble_hrs_client_config *hrs_client_config);
 
void ble_hrs_client_on_ble_evt(const ble_evt_t *ble_evt, void *ble_hrs_client);
 
uint32_t ble_hrs_client_hrm_notif_enable(struct ble_hrs_client *hrs_client);
 
uint32_t ble_hrs_client_hrm_notif_disable(struct ble_hrs_client *hrs_client);
 
void ble_hrs_on_db_disc_evt(struct ble_hrs_client *hrs_client,
                            const struct ble_db_discovery_evt *evt);
 
uint32_t ble_hrs_client_handles_assign(struct ble_hrs_client *hrs_client, uint16_t conn_handle,
                                       const struct ble_hrs_handles *peer_hrs_handles);
 
#ifdef __cplusplus
}
#endif
 
#endif /* BLE_HRS_CLIENT_H__ */