peer_manager.h

/*
 * Copyright (c) 2015-2025 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
 */
 
#ifndef PEER_MANAGER_H__
#define PEER_MANAGER_H__
 
#include <stdint.h>
#include <stdbool.h>
#include <ble.h>
#include <ble_gap.h>
#include <bm/bluetooth/peer_manager/peer_manager_types.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
enum pm_peer_id_list_skip {
        PM_PEER_ID_LIST_ALL_ID,
        PM_PEER_ID_LIST_SKIP_NO_ID_ADDR = 1 << 0,
        PM_PEER_ID_LIST_SKIP_NO_IRK = 1 << 1,
        PM_PEER_ID_LIST_SKIP_NO_CAR = 1 << 2,
        PM_PEER_ID_LIST_SKIP_ALL = PM_PEER_ID_LIST_SKIP_NO_IRK | PM_PEER_ID_LIST_SKIP_NO_CAR
};
 
uint32_t pm_init(void);
 
uint32_t pm_register(pm_evt_handler_t event_handler);
 
uint32_t pm_sec_params_set(ble_gap_sec_params_t *sec_params);
 
uint32_t pm_conn_secure(uint16_t conn_handle, bool force_repairing);
 
uint32_t pm_conn_exclude(uint16_t conn_handle, const void *context);
 
void pm_conn_sec_config_reply(uint16_t conn_handle, struct pm_conn_sec_config *conn_sec_config);
 
uint32_t pm_conn_sec_params_reply(uint16_t conn_handle, ble_gap_sec_params_t *sec_params,
                                  const void *context);
 
void pm_local_database_has_changed(void);
 
uint32_t pm_conn_sec_status_get(uint16_t conn_handle, struct pm_conn_sec_status *conn_sec_status);
 
bool pm_sec_is_sufficient(uint16_t conn_handle, struct pm_conn_sec_status *sec_status_req);
 
uint32_t pm_lesc_public_key_set(ble_gap_lesc_p256_pk_t *public_key);
 
uint32_t pm_allow_list_set(const uint16_t *peers, uint32_t peer_cnt);
 
uint32_t pm_allow_list_get(ble_gap_addr_t *addrs, uint32_t *addr_cnt, ble_gap_irk_t *irks,
                           uint32_t *irk_cnt);
 
uint32_t pm_device_identities_list_set(const uint16_t *peers, uint32_t peer_cnt);
 
uint32_t pm_id_addr_set(const ble_gap_addr_t *addr);
 
uint32_t pm_id_addr_get(ble_gap_addr_t *addr);
 
uint32_t pm_privacy_set(const ble_gap_privacy_params_t *privacy_params);
 
uint32_t pm_privacy_get(ble_gap_privacy_params_t *privacy_params);
 
bool pm_address_resolve(const ble_gap_addr_t *addr, const ble_gap_irk_t *irk);
 
uint32_t pm_conn_handle_get(uint16_t peer_id, uint16_t *conn_handle);
 
uint32_t pm_peer_id_get(uint16_t conn_handle, uint16_t *peer_id);
 
uint32_t pm_peer_id_list(uint16_t *peer_list, uint32_t *const list_size,
                         uint16_t first_peer_id, enum pm_peer_id_list_skip skip_id);
 
uint16_t pm_next_peer_id_get(uint16_t prev_peer_id);
 
uint32_t pm_peer_count(void);
 
uint32_t pm_peer_data_load(uint16_t peer_id, enum pm_peer_data_id data_id, void *data,
                           uint32_t *len);
 
uint32_t pm_peer_data_bonding_load(uint16_t peer_id, struct pm_peer_data_bonding *data);
 
uint32_t pm_peer_data_remote_db_load(uint16_t peer_id, struct ble_gatt_db_srv *data,
                                     uint32_t *len);
 
uint32_t pm_peer_data_app_data_load(uint16_t peer_id, void *data, uint32_t *len);
uint32_t pm_peer_data_store(uint16_t peer_id, enum pm_peer_data_id data_id, const void *data,
                            uint32_t len, uint32_t *token);
 
uint32_t pm_peer_data_bonding_store(uint16_t peer_id, const struct pm_peer_data_bonding *data,
                                    uint32_t *token);
 
uint32_t pm_peer_data_remote_db_store(uint16_t peer_id, const struct ble_gatt_db_srv *data,
                                      uint32_t len, uint32_t *token);
 
uint32_t pm_peer_data_app_data_store(uint16_t peer_id, const void *data, uint32_t len,
                                     uint32_t *token);
uint32_t pm_peer_data_delete(uint16_t peer_id, enum pm_peer_data_id data_id);
 
uint32_t pm_peer_new(uint16_t *new_peer_id, struct pm_peer_data_bonding *bonding_data,
                     uint32_t *token);
 
uint32_t pm_peer_delete(uint16_t peer_id);
 
uint32_t pm_peers_delete(void);
uint32_t pm_peer_ranks_get(uint16_t *highest_ranked_peer, uint32_t *highest_rank,
                           uint16_t *lowest_ranked_peer, uint32_t *lowest_rank);
 
uint32_t pm_peer_rank_highest(uint16_t peer_id);
 
#ifdef __cplusplus
}
#endif
 
#endif /* PEER_MANAGER_H__ */