# hisi-rf-core
`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`; applications drive TCP/IP through
`embassy-net` or the optional `smoltcp::phy::Device` adapter. Vendor archives,
ROM symbols, schedulers, TLS, NVS formats, and image packaging stay outside this
crate.
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.