Expand description
Chip-neutral radio control and L2 data-plane contracts.
This crate owns the portable controller, runner, configuration, event, and
L2-device contracts. Applications normally depend on the chip-selecting
hisi-rf facade instead of naming this implementation crate directly.
init claims caller-provided static state and returns an exclusive
RadioController. Splitting it yields a WifiController, a
WifiDevice, and the mandatory RadioRunner. Only the runner calls the
chip backend; control methods merely enqueue commands and await completion.
Modules§
- ble
- Chip-neutral Bluetooth Low Energy GAP configuration contracts.
- sle
- Chip-neutral SLE announce and seek configuration contracts.
Structs§
- Backend
Error - Backend error with a stable class and lossless chip-specific context.
- Backend
Timeout - Non-zero timeout for a bounded backend or vendor lifecycle call.
- Blocking
Runner Diagnostics - Observational counters for the blocking
RadioRunnerpath. - Connection
Info - Successful station association.
- Diagnostic
- Allocation-free diagnostic view of a public RF
Error. - Diagnostic
Trace - Fixed-capacity trace attached to one backend error.
- Diagnostic
Trace Entry - One numeric, secret-free backend trace entry.
- Event
Diagnostics - Event queue overflow diagnostics.
- Operation
Timeout - Non-zero end-to-end timeout for one protocol operation.
- Passphrase
- Owned WPA2/WPA3-Personal passphrase that is erased on drop.
- Radio
Config - Radio-wide configuration.
- Radio
Controller - Exclusive unsplit radio ownership.
- Radio
Parts - Enabled protocol handles plus the mandatory runner.
- Radio
Resources - Caller-provided chip resources.
- Radio
Runner - Long-lived owner of a chip backend.
- Radio
State - Static storage for one radio controller and its bounded event queue.
- Scan
Config - Bounded station scan request.
- Scan
Outcome - Result count for a caller-provided scan buffer.
- Scan
Result - One chip-neutral bounded scan result.
- Ssid
- Validated IEEE 802.11 SSID bytes.
- Station
Config - Validated station connection request.
- Wifi
Config - Wi-Fi control-plane defaults.
- Wifi
Controller - Async Wi-Fi control plane. This handle is deliberately not cloneable.
- Wifi
Device - L2 data-plane ownership independent of the control backend.
- Wifi
L2Capabilities - Immutable link-layer identity published by one initialized Wi-Fi backend.
- Wifi
Parts - Separate Wi-Fi control and L2 data-plane ownership.
Enums§
- Backend
Error Class - Stable class for backend-specific failures.
- Diagnostic
Code - Stable identity for a public RF failure.
- Diagnostic
Stage - Stable stage at which a public RF failure was reported.
- Diagnostic
Trace Kind - Stable identity for one bounded backend trace value.
- Error
- Failure to establish or use the radio control plane.
- Management
Frame Protection - IEEE 802.11 management-frame protection policy.
- Personal
Security - Validated Personal-mode security selected for one station connection.
- Recovery
Action - Action a caller or operator can take after a failure.
- SaePwe
- SAE password-element derivation policy.
- Security
- Link-layer security discovered during scan.
- Wifi
Event - Successful and failed state transitions emitted by the runner.
Constants§
- DIAGNOSTIC_
SCHEMA - Versioned machine-readable diagnostic schema.
- DIAGNOSTIC_
TRACE_ CAPACITY - Maximum number of backend trace entries retained by one public error.
Traits§
- Wifi
Backend - Chip backend driven exclusively by
RadioRunner.
Functions§
- init
- Claim one radio instance without invoking its backend.