OpenPuck/ReversePuckFirmware/radio.h

// radio.h -- bare-metal nRF52 RADIO (ESB-style) hardware layer.
//
// *** VERBATIM COPY of OpenPuck/radio.h -- keep byte-identical. ***
// The controller emulator speaks the SAME 2.4 GHz PHY/CRC/address layer as the puck; only the
// roles are inverted (we answer polls instead of issuing them). Arduino compiles a sketch folder
// flat, so this file is duplicated rather than shared. If you change the radio layer in OpenPuck,
// mirror it here (and vice-versa) -- the two MUST agree on the air.
//
// Register-confirmed config (decoded from real-puck capture): PHY=Ble_2Mbit, ENDIAN=Big (MSB-first),
// whitening off, addr "ibex", CRC16 poly 0x11021 init 0xFFFF (address included). On-air address =
// bitrev8 of stored bytes.
#pragma once
#include <stdint.h>
#include <Arduino.h>

// Bounded radio-disable wait: NEVER spin forever. A wedged RADIO would hang the main loop (USB stops
// being serviced -> device "dies" until replug). On timeout we bail; the next rfConfig re-inits.
#define RWAIT_DISABLED()                                   \
	do {                                               \
		uint32_t _w = micros();                    \
		while (!NRF_RADIO->EVENTS_DISABLED &&      \
		       (uint32_t)(micros() - _w) < 3000) { \
		}                                          \
	} while (0)

// Discovery/reconnect address (IBEX FUN_00019000, firmware-derived, definitive):
//   base = "ibex" (69 62 65 78), prefix = 0x10, channel = 2.
extern const uint8_t PAIR_BASE[4]; // "ibex"
extern uint8_t g_rfPrefix; // discovery prefix
extern uint8_t g_rfCh; // current TX/RX channel
extern uint8_t g_rfBase[4]; // "ibex"
// connected-session channel: a CLEAN data channel off the congested adv ch2
extern uint8_t g_sessCh;

// Session address (base+prefix). On the puck this is per-device and advertised; on the controller
// emulator it is ADOPTED from the puck's E1 host frame (the puck advertises it; we follow).
extern uint8_t g_sessBase[4];
extern uint8_t g_sessPrefix;
void rfGenSessionAddr();

// RADIO DMA buffers (>= MAXLEN+2; the controller's 0x43-augmented F1 is ~66B)
extern uint8_t rfrx[100], rftx[100];
extern uint32_t g_rfRxCount;

// ---- tunable radio parameters ----
extern uint32_t g_crcinit;
extern uint8_t g_whiteiv;
extern uint8_t g_mode; // RADIO_MODE_MODE_* (real puck = Ble_2Mbit)
extern uint32_t g_pcnf0; // S0LEN0, LFLEN8, S1LEN3 (ESB DPL) -- CRC-VALIDATED
extern uint8_t g_statlen; // static-mode payload length
extern uint32_t g_pcnf1; // ENDIAN=Big, BALEN4, MAXLEN96 -- CRC-VALIDATED
extern uint32_t g_crcpoly;
extern uint16_t g_crccnf; // CRC16, address included
extern uint8_t g_pid;
extern uint8_t g_balen; // ESB 5-byte addr
// false = bitrev8 prefix (ESB addr_conv); true = raw prefix byte
extern bool g_prefixRaw;

uint8_t rfBitrev8(uint8_t x);
// Access address (IBEX FUN_00037530): BASE0 = bitrev8 each base byte packed big-endian; PREFIX0 = raw
// or bitrev8 prefix per g_prefixRaw. "ibex" 69 62 65 78 -> BASE0=0x9646A61E, PREFIX0=0x10.
void rfSetAddr(const uint8_t b4[4], uint8_t prefix);
// Program MODE/FREQUENCY/PCNF/CRC/whitening from the tunables above onto channel ch (radio left disabled).
void rfConfig(uint8_t ch);