switch-hal

Switch-HAL 是一个 no_std 的嵌入式 Rust 库，用于处理按钮、开关、LED 和晶体管。基本上，任何类似开关的东西，无论是输入还是输出。

它既是一个使用 embedded-hal::digital 特性的驱动程序，也是它自己的抽象。它提供了一个简单、零成本的抽象，以阐明您应用程序代码的 意图。

为什么选择 Switch-HAL？为什么不用原始 GPIO 呢？

您是想使该线路处于高电平吗？
还是您想 关闭 那个 LED？
等等……那个 LED 是 高电平有效 吗？
原理图在哪里？
好吧……阴极连接到输入线……这意味着它是低电平有效。

现在在每个需要打开或关闭该 LED 的代码位置重复此过程。
当硬件发生变化时会发生什么？
使用原始 GPIO 设置引脚高电平和低电平将需要在您的代码库中到处进行更改。

如果只需在初始化应用程序时考虑一次，那岂不是更好？
然后从那时起，只需调用 led.on() 或 led.off()。
在适当的级别上有一个抽象可以减少认知负荷。
在应用程序的单个位置指定一个简单的外围设备是高电平有效还是低电平有效可以减少维护负担。

文档

https://docs.rs/crate/switch-hal

或构建本地副本

cargo docs

然后在您的浏览器中打开 target/doc/switch_hal/index.html。

许可证

根据以下任一许可证授权：

• Apache 许可证 2.0 (LICENSE-APACHE 或 https://apache.ac.cn/licenses/LICENSE-2.0)
• MIT 许可证 (LICENSE-MIT 或 http://opensource.org/licenses/MIT)

任选其一。

架构决策记录

主要设计决策记录在adr目录中。

变更日志

0.4.0

新增了StatefulOutputSwitch，感谢forkbomb9

0.3.3

更新嵌入式HAL到0.2.5版本

0.3.2

• 添加了便利转换函数into_active_low_switch()和into_active_high_switch()