Ferris on Air (FoA) is an open source 802.11 stack for the ESP32 written in async rust, with the work of the esp32-open-mac project. The stack is intended to be used with embassy and is still in very early stages of development. We do not claim to be Wi-Fi certified, but implement the features specified by IEEE 802.11 to our best knowledge.
The main FoA crate acts as a multiplexer, that divides access to the hardware up into a number of virtual interfaces (VIF's). These can then be passed to interface implementations, like foa_sta or foa_dswifi. These interface implementations can coexist, enabling things like AP/STA operation in the future.
The foa crate contains the LMAC, TX buffer management and RX ARC buffer management.
foa_sta contains a rudimentary implementation of a station interface.
examples contain a set of examples showing how to use different parts of the stack.
For a concrete usage example, see examples. These examples can be run with ./run_example.sh <EXAMPLE_NAME> <CHIP> [SSID] [LOG_LEVEL].
- Install the ESP32 rust toolchain, by following https://docs.esp-rs.org/book/installation/index.html; for now we only support Xtensa targets, so follow those steps. We're using
no_std, so you don't need to follow thestdsteps. - Install
espflashby runningcargo install espflash - CHIP can be esp32 or esp32s2
- DEFMT_LOG accepts the following logging levels: error, warn, info, debug, trace. Enabling a logging level also enables higher severity logging levels
The docs sometimes contain anecdotes I left during coding, since I believe them to be interesting.
This project is licensed under Apache 2.0 or MIT at your option.