Skip to content

RuView v0.9.0 Realtek RTL8720F Beta 1

Pre-release
Pre-release

Choose a tag to compare

View all tags
@ruvnet ruvnet released this 18 Jul 23:49
v0.9.0-realtek-beta.1
8a5af5d
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

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.

Assets 5
Loading