Interrupt 使用指南
Interrupt 相关 .c 和 .h 文件分别位于 luban-lite\kernel\common\include\osal\aic_osal_platform_lbl.h 和 luban-lite\bsp\artinchip\sys\dxxx\ 目录。主要源文件说明如下：
| 文件 | 说明 |
|---|---|
| aic_osal_platform_lbl.h | aicos 层中断 注册 & 使能 函数 |
| aic_drv_irq.c | drv 层 interrupt 的实现 |
| aic_drv_gpio.c | drv 层 gpio 中断的扩展 |
模块架构
- 普通中断对于普通中断来说实现的原理非常简单，核心就是两个数组 g_irqvector[] 和 g_irqdata[]，分别用来存储中断处理函数的函数指针和附加数据。对应具体操作如下：
-
中断注册。用户调用 aicos_request_irq() 根据中断号把中断处理函数和附加数据存入到 g_irqvector[] 和 g_irqdata[] 数组。
-
中断处理。中断发生后所有中断首先会跳入 Default_IRQHandler() 通用中断处理函数中，然后根据 MCAUSE 寄存器查询当前的中断号，根据中断号在 g_irqvector[] 和 g_irqdata[] 数组中查询具体的中断处理函数指针和附加数据，然后再跳转到具体 ISR 中执行。
-
- GPIO 中断
GPIO 中断的实现稍有不同。因为 GPIO 一个 Group 只能共享一个中断（一个 Group 最多包含 32 个 Pin），但是用户要求对每个 Pin 单独的注册中断处理函数，所以需要对 GPIO Pin 二级中断进行特殊处理。既能实现功能又能让用户零感知。具体做法如下：
-
扩大 g_irqvector[] 和 g_irqdata[] 数组。让每个 GPIO Pin 中断都拥有独立的存放位置，另外也可以做到对一级中断和二级中断格式一样。
-
中断注册。目前在 rt-thread 下可以使用 rt_pin_attach_irq() 函数来注册 GPIO Pin 中断，使用 rt_pin_irq_enable() 函数来使能 GPIO Pin 中断。
处断处理。GPIO Pin 发生中断以后，首先会跳转到一级中断处理函数 drv_gpio_group_irqhandler() 中执行，通过查询发生中断的 Group 和 Pin Offset，最终在 g_irqvector[] 和 g_irqdata[] 数组中查询到具体的中断处理函数指针和附加数据，然后再跳转到具体 ISR 中执行。
CMU 驱动的逻辑比较简单，目前只在 HAL 层提供了 Clock 和 Reset 的 API 接口。RTOS 驱动和 Baremetal 驱动都可以直接使用。
-
数据结构设计
Interrupt 模块关键结构体定义如下：
irq_handler_t/pin_irq_handler_t
enum irqreturn
{
IRQ_NONE = (0 << 0),
IRQ_HANDLED = (1 << 0),
IRQ_WAKE_THREAD = (1 << 1),
};
typedef enum irqreturn irqreturn_t;
typedef irqreturn_t (*irq_handler_t)(int, void *);
typedef irqreturn_t (*pin_irq_handler_t)(void *);接口设计
| 函数原型 | int aicos_request_irq (unsigned int irq, irq_handler_t handler, unsigned int flags, const char *name, void *data) |
|---|---|
| 功能说明 | 注册中断 |
| 参数 | irq ：中断号 handler：中断处理函数 flags ：中断标志 name ：中断号名称 data ：中断附加数据 |
| 返回值 | 操作是否成功 (0=OK, other=Error) |
| 注意事项 | - |
| 函数原型 | void aicos_irq_enable(unsigned int irq) |
|---|---|
| 功能说明 | 使能中断 |
| 参数 | irq：中断号 |
| 返回值 | 无 |
| 注意事项 | - |
| 函数原型 | void aicos_irq_disable(unsigned int irq) |
|---|---|
| 功能说明 | 关闭中断 |
| 参数 | irq：中断号 |
| 返回值 | 无 |
| 注意事项 | - |
| 函数原型 | void aicos_local_irq_enable(void) |
|---|---|
| 功能说明 | 使能 CPU 全局中断中断 |
| 参数 | 无 |
| 返回值 | 无 |
| 注意事项 | - |
| 函数原型 | void aicos_local_irq_disable(void) |
|---|---|
| 功能说明 | 关闭 CPU 全局中断中断 |
| 参数 | 无 |
| 返回值 | 无 |
| 注意事项 | - |
RTT GPIO Irq API
| 函数原型 | rt_err_t rt_pin_attach_irq (rt_int32_t pin, rt_uint32_t mode, void (*hdr)(void *args), void *args) |
|---|---|
| 功能说明 | 注册 gpio pin 中断 |
| 参数 | pin ：pin 管脚编号 mode：pin 中断模式，上升下降沿、高低电平 hdr ：pin 中断处理函数 args：pin 中断附加数据 |
| 返回值 | 操作是否成功 (0=OK, other=Error) |
| 注意事项 | - |
| 函数原型 | rt_err_t rt_pin_detach_irq(rt_int32_t pin) |
|---|---|
| 功能说明 | 注销 gpio pin 中断 |
| 参数 | pin：pin 管脚编号 |
| 返回值 | 操作是否成功 (0=OK, other=Error) |
| 注意事项 | - |
| 函数原型 | rt_err_t rt_pin_irq_enable(rt_base_t pin, rt_uint32_t enabled) |
|---|---|
| 功能说明 | 使能/关闭 gpio pin 中断 |
| 参数 | pin ：pin 管脚编号 enabled：使能/关闭 |
| 返回值 | 操作是否成功 (0=OK, other=Error) |
| 注意事项 | - |