46 lines
2.0 KiB
Markdown
46 lines
2.0 KiB
Markdown
# 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-sim` emits 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.
|