为 ESP IDF SDK 中的驱动程序提供安全的 Rust 包装器

亮点

• 实现了 embedded-hal V0.2 和 V1.0 的 trait，包括阻塞和异步
• 支持几乎所有 ESP IDF 驱动程序：GPIO、SPI、I2C、TIMER、PWM、I2S、UART 等
• 每个驱动程序的阻塞和 async 模式（正在开发异步支持）
• 将 esp-idf-sys 重新导出为 esp_idf_hal::sys

您还可以查看 ESP IDF 的 服务 包装器和在 esp-idf-sys crate 中的 ESP IDF 原始绑定！

（对于裸机 Rust ESP 项目，请检查 esp-hal。）

构建先决条件

遵循 esp-idf-template crate 中的 先决条件 部分。

示例

可以使用 cargo-espflash 方便地构建和烧录示例。例如，在 ESP32-C3 上运行 ledc_simple：（将 Rust 目标和示例名称与您的 ESP32 MCU 相对应的目标以及您要构建的示例进行交换）

使用 cargo-espflash

$ MCU=esp32c3 cargo espflash flash --target riscv32imc-esp-espidf --example ledc_simple --monitor

为了在其他芯片上运行示例，您可能需要至少调整所使用的引脚。

使用ESP IDF设置"Hello, world!"二进制crate

使用esp-idf-template项目。所有设置和构建工作将自动完成 - 您无需手动克隆ESP IDF仓库。

更多信息

有关更多信息，请参阅以下内容：

• Rust on ESP 书籍
• ESP嵌入式培训
• esp-idf-template项目
• embedded-hal项目
• esp-idf-svc项目
• embedded-svc项目
• esp-idf-sys项目
• Rust for Xtensa工具链
• Rust-with-STD演示项目

硬件说明

每个芯片都有一些GPIO引脚，通常由SPI0和SPI1外设使用，以连接外部PSRAM和/或SPI闪存。数据表明确指出，不建议使用这些引脚，但为了完整性，此crate仍然包括它们。

请参考下表以确定不建议使用的引脚。

* 当使用八位闪存和/或八位PSRAM时