Files
Momentum-Firmware/targets/f7/furi_hal/furi_hal_interrupt.h
あく 70d2453bbc VA Fixes: USB IRQ Handling and EP configuration, Thread handler shenanigans. (#3705)
* FuriHal: properly handle high priority USB IRQ, change CDC decriptor to use separate TX/RX endpoints
* Furi: drop task handle, cleanup casts and memory corrupt in threads
* FuriHal: update max power in USB descriptors
* Furi: properly handle thread free if thread was not started
* Furi crash: meaningful interrupt name instead of id

---------

Co-authored-by: SG <who.just.the.doctor@gmail.com>
2024-06-13 01:07:29 +10:00

124 lines
3.8 KiB
C

#pragma once
#include <stm32wbxx_ll_tim.h>
#ifdef __cplusplus
extern "C" {
#endif
/** Timer ISR */
typedef void (*FuriHalInterruptISR)(void* context);
typedef enum {
// TIM1, TIM16, TIM17
FuriHalInterruptIdTim1TrgComTim17,
FuriHalInterruptIdTim1Cc,
FuriHalInterruptIdTim1UpTim16,
// TIM2
FuriHalInterruptIdTIM2,
// DMA1
FuriHalInterruptIdDma1Ch1,
FuriHalInterruptIdDma1Ch2,
FuriHalInterruptIdDma1Ch3,
FuriHalInterruptIdDma1Ch4,
FuriHalInterruptIdDma1Ch5,
FuriHalInterruptIdDma1Ch6,
FuriHalInterruptIdDma1Ch7,
// DMA2
FuriHalInterruptIdDma2Ch1,
FuriHalInterruptIdDma2Ch2,
FuriHalInterruptIdDma2Ch3,
FuriHalInterruptIdDma2Ch4,
FuriHalInterruptIdDma2Ch5,
FuriHalInterruptIdDma2Ch6,
FuriHalInterruptIdDma2Ch7,
// RCC
FuriHalInterruptIdRcc,
// Comp
FuriHalInterruptIdCOMP,
// HSEM
FuriHalInterruptIdHsem,
// LPTIMx
FuriHalInterruptIdLpTim1,
FuriHalInterruptIdLpTim2,
//UARTx
FuriHalInterruptIdUart1,
//LPUARTx
FuriHalInterruptIdLpUart1,
// Service value
FuriHalInterruptIdMax,
} FuriHalInterruptId;
typedef enum {
FuriHalInterruptPriorityLowest =
-3, /**< Lowest priority level, you can use ISR-safe OS primitives */
FuriHalInterruptPriorityLower =
-2, /**< Lower priority level, you can use ISR-safe OS primitives */
FuriHalInterruptPriorityLow =
-1, /**< Low priority level, you can use ISR-safe OS primitives */
FuriHalInterruptPriorityNormal =
0, /**< Normal(default) priority level, you can use ISR-safe OS primitives */
FuriHalInterruptPriorityHigh =
1, /**< High priority level, you can use ISR-safe OS primitives */
FuriHalInterruptPriorityHigher =
2, /**< Higher priority level, you can use ISR-safe OS primitives */
FuriHalInterruptPriorityHighest =
3, /**< Highest priority level, you can use ISR-safe OS primitives */
/* Special group, read docs first(ALL OF THEM: especially FreeRTOS configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY) */
FuriHalInterruptPriorityKamiSama =
6, /**< Forget about thread safety, you are god now. No one can prevent you from messing with OS critical section. You are not allowed to use any OS primitives, but who can stop you? Use this priority only for direct hardware interaction with LL HAL. */
} FuriHalInterruptPriority;
/** Initialize interrupt subsystem */
void furi_hal_interrupt_init(void);
/** Set ISR and enable interrupt with default priority
*
* @warning Interrupt flags are not cleared automatically. You may want to
* ensure that your peripheral status flags are cleared.
*
* @param index - interrupt ID
* @param isr - your interrupt service routine or use NULL to clear
* @param context - isr context
*/
void furi_hal_interrupt_set_isr(FuriHalInterruptId index, FuriHalInterruptISR isr, void* context);
/** Set ISR and enable interrupt with custom priority
*
* @warning Interrupt flags are not cleared automatically. You may want to
* ensure that your peripheral status flags are cleared.
*
* @param index - interrupt ID
* @param priority - One of FuriHalInterruptPriority
* @param isr - your interrupt service routine or use NULL to clear
* @param context - isr context
*/
void furi_hal_interrupt_set_isr_ex(
FuriHalInterruptId index,
FuriHalInterruptPriority priority,
FuriHalInterruptISR isr,
void* context);
/** Get interrupt name by exception number.
* Exception number can be obtained from IPSR register.
*
* @param exception_number
* @return const char* or NULL if interrupt name is not found
*/
const char* furi_hal_interrupt_get_name(uint8_t exception_number);
#ifdef __cplusplus
}
#endif