Skip to content

Latest commit

 

History

History
118 lines (75 loc) · 3.11 KB

README.md

File metadata and controls

118 lines (75 loc) · 3.11 KB

stm32-rustup

English: README.EN.md

Rust嵌入式开发指北。

Why

我C、C++写的好好的,为什么要换Rust?

首先Rust作为一门新兴的语言,相比C有着更良好的使用体验,其次使用Rust可以享受到Rust丰富的no_std环境。

Rust具有的高级现代语言的特性使得其在不同型号芯片,甚至不同架构芯片上,仅仅通过简单的修改即可移植,See 移植

同时相比于arm-gcc-none-eabi,即标准的ARM嵌入式编译器,Rust有着更高的性能。

crates

什么叫舒服啊.jpg

尝试

目前有如下例子:

  • hello 通过rtt输出 "Hello Embedded World"
  • blink 闪烁LED
  • button 读取GPIO控制LED
  • usart-irq 通过串口中断读取USART, 实现复读机
  • button-exti GPIO外部中断控制LED
  • iwdg 独立看门狗
  • timer 定时器控制LED
  • pwm PWM控制LED
  • rng 随机数发生器

IDE

VSCode是一个很好的选择,你需要安装如下扩展:

  • crates
  • rust-analyzer

请注意:此bug已经修复, 请使用最新版本 0.2.441. 在最新版本的rust-analyzer中存在着无法解析宏的Bug, 在修复之前请使用 0.2.400 版本 当前最新版本:0.2.416

编译

使用如下命令进行编译 blink

cargo build --example blink

编译后的ELF产物在target/thumbv7em-none-eabihf/debug/目录下,执行binutils即可查看相关信息。

第一次编译的过程会很长,如果你修改了内存布局memory.x,再次执行cargo build并不会重新应用你的内存布局, 你需要清除掉之前的缓存重新进行编译才可以应用新的内存布局

cargo clean
cargo build --example some_bin

设备

stm32F429IGT6,若干导线,ST-Link调试器,TTL转串口。

资源

例子中用到的外设资源:

高速外部时钟源 25MHz

  • PB0 - 绿色LED
  • PB1 - 红色LED
  • PA0 - WK_UP
  • PC13 - 按键
  • PH2 - 按键
  • PH3 - 按键

在我的博客上有更多有关嵌入式Rust的相关内容,也在持续更新中。

-> Blog <-

移植

如果想要在你的设备上进行实验,请注意一些内容:

  1. 首先根据自己的设备修改内存布局memory.x
  2. cargo.toml中替换HAL,如果你的设备不是ARM内核,请同时修改cortex-m至你的目标架构
  3. 根据你的设备重新定义源码中的引脚

如果你要在不同目标平台上进行修改尝试,请执行以下操作:

  1. 修改.cargo/config文件,将其中有关target的内容修改为你的目标架构
  2. 修改cargo.toml,引入你设备的布局,HAL等
  3. 可选,修改.vscode/settings.json中的内容来让VSCode正确检查你的代码

更多资源

Q&A

Open an Issues And I‘ll try my best to answer.

Author

@Logiase

LICENSE

MIT LICENSE