rt-thread/components/rust/docs/4.modules/modules_cn.md

编写RT-Thread可以使用的rust动态库

1. 设置项目 像往常一样创建一个新的cargo项目。有一些标志可以告诉cargo去生成一个系统库，而不是常规的rust目标文件。

   [lib]
   name = "your_crate"
   crate-type = ["cdylib"]      # 生成动态链接库
   # crate-type = ["staticlib"] # 生成静态链接库
   

在 config.toml 中添加以下内容，以指定目标平台

[build]
target = "your_target

1. 开启 RT-Thread 加载动态模块功能 为了能够在 RT-Thread 中加载动态模块，需要在 Kconfig 中开启

   RT-Thread Components → C/C++ and POSIX layer 
   → POSIX (Portable Operating System Interface) layer 
       → Enable dynamic module APIs, dlopen()/dlsym()/dlclose() etc
   

2. 打开文件系统 为了能够将动态模块放入 RT-Thread 中，需要在 Kconfig 中开启文件系统。

   RT-Thread online packages → system packages 
   → lwext4: an excellent choice of ext2/3/4 filesystem for microcontrollers.
   

rust库的使用

在 Cargo.toml 中添加 rt_rust 依赖

[dependencies]
rt_rust = { path = "PATH/TO/rust/rt-rust" }

目前不支持macro-main库的使用，因为它会导致入口识别错误。

参考资料

• The Embedded Rust Book