Device driver toolkit #![no_std]

编写更好的设备驱动程序的工具包，更快速。

此crate包含一组特质，用于表示设备、寄存器和命令。您可以使用宏以方便的方式实现寄存器和命令。

您可以用相当简单的方式为用户提供阻塞和非阻塞的设备接口。

目前您有以下选项

• 使用类似Rust语法的宏：示例
• 从外部json文件生成：示例
• 从外部yaml文件生成：示例

欢迎反馈和功能请求！只需在github上提交一个问题。我想为这个crate添加更多功能，但前提是（或许是你）需要它们。

我意识到文档有些不足，但示例应该相当直观。对于使用此crate的实际驱动程序示例，您还可以查看：https://github.com/diondokter/s2lp

仍然需要

• 添加一次读取多个寄存器的功能
• CLI生成实现（为驱动程序用户提高编译时间）

注意：直到https://github.com/illicitonion/num_enum/pull/77合并，您需要在使用device-driver宏的crate中导入num_enum。这需要添加到Cargo.toml中。尝试从device-driver导入重新导出是不够的。

架构

此crate由三部分组成

• 设备驱动程序：主要包，重新导出所需的一切。它定义了一组代表设备和寄存器的特质。设备特质由驱动程序包实现，以便系统了解如何读写寄存器。所有这些都通过寄存器特质完成，该特质包含有关寄存器的所有信息。可以手动实现寄存器和它们的字段，但此包提供了生成所有内容的非常实用的功能。
• 设备驱动程序生成：这就像是后端。它定义了设备及其寄存器和字段的一种中间表示形式。从那里可以生成实现上述设备驱动程序特质的Rust代码。它还提供了针对各种类型的自定义serde反序列化例程，以便它们可以方便地表达。
• 设备驱动程序宏：包含所有进程宏。一个宏接受定义文件的路径。然后使用serde将其反序列化到'生成'表示形式。另一个宏定义自定义Rust语法并将其转换为'生成'表示形式。然后两者都生成寄存器和它们的字段的实现。

语义版本

任何可能会破坏用户代码的东西都将导致破坏性的语义版本号升级。这包括宏格式和文件寄存器定义格式。

生成和宏包被视为内部包，因此它们在语义版本号升级方面可能不会那么严格。这主要是为了使它们与主包的版本保持一致。

如果您直接依赖这些包，请告诉我！如果我知道它们有直接的用户，我将对版本更加严格。

许可证

根据您的选择，许可如下

• Apache License，版本2.0（LICENSE-APACHE 或 http://www.apache.org/licenses/LICENSE-2.0）
• MIT许可证（LICENSE-MIT 或 http://opensource.org/licenses/MIT）

。

贡献

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

变更日志

未发布

0.7.0 (22-08-24)

• 破坏性：改进了命令分发的API
• 添加了缓冲区支持
• 添加了严格模式转换。这使得类型需要From<原始类型>而不是TryFrom<原始类型>。但读取寄存器字段的结果不再是。
• 向寄存器添加了字节序选项，以便它们可以以小端格式读取和存储。（当未指定时，默认为大端）
• 向寄存器结构添加了BitAnd、BitOr和BitXor。它不像我希望的那样一致，但希望在下一个版本中修复。
• 添加了对寄存器块的支持