[笔记].Nios II 9.1的sys/alt_irq.h与之前版本的区别

引子

以前版本的sys/alt_irq.h，我在这里就不多说了；此处仅浅析9.1版本的增强版的sys/alt_irq.h。

浅析

[b]1 增强版的API[/b]
表1 增强版的HAL中断的API





[b]2 先前的HAL中断API[/b]

alt_irq_register()

alt_irq_disable()

alt_irq_enable()

alt_irq_disable_all()

alt_irq_enable_all()

alt_irq_interruptible()

alt_irq_non_interruptible()

alt_irq_enabled()

[b]3 写ISR[/b]
[b]（1）使用增强版中断API注册ISR[/b]

int alt_ic_isr_register(alt_u32 ic_id,
alt_u32 irq,
alt_isr_func isr,
void *isr_context,
void* flags)

ic_id为中断控制器标号，定义于system.h之中。在使用菊花链的EIC中，ic_id使用菊花链标识EIC；在IIC中，ic_id则不重要。

irq为设备的硬件中断号，定义于system.h之中。

对于IIC来讲，irq就是IRQ号。中断的优先级与IRQ的编号成相反顺序。故IRQ_0代表最高优先级的中断，IRQ_31则是最低优先级的。

对于EIC来讲，irq就是中断端口的ID。

isr_context指向与设备驱动实例相关的数据结构体。isr_context传递输入参数给中断服务程序的函数。用于传递特定上下文的信息给ISR，也可指向任何特定ISR的信息。该上下文的值对于HAL是不透明的；it is provided entirely for the benefit of the user-defined ISR。

isr指向相应的IRQ号的irq调用的ISR函数的指针。ISR函数原型如下：

void handle_button_interrupts(void* isr_context);

给该函数提供的输入参数就是isr_context。

注： 给isr注册空指针，将会导致中断失去使能；handle_button_interrupts为isr服务函数名称，不固定。

flags保留未用。

[b]（2）使能或者去使能中断[/b]
增强版的中断API提供如下函数：alt_ic_irq_disable()，alt_ic_irq_enable()，alt_ic_irq_enabled()，alt_irq_disable_all()，alt_irq_enable_all()。

alt_irq_enable()允许编程以使某些部分的代码禁用硬件中断，或此后重新使能它们。

alt_ic_irq_disable()和alt_ic_irq_enable()允许使能或去使能单独的中断。

alt_irq_disable_all（）去使能所有中断，并返回一上下文值。

欲重新使能硬件中断，可调用alt_irq_enable_all()，并传递上下文参数。中断在返回状态的优先级之前调用alt_irq_disable_all()。

若可屏蔽的异常被使能，则alt_irq_enabled()返回非零值。

alt_ic_irq_enabled()则决定那个被指定的中断被使能。

[b]（3）升级至增强版的HAL中断[/b]
表2 升级HAL中断的API





[b]（4）支持多种HAL中断的API[/b]
在软件编译工具中选择中断API，使用system.h中的如下符号来定义其中之一，来标识哪种中断API可用：

ALT_ENHANCED_INTERRUPT_PRESENT——定义使用增强版的API实现

ALT_LEGACY_INERRUPT_API_PRESENT——定义使用先前的API实现

在用户的驱动代码中，使用这些符号来决定哪种API被调用。

[b]（5）使用HAL注册按键中断的C范例[/b]

#include "system.h"
#include "sys/alt_irq.h"
#include "altera_avalon_pio_regs.h"

// 定义全局变量以储存边沿捕获值
volatile int edge_capture;

//  初始化button_pio
static void init_button_pio()
{
// 改写edge_capture指针以匹配alt_irq_register()函数原型
void* edge_capture_ptr = (void*) &edge_capture;

// 使能所有4个按钮中断
IOWR_ALTERA_AVALON_PIO_IRQ_MASK(BUTTON_PIO_BASE, 0xf);

// 清边沿捕获寄存器
IOWR_ALTERA_AVALON_PIO_EDGE_CAP(BUTTON_PIO_BASE, 0x0);

// 注册ISR
// Nios II 9.1
#ifdef ALT_ENHANCED_INTERRUPT_API_PRESENT
alt_ic_isr_register(BUTTON_PIO_IRQ_INTERRUPT_CONTROLLER_ID,
BUTTON_PIO_IRQ,
handle_button_interrupts,
edge_capture_ptr, 0x0);
// Nios II 9.1之前版本
#else
alt_irq_register(BUTTON_PIO_IRQ,
edge_capture_ptr,
handle_button_interrupts);
#endif
}

此处的BUTTON_PIO_IRQ为按钮中断的中断号；handle_button_interrupts为按钮中断的中断服务子程序，未列出。

[b]4 完整的ISR使用范例[/b]
[笔记].如何使用Nios II的中断：PIO中断与定时器中断

附录

[b]1 Nios II HAL 源代码路径[/b]
X:\Altera\91\nios2eds\components\altera_nios2\HAL

参考

1 finalspeed的空间.quartus9.1中断的写法

2 Altera. Exception Handling.Interrupt Service Routines

3 Altera.HAL API Reference