teensy4-rs

为Teensy 4上的Rust开发提供crate集合。支持以下板子

• Teensy 4.0
• Teensy 4.1
• Teensy MicroMod

API文档 (master)

依赖项

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

• thumbv7em-none-eabihf Rust目标，可以使用rustup安装

  rustup target add thumbv7em-none-eabihf
  

• 一个强大的objcopy，用于将Rust可执行文件转换为hex文件。项目中的文档和工具使用由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, Version 2.0 (LICENSE-APACHE 或 http://www.apache.org/licenses/LICENSE-2.0)
• MIT 许可证 (LICENSE-MIT 或 http://opensource.org/licenses/MIT)

任选其一。