History

Georges 107732b111 Add support for splitting esp32 uart into TX and RX (#754 ) * Add support for splitting esp32 uart into TX and RX * Keeps existing API for uart, but wraps it in Tx and Rx sub-types * Adds split() method similar to embassy-rs nRF/stm32/rp for getting indepdendent TX and RX parts * Implements e-h traits for TX and RX types * Add esp32s3 example * finish implementing * rebase examples * declare new examples * fix fmt * rebase on 0.12.0 * fix fmt * fix fmt * merge embassy_serial_split example with embassy_serial * fix changelog * fix changelog		2023-09-20 13:19:34 +01:00
..
.cargo	Add bare-bones PSRAM support for ESP32-S2	2023-04-25 16:47:57 +02:00
examples	Add support for splitting esp32 uart into TX and RX (#754 )	2023-09-20 13:19:34 +01:00
ld	Update PACs and `xtensa-lx-rt` package (#761 )	2023-08-29 07:58:16 -07:00
src	Add defmt support, make `log` optional (#773 )	2023-09-04 11:29:44 +01:00
build.rs	Add bare-bones PSRAM support for ESP32-S2	2023-04-25 16:47:57 +02:00
Cargo.toml	Bump the MSRV to `1.67`, check the `defmt` feature in MSRV check (#798 )	2023-09-19 05:19:55 -07:00
README.md	Update each HAL package's `README`	2023-08-23 07:42:56 -07:00
rust-toolchain.toml

README.md

esp32s2-hal

no_std HAL for the ESP32 from Espressif.

Implements a number of the traits defined in embedded-hal.

This device uses the Xtensa ISA, which is not officially supported by the Rust compiler. In order to develop for this device, you must use the Rust compiler fork with Xtensa support, found at esp-rs/rust.

Please refer to the documentation for more information.

Documentation

Resources

Getting Started

Installing the Rust Compiler

We provide a tool, espup, for easily installing the Rust toolchain with Xtensa support:

cargo install espup
espup install

Following installation of the Xtensa toolchain, if you are running a Unix-like operating system (macOS, Linux) then you must additionally export the necessary environment variables:

. $HOME/export-esp.sh

See the Installation chapter of The Rust on ESP Book for more details.

License

Licensed under either of:

Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.