FreeRTOS port on GAP8/RISC-V
|
Macros | |
#define | semBINARY_SEMAPHORE_QUEUE_LENGTH |
#define | semSEMAPHORE_QUEUE_ITEM_LENGTH |
#define | semGIVE_BLOCK_TIME |
#define | xSemaphoreTake(xSemaphore, xBlockTime) |
#define | xSemaphoreGive(xSemaphore) |
#define | xSemaphoreGiveFromISR(xSemaphore, pxHigherPriorityTaskWoken) |
#define | xSemaphoreTakeFromISR(xSemaphore, pxHigherPriorityTaskWoken) |
#define | vSemaphoreDelete(xSemaphore) |
#define | xSemaphoreGetMutexHolder(xSemaphore) |
#define | xSemaphoreGetMutexHolderFromISR(xSemaphore) |
#define | uxSemaphoreGetCount(xSemaphore) |
Typedefs | |
typedef QueueHandle_t | SemaphoreHandle_t |
#define semBINARY_SEMAPHORE_QUEUE_LENGTH |
#define semGIVE_BLOCK_TIME |
#define semSEMAPHORE_QUEUE_ITEM_LENGTH |
#define uxSemaphoreGetCount | ( | xSemaphore | ) |
UBaseType_t uxSemaphoreGetCount( SemaphoreHandle_t xSemaphore );
If the semaphore is a counting semaphore then uxSemaphoreGetCount() returns its current count value. If the semaphore is a binary semaphore then uxSemaphoreGetCount() returns 1 if the semaphore is available, and 0 if the semaphore is not available.
#define vSemaphoreDelete | ( | xSemaphore | ) |
Referenced by __os_native_api_mutex_deinit().
#define xSemaphoreGetMutexHolder | ( | xSemaphore | ) |
TaskHandle_t xSemaphoreGetMutexHolder( SemaphoreHandle_t xMutex );
If xMutex is indeed a mutex type semaphore, return the current mutex holder. If xMutex is not a mutex type semaphore, or the mutex is available (not held by a task), return NULL.
Note: This is a good way of determining if the calling task is the mutex holder, but not a good way of determining the identity of the mutex holder as the holder may change between the function exiting and the returned value being tested.
#define xSemaphoreGetMutexHolderFromISR | ( | xSemaphore | ) |
TaskHandle_t xSemaphoreGetMutexHolderFromISR( SemaphoreHandle_t xMutex );
If xMutex is indeed a mutex type semaphore, return the current mutex holder. If xMutex is not a mutex type semaphore, or the mutex is available (not held by a task), return NULL.
#define xSemaphoreGive | ( | xSemaphore | ) |
#define xSemaphoreGiveFromISR | ( | xSemaphore, | |
pxHigherPriorityTaskWoken | |||
) |
Referenced by __os_native_api_mutex_release(), and __os_native_api_sem_give().
#define xSemaphoreTake | ( | xSemaphore, | |
xBlockTime | |||
) |
Referenced by __os_native_api_mutex_lock(), and __os_native_api_sem_take().
#define xSemaphoreTakeFromISR | ( | xSemaphore, | |
pxHigherPriorityTaskWoken | |||
) |
semphr. h
xSemaphoreTakeFromISR( SemaphoreHandle_t xSemaphore, BaseType_t *pxHigherPriorityTaskWoken )
Macro to take a semaphore from an ISR. The semaphore must have previously been created with a call to xSemaphoreCreateBinary() or xSemaphoreCreateCounting().
Mutex type semaphores (those created using a call to xSemaphoreCreateMutex()) must not be used with this macro.
This macro can be used from an ISR, however taking a semaphore from an ISR is not a common operation. It is likely to only be useful when taking a counting semaphore when an interrupt is obtaining an object from a resource pool (when the semaphore count indicates the number of resources available).
xSemaphore | A handle to the semaphore being taken. This is the handle returned when the semaphore was created. |
pxHigherPriorityTaskWoken | xSemaphoreTakeFromISR() will set *pxHigherPriorityTaskWoken to pdTRUE if taking the semaphore caused a task to unblock, and the unblocked task has a priority higher than the currently running task. If xSemaphoreTakeFromISR() sets this value to pdTRUE then a context switch should be requested before the interrupt is exited. |
Referenced by __attribute__(), and __os_native_api_sem_take().
typedef QueueHandle_t SemaphoreHandle_t |