interrupts.h

#pragma once
 
/************************************************************************************************
 * @file   interrupts.h
 *
 * @brief  Interrupts Library Header file
 *
 * @date   2024-10-27
 * @author Midnight Sun Team #24 - MSXVI
 ************************************************************************************************/
 
/* Standard library Headers */
#include <stdbool.h>
#include <stdint.h>
 
/* Inter-component Headers */
#include "FreeRTOSConfig.h"
 
/* Intra-component Headers */
#include "gpio.h"
#include "status.h"
 
typedef enum {
  INTERRUPT_TYPE_INTERRUPT = 0, 
  INTERRUPT_TYPE_EVENT,         
  NUM_INTERRUPT_CLASSES,        
} InterruptClass;
 
typedef enum {
  INTERRUPT_PRIORITY_HIGH = configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY,
  INTERRUPT_PRIORITY_NORMAL,
  INTERRUPT_PRIORITY_LOW,
  NUM_INTERRUPT_PRIORITIES,
} InterruptPriority;
 
typedef enum {
  INTERRUPT_EDGE_RISING = 0, 
  INTERRUPT_EDGE_FALLING,    
  INTERRUPT_EDGE_TRANSITION, 
  NUM_INTERRUPT_EDGES,       
} InterruptEdge;
 
typedef struct InterruptSettings {
  InterruptClass class;       
  InterruptPriority priority; 
  InterruptEdge edge;         
} InterruptSettings;
 
#define NUM_STM32L433X_INTERRUPT_CHANNELS 83U
 
#define NUM_STM32L433X_EXTI_LINES 16U
 
void interrupt_init(void);
 
StatusCode interrupt_nvic_enable(uint8_t irq_channel, InterruptPriority priority);
 
StatusCode interrupt_exti_enable(GpioAddress *address, const InterruptSettings *settings);
 
StatusCode interrupt_exti_trigger(uint8_t line);
 
StatusCode interrupt_exti_get_pending(uint8_t line, uint8_t *pending_bit);
 
StatusCode interrupt_exti_clear_pending(uint8_t line);
 
StatusCode interrupt_exti_set_mask(uint8_t line, bool masked);
 
#ifdef MS_PLATFORM_X86
 
typedef void (*x86InterruptHandler)(uint8_t interrupt_id);
 
StatusCode interrupt_nvic_register_handler(uint8_t irq_channel, x86InterruptHandler handler, const InterruptSettings *settings);
 
StatusCode interrupt_exti_register_handler(uint8_t line, x86InterruptHandler handler, const InterruptSettings *settings);
 
#endif