ra8_isr.h

Go to the documentation of this file.

 
#pragma once
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <stdint.h>
 
#include "ra8_elc_regs.h"
#include "ra8_err.h"
 
/* =============================================================================
 * Constants
 * =============================================================================
 */

typedef enum : uint16_t {
  k_ra8_isr_slot_count = 96U, 
} ra8_isr_slot_count_t;

typedef enum : uint8_t {
  k_ra8_isr_prio_max     = 15U, 
  k_ra8_isr_prio_default = 8U,  
} ra8_isr_prio_t;

typedef enum : uint16_t {
  k_ra8_isr_slot_none = 0xFFFFU, 
} ra8_isr_invalid_slot_t;

typedef void (*ra8_isr_handler_t)(void* ctx);
 
/* =============================================================================
 * Lifecycle
 * =============================================================================
 */

[[nodiscard]] ra8_err_t ra8_isr_init(void);
 
/* =============================================================================
 * Registration
 * =============================================================================
 */

[[nodiscard]] ra8_err_t ra8_isr_register(ra8_elc_event_t   event,
                                         ra8_isr_handler_t handler,
                                         void*             ctx,
                                         uint8_t           priority,
                                         uint16_t*         out_slot);

[[nodiscard]] ra8_err_t ra8_isr_unregister(ra8_elc_event_t event);
 
/* =============================================================================
 * Dispatch
 * =============================================================================
 */

void ra8_isr_dispatch(uint16_t slot);
 
/* =============================================================================
 * Priority / enable shortcuts
 * =============================================================================
 */

[[nodiscard]] ra8_err_t ra8_isr_set_priority(ra8_elc_event_t event, uint8_t priority);

[[nodiscard]] ra8_err_t ra8_isr_lookup_slot(ra8_elc_event_t event, uint16_t* out_slot);

[[nodiscard]] ra8_err_t ra8_isr_set_dtc(uint16_t slot, bool enable);

void ra8_isr_globals_enable(void);

void ra8_isr_globals_disable(void);
 
#ifdef __cplusplus
}
#endif