semaphore.h

#pragma once
 
/************************************************************************************************
 * @file   semaphore.h
 *
 * @brief  Header file for the semaphore library
 *
 * @date   2024-10-27
 * @author Midnight Sun Team #24 - MSXVI
 ************************************************************************************************/
 
/* Standard library Headers */
#include <stdbool.h>
 
/* Inter-component Headers */
#include "FreeRTOS.h"
#include "semphr.h"
 
/* Intra-component Headers */
#include "status.h"
 
#define BLOCK_INDEFINITELY UINT16_MAX
 
typedef struct Semaphore {
  SemaphoreHandle_t handle; 
  StaticSemaphore_t buffer; 
} Semaphore;
 
typedef Semaphore Mutex;
 
StatusCode mutex_init(Mutex *mutex);
 
StatusCode mutex_lock(Mutex *mutex, uint16_t ms_to_wait);
 
StatusCode mutex_unlock(Mutex *mutex);
 
StatusCode sem_init(Semaphore *sem, uint32_t max_count, uint32_t initial_count);
 
StatusCode sem_wait(Semaphore *sem, uint32_t timeout_ms);
 
StatusCode sem_post(Semaphore *sem);