rt-thread/components/rust/core/src/lib.rs

/*
 * Copyright (c) 2006-2025, RT-Thread Development Team
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * Change Logs:
 * Date           Author       notes
 * 2025-09-15     foxglove     1.0 version
 * 2025-09-25     foxglove     1.1 version
 * 2025-10-10     foxglove     latest version
 */

/* RT-Thread Rust core library

Provides basic system support functionality including file system, network,
and device interfaces. Designed for embedded devices running RT-Thread.
*/

#![no_std]
#![feature(alloc_error_handler)]
#![feature(linkage)]
#![allow(dead_code)]

pub extern crate alloc;

#[doc = "Alloc by rt-thread"]
#[global_allocator]
static GLOBAL: allocator::RttAlloc = allocator::RttAlloc;
pub mod api;
pub mod bindings;

pub mod init;
pub mod allocator;
pub mod mutex;
pub mod out;
pub mod fs;
pub mod panic;
pub mod param;
pub mod queue;
pub mod sem;
pub mod thread;
pub mod time;
pub mod libloader;

mod prelude;
pub use prelude::v1::*;

/* Re-export initialization function */
pub use init::rust_init;

#[derive(Debug, Copy, Clone, Eq, PartialEq)]
pub enum RTTError {
    ThreadStartupErr,
    MutexTakeTimeout,
    SemaphoreTakeTimeout,
    QueueSendTimeout,
    QueueReceiveTimeout,
    OutOfMemory,

    DeviceNotFound,
    DeviceOpenFailed,
    DeviceCloseFailed,
    DeviceReadFailed,
    DeviceWriteFailed,
    DeviceTransFailed,
    DeviceConfigFailed,
    DeviceSetRxCallBackFailed,
    DeviceSetTxCallBackFailed,

    FileOpenErr,
    FileCloseErr,
    FileReadErr,
    FileWriteErr,
    FileSeekErr,
    FileFlushErr,
    FileDeleteErr,
    FileSetLengthErr,
    FileSyncErr,

    FuncUndefined,
}

pub type RTResult<T> = Result<T, RTTError>;