uwb_seam.h

Overview

the DW3000 entry points the CCC engine owns. Four decadriver calls carry engine behaviour that no caller may skip: arming RX must program the CCC STS for the slot, loading an STS-IV must substitute the CCC STS-V, registering callbacks must insert the Pre-POLL shim, and (re)configuring the PHY is traced. Every call site in this module goes through the helpers below instead of <deca_device_api.h>, so a site added later cannot quietly bypass any of it. scripts/check-uwb-seam.sh enforces that mechanically. Under CONFIG_WOZ_ALIRO the engine supplies the definitions: woz_uwb_arm_rx ccc_shim_rx.c program the CCC key/IV, then arm RX woz_uwb_set_sts_iv ccc_shim_wrap.c substitute the CCC STS-V per frame woz_uwb_set_callbacks uwb_rxdiag.c insert the tally + Pre-POLL shims woz_uwb_configure_phy uwb_rxdiag.c log the PHY configuration The ESP32 port omits uwb_rxdiag.c (it is k_work-based) and supplies the last two from port/woz_seam_stubs.c instead. Below the CONFIG_WOZ_ALIRO tier there is no engine to reach, so each helper inlines to the plain decadriver call. The implementations are free to call the decadriver directly — that is how they reach the hardware, and how a site that has already programmed the STS itself (the self-rearm paths in ccc_shim_rx.c) opts out on purpose.

used by ccc_shim_rx.c ccc_shim_wrap.c uwb_isr.c uwb_min.c uwb_rxdiag.c