ble_hrs.h

/*
 * Copyright (c) 2012 - 2024 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
 */
#ifndef BLE_HRS_H__
#define BLE_HRS_H__
 
#include <stdint.h>
#include <stdbool.h>
#include <ble.h>
#include <bm/bluetooth/ble_conn_params.h>
#include <bm/softdevice_handler/nrf_sdh_ble.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define BLE_HRS_DEF(_name)                                                                         \
        static struct ble_hrs _name;                                                               \
        NRF_SDH_BLE_OBSERVER(_name##_obs, ble_hrs_on_ble_evt, &_name, HIGH)
 
#define BLE_HRS_CONFIG_SEC_MODE_DEFAULT                                                            \
        {                                                                                          \
                .hrm_char = {                                                                      \
                        .cccd_write = BLE_GAP_CONN_SEC_MODE_OPEN,                                  \
                },                                                                                 \
                .bsl_char.read = BLE_GAP_CONN_SEC_MODE_OPEN,                                       \
        }
 
#define BLE_HRS_BODY_SENSOR_LOCATION_OTHER 0
#define BLE_HRS_BODY_SENSOR_LOCATION_CHEST 1
#define BLE_HRS_BODY_SENSOR_LOCATION_WRIST 2
#define BLE_HRS_BODY_SENSOR_LOCATION_FINGER 3
#define BLE_HRS_BODY_SENSOR_LOCATION_HAND 4
#define BLE_HRS_BODY_SENSOR_LOCATION_EAR_LOBE 5
#define BLE_HRS_BODY_SENSOR_LOCATION_FOOT 6
enum ble_hrs_evt_type {
        BLE_HRS_EVT_NOTIFICATION_ENABLED,
        BLE_HRS_EVT_NOTIFICATION_DISABLED,
        BLE_HRS_EVT_ERROR,
};
 
struct ble_hrs_evt {
        enum ble_hrs_evt_type evt_type;
        uint16_t conn_handle;
        union {
                struct {
                        uint32_t reason;
                } error;
        };
};
 
/* Forward declaration */
struct ble_hrs;
 
typedef void (*ble_hrs_evt_handler_t)(struct ble_hrs *hrs, const struct ble_hrs_evt *evt);
 
struct ble_hrs_config {
        ble_hrs_evt_handler_t evt_handler;
        bool is_sensor_contact_supported;
        uint8_t *body_sensor_location;
        struct {
                struct {
                        ble_gap_conn_sec_mode_t cccd_write;
                } hrm_char;
                struct {
                        ble_gap_conn_sec_mode_t read;
                } bsl_char;
        } sec_mode;
};
 
struct ble_hrs {
        ble_hrs_evt_handler_t evt_handler;
        uint16_t service_handle;
        uint16_t conn_handle;
        ble_gatts_char_handles_t hrm_handles;
        ble_gatts_char_handles_t bsl_handles;
        uint16_t rr_interval[CONFIG_BLE_HRS_MAX_BUFFERED_RR_INTERVALS];
        uint16_t rr_interval_count;
        uint8_t max_hrm_len;
        bool is_sensor_contact_supported;
        bool is_sensor_contact_detected;
};
 
uint32_t ble_hrs_init(struct ble_hrs *hrs, const struct ble_hrs_config *hrs_config);
 
void ble_hrs_conn_params_evt(struct ble_hrs *hrs, const struct ble_conn_params_evt *conn_param_evt);
 
uint32_t ble_hrs_heart_rate_measurement_send(struct ble_hrs *hrs, uint16_t heart_rate);
 
uint32_t ble_hrs_rr_interval_add(struct ble_hrs *hrs, uint16_t rr_interval);
 
bool ble_hrs_rr_interval_buffer_is_full(struct ble_hrs *hrs);
 
uint32_t ble_hrs_sensor_contact_supported_set(struct ble_hrs *hrs,
                                              bool is_sensor_contact_supported);
 
uint32_t ble_hrs_sensor_contact_detected_update(struct ble_hrs *hrs,
                                                bool is_sensor_contact_detected);
 
uint32_t ble_hrs_body_sensor_location_set(struct ble_hrs *hrs, uint8_t body_sensor_location);
 
void ble_hrs_on_ble_evt(const ble_evt_t *ble_evt, void *ble_hrs);
 
#ifdef __cplusplus
}
#endif
 
#endif /* BLE_HRS_H__ */