Crate xwrust

XWOS Rust Framework

简介

XWOS RUST是基于XWOS的CAPI编写的RUST语言 #![no_std] 环境的框架， 可让XWOS从C语言的RTOS进化成RUST语言的RTOS。

在编写XWOS RUST时，作者充分阅读并参考了RUST的std库的代码， 尽量仿照std库的形式提供API。使得熟悉RUST语言的朋友更容易掌握如何使用XWOS RUST。

传统RUST程序的入口是 main.rs 的 fn main() ， XWOS RUST的入口是 pub unsafe extern "C" fn xwrust_main() 。 用户需要在工程目录（例如电路板模块 bm 文件夹 或 OEM 文件夹）建立一个独立的 玄武模块 来定义此函数。

// bm/rustapp/src/lib.rs
// crate-type = ["staticlib"]
#![no_std]

use xwrust::xwmm::allocator::AllocatorMempool;

#[global_allocator]
pub static GLOBAL_ALLOCATOR: AllocatorMempool = AllocatorMempool;

#[no_mangle]
pub unsafe extern "C" fn xwrust_main() {
    // 用户代码
}

然后在XWOS的C语言入口 xwos_main() 中创建一个线程来调用 xwrust_main() 。

extern void xwrust_main(void);
xwer_t xwrust_task(void * arg);

xwos_thd_d xwrust_thd;
xwer_t xwos_main(void)
{
        struct xwos_thd_attr attr;

        xwos_thd_attr_init(&attr);
        attr.name = "xwrust.thd";
        attr.stack = NULL;
        attr.stack_size = 8192;
        attr.priority = XWRUST_THD_PRIORITY;
        attr.detached = true;
        attr.privileged = true;
        xwos_thd_create(&xwrust_thd, &attr, xwrust_task, NULL);
}

// 独立的RUST线程
xwer_t xwrust_task(void * arg)
{
        xwrust_main();
}

因为需要与C语言编写的内核进行静态链接，用户应该创建的是基于 lib.rs 的静态库而非 main.rs 。

[package]
name = "rustapp"
version = "0.1.0"
edition = "2021"

[lib]
name = "rustapp"
crate-type = ["staticlib"]

XWOS RUST 的功能

XWOS RUST提供了RTOS的基本功能：

• 内存管理
  • 全局内存分配器
• 调度器
• 电源管理
• 线程
• 软件定时器
• 锁
  • 互斥锁
  • 自旋锁
  • 顺序锁
• 同步机制
  • 信号量
  • 条件量
  • 事件标志
  • 线程栅栏
  • 信号选择器
• 线程间通讯
  • 消息队列
  • 循环队列
• 其他
  • 时间
  • 类型
  • 错误码
  • 位图

XWOS RUST所有功能都提供了 static 创建的方法，如果不使用 Arc<T>, Box<T> 等， 即可实现完全静态内存分配的代码。

返回XWOS首页

XWOS首页

Modules

• cfg
  XWOS RUST：配置
• errno
  XWOS RUST：错误码
• macros
  XWOS RUST：宏
• panic
  XWOS RUST：panic
• types
  XWOS RUST：基本类型
• xwbmp
  XWOS RUST：位图数组
• xwds
  XWOS RUST：设备栈
• xwmd
  XWOS RUST：中间件
• xwmm
  XWOS RUST：内存管理
• xwos
  XWOS RUST：内核库
• xwtm
  XWOS RUST：系统时间

Macros

• bit
  生成位掩码的宏
• pin
  生成GPIO PIN掩码的宏