woz_uwb_facade.h

// Public header for UWB facade: exposes Aliro DS-TWR responder lifecycle and range query; the CCC
// engine is bound and unbound via internal ursk and stop calls.
/*
 * Copyright (c) 2026 asxeem
 * SPDX-License-Identifier: ISC
 * C shim bridging the add-on UWB impl to the Woz FiRa/CCC engine.
 */
#pragma once
#include <stddef.h>
#include <stdint.h>
#include <stdbool.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
int woz_uwb_bind_ursk(const uint8_t *ursk, size_t ursk_len);
 
struct woz_uwb_aliro_cfg {
        uint32_t session_id;         
        uint8_t channel;             
        uint8_t sync_code_index;     
        uint16_t slot_duration_rstu; 
        uint32_t block_duration_ms;  
        uint8_t slot_per_round;      
        uint32_t sts_index0;         
        uint64_t uwb_time_us;        
        const uint8_t *ursk;         
        const uint8_t *ranging_config;
        size_t rc_len; 
};
 
int woz_uwb_start_aliro(const struct woz_uwb_aliro_cfg *cfg);
 
int woz_uwb_prewarm(uint8_t channel, uint8_t sync_code_index);
 
void woz_uwb_stop(void);
 
bool woz_uwb_last_range_cm(int32_t *cm_out);
 
bool woz_uwb_trusted_range_cm(int32_t *cm_out);
 
bool woz_uwb_trusted_range_age_cm(int32_t *cm_out, int64_t *age_ms_out);
 
uint32_t woz_uwb_range_generation(void);
 
bool woz_uwb_trusted_range_after_cm(int32_t *cm_out, uint32_t after);
 
struct woz_uwb_range_integrity {
        bool sts_ok;         
        int16_t sts_quality; 
        uint8_t trust_level; 
};
 
bool woz_uwb_trusted_range_after_checked_cm(int32_t *cm_out, uint32_t after,
                                            struct woz_uwb_range_integrity *ig_out);
 
void woz_uwb_set_range_listener(void (*cb)(void));
 
#ifdef __cplusplus
}
#endif