以下为在 ESP-IDF (FreeRTOS) 上运行的 blinky 示例:
https://github.com/esp-rs/esp-idf-hal/blob/master/examples/blinky.rs
rust
//! Blinks an LED
//!
//! This assumes that a LED is connected to GPIO4.
//! Depending on your target and the board you are using you should change the pin.
//! If your board doesn't have on-board LEDs don't forget to add an appropriate resistor.
//!
use esp_idf_hal::delay::FreeRtos; // 导入延迟函数的库
use esp_idf_hal::gpio::*; // 导入GPIO库
use esp_idf_hal::peripherals::Peripherals; // 导入外设库
/*
* fn main() -> anyhow::Result<()> 是程序的入口点,也就是程序开始执行的地方。在Rust语言中,每个可执行程序都必须包含一个main函数作为程序的入口。
*
* fn:这是Rust中定义函数的关键字。
* main():函数名为main,这是Rust中约定俗成的用于表示程序入口的函数名。
* -> anyhow::Result<()>:箭头后面的部分表示函数的返回类型。在这里,anyhow::Result<()> 表示这个函数返回一个 Result 类型。anyhow 是一个用于错误处理的库,Result 是一个枚举类型,可以表示操作成功(Ok)或操作失败(Err)。() 表示空元组,即没有特定的值需要返回。所以,这个函数返回一个可能包含成功或失败信息的 Result。
* 在这个特定的例子中,main 函数的返回类型为 Result,表明它可能会返回错误信息,但是由于注释的规定,我们无法在这个上下文中提供详细的错误信息。通常情况下,如果程序执行成功,main 函数会返回一个 Ok(()),如果出现错误,它会返回一个 Err,其中包含了错误的信息。
*/
fn main() -> anyhow::Result<()> {
// 链接ESP-IDF所需的补丁
esp_idf_sys::link_patches();
// 初始化外设
let peripherals = Peripherals::take().unwrap();
// 创建一个可输出的引脚驱动实例,将其设置为 GPIO4 引脚的输出模式
let mut led = PinDriver::output(peripherals.pins.gpio4)?;
println!("Hello world!"); // 打印"Hello world!"到终端
// 设置一个每 1000 毫秒即切换 LED 开/关状态的无限循环
loop {
led.set_high()?; // 将LED引脚设置为高电平(LED开启状态)
// 在这里进行延迟,以确保不触发看门狗
FreeRtos::delay_ms(1000); // 延迟1秒
led.set_low()?; // 将LED引脚设置为低电平(LED关闭状态)
FreeRtos::delay_ms(1000); // 延迟1秒
}
}
更多示例存放在 esp-idf-hal 仓库中: