aliro_ranging.h

// Aliro M1-M4 ranging-setup interface: negotiates UWB ranging parameters with the device and
// produces the BLE ranging-control secure channel used to carry the M1-M4 exchange.
/*
 * Copyright (c) 2026 asxeem
 * SPDX-License-Identifier: ISC
 *
 * aliro_ranging — the post-auth Aliro UWB ranging-setup (M1-M4) on ESP32. Thin
 * glue that drives the engine's reader adapter/session (modules/woz_uwb aliro_uwb_
 * adapter + session): on a completed credential-auth it creates a session bound to
 * the derived URSK, emits M1 over the BLE L2CAP channel, feeds inbound M2/M4 back
 * to the engine, and lets the engine negotiate the ranging parameters and start
 * the DW3000 responder itself (via cherry_ccc_shim -> woz_uwb_start_aliro). This
 * replaces the earlier canned-parameter handoff.
 *
 * The DW3000 is single-session, so exactly one ranging session runs at a time.
 * The whole lifecycle stays on the BLE-host task (create/feed/teardown + the
 * engine's transmit/event callbacks are all synchronous), so no locking is needed.
 */
#pragma once
 
#include <stddef.h>
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
int aliro_ranging_init(void);
 
struct aliro_secchan; /* the BleSK ranging channel (from aliro_crypto.h) */
 
int aliro_ranging_start(uint16_t conn_handle, uint32_t session_id, const uint8_t *ursk,
                        struct aliro_secchan *sc_ble);
 
int aliro_ranging_feed(uint16_t conn_handle, const uint8_t *data, size_t len);
 
void aliro_ranging_stop(uint16_t conn_handle);
 
#ifdef __cplusplus
}
#endif