Ken Van Hoeylandt
e6abd496f9
* **New Features** * Time and delay utilities added (ticks, ms, µs); SD card now uses an expansion-header CS pin; HTTP downloads warn when run on the GUI task and yield to avoid blocking. * **Bug Fixes / Reliability** * Many hard-crash paths converted to guarded checks to reduce abrupt termination and improve stability. * **Tests** * Unit tests added to validate time and delay accuracy. * **Chores** * License header and build/macro updates.
63 lines
1.5 KiB
C
63 lines
1.5 KiB
C
// SPDX-License-Identifier: Apache-2.0
|
|
|
|
#pragma once
|
|
|
|
#include <assert.h>
|
|
#include <stdbool.h>
|
|
|
|
#include <Tactility/Check.h>
|
|
#include <Tactility/FreeRTOS/semphr.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct Mutex {
|
|
QueueHandle_t handle;
|
|
// TODO: Debugging functionality
|
|
};
|
|
|
|
inline static void mutex_construct(struct Mutex* mutex) {
|
|
assert(mutex->handle == NULL);
|
|
mutex->handle = xSemaphoreCreateMutex();
|
|
}
|
|
|
|
inline static void mutex_destruct(struct Mutex* mutex) {
|
|
assert(mutex->handle != NULL);
|
|
vPortAssertIfInISR();
|
|
vSemaphoreDelete(mutex->handle);
|
|
mutex->handle = NULL;
|
|
}
|
|
|
|
inline static void mutex_lock(struct Mutex* mutex) {
|
|
check(xPortInIsrContext() != pdTRUE);
|
|
xSemaphoreTake(mutex->handle, portMAX_DELAY);
|
|
}
|
|
|
|
inline static bool mutex_try_lock(struct Mutex* mutex) {
|
|
check(xPortInIsrContext() != pdTRUE);
|
|
return xSemaphoreTake(mutex->handle, 0) == pdTRUE;
|
|
}
|
|
|
|
inline static bool mutex_try_lock_timed(struct Mutex* mutex, TickType_t timeout) {
|
|
check(xPortInIsrContext() != pdTRUE);
|
|
return xSemaphoreTake(mutex->handle, timeout) == pdTRUE;
|
|
}
|
|
|
|
inline static bool mutex_is_locked(struct Mutex* mutex) {
|
|
if (xPortInIsrContext() == pdTRUE) {
|
|
return xSemaphoreGetMutexHolderFromISR(mutex->handle) != NULL;
|
|
} else {
|
|
return xSemaphoreGetMutexHolder(mutex->handle) != NULL;
|
|
}
|
|
}
|
|
|
|
inline static void mutex_unlock(struct Mutex* mutex) {
|
|
check(xPortInIsrContext() != pdTRUE);
|
|
xSemaphoreGive(mutex->handle);
|
|
}
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|