V1.0

2026-06-09 16:39:17 +08:00
commit 41a602f89c
3057 changed files with 771495 additions and 0 deletions
@@ -0,0 +1,286 @@
+/**
+ ****************************************************************************************
+ *
+ * @file lb.h
+ *
+ * @brief Link Broadcaster internal definition
+ *
+ * Copyright (C) RivieraWaves 2009-2015
+ *
+ ****************************************************************************************
+ */
+
+#ifndef LB_INT_H_
+#define LB_INT_H_
+
+#include "rwbt_config.h"
+
+/**
+ ****************************************************************************************
+ * @addtogroup LB Link Broadcaster
+ * @{
+ ****************************************************************************************
+ */
+
+/*
+ * INCLUDE FILES
+ ****************************************************************************************
+ */
+
+#include <stdint.h>          // standard integer
+#include <stdbool.h>         // standard boolean
+
+
+/*
+ * DEFINES
+ ****************************************************************************************
+ */
+
+/// Maximum number of instances of the LB task
+#define LB_IDX_MAX  1
+
+/// Default number broadcast retransmissions
+#define LB_DEFAULT_NBC 2
+
+/// As default CSB lt_addr is not reserved - invalid value 0 denotes this
+#define LB_CSB_LT_ADDR_NOT_RESERVED 0
+
+/// LMP message instant offset, where a specific clock instant is required (in slots)
+#define LB_CLK_ADJ_CLK_TX_INSTANT_OFFSET  10
+
+/// Minimum offset to perform a coarse clock adjust
+#define LB_PCA_MIN_CC_ADJ_US             40
+
+
+/*
+ * ENUMERATIONS
+ ****************************************************************************************
+ */
+
+/// Possible states of the LB task
+enum LB_STATE
+{
+    /// FREE state
+    LB_IDLE,
+    /// WAIT MASTER KEY CFM state message handlers.
+    LB_WAIT_MASTER_KEY_CFM,
+    /// WAIT RESTART ENC CFM state message handlers.
+    LB_WAIT_RESTART_ENC_CFM,
+
+    // Number of states.
+    LB_STATE_MAX
+};
+
+
+
+/*
+ * TYPE DEFINITIONS
+ ****************************************************************************************
+ */
+
+#if PCA_SUPPORT
+/// LC PCA coase clock adjustment Structure
+struct lb_pca_tag
+{
+    /// transaction ID
+    uint8_t         tr_id;
+    /// aggregate coarse clock adjustment period
+    uint8_t         frame_period;
+    /// coarse clock adjustment event id
+    uint8_t         clk_adj_id;
+    /// coarse clock adjustment instant (in 625us BT slots)
+    uint32_t         clk_adj_instant;
+    /// coarse clock adjustment us offset
+    int16_t         clk_adj_us;
+    /// coarse clock adjustment slot offset
+    uint8_t         clk_adj_slots;
+    /// coarse clock adjustment mode
+    uint8_t         clk_adj_mode;
+    /// coarse clock adjustment PDU instant
+    uint32_t         clk_adj_clk;
+    /// clock_adj instant pending
+    bool instant_pending;
+    /// number of pending LMP_clk_adj_ack responses
+    uint8_t pending_clk_adj_acks;
+    /// clk_adj_ack idx flags - one per slave
+    uint16_t clk_adj_ack_flags;
+    /// link id recovery with sscan
+    uint8_t sscan_link_id;
+};
+#endif // PCA_SUPPORT
+
+///LB master key environment structure
+struct master_key
+{
+    /// encryption key size mask
+    uint16_t        enc_key_size_msk;
+    /// encryption mode
+    uint8_t         enc_mode;
+    /// status
+    uint8_t         status;
+    /// in use boolean
+    bool            in_use;
+};
+
+/// LB environment structure
+struct lb_env_tag
+{
+    #if CSB_SUPPORT
+    /// reserved lt_addr for CSB
+    uint8_t             res_lt_addr;
+    /// max packet size for CSB data
+    uint16_t            csb_max_pkt_size;
+    /// CSB mode active flag
+    bool                csb_mode_enabled;
+    /// CSB interval (in half-slots)
+    uint16_t            csb_interval;
+    /// CSB offset (in half-slots)
+    uint16_t            csb_offset;
+    /// CSB buffer pointer
+    uint16_t            buf_ptr;
+    /// CSB buffer size
+    uint16_t            csb_buf_data_len;
+    /// Sync Train service data
+    uint8_t             service_data;
+    #endif // CSB_SUPPORT
+    #if CSB_SUPPORT || PCA_SUPPORT
+    /// Sync Train timeout
+    uint32_t            sync_train_to;
+    /// Sync Train interval
+    uint32_t            sync_train_intv;
+    /// Synchronization_scanTO (in slots)
+    uint16_t            sync_scan_to;
+    /// Sync_Scan_Window (in slots)
+    uint16_t           sync_scan_win;
+    /// Sync_Scan_Interval (in slots)
+    uint16_t           sync_scan_int;
+    #endif // CSB_SUPPORT || PCA_SUPPORT
+    /// Active channel Map for CSB
+    struct chnl_map ch_map;
+
+    /// nb of piconet broadcast acl
+    uint16_t            nb_pic_acl;
+    /// connection handle
+    uint16_t            conhdl;
+    /// act handle
+    uint16_t            act_hdl;
+    /// piconet handle
+    uint16_t            pic_hdl;
+    /// process id count
+    uint16_t            pid_lc_cnt;
+
+    /// nb broadcast retransmissions
+    uint8_t                num_bcst_ret;
+
+    #if PCA_SUPPORT
+    /// Piconet clock adjust data structure
+    struct  lb_pca_tag pca;
+    #endif // PCA_SUPPORT
+
+    /// master key
+    struct master_key   mstkey[MAX_NB_ACTIVE_ACL];
+    /// bd address
+    uint8_t             lid;
+    /// new key flag
+    uint8_t             new_key_flag;
+    /// master key request flag
+    bool                mst_key_req;
+    /// encryption broadcast
+    bool                enc_brcst;
+
+    /// master key
+    struct ltk  LM_MasterKey;
+    /// master random key
+    struct ltk  LM_MasterKeyRand;
+    /// master encryption key
+    struct ltk  LM_MasterEncRand;
+    /// master encryption key size
+    uint8_t     LM_MasterEncKeySize;
+};
+
+
+/*
+ * GLOBAL VARIABLE DEFINITION
+ *****************************************************************************************
+ */
+
+/// LB task descriptor
+extern const struct ke_task_desc TASK_DESC_LB;
+
+/// LB task message handlers table
+extern const struct ke_state_handler lb_default_handler;
+
+/// LB task state
+extern ke_state_t lb_state[LB_IDX_MAX];
+
+/// LB environment variable
+extern struct lb_env_tag lb_env;
+
+
+/*
+ * FUNCTION DECLARATIONS
+ ****************************************************************************************
+ */
+
+/**
+ ****************************************************************************************
+ * @brief Handle the master key creation.
+ *
+ * This function create the master key and send the request over every pid LC
+ ****************************************************************************************
+ */
+void lb_mst_key(void);
+
+/**
+ ****************************************************************************************
+ * @brief Handle the master key creation completion.
+ *
+ * This function create the master key and send the request over every pid LC
+ ****************************************************************************************
+ */
+void lb_mst_key_cmp(uint8_t status, uint16_t conhdl, uint8_t new_key_flag);
+
+/**
+ ****************************************************************************************
+ * @brief Restart encryption
+ *
+ * @param[in] conhdl       Connection handle
+ ****************************************************************************************
+ */
+void lb_mst_key_restart_enc(uint16_t conhdl);
+
+/**
+ ****************************************************************************************
+ * @brief This function start Active Broadcast Encryption link.
+ ****************************************************************************************
+ */
+void lb_mst_start_act_bcst_enc(void);
+
+/**
+ ****************************************************************************************
+ * @brief This function Stop Active Broadcast Encryption.
+ ****************************************************************************************
+ */
+void lb_mst_stop_act_bcst_enc(void);
+
+#if PCA_SUPPORT
+/**
+****************************************************************************************
+* @brief Functions dedicated to send broadcast LMP
+*
+* @param[in] clk_adj_instant   Instant.
+* @param[in] clk_adj_id        Clock Adjust ID.
+* @param[in] clk_adj_us        Adjustment us
+* @param[in] clk_adj_slots     Adjustment slots
+* @param[in] clk_adj_mode      Mode.
+* @param[in] clk_adj_clk       Current clock
+* @param[in] tr_id             Transaction ID
+* *****************************************************************************************
+*/
+void lb_send_pdu_clk_adj(uint32_t clk_adj_instant, uint8_t clk_adj_id, int16_t clk_adj_us, uint8_t clk_adj_slots, uint8_t clk_adj_mode, uint32_t clk_adj_clk, uint8_t tr_id);
+
+#endif //PCA_SUPPORT
+
+/// @} LB
+
+#endif // LB_INT_H_