Struct StaticMutex 

pub struct StaticMutex<T: ?Sized> { /* private fields */ }

A statically-allocated mutex for protecting shared data.

Similar to Mutex<T> but designed to be allocated at compile time as a static variable. Requires explicit initialization before use.

Examples

use osal_rs::os::StaticMutex;
 
static mut COUNTER_MUTEX: Option<StaticMutex<u32>> = None;
 
// During initialization:
unsafe {
    COUNTER_MUTEX = Some(StaticMutex::new(0).unwrap());
}

Implementations

impl<T> StaticMutex<T>

pub fn new(data: T) -> Result<Self>

Creates a new static mutex protecting the given data.

Parameters

• data - The initial value to protect

Returns

• Ok(StaticMutex) - Successfully created
• Err(Error::OutOfMemory) - Failed to allocate mutex resources

Examples

let mutex = StaticMutex::new(42).unwrap();

impl<T> StaticMutex<T>

pub fn init(&mut self) -> Result<()>

Initializes the mutex.

Note: The mutex is already initialized in the constructor. This method is provided for API compatibility.

Returns

Always returns Ok(())

Trait Implementations

impl<T> StaticMutex<T> for StaticMutex<T>

fn lock(&self) -> Result<StaticMutexGuard<'_, T>>

Acquires the lock and returns a guard.

Blocks until the lock is available.

fn lock_from_isr(&self) -> Result<StaticMutexGuardFromIsr<'_, T>>

Acquires the lock from ISR context and returns an ISR guard.

Non-blocking version for interrupt service routines.

fn get_mut(&mut self) -> &mut T

Returns a mutable reference to the underlying data.

Safe because it requires exclusive mutable access to the mutex.

type Guard<'a> = StaticMutexGuard<'a, T> where Self: 'a, T: 'a

Guard type returned by lock(), providing RAII-style mutex access.

type GuardFromIsr<'a> = StaticMutexGuardFromIsr<'a, T> where Self: 'a, T: 'a

Guard type returned by lock_from_isr(), for ISR-context mutex access.