teensy4-rs

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

• Teensy 4.0
• Teensy 4.1
• Teensy MicroMod

API文档（《code>master）

依赖项

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

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

  rustup target add thumbv7em-none-eabihf
  

• 一个能够将Rust二进制文件转换为hex文件的objcopy。项目中的文档和工具使用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目录。

贡献

我们欢迎支持！一种很好的贡献方式是开始使用这些crate开发Teensy 4应用程序。提交一个issue来帮助我们识别bug、功能请求或文档空白。请参阅CONTRIBUTING.md以了解最适合您请求的最佳issue追踪器。

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

致谢和参考文献

• Teensy 4非常出色，这归功于PJRC及其朋友的辛勤工作。我们可以在Arduino插件中找到使用的Teensy代码这里。这段代码对库产生了很大影响。
• Rust Cortex M团队，特别是cortex-m-rtcrate。

许可证

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

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

。