RuView v0.9.0-realtek-beta.1
This prerelease introduces the Rust-first RTL8720F 2.4 GHz radar transport and
RuView ingestion path. It is intentionally simulator-validated until Realtek
hardware and the vendor SDK callback ABI arrive.
Included
- ADR-263 records the upstream Ameba integration and licensing boundary.
- ADR-264 defines a versioned, bounded, CRC-protected radar envelope.
rtl8720f-simemits deterministic CFR, near-range, far-range, interference,
and capability reports to UDP or replay files.- The sensing server validates RTL8720F datagrams, publishes bounded summaries
over/ws/sensing, and exposes the latest report at
/api/v1/radar/latest. - Synthetic provenance is retained end to end as
realtek:simulated; simulator
data is never presented as hardware data.
Compatibility
The adapter tracks the radar control surface proposed by Ameba RTOS pull
request #1336 (wifi_radar_config, AT+RAD, and AT+RADDBG). The stable Ameba
RTOS v1.2.1 release does not yet expose the complete radar receive callback ABI,
so no vendor-private headers or binary libraries are copied into this release.
Validation status
- Rust codec round trips, corruption rejection, size bounds, and deterministic
simulator tests pass. - RuView server ingestion, REST reporting, and source provenance were exercised
end to end over loopback UDP. - Windows release binaries are built from this branch and accompanied by
SHA-256 checksums.
Known limitations
- No physical RTL8720F board has been flashed or measured.
- The vendor report callback and exact report layouts remain an SDK/hardware
validation gate; the adapter boundary may change when those arrive. - This beta exposes transport and aggregate radar observability. Radar-to-pose,
vital-sign inference, RF calibration, and accuracy claims are not enabled. - 2.4 GHz radar reports are not mislabeled as mmWave or Wi-Fi CSI events.
Do not deploy this prerelease for safety-critical, medical, or occupancy billing
uses. It is an integration beta for SDK and hardware bring-up.