f023b5f611
Pushes all work done in the topic-ble-llcp branch into main branch This is a refactoring of the LL control procedures; the refactored control procedures are hidden behind a KConfig option and per default disabled Goal of the refactoring: close issue Link Layer Control Procedure overhaul #15256 make it easier to add/update control procedures Refactoring consists in principal of writing explicit state machines for the control procedures. To reduce the risk of regression errors unit-tests have been added Following control procedures are implemented: Connection update procedure Channel map update procedure Encryption procedure Feature exchange procedure Version exchange procedure ACL termination procedure Connection parameters request procedure LE Ping procedure Data Length Update procedure PHY update procedure Min. nr. Of channels used procedure Constant Tone extension request procedure This is a joined work by the people listed in the signed-off-by list (in alphabetical order) Signed-off-by: Andries Kruithof Andries.Kruithof@nordicsemi.no Signed-off-by: Erik Brockhoff erbr@oticon.com Signed-off-by: Piotr Pryga piotr.pryga@nordicsemi.no Signed-off-by: Szymon Janc szymon.janc@codecoup.pl Signed-off-by: Thomas Ebert Hansen thoh@oticon.com Signed-off-by: Tommie Skriver tosk@demant.com Signed-off-by: Andries Kruithof <Andries.Kruithof@nordicsemi.no>
161 lines
4.0 KiB
C
161 lines
4.0 KiB
C
/*
|
||
* Copyright (c) 2020 Demant
|
||
*
|
||
* SPDX-License-Identifier: Apache-2.0
|
||
*/
|
||
|
||
/* Temporary data structure to avoid change ll_conn/lll_conn to much
|
||
* and having to update all the dependencies
|
||
*/
|
||
|
||
enum { ULL_CP_CONNECTED, ULL_CP_DISCONNECTED };
|
||
|
||
/**
|
||
* @brief Initialize the LL Control Procedure system.
|
||
*/
|
||
void ull_cp_init(void);
|
||
|
||
/**
|
||
* @brief Initialize the LL Control Procedure connection data.
|
||
*/
|
||
void ull_llcp_init(struct ll_conn *conn);
|
||
|
||
/**
|
||
* @brief XXX
|
||
*/
|
||
void ull_cp_state_set(struct ll_conn *conn, uint8_t state);
|
||
|
||
/**
|
||
*
|
||
*/
|
||
void ull_cp_release_tx(struct ll_conn *conn, struct node_tx *tx);
|
||
|
||
/**
|
||
*
|
||
*/
|
||
void ull_cp_release_ntf(struct node_rx_pdu *ntf);
|
||
|
||
/**
|
||
* @brief Run pending LL Control Procedures.
|
||
*/
|
||
void ull_cp_run(struct ll_conn *conn);
|
||
|
||
/**
|
||
* @brief Handle TX ack PDU.
|
||
*/
|
||
void ull_cp_tx_ack(struct ll_conn *conn, struct node_tx *tx);
|
||
|
||
/**
|
||
* @brief Handle received LL Control PDU.
|
||
*/
|
||
void ull_cp_rx(struct ll_conn *conn, struct node_rx_pdu *rx);
|
||
|
||
#if defined(CONFIG_BT_CTLR_LE_PING)
|
||
/**
|
||
* @brief Initiate a LE Ping Procedure.
|
||
*/
|
||
uint8_t ull_cp_le_ping(struct ll_conn *conn);
|
||
#endif /* CONFIG_BT_CTLR_LE_PING */
|
||
|
||
/**
|
||
* @brief Initiate a Version Exchange Procedure.
|
||
*/
|
||
uint8_t ull_cp_version_exchange(struct ll_conn *conn);
|
||
|
||
/**
|
||
* @brief Initiate a Feature Exchange Procedure.
|
||
*/
|
||
uint8_t ull_cp_feature_exchange(struct ll_conn *conn);
|
||
|
||
#if defined(CONFIG_BT_CTLR_MIN_USED_CHAN)
|
||
/**
|
||
* @brief Initiate a Minimum used channels Procedure.
|
||
*/
|
||
uint8_t ull_cp_min_used_chans(struct ll_conn *conn, uint8_t phys, uint8_t min_used_chans);
|
||
#endif /* CONFIG_BT_CTLR_MIN_USED_CHAN */
|
||
|
||
/**
|
||
* @brief Initiate a Encryption Start Procedure.
|
||
*/
|
||
uint8_t ull_cp_encryption_start(struct ll_conn *conn, const uint8_t rand[8], const uint8_t ediv[2],
|
||
const uint8_t ltk[16]);
|
||
|
||
/**
|
||
* @brief Initiate a Encryption Pause Procedure.
|
||
*/
|
||
uint8_t ull_cp_encryption_pause(struct ll_conn *conn, const uint8_t rand[8], const uint8_t ediv[2],
|
||
const uint8_t ltk[16]);
|
||
|
||
/**
|
||
* @brief Check if an encryption pause procedure is active.
|
||
*/
|
||
uint8_t ull_cp_encryption_paused(struct ll_conn *conn);
|
||
|
||
/**
|
||
*/
|
||
void ull_cp_ltk_req_reply(struct ll_conn *conn, const uint8_t ltk[16]);
|
||
|
||
/**
|
||
*/
|
||
void ull_cp_ltk_req_neq_reply(struct ll_conn *conn);
|
||
|
||
/**
|
||
* @brief Initiate a PHY Update Procedure.
|
||
*/
|
||
uint8_t ull_cp_phy_update(struct ll_conn *conn, uint8_t tx, uint8_t flags, uint8_t rx,
|
||
uint8_t host_initiated);
|
||
|
||
/**
|
||
* @brief Initiate a Connection Parameter Request Procedure or Connection Update Procedure
|
||
*/
|
||
uint8_t ull_cp_conn_update(struct ll_conn *conn, uint16_t interval_min, uint16_t interval_max,
|
||
uint16_t latency, uint16_t timeout);
|
||
|
||
/**
|
||
* @brief Accept the remote device’s request to change connection parameters.
|
||
*/
|
||
void ull_cp_conn_param_req_reply(struct ll_conn *conn);
|
||
|
||
/**
|
||
* @brief Reject the remote device’s request to change connection parameters.
|
||
*/
|
||
void ull_cp_conn_param_req_neg_reply(struct ll_conn *conn, uint8_t error_code);
|
||
|
||
/**
|
||
* @brief Check if a remote data length update is in the works.
|
||
*/
|
||
uint8_t ull_cp_remote_dle_pending(struct ll_conn *conn);
|
||
|
||
/**
|
||
* @brief Initiate a Termination Procedure.
|
||
*/
|
||
uint8_t ull_cp_terminate(struct ll_conn *conn, uint8_t error_code);
|
||
|
||
/**
|
||
* @brief Initiate a Channel Map Update Procedure.
|
||
*/
|
||
uint8_t ull_cp_chan_map_update(struct ll_conn *conn, const uint8_t chm[5]);
|
||
|
||
/**
|
||
* @brief Check if Channel Map Update Procedure is pending
|
||
*/
|
||
const uint8_t *ull_cp_chan_map_update_pending(struct ll_conn *conn);
|
||
|
||
#if defined(CONFIG_BT_CTLR_DATA_LENGTH)
|
||
/**
|
||
* @brief Initiate a Data Length Update Procedure.
|
||
*/
|
||
uint8_t ull_cp_data_length_update(struct ll_conn *conn, uint16_t max_tx_octets,
|
||
uint16_t max_tx_time);
|
||
#endif /* CONFIG_BT_CTLR_DATA_LENGTH */
|
||
/**
|
||
* @brief Initiate a CTE Request Procedure.
|
||
*/
|
||
uint8_t ull_cp_cte_req(struct ll_conn *conn, uint8_t min_cte_len, uint8_t cte_type);
|
||
|
||
/**
|
||
* @brief Enable or disable response to CTE Request Procedure.
|
||
*/
|
||
void ull_cp_cte_rsp_enable(struct ll_conn *conn, bool enable, uint8_t max_cte_len,
|
||
uint8_t cte_types);
|