Measure & wire USB-Kestrel TSF-write / TBTT-follow so a USB 8852CU can run a cell node (M6 moving-UE)

Open
#579 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
12/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
cpp
Domain
networking

Research direction

Start in src/kestrel/RtlKestrelDevice.cpp where tsf_write_ok and tbtt_follows_tsf are forced false for USB, and read the PCIe path that sets them from measurement. The USB analogue to build on is tests/kestrel_tbtt_probe.cpp (PCIe/8852C only) plus the cellcaps probe in examples/cellcaps, which produced the caps dump in the issue. Done means a measured TSF write and TBTT-follow on a USB 8852CU, the two caps gated on that measurement, and a cell UE landing its uplink in slot. This needs the physical radio on the bench, so it is not a code-only start.

Written by the indexing model from the issue text.

Description

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/cell caps_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):

{"radio":"usb 0bda:c85a","chip":"RTL8852C","variant":"C8852C","transport":"usb",
 "tsf_write_ok":0,"tbtt_follows_tsf":0,"beacon_backoff_ctl":1,"hw_beacon_txtsf":1,
 "ack_responder_ok":1,"hw_rx_timestamp":1,"hw_injected_mgmt_txtsf":1,"cell_node_ok":0}

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

  1. 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.
  2. 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.
  3. 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.

🤖 Generated with Claude Code

Dominant language
C
Stars
56
Forks
29
Avg merge
3h 43m
Merged PRs (30d)
75

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from OpenIPC/devourer

All issues in OpenIPC/devourer

Similar issues

More C issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.