ble_conn_state.h

/*
 * Copyright (c) 2015 - 2025 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
 */
 
#ifndef BLE_CONN_STATE_H__
#define BLE_CONN_STATE_H__
 
#include <stdbool.h>
#include <stdint.h>
#include <ble.h>
#include <ble_gap.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
enum ble_conn_state_status {
        BLE_CONN_STATUS_INVALID,
        BLE_CONN_STATUS_DISCONNECTED,
        BLE_CONN_STATUS_CONNECTED,
};
 
#define BLE_CONN_STATE_MAX_CONNECTIONS BLE_GAP_ROLE_COUNT_COMBINED_MAX
 
#define BLE_CONN_STATE_USER_FLAG_INVALID CONFIG_BLE_CONN_STATE_USER_FLAG_COUNT
 
struct ble_conn_state_conn_handle_list {
        uint32_t len;
        uint16_t conn_handles[BLE_CONN_STATE_MAX_CONNECTIONS];
};
 
typedef void (*ble_conn_state_user_function_t)(uint16_t conn_handle, void *ctx);
 
void ble_conn_state_init(void);
 
bool ble_conn_state_valid(uint16_t conn_handle);
 
uint8_t ble_conn_state_role(uint16_t conn_handle);
 
enum ble_conn_state_status ble_conn_state_status(uint16_t conn_handle);
 
bool ble_conn_state_encrypted(uint16_t conn_handle);
 
bool ble_conn_state_mitm_protected(uint16_t conn_handle);
 
bool ble_conn_state_lesc(uint16_t conn_handle);
 
uint32_t ble_conn_state_conn_count(void);
 
uint32_t ble_conn_state_central_conn_count(void);
 
uint32_t ble_conn_state_peripheral_conn_count(void);
 
struct ble_conn_state_conn_handle_list ble_conn_state_conn_handles(void);
 
struct ble_conn_state_conn_handle_list ble_conn_state_central_handles(void);
 
struct ble_conn_state_conn_handle_list ble_conn_state_periph_handles(void);
 
uint16_t ble_conn_state_conn_idx(uint16_t conn_handle);
 
int ble_conn_state_user_flag_acquire(void);
 
bool ble_conn_state_user_flag_get(uint16_t conn_handle, uint16_t flag_index);
 
void ble_conn_state_user_flag_set(uint16_t conn_handle, uint16_t flag_index, bool value);
 
uint32_t ble_conn_state_for_each_connected(ble_conn_state_user_function_t user_function,
                                           void *ctx);
 
uint32_t ble_conn_state_for_each_set_user_flag(uint16_t flag_index,
                                               ble_conn_state_user_function_t user_function,
                                               void *ctx);
 
#ifdef __cplusplus
}
#endif
 
#endif /* BLE_CONN_STATE_H__ */