OpenPuck/OpenController/ctrl_bonds.h

// ctrl_bonds.h -- the emulated controller's bonds to pucks.
//
// A real Steam Controller bonds to up to two pucks under the Zephyr settings keys `esb/bond` (slot 0)
// and `esb/bond_2` (slot 1). We mirror that: two slots, each holding the 24-byte bond record
//   rec = [proteus_uuid 4 LE][ibex_uuid 4 LE][puck_serial 16]
// -- the SAME 24-byte shape Steam writes to the puck via 0xA2, except the trailing serial is the
// PUCK's (the peer), not the controller's. The 8-byte uuid key is identical on both sides and is what
// matches the puck's E1 host frame at reconnect. Persists to LittleFS `/ctrlbond.bin`.
#pragma once
#include <stdint.h>

#define NBOND 2

struct CtrlBond {
	uint8_t rec[24]; // [proteus_uuid 4][ibex_uuid 4][puck_serial 16]
	bool used;
	// feature-report reply staging (filled in ISR, read on GET)
	uint8_t resp[63];
	uint16_t resp_len;
};
extern CtrlBond g_bond[NBOND];
extern volatile bool g_bondDirty; // bonds changed -> flush to flash from loop()

bool ctrlRecEmpty(const uint8_t *r);
void loadCtrlBonds();
void saveCtrlBonds();
// Find a bond slot matching a puck E1 host frame's [proteus_uuid 4][ibex_uuid 4]; -1 if none.
int ctrlBondMatch(const uint8_t *proteus_uuid, const uint8_t *ibex_uuid);