esp8266-hal

⚠️ 注意 这个 HAL 现已进入维护模式。目前没有计划进一步开发，但 PR 仍然可以接受。

用 Rust 编写的 ESP8266 的实验性硬件抽象层。

加入讨论： https://matrix.to/#/#esp-rs:matrix.org！

一个使用此包的示例项目可以在 这里 找到。

设置编译器

为了构建 Xtensa 架构的 Rust，您必须使用 esp-rs/rust 编译器分支。

这可以通过在 esp-rs/rust-build 仓库中找到的安装脚本和预构建工件来安装。或者，您可以从源代码构建和安装编译器。

有关 Rust 编译器分支的更多信息，请参阅 安装 Rust 部分 Rust 在 ESP 书籍。

使用安装脚本

Linux/macOS

$ curl -LO https://raw.githubusercontent.com/esp-rs/rust-build/main/install-rust-toolchain.sh
$ chmod +x install-rust-toolchain.sh
$ ./install-rust-toolchain.sh

Windows

PS> Invoke-WebRequest https://raw.githubusercontent.com/esp-rs/rust-build/main/Install-RustToolchain.ps1 -OutFile Install-RustToolchain.ps1
PS> .\Install-RustToolchain.ps1

Rust with Podman

或者您可能在已经预安装了 Rust 和 ESP-IDF 的容器中构建项目。

$ podman run --device /dev/ttyUSB0 -it docker.io/espressif/idf-rust

这个容器缺少 ESP8266 的工具，但您可以使用这些说明在容器内部安装它们

$ apt update && apt install gcc-xtensa-lx106 binutils-xtensa-lx106

烧录示例

安装了 Rust 编译器分支后，您可以使用 cargo-espflash 烧录示例

$ cargo install cargo-espflash
$ cargo espflash --release --example blinky /dev/ttyUSB0

许可协议

许可协议为以下之一

• Apache许可证，版本2.0（LICENSE-APACHE 或 https://apache.ac.cn/licenses/LICENSE-2.0）
• MIT许可证（《LICENSE-MIT》或 http://opensource.org/licenses/MIT）

由您自行选择。

贡献

除非您明确声明，否则根据Apache-2.0许可证定义，您有意提交以包含在工作中的任何贡献，都将根据上述条款双许可，不附加任何额外条款或条件。