You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Measure & wire USB-Kestrel TSF-write / TBTT-follow so a USB 8852CU can run a cell node (M6 moving-UE) #579
Part of the scheduled-RAN epic #254; unblocks the portable moving-UE node in #563 (Option B) and the M6 follow-ups (#566).
What
A USB Kestrel (RTL8852CU/8832CU) cannot run a cell node today, because the cell caps gate (examples/cellcaps_ok) requires tsf_write_ok ∧ tbtt_follows_tsf ∧ beacon_backoff_ctl ∧ hw_beacon_txtsf, and over USB the first two are false by policy, not by measurement:
// src/kestrel/RtlKestrelDevice.cpp
c.tsf_write_ok = !_device.is_usb(); // "USB is unmeasured, so it stays refused there"
c.tbtt_follows_tsf = !_device.is_usb();
This was confirmed on hardware (an RTL8852CU on z890p, read with the cellcaps probe):
So it is the same 8852C die as the fleet's 8852CE, correctly identified, with the ACK responder, HW beacon TX-TSF and RX timestamp all present — only the TSF-write / TBTT-follow pair is withheld because it has never been validated over the USB bus.
Why it matters
The M6 moving-UE bench (#563, Option B) needs a portable, battery-friendly UE node. A USB 8852CU is the obvious candidate — but a UE still needs caps_ok (its uplink is a TSF-steered HW beacon). Until the USB TSF path is measured and wired, no USB radio can be a cell UE, and the moving-UE walk has no portable node.
To do
Measure, over USB, on the bench (8852CU/8832CU):
WriteTsf actually moves the TSF by the requested step — a read-add-write against the free-running counter, as the PCIe RTL8852CE bench did (the basis for the PCIe tsf_write_ok).
TBTT follows the TSF: a WriteTsf on an active HW beacon moves its TBTT with it — the USB analogue of tests/kestrel_tbtt_probe.cpp (currently PCIe + 8852C only), witnessed on a second radio.
Wire it: set tsf_write_ok / tbtt_follows_tsf true for USB Kestrel gated on the measurement (by variant / measured flag), so caps_ok passes only where it has been shown to hold.
Rig check: run a cell UE on a USB 8852CU against a known-good DU (over-the-air sync, no PTP needed) and confirm its uplink lands in slot, as the PCIe UEs do.
Notes
beacon_backoff_ctl, hw_beacon_txtsf, ack_responder_ok, hw_rx_timestamp are already true over USB, so only the TSF-write/TBTT pair is in question.
The cellcaps probe used above (examples/cellcaps, reads the cell-gate caps for any USB/PCIe radio) can be PR'd alongside if useful.
DU use over USB additionally needs PTP, which is a separate matter; this issue is scoped to the UE caps.
The cellcaps probe that produced the hardware readout above is merged: #580 (3855c893). build/cellcaps with DEVOURER_VID/PID or DEVOURER_PCIE_BDF prints the cell-gate caps for any radio, so the measure-and-wire work here can re-check cell_node_ok on a USB 8852CU directly.
Activity
examples/cellcaps: print the AdapterCaps that gate a cell node (#580)
josephnef commentedon Nov 14, 2026
The
cellcapsprobe that produced the hardware readout above is merged: #580 (3855c893).build/cellcapswithDEVOURER_VID/PIDorDEVOURER_PCIE_BDFprints the cell-gate caps for any radio, so the measure-and-wire work here can re-checkcell_node_okon a USB 8852CU directly.