teensy4-rs

一组用于 Rust 在 Teensy 4 上的开发的 crate。支持以下板子

• Teensy 4.0
• Teensy 4.1
• Teensy MicroMod

API 文档 (master)

依赖关系

• 安装 Rust。使用 rustup 安装 Rust。我们支持最新的稳定 Rust 工具链。

• 使用 rustup 安装的 thumbv7em-none-eabihf Rust 目标

  rustup target add thumbv7em-none-eabihf
  

• 一个能够将 Rust 可执行文件转换为 hex 文件的 objcopy。项目中的文档和工具使用 Rust-embedded/cargo-binutils 提供的 LLVM objcopy。如果想要精确遵循此文档，请安装 cargo-binutils。

• 要将程序下载到您的 Teensy 4，您需要一个 teensy_loader_cli 的构建，或者 Teensy Loader 应用程序。后者可在 Teensyduino 扩展中找到。

入门

使用我们的 cargo-generate 模板，teensy4-rs-template，根据这些库启动您自己的 teensy4-rs 项目

cargo install cargo-generate
cargo generate --git https://github.com/mciantyre/teensy4-rs-template --name hello-world
cd hello-world
cargo objcopy --release -- -O ihex hello-world.hex

将 hello-world.hex 下载到您的 Teensy 4！

请参阅 Rust 文档以获取 API 信息。特别是，研究 imxrt-hal API，因为 BSP 将许多 HAL 接口转发

cargo doc --open

如果您想测试您的系统，请尝试该项目中的各种示例，位于 examples 目录。

贡献

我们欢迎支持！一种很好的贡献方式是开始使用crates来开发Teensy 4应用程序。提交一个问题以帮助我们识别错误、功能请求或文档空白。查看 CONTRIBUTING.md 了解您请求的最佳问题跟踪器。

如果您想直接为 teensy4-rs 项目做出贡献，请阅读 CONTRIBUTING.md 中的开发指南。

致谢和参考

• Teensy 4 真棒，这要归功于PJRC和朋友们辛勤的工作。我们可以在Arduino插件中找到使用的Teensy代码 这里。该代码极大地影响了这个库。
• Rust Cortex M团队，特别是 cortex-m-rt crate。

许可证

根据您的选择，许可如下：

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

。