1849|2

114

帖子

1

资源

一粒金砂(中级)

使用 Rust 进行嵌入式开发 [复制链接]

作者:  liukang

Rust 是什么

Rust 是一门赋予每个人 构建可靠且高效软件能力的语言。

  • 高性能:速度惊人且内存利用率极高

  • 可靠性:在编译期就能消除各种内存错误

  • 生产力:出色的文档,友好的编译器和清晰的错误提示信息

为什么要用 Rust 进行嵌入式开发

Rust 的设计理念:既要安全,也要高性能。Rust 的设计理念完全是嵌入式开发所需要的。

嵌入式软件在运行过程中出现问题,大部分是由于内存引起的。Rust 语言可以说是一门面向编译器的语言。在编译期间,就能够确保你安全地使用内存。

目前,嵌入式的主流开发语言还是 C 语言,不能上来就把底层的逻辑用 Rust 重新实现一遍。但是可以在 C 代码中嵌入 Rust 语言。

C 调用 Rust

在 C 代码中调用 Rust 代码,需要我们将 Rust 源代码打包为静态库文件。在 C 代码编译时,链接进去。

创建 lib 库

1、在 Clion 中使用 cargo init --lib rust_to_c 建立 lib 库。添加以下代码到 lib.rs 中,使用 Rust 语言计算两个整数的和:

 1#![no_std]
 2use core::panic::PanicInfo;
 3
 4#[no_mangle]
 5pub extern "C" fn sum(a: i32, b: i32) -> i32 {
 6    a + b
 7}
 8
 9#[panic_handler]
10fn panic(_info:&PanicInfo) -> !{
11    loop{}
12}

 

在 Cargo.toml 文件中添加以下代码,生成静态库文件:

 

1[lib]
2name = "sum"
3crate-type = ["staticlib"]
4path = "src/lib.rs"

 

交叉编译

1、安装 armv7 target:

1rustup target add armv7a-none-eabi

 

2、生成静态库文件:

1PS C:\Users\LiuKang\Desktop\RUST\rust_to_c> cargo build --target=armv7a-none-eabi --release --verbose
2       Fresh rust_to_c v0.1.0 (C:\Users\LiuKang\Desktop\RUST\rust_to_c)
3    Finished release [optimized] target(s) in 0.01s

 

生成头文件

1、安装 cbindgen](https://github.com/eqrion/cbindgen)), cbindgen 从 rust 库生成 C/C++ 11 头文件:

1cargo install --force cbindgen

2、在项目文件夹下新建文件 cbindgen.toml 文件:

3、生成头文件:

1cbindgen --config cbindgen.toml --crate rust_to_c --output sum.h

 

调用 Rust 库文件

1、将生成的sum.h 以及 sum.a 文件放入 rt-thread\bsp\qemu-vexpress-a9\applications 目录下

2、修改 SConscript 文件,添加静态库:

 1from building import *
 2
 3cwd     = GetCurrentDir()
 4src     = Glob('*.c') + Glob('*.cpp')
 5CPPPATH = [cwd]
 6
 7LIBS = ["libsum.a"]
 8LIBPATH = [GetCurrentDir()]
 9
10group = DefineGroup('Applications', src, depend = [''], CPPPATH = CPPPATH, LIBS = LIBS, LIBPATH = LIBPATH)
11
12Return('group')

 

3、在 main 函数中调用 sum 函数, 并获取返回值

 1#include <stdint.h>
 2#include <stdio.h>
 3#include <stdlib.h>
 4#include <rtthread.h>
 5#include "sum.h"
 6
 7int main(void)
 8{
 9    int32_t tmp;
10
11    tmp = sum(1, 2);
12    printf("call rust sum(1, 2) = %d\n", tmp);
13
14    return 0;
15}

 

4、在 env 环境下,使用 scons 编译工程:

 1   LiuKang@DESKTOP-538H6DE D:\repo\github\rt-thread\bsp\qemu-vexpress-a9
 2   $ scons -j6
 3   scons: Reading SConscript files ...
 4   scons: done reading SConscript files.
 5
 6   scons: warning: you do not seem to have the pywin32 extensions installed;
 7   parallel (-j) builds may not work reliably with open Python files.
 8   File "D:\software\env_released_1.2.0\env\tools\Python27\Scripts\scons.py", line 204, in <module>
 9   scons: Building targets ...
10   scons: building associated VariantDir targets: build
11   LINK rtthread.elf
12   arm-none-eabi-objcopy -O binary rtthread.elf rtthread.bin
13   arm-none-eabi-size rtthread.elf
14  text    data     bss     dec     hex filename
15628220    2148   86700  717068   af10c rtthread.elf
16   scons: done building targets.
17
18   LiuKang@DESKTOP-538H6DE D:\repo\github\rt-thread\bsp\qemu-vexpress-a9
19   $ qemu.bat
20   WARNING: Image format was not specified for 'sd.bin' and probing guessed raw.
21Automatically detecting the format is dangerous for raw images, write operations on block 0 will be restricted.
22Specify the 'raw' format explicitly to remove the restrictions.
23
24\ | /
25   - RT -     Thread Operating System
26/ | \     4.0.4 build Jul 28 2021
272006 - 2021 Copyright by rt-thread team
28   lwIP-2.1.2 initialized!
29   [I/sal.skt] Socket Abstraction Layer initialize success.
30   [I/SDIO] SD card capacity 65536 KB.
31   [I/SDIO] switching card to high speed failed!
32   call rust sum(1, 2) = 3
33   msh />

 

加减乘除

1、在 lib.rs 文件中,使用 rust 语言实现加减乘除运算:

 1  #![no_std]
 2  use core::panic::PanicInfo;
 3
 4
 5  #[no_mangle]
 6  pub extern "C" fn add(a: i32, b: i32) -> i32 {
 7      a + b
 8  }
 9
10  #[no_mangle]
11  pub extern "C" fn subtract(a: i32, b: i32) -> i32 {
12      a - b
13  }
14
15  #[no_mangle]
16  pub extern "C" fn multiply(a: i32, b: i32) -> i32 {
17      a * b
18  }
19
20  #[no_mangle]
21  pub extern "C" fn divide(a: i32, b: i32) -> i32 {
22      a / b
23  }
24
25  #[panic_handler]
26  fn panic(_info:&PanicInfo) -> !{
27      loop{}
28  }

 

2、生成库文件和头文件并放在 application 目录下

3、使用 scons 编译,链接时报错,在 rust github 仓库的 issues 中找到了 解决办法(https://github.com/rust-lang/compiler-builtins/issues/353) :

1   LINK rtthread.elf
2   d:/software/env_released_1.2.0/env/tools/gnu_gcc/arm_gcc/mingw/bin/../lib/gcc/arm-none-eabi/5.4.1/armv7-ar/thumb\libgcc.a(_arm_addsubdf3.o): In function `__aeabi_ul2d':
3   (.text+0x304): multiple definition of `__aeabi_ul2d'
4   applications\libsum.a(compiler_builtins-9b744f6fddf5e719.compiler_builtins.20m0qzjq-cgu.117.rcgu.o):/cargo/registry/src/github.com-1ecc6299db9ec823/compiler_builtins-0.1.35/src/float/conv.rs:143: first defined here
5   collect2.exe: error: ld returned 1 exit status
6   scons: *** [rtthread.elf] Error 1
7   scons: building terminated because of errors.

 

4、修改 rtconfig.py 文件, 添加链接参数 --allow-multiple-definition

1    DEVICE = ' -march=armv7-a -marm -msoft-float'
2    CFLAGS = DEVICE + ' -Wall'
3    AFLAGS = ' -c' + DEVICE + ' -x assembler-with-cpp -D__ASSEMBLY__ -I.'
4    LINK_SCRIPT = 'link.lds'
5    LFLAGS = DEVICE + ' -nostartfiles -Wl,--gc-sections,-Map=rtthread.map,-cref,-u,system_vectors,--allow-multiple-definition'+\
6                      ' -T %s' % LINK_SCRIPT
7
8    CPATH = ''
9    LPATH = ''

 

5、编译并运行 qemu:

 1   LiuKang@DESKTOP-538H6DE D:\repo\github\rt-thread\bsp\qemu-vexpress-a9
 2   $ scons -j6
 3   scons: Reading SConscript files ...
 4   scons: done reading SConscript files.
 5
 6   scons: warning: you do not seem to have the pywin32 extensions installed;
 7   parallel (-j) builds may not work reliably with open Python files.
 8   File "D:\software\env_released_1.2.0\env\tools\Python27\Scripts\scons.py", line 204, in <module>
 9   scons: Building targets ...
10   scons: building associated VariantDir targets: build
11   LINK rtthread.elf
12   arm-none-eabi-objcopy -O binary rtthread.elf rtthread.bin
13   arm-none-eabi-size rtthread.elf
14  text    data     bss     dec     hex filename
15628756    2148   86700  717604   af324 rtthread.elf
16   scons: done building targets.
17
18   LiuKang@DESKTOP-538H6DE D:\repo\github\rt-thread\bsp\qemu-vexpress-a9
19   $ qemu.bat
20   WARNING: Image format was not specified for 'sd.bin' and probing guessed raw.
21    Automatically detecting the format is dangerous for raw images, write operations on block 0 will be restricted.
22    Specify the 'raw' format explicitly to remove the restrictions.
23
24\ | /
25   - RT -     Thread Operating System
26/ | \     4.0.4 build Jul 28 2021
272006 - 2021 Copyright by rt-thread team
28   lwIP-2.1.2 initialized!
29   [I/sal.skt] Socket Abstraction Layer initialize success.
30   [I/SDIO] SD card capacity 65536 KB.
31   [I/SDIO] switching card to high speed failed!
32   call rust sum(1, 2) = 3
33   call rust subtract(2, 1) = 1
34   call rust multiply(2, 2) = 4
35   call rust divide(4, 2) = 2

 

Rust 调用 C

可以 在 C 代码中调用 Rust,那么在 Rust 中也可以调用 C 代码。我们在 Rust 代码中调用 rt_kprintf 函数:

修改 lib.rs 文件

 1    // 导入的 rt-thread 函数列表
 2    extern "C" {
 3        pub fn rt_kprintf(format: *const u8, ...);
 4    }
 5
 6    #[no_mangle]
 7    pub extern "C" fn add(a: i32, b: i32) -> i32 {
 8        unsafe {
 9            rt_kprintf(b"this is from rust\n\0" as *const u8);
10        }
11        a + b
12    }

 

生成库文件

1    cargo build --target=armv7a-none-eabi --release --verbose
2       Compiling rust_to_c v0.1.0 (C:\Users\LiuKang\Desktop\RUST\rust_to_c)
3         Running `rustc --crate-name sum --edition=2018 src/lib.rs --error-format=json --json=diagnostic-rendered-ansi --crate-type staticlib --emit=dep-info,link -C opt-level=3 -C embed-bitcode=no -C metadata=a
4    0723fa112c78339 -C extra-filename=-a0723fa112c78339 --out-dir C:\Users\LiuKang\Desktop\RUST\rust_to_c\target\armv7a-none-eabi\release\deps --target armv7a-none-eabi -L dependency=C:\Users\LiuKang\Desktop\RUS
5    T\rust_to_c\target\armv7a-none-eabi\release\deps -L dependency=C:\Users\LiuKang\Desktop\RUST\rust_to_c\target\release\deps`
6        Finished release [optimized] target(s) in 0.11s

 

运行

复制 rust 生成的库文件到 application 目录下。

 1    LiuKang@DESKTOP-538H6DE D:\repo\github\rt-thread\bsp\qemu-vexpress-a9                                                       
 2    $ scons -j6                                                                                                             
 3    scons: Reading SConscript files ...                                                                                  
 4    scons: done reading SConscript files.                                                                                                     
 5    scons: warning: you do not seem to have the pywin32 extensions installed;                                                   
 6            parallel (-j) builds may not work reliably with open Python files.                                                  
 7    File "D:\software\env_released_1.2.0\env\tools\Python27\Scripts\scons.py", line 204, in <module>                            
 8    scons: Building targets ...                                                                                                 
 9    scons: building associated VariantDir targets: build                                                                        
10    LINK rtthread.elf                                                                                                           
11    arm-none-eabi-objcopy -O binary rtthread.elf rtthread.bin                                                                   
12    arm-none-eabi-size rtthread.elf                                                                                             
13       text    data     bss     dec     hex filename                                                                            
14     628812    2148   90796  721756   b035c rtthread.elf                                                                        
15    scons: done building targets.                                                                                               
16
17    LiuKang@DESKTOP-538H6DE D:\repo\github\rt-thread\bsp\qemu-vexpress-a9                                                       
18    $ qemu.bat                                                                                                                  
19    WARNING: Image format was not specified for 'sd.bin' and probing guessed raw.                                               
20             Automatically detecting the format is dangerous for raw images, write operations on block 0 will be restricted.    
21             Specify the 'raw' format explicitly to remove the restrictions.                                                    
22
23     \ | /                                                                                                                      
24    - RT -     Thread Operating System                                                                                          
25     / | \     4.0.4 build Jul 28 2021                                                                                          
26     2006 - 2021 Copyright by rt-thread team                                                                                    
27    lwIP-2.1.2 initialized!                                                                                                     
28    [I/sal.skt] Socket Abstraction Layer initialize success.                                                                    
29    [I/SDIO] SD card capacity 65536 KB.                                                                                         
30    [I/SDIO] switching card to high speed failed!                                                                               
31    this is from rust                                                                                                           
32    call rust sum(1, 2) = 3                                                                                           
33    call rust subtract(2, 1) = 1                                                                                                
34    call rust multiply(2, 2) = 4                                                                                                
35    call rust divide(4, 2) = 2                                                                                     
36    msh />                                                                                                                      

 


回复

5249

帖子

18

资源

五彩晶圆(中级)

rust东西是个好东西,虽然很复杂,虽然现在整个开发环境还很原始,但是如果有大厂推,有大厂去改善开发、下载、调试的环境,这个东西值得试试。

个人签名

默认摸鱼


回复

1988

帖子

2

资源

五彩晶圆(初级)

一年前我在STM32F103上实验没有成功过,就放下了。看到楼主的我在努努力。


回复
您需要登录后才可以回帖 登录 | 注册

查找数据手册?

EEWorld Datasheet 技术支持

最新文章 更多>>
    推荐帖子
    [GD32E231 DIY大赛] 04. 机械臂艰难的组装过程

    本帖最后由 传媒学子 于 2019-5-19 18:29 编辑 # 04. 机械臂艰难的组装过程# 夹杂这省钱和锻炼自己动手能力的动机下,我掏 ...

    晶振与晶体的参数详细介绍

    1.晶振与晶体的区别 (1) 晶振是有源晶振的简称,又叫振荡器。英文名称是oscillator。晶体则是无源晶振的简称,也叫谐振器。英文 ...

    AVR单片机I2C总线程序

    #include "iom16v.h" /*I2C总线主机模式错误处理*/ void error(unsigned char type) { switch (type & 0xF8) { ...

    “赞一赞我的国”:集合啦,侃侃好用的国产单片机

    已颁奖,点此查看 ——————————————&m ...

    【短时天气预报系统】v0.0.1实现

    下周出行,交作业 作品简介 楼主所处坐标对流天气比较多,天气闷热潮湿 默默盯了下,一天晾晒的衣物进进出出五六趟 ...

    刚刚发贴时,只要选了邀请人之后 ,点击保存按钮后就出现错误提示Discuz!

    本帖最后由 深圳小花 于 2021-7-31 19:47 编辑 刚刚发贴时,只要选了邀请人之后 ,点击保存按钮后就出现错误提示 Discuz! ...

    关闭
    站长推荐上一条 1/10 下一条

    About Us 关于我们 客户服务 联系方式 器件索引 网站地图 最新更新 手机版

    站点相关: 安防电子 汽车电子 手机便携 工业控制 家用电子 医疗电子 测试测量 网络通信 物联网

    北京市海淀区知春路23号集成电路设计园量子银座1305 电话:(010)82350740 邮编:100191

    电子工程世界版权所有 京B2-20211791 京ICP备10001474号-1 电信业务审批[2006]字第258号函 京公网安备 11010802033920号 Copyright © 2005-2022 EEWORLD.com.cn, Inc. All rights reserved
    快速回复 返回顶部 返回列表