Crate rvcsi_core 

rvCSI core

Foundation types for the rvCSI edge RF sensing runtime (ADR-095, ADR-096).

Every CSI source is normalized into a CsiFrame; bounded sequences of frames become a CsiWindow; semantic interpretations become a CsiEvent. A CsiSource is the plugin trait every hardware/file/replay adapter implements. Nothing crosses a language boundary (napi-rs / napi-c) until validate_frame has run and the frame’s ValidationStatus is Accepted or Degraded.

This crate is dependency-light (serde + thiserror only) and no_std-clean in spirit so it can be reused from WASM later.

Structs

AdapterProfile

Capability descriptor for a source — used by validation to bound frames and by health checks to flag unsupported firmware/driver state.

CsiEvent

A detected event with confidence and the evidence windows that justify it.

CsiFrame

One CSI observation at a timestamp, normalized across all sources.

CsiWindow

A bounded window of frames, summarized into per-subcarrier statistics plus scalar motion / presence / quality scores.

EventId

Identifies a semantic event.

FrameId

Identifies one CSI observation within a capture session.

IdGenerator

Monotonic id minter shared by a runtime instance.

QualityScore

Computed usability confidence for a frame, in [0.0, 1.0].

SessionId

Identifies a capture session (one source + one runtime config).

SourceConfig

Parameters for opening a source (mirrors the TS SDK RvCsi.open(...) shape).

SourceHealth

Health snapshot for a source (returned by CsiSource::health and the rvcsi health CLI / rvcsi_health_report MCP tool).

SourceId

Human-readable identifier for a CSI source.

ValidationPolicy

Tunable bounds for the validation pipeline.

WindowId

Identifies a bounded window of frames.

Enums

AdapterKind

Which family of source produced a frame.

CsiEventKind

Kinds of event the runtime emits (ADR-095 FR5).

RvcsiError

Errors surfaced by the rvCSI core, adapters, DSP and event pipeline.

ValidationError

Why a frame was rejected (a hard failure).

ValidationStatus

Outcome of the validation pipeline for a frame.

Traits

CsiSource

The plugin trait every CSI source implements.

Functions

validate_frame

Validate frame against profile and policy, mutating it in place.

Type Aliases

Result

Re-exported result type for the runtime.