adafruit-macropad - Adafruit Macropad 的板级支持

如果你正在编写需要在 Adafruit Macropad 上运行的代码 - Adafruit 的一个3x4键盘和OLED组合板，则应包含此crate。

此crate包括 rp2040-hal，但同时也根据Feather上的连接方式配置了RP2040芯片的每个引脚。

使用方法

要使用此crate，你的 Cargo.toml 文件应包含

adafruit-macropad = "0.8.0"

在你的程序中，你需要调用 adafruit_macropad::Pins::new 来创建一个新的 Pins 结构。这将设置所有板载设备的GPIO。有关详细信息，请参阅 示例文件夹。

示例

一般说明

要编译示例，克隆 rp-hal-boards 仓库并运行

rp-hal-boards/boards/adafruit-macropad $ cargo build --release --example <name>

你将得到一个名为 ./target/thumbv6m-none-eabi/release/examples/<name> 的ELF文件，其中 target 文件夹位于 rp-hal-boards 仓库签出的顶部。通常你还需要指定 --target=thumbv6m-none-eabi，但当你从此git仓库构建示例时，这被设置为默认值。

如果你想将ELF文件转换为UF2并将其自动复制到由RP2040引导加载程序导出的USB驱动器，只需将板子启动到引导加载程序模式并运行

rp-hal-boards/boards/adafruit-macropad $ cargo run --release --example <name>

如果你收到关于找不到 elf2uf2-rs 的错误，请尝试

$ cargo install elf2uf2-rs, then repeating the `cargo run` command above.

贡献

贡献使开源社区成为一个学习、灵感和创作的绝佳场所。你做出的任何贡献都将被 高度重视。

步骤如下

1. 通过点击页面顶部的“Fork”按钮来分支项目。
2. 创建您的特性分支（git checkout -b feature/AmazingFeature）
3. 对代码或文档进行一些修改。
4. 提交您的更改（git commit -m 'Add some AmazingFeature'）
5. 将更改推送到特性分支（git push origin feature/AmazingFeature）
6. 创建一个新的拉取请求
7. 管理员将审查拉取请求，并讨论可能需要的任何更改。
8. 一旦所有人都满意，管理员可以将拉取请求合并，您的工作就将成为我们项目的一部分！

行为准则

对本仓库的贡献是在Rust行为准则的条款下组织的，并且本仓库的维护者rp-rs团队承诺将介入以维护该行为准则。

许可证

本仓库的内容采用MIT OR Apache 2.0许可证双重许可。这意味着您在重用此代码时可以选择MIT许可证或Apache-2.0许可证。有关每个特定许可证的更多信息，请参阅MIT或APACHE2.0。

对本项目的任何提交（例如，作为拉取请求）都必须在这些条款下提供。