hisi-rf-core owns the chip-neutral radio contracts for the hispark-rs
ecosystem. It provides Wi-Fi control, L2 device ownership, a mandatory
background runner, and bounded events without owning an IP stack. Applications
normally select a chip through the hisi-rf facade; backend crates implement
the contracts defined here.
Chip repositories implement WifiBackend; the current WS63 application path uses
the optional smoltcp::phy::Device adapter. Vendor archives,
ROM symbols, schedulers, TLS, NVS formats, and image packaging stay outside this
crate.
The experimental embassy-net-driver feature adds caller-owned l2::L2Storage
and a standard driver over instance queues. It does not yet wire the WS63 global
callback bridge or ship an Embassy Net named profile. See the
L2 ownership contract for token, link and test boundaries.
Public errors expose an allocation-free, versioned diagnostic view with stable machine codes and recovery actions. The diagnostic schema deliberately excludes SSID, passphrase, key material, and arbitrary backend text while preserving a lossless numeric backend code. Schema v2 additionally carries an immutable backend profile revision and a fixed four-entry numeric trace, so protocol stages and raw status values remain observable without allocation or text logs.
This crate has no PAC, radio blob, scheduler, allocator, ROM, NVS, TLS, or image format dependency. It is an early alpha; the public surface may change while the single-dependency facade and WS63 backend are stabilized.
The incremental-backend-experiment feature exposes the non-default A5B
operation protocol: generation-tagged identities, explicit cancellation,
bounded work reports, a deterministic runner state machine, and fair command,
backend, L2 RX, and timer wake selection. The validated blocking backend remains
the default until host interleaving and silicon parity gates pass.