ccc_mac.h

Go to the documentation of this file.

 
#ifndef CCC_MAC_H
#define CCC_MAC_H
 
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
 
#include "ccc_kdf.h"
 
uint16_t ccc_hop_round_index(uint32_t block_index, uint32_t hop_key_rw, uint32_t n_round);
 
/* ── SP0 frame codec ──────────────────────────────────────────────────────── */
 
#define CCC_MHR_LEN            23
#define CCC_PRE_POLL_LEN       13
#define CCC_FINAL_DATA_HDR_LEN 18
#define CCC_RESPONDER_LEN      7
#define CCC_MAX_RESPONDERS     10
#define CCC_MSG_ID_PRE_POLL    0x01u
#define CCC_MSG_ID_FINAL_DATA  0x02u
 
struct ccc_mhr_fields {
        uint16_t dest_short_addr;              
        uint32_t frame_counter;                
        uint8_t key_source[CCC_KEYSOURCE_LEN]; 
        uint8_t msg_id;                        
        uint8_t payload_len;                   
};
 
int ccc_build_mhr(const struct ccc_mhr_fields *f, uint8_t out[CCC_MHR_LEN]);
 
int ccc_parse_mhr(const uint8_t in[CCC_MHR_LEN], struct ccc_mhr_fields *f);
 
struct ccc_pre_poll {
        uint32_t uwb_session_id; 
        uint32_t poll_sts_index; 
        uint16_t ranging_block;  
        uint8_t hop_flag;        
        uint16_t round_index;    
};
 
int ccc_pre_poll_pack(const struct ccc_pre_poll *p, uint8_t out[CCC_PRE_POLL_LEN]);
 
int ccc_pre_poll_parse(const uint8_t in[CCC_PRE_POLL_LEN], struct ccc_pre_poll *p);
 
struct ccc_responder_ts {
        uint8_t responder_index;       
        uint32_t timestamp;            
        uint8_t timestamp_uncertainty; 
        uint8_t ranging_status;        
};
 
struct ccc_final_data {
        uint32_t uwb_session_id;      
        uint16_t ranging_block;       
        uint8_t hop_flag;             
        uint16_t round_index;         
        uint32_t final_sts_index;     
        uint32_t ranging_ts_final_tx; 
        uint8_t num_responders;       
        struct ccc_responder_ts responders[CCC_MAX_RESPONDERS];
};
 
int ccc_final_data_pack(const struct ccc_final_data *f, uint8_t *out, size_t cap, size_t *len);
 
int ccc_final_data_parse(const uint8_t *in, size_t len, struct ccc_final_data *f);
 
/* ── Ranging schedule ─────────────────────────────────────────────────────── */
 
enum ccc_hop_mode {
        CCC_HOP_NONE = 0,       
        CCC_HOP_CONTINUOUS = 1, 
};
 
enum ccc_slot {
        CCC_SLOT_PRE_POLL,   
        CCC_SLOT_POLL,       
        CCC_SLOT_RESPONSE,   
        CCC_SLOT_FINAL,      
        CCC_SLOT_FINAL_DATA, 
};
 
struct ccc_ran_params {
        uint32_t sts_index0;        
        uint16_t n_slot_per_round;  
        uint16_t n_round;           
        uint8_t n_responder;        
        uint32_t hop_key_rw;        
        enum ccc_hop_mode hop_mode; 
};
 
struct ccc_hop_decision {
        uint8_t hop_flag;     
        uint16_t round_index; 
};
 
uint16_t ccc_block_round(const struct ccc_ran_params *p, uint32_t block);
 
uint32_t ccc_slot_sts_index(const struct ccc_ran_params *p, uint32_t block, uint16_t round,
                            enum ccc_slot slot, uint8_t responder);
 
struct ccc_hop_decision ccc_initiator_next_hop(const struct ccc_ran_params *p, uint32_t block);
 
/* ── Double-sided two-way ranging ─────────────────────────────────────────── */
 
struct ccc_ds_twr {
        uint32_t t_round1; 
        uint32_t t_reply1; 
        uint32_t t_round2; 
        uint32_t t_reply2; 
};
 
uint32_t ccc_ds_twr_tof(const struct ccc_ds_twr *t);
 
int ccc_responder_ds_twr(const struct ccc_final_data *fd, uint8_t responder, uint32_t t_reply1,
                         uint32_t t_round2, struct ccc_ds_twr *out);
 
/* ── URSK lifetime ────────────────────────────────────────────────────────── */
 
#define CCC_STS_INDEX_MAX 0x7FFFFFFFu
 
bool ccc_ursk_exhausted(const struct ccc_ran_params *p, uint32_t block);
 
#endif /* CCC_MAC_H */