2 个版本
0.1.1 | 2020年3月22日 |
---|---|
0.1.0 | 2019年12月31日 |
#358 in 构建实用工具
34KB
617 行
teensy4-rs
一组针对 Teensy 4 进行 Rust 开发的 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 可执行文件转换为十六进制文件的
objcopy
。项目中的文档和工具使用由cargo-binutils
提供的 LLVMobjcopy
。如果您想精确遵循此文档,请安装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
APIs,因为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或http://www.apache.org/licenses/LICENSE-2.0)
- MIT许可证(LICENSE-MIT或http://opensource.org/licenses/MIT)
。