跳至主要內容

Irq模块用户手册

大约 9 分钟约 2797 字2025/12/26

Irq模块用户手册

目录

1. 简介

本模块提供了对 中断控制器 的抽象接口，支持以下功能：

  • 初始化: 通过 HLI_Irq_Init 函数配置中断模块，包括设置中断优先级分组以及各个中断源的抢占优先级和子优先级。
  • 使能/禁止中断: 通过 HLI_Irq_SetIntrStatus 函数可以使能或禁止特定的中断源。
  • 反初始化: 通过 HLI_Irq_DeInit 函数可以禁止所有在 HLI_Irq_Init 中配置的中断。
  • 全局中断控制: 提供了 HLI_ENABLE_INTERRUPT() 和 HLI_DISABLE_INTERRUPT() 宏来全局使能和禁止中断。

1.1 支持的设备

当前软件适用于以下芯片:

  • KF32A158xxxSF

1.2 名词及缩写

缩写解释
MCU微控制器
ISR中断服务例程
IRQ中断请求

2. 文件结构

文件名称描述
kf32axxx_hli_irq.c此文件包含irq驱动程序的通用功能
kf32axxx_hli_irq.h此头文件输出irq驱动程序的宏、类型定义和函数原型
kf32axxx_hli_irq_cfg.h此头文件输出irq驱动程序的配置相关定义
kf32axxx_hli_irq_Lcfg.c此头文件输出irq驱动程序的配置相关原型
kf32axxx_hli_irq_Lcfg.h此头文件输出irq驱动程序的配置相关定义

3. 数据结构

3.1 数据类型

3.1.1 宏定义

  1. 中断优先级分组

    hdy解释
    INTR_PREEMP_0抢占优先级为 3 位, 子优先级为 1 位。抢占优先级范围：0 - 7，子优先级范围：0 - 1
    INTR_PREEMP_1抢占优先级为 2 位, 子优先级为 2 位。抢占优先级范围：0 - 3，子优先级范围：0 - 3
    INTR_PREEMP_2抢占优先级为 1 位, 子优先级为 3 位。抢占优先级范围：0 - 1，子优先级范围：0 - 7
    INTR_PREEMP_3抢占优先级为 0 位, 子优先级为 4 位。抢占优先级范围：0，子优先级范围：0 - 15

3.1.2 枚举

  1. 中断类型

    枚举值解释
    HLI_SYSTICK_IRQNSYSTICK 中断类型
    HLI_WWDT_IRQNWWDT 中断类型
    HLI_EINT16_IRQNEINT16 中断类型
    HLI_PA_IRQNPA 中断类型
    HLI_PB_IRQNPB 中断类型
    HLI_PC_IRQNPC 中断类型
    HLI_PD_IRQNPD 中断类型
    HLI_PE_IRQNPE 中断类型
    HLI_PF_IRQNPF 中断类型
    HLI_PX_IRQNPX 中断类型
    HLI_T1_IRQNT1 中断类型
    HLI_T3_IRQNT3 中断类型
    HLI_T5_IRQNT5 中断类型
    HLI_T6_IRQNT6 中断类型
    HLI_CANFD6MB15TO0_IRQNCANFD6MB15TO0 中断类型
    HLI_CANFD6MB31TO16_IRQNCANFD6MB31TO16 中断类型
    HLI_CANFD6MB47TO32_IRQNCANFD6MB47TO32 中断类型
    HLI_CANFD6MB63TO48_IRQNCANFD6MB63TO48 中断类型
    HLI_T14_IRQNT14 中断类型
    HLI_RNG_IRQNRNG 中断类型
    HLI_CANFD7MB15TO0_IRQNCANFD7MB15TO0 中断类型
    HLI_CANFD7MB31TO16_IRQNCANFD7MB31TO16 中断类型
    HLI_ADC0_IRQNADC0 中断类型
    HLI_ADC1_IRQNADC1 中断类型
    HLI_CANFD6BUS_IRQNCANFD6BUS 中断类型
    HLI_T11_IRQNT11 中断类型
    HLI_T0_IRQNT0 中断类型
    HLI_DMA0_IRQNDMA0 中断类型
    HLI_CMP_IRQNCMP 中断类型
    HLI_USART0_IRQNUSART0 中断类型
    HLI_USART1_IRQNUSART1 中断类型
    HLI_SPI0_IRQNSPI0 中断类型
    HLI_SPI1_IRQNSPI1 中断类型
    HLI_DMA1_IRQNDMA1 中断类型
    HLI_EINT19TO17_IRQNEINT19TO17 中断类型
    HLI_CANFD6_IRQNCANFD6 中断类型
    HLI_CANFD7_IRQNCANFD7 中断类型
    HLI_CANFD7MB47TO32_IRQNCANFD7MB47TO32 中断类型
    HLI_CANFD7MB63TO48_IRQNCANFD7MB63TO48 中断类型
    HLI_EINT31TO20_IRQNEINT31TO20 中断类型
    HLI_CMU_IRQNCMU 中断类型
    HLI_OSC_IRQNOSC 中断类型
    HLI_CLK_IRQNCLK 中断类型
    HLI_IIC0_IRQNIIC0 中断类型
    HLI_IIC1_IRQNIIC1 中断类型
    HLI_IIC2_IRQNIIC2 中断类型
    HLI_T12_IRQNT12 中断类型
    HLI_T2_IRQNT2 中断类型
    HLI_T4_IRQNT4 中断类型
    HLI_T13_IRQNT13 中断类型
    HLI_USART2_IRQNUSART2 中断类型
    HLI_T16_IRQNT16 中断类型
    HLI_USART6_IRQNUSART6 中断类型
    HLI_SPI2_IRQNSPI2 中断类型
    HLI_CANFD7BUS_IRQNCANFD7BUS 中断类型
    HLI_WKP_IRQNWKP 中断类型
    HLI_CANFD8BUS_IRQNCANFD8BUS 中断类型
    HLI_T20_IRQNT20 中断类型
    HLI_USART3_IRQNUSART3 中断类型
    HLI_SHA_IRQNSHA 中断类型
    HLI_RSA_IRQNRSA 中断类型
    HLI_FIRSTKPROG_IRQNFIRSTKPROG 中断类型
    HLI_FIRSTKSERA_IRQNFIRSTKSERA 中断类型
    HLI_CANFD8MB15TO0_IRQNCANFD8MB15TO0 中断类型
    HLI_CANFD8MB31TO16_IRQNCANFD8MB31TO16 中断类型
    HLI_CANFD8MB47TO32_IRQNCANFD8MB47TO32 中断类型
    HLI_CANFD8MB63TO48_IRQNCANFD8MB63TO48 中断类型
    HLI_CANFD8_IRQNCANFD8 中断类型
    HLI_CANFD9_IRQNCANFD9 中断类型
    HLI_T31_IRQNT31 中断类型
    HLI_T32_IRQNT32 中断类型
    HLI_T33_IRQNT33 中断类型
    HLI_T36_IRQNT36 中断类型
    HLI_T9_IRQNT9 中断类型
    HLI_T10_IRQNT10 中断类型
    HLI_CANFD9BUS_IRQNCANFD9BUS 中断类型
    HLI_STOPWATCHTICK_IRQNSTOPWATCHTICK 中断类型
    HLI_T21_IRQNT21 中断类型
    HLI_FLASHABUSY_IRQNFLASHABUSY 中断类型
    HLI_FLASHBBUSY_IRQNFLASHBBUSY 中断类型
    HLI_SRAMECC_IRQNSRAMECC 中断类型
    HLI_DRAMECC_IRQNDRAMECC 中断类型
    HLI_CACHEECC_IRQNCACHEECC 中断类型
    HLI_FLASHERR_IRQNFLASHERR 中断类型
    HLI_ISMU_IRQNISMU 中断类型
    HLI_CANFD9MB15TO0_IRQNCANFD9MB15TO0 中断类型
    HLI_CANFD9MB31TO16_IRQNCANFD9MB31TO16 中断类型
    HLI_CANFD9MB47TO32_IRQNCANFD9MB47TO32 中断类型
    HLI_CANFD9MB63TO48_IRQNCANFD9MB63TO48 中断类型
    HLI_AES_IRQNAES 中断类型
    HLI_BUSERR_IRQNBUSERR 中断类型
    HLI_IRQ_MAX-

    注

    以上枚举值适用于 KF32A158xxxSF系列。

3.1.3 类型定义

无。

3.2 配置项说明

  1. 静态配置

    静态配置在 kf32axxx_hli_irq_cfg.h 文件中通过宏定义完成，用于使能或禁止各个模块的统一中断。

    宏定义解释使用说明
    WWDT_UNIFIED_INTERRUPTWWDT 中断使用时开启
    EINT16_UNIFIED_INTERRUPTEINT16 中断关闭
    PA_UNIFIED_INTERRUPTPA 中断使用时开启
    PB_UNIFIED_INTERRUPTPB 中断使用时开启
    PC_UNIFIED_INTERRUPTPC 中断使用时开启
    PD_UNIFIED_INTERRUPTPD 中断使用时开启
    PE_UNIFIED_INTERRUPTPE 中断使用时开启
    PF_UNIFIED_INTERRUPTPF 中断使用时开启
    PX_UNIFIED_INTERRUPTPX 中断使用时开启
    T1_UNIFIED_INTERRUPTT1 中断使用时开启
    T3_UNIFIED_INTERRUPTT3 中断使用时开启
    T5_UNIFIED_INTERRUPTT5 中断使用时开启
    T6_UNIFIED_INTERRUPTT6 中断使用时开启
    CANFD6MB15TO0_UNIFIED_INTERRUPTCANFD6MB15TO0 中断使用时开启
    CANFD6MB31TO16_UNIFIED_INTERRUPTCANFD6MB31TO16 中断使用时开启
    CANFD6MB47TO32_UNIFIED_INTERRUPTCANFD6MB47TO32 中断使用时开启
    CANFD6MB63TO48_UNIFIED_INTERRUPTCANFD6MB63TO48 中断使用时开启
    T14_UNIFIED_INTERRUPTT14 中断使用时开启
    RNG_UNIFIED_INTERRUPTRNG 中断使用时开启
    CANFD7MB15TO0_UNIFIED_INTERRUPTCANFD7MB15TO0 中断使用时开启
    CANFD7MB31TO16_UNIFIED_INTERRUPTCANFD7MB31TO16 中断使用时开启
    ADC0_UNIFIED_INTERRUPTADC0 中断使用时开启
    ADC1_UNIFIED_INTERRUPTADC1 中断使用时开启
    CANFD6BUS_UNIFIED_INTERRUPTCANFD6BUS 中断使用时开启
    T11_UNIFIED_INTERRUPTT11 中断关闭
    T0_UNIFIED_INTERRUPTT0 中断使用时开启
    DMA0_UNIFIED_INTERRUPTDMA0 中断建议开启
    CMP_UNIFIED_INTERRUPTCMP 中断关闭
    USART0_UNIFIED_INTERRUPTUSART0 中断使用时开启
    USART1_UNIFIED_INTERRUPTUSART1 中断使用时开启
    SPI0_UNIFIED_INTERRUPTSPI0 中断使用时开启
    SPI1_UNIFIED_INTERRUPTSPI1 中断使用时开启
    DMA1_UNIFIED_INTERRUPTDMA1 中断建议开启
    EINT19TO17_UNIFIED_INTERRUPTEINT19TO17 中断使用时开启
    CANFD6GEN_UNIFIED_INTERRUPTCANFD6 中断使用时开启
    CANFD7GEN_UNIFIED_INTERRUPTCANFD7 中断使用时开启
    CANFD7MB47TO32_UNIFIED_INTERRUPTCANFD7MB47TO32 中断使用时开启
    CANFD7MB63TO48_UNIFIED_INTERRUPTCANFD7MB63TO48 中断使用时开启
    EINT31TO20_UNIFIED_INTERRUPTEINT31TO20 中断关闭
    CMU_UNIFIED_INTERRUPTCMU 中断使用时开启
    OSC_UNIFIED_INTERRUPTOSC 中断使用时开启
    CLK_UNIFIED_INTERRUPTCLK 中断使用时开启
    IIC0_UNIFIED_INTERRUPTIIC0 中断使用时开启
    IIC1_UNIFIED_INTERRUPTIIC1 中断使用时开启
    IIC2_UNIFIED_INTERRUPTIIC2 中断使用时开启
    T12_UNIFIED_INTERRUPTT12 中断关闭
    T2_UNIFIED_INTERRUPTT2 中断使用时开启
    T4_UNIFIED_INTERRUPTT4 中断使用时开启
    T13_UNIFIED_INTERRUPTT13 中断关闭
    USART2_UNIFIED_INTERRUPTUSART2 中断使用时开启
    T16_UNIFIED_INTERRUPTT16 中断关闭
    USART6_UNIFIED_INTERRUPTUSART6 中断使用时开启
    SPI2_UNIFIED_INTERRUPTSPI2 中断使用时开启
    CANFD7BUS_UNIFIED_INTERRUPTCANFD7BUS 中断使用时开启
    WKP_UNIFIED_INTERRUPTWKP 中断关闭
    CANFD8BUS_UNIFIED_INTERRUPTCANFD8BUS 中断使用时开启
    T20_UNIFIED_INTERRUPTT20 中断使用时开启
    USART3_UNIFIED_INTERRUPTUSART3 中断使用时开启
    SHA_UNIFIED_INTERRUPTSHA 中断使用时开启
    RSA_UNIFIED_INTERRUPTRSA 中断使用时开启
    FIRSTKPROG_UNIFIED_INTERRUPTFIRSTKPROG 中断使用时开启
    FIRSTKSERA_UNIFIED_INTERRUPTFIRSTKSERA 中断使用时开启
    CANFD8MB15TO0_UNIFIED_INTERRUPTCANFD8MB15TO0 中断使用时开启
    CANFD8MB31TO16_UNIFIED_INTERRUPTCANFD8MB31TO16 中断使用时开启
    CANFD8MB47TO32_UNIFIED_INTERRUPTCANFD8MB47TO32 中断使用时开启
    CANFD8MB63TO48_UNIFIED_INTERRUPTCANFD8MB63TO48 中断使用时开启
    CANFD8GEN_UNIFIED_INTERRUPTCANFD8 中断使用时开启
    CANFD9GEN_UNIFIED_INTERRUPTCANFD9 中断使用时开启
    T31_UNIFIED_INTERRUPTT31 中断关闭
    T32_UNIFIED_INTERRUPTT32 中断关闭
    T33_UNIFIED_INTERRUPTT33 中断关闭
    T36_UNIFIED_INTERRUPTT36 中断关闭
    T9_UNIFIED_INTERRUPTT9 中断使用时开启
    T10_UNIFIED_INTERRUPTT10 中断使用时开启
    CANFD9BUS_UNIFIED_INTERRUPTCANFD9BUS 中断使用时开启
    STOPWATCHTICK_UNIFIED_INTERRUPTSTOPWATCHTICK 中断使用时开启
    T21_UNIFIED_INTERRUPTT21 中断使用时开启
    FLASHABUSY_UNIFIED_INTERRUPTFLASHABUSY 中断使用时开启
    FLASHBBUSY_UNIFIED_INTERRUPTFLASHBBUSY 中断使用时开启
    SRAMECC_UNIFIED_INTERRUPTSRAMECC 中断使用时开启
    DRAMECC_UNIFIED_INTERRUPTDRAMECC 中断使用时开启
    CACHEECC_UNIFIED_INTERRUPTCACHEECC 中断使用时开启
    FLASHERR_UNIFIED_INTERRUPTFLASHERR 中断使用时开启
    ISMU_UNIFIED_INTERRUPTISMU 中断使用时开启
    CANFD9MB15TO0_UNIFIED_INTERRUPTCANFD9MB15TO0 中断使用时开启
    CANFD9MB31TO16_UNIFIED_INTERRUPTCANFD9MB31TO16 中断使用时开启
    CANFD9MB47TO32_UNIFIED_INTERRUPTCANFD9MB47TO32 中断使用时开启
    CANFD9MB63TO48_UNIFIED_INTERRUPTCANFD9MB63TO48 中断使用时开启
    AES_UNIFIED_INTERRUPTAES 中断使用时开启
    BUSERR_UNIFIED_INTERRUPTBUSERR 中断使用时开启

    注

    以上宏定义适用于 KF32A158xxxSF系列。

  2. 中断优先级配置 (HLI_PriorityType)

    成员解释取值范围
    Preemption_Priority抢占优先级取决于优先级分组，数值越小，优先级越高。
    Sub_Priority子优先级取决于优先级分组，数值越小，优先级越高。

  3. Irq 配置 (HLI_Irq_ConfigType)

    成员解释取值范围
    PriorityGroup中断优先级分组模式参考中断优先级分组。
    XXX_Priority对应外设中断优先级指向 HLI_PriorityType 类型的变量。

4. 驱动函数

4.1 函数接口

4.1.1 HLI_Irq_Init

NameDescription
函数名称HLI_Irq_Init
语法void HLI_Irq_Init(const HLI_Irq_ConfigType *IrqConfigPtr)
同步/异步同步
重入性不可重入
形参(输入)IrqConfigPtr: 指向Irq配置信息的指针
返回值无
描述配置中断优先级分组和各外设中断优先级，支持多个中断源。
注意事项IrqConfigPtr 不能为空；仅配置启用的中断源。

4.1.2 HLI_Irq_SetIntrStatus

NameDescription
函数名称HLI_Irq_SetIntrStatus
语法bool HLI_Irq_SetIntrStatus(HLI_Irq_NumType IrqNum, bool Status)
同步/异步同步
重入性不可重入
形参(输入)IrqNum: 中断号
形参(输入)Status: true 为使能, false 为关闭
返回值true: 设置成功
返回值false: 设置失败
描述使能或禁止指定的中断。
注意事项无

4.1.3 HLI_Irq_DeInit

NameDescription
函数名称HLI_Irq_DeInit
语法void HLI_Irq_DeInit(void)
同步/异步同步
重入性可重入
形参(输入)无
返回值无
描述反初始化 Irq 模块，恢复默认中断配置。
注意事项仅反初始化已配置的中断源。

4.1.4 HLI_ENABLE_INTERRUPT

NameDescription
函数名称HLI_ENABLE_INTERRUPT
语法#define HLI_ENABLE_INTERRUPT() do{__asm volatile("ENI");__asm volatile("NOP");} while (0)
同步/异步同步
重入性可重入
形参(输入)无
返回值无
描述使能全局中断。
注意事项此功能为宏定义, 非一般函数。

4.1.5 HLI_DISABLE_INTERRUPT

NameDescription
函数名称HLI_DISABLE_INTERRUPT
语法#define HLI_DISABLE_INTERRUPT() do{__asm volatile("DSI");__asm volatile("NOP");} while (0)
同步/异步同步
重入性可重入
形参(输入)无
返回值无
描述关闭全局中断。
注意事项此功能为宏定义, 非一般函数。

4.2 中断回调

Irq 模块本身不提供中断回调函数。用户应在相应外设的驱动中注册和实现回调。

5. 使用示例

注

示例中使用的参数仅用作示例演示，应用时以实际为准。

1. 基本初始化与配置

此示例展示如何初始化 Irq 模块并设置 DMA 中断优先级。

6. 限制与假设

  • 优先级分组固定为 4 种模式，不支持自定义分组位宽。

7. 变更记录

版本时间变更记录
v1.02025.11.21新增初版文档
最近更新
贡献者: 翟宇