components/rust/core/src/api/mutex.rs


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

/*
 * Copyright (c) 2006-2025, RT-Thread Development Team
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * Change Logs:
 * Date           Author       notes
 * 2025-10-10     foxglove     Mutex API
 */
use crate::api::RttCResult;
use crate::bindings::*;
use core::ptr;
use alloc::ffi::CString;

pub type APIRawMutex = rt_mutex_t;

#[inline]
pub fn mutex_create(name: &str) -> Option<APIRawMutex> {
    let s = CString::new(name).unwrap();
    let raw;
    unsafe {
        raw = rt_mutex_create(s.as_ptr(), 1);
    }
    if raw == ptr::null_mut() {
        None
    } else {
        Some(raw)
    }
}

#[inline]
pub fn mutex_delete(handle: APIRawMutex) {
    unsafe {
        rt_mutex_delete(handle);
    }
}

#[inline]
pub fn mutex_take(handle: APIRawMutex, tick: isize) -> RttCResult {
    unsafe { rt_mutex_take(handle, tick as _).into() }
}

#[inline]
pub fn mutex_release(handle: APIRawMutex) {
    unsafe {
        rt_mutex_release(handle);
    }
}