request_irq() | 注册中断服务

1、中断注册方法

在linux内核中用于申请中断的函数是request_irq（），函数原型在Kernel/irq/manage.c中定义：

int request_irq(unsigned int irq, irq_handler_t handler,
                         unsigned long irqflags, const char *devname, void *dev_id)

irq是要申请的硬件中断号。

handler是向系统注册的中断处理函数，是一个回调函数，中断发生时，系统调用这个函数，dev_id参数将被传递给它。

irqflags是中断处理的属性，若设置了IRQF_DISABLED （老版本中的SA_INTERRUPT，本版zhon已经不支持了），则表示中断处理程序是快速处理程序，快速处理程序被调用时屏蔽全部中断，慢速处理程序不屏蔽；若设置了IRQF_SHARED （老版本中的SA_SHIRQ），则表示多个设备共享中断，若设置了IRQF_SAMPLE_RANDOM（老版本中的SA_SAMPLE_RANDOM），表示对系统熵有贡献，对系统获取随机数有好处。（这几个flag是能够经过或的方式同时使用的）

devname设置中断名称，一般是设备驱动程序的名称  在cat /proc/interrupts中能够看到此名称。

dev_id在中断共享时会用到，通常设置为这个设备的设备结构体或者NULL。

request_irq()返回0表示成功，返回-INVAL表示中断号无效或处理函数指针为NULL，返回-EBUSY表示中断已经被占用且不能共享。

==================================================================================================================================

request_irq() | 注册中断服务

 

 

在 2.4 内核和 2.6内核中都使用  request_irq() 函数来注册中断服务函数。在 2.4 内核中，须要包含的头文件是 #include <linux/sched.h> ，2.6 内核中须要包含的头文件则是
#include <linux/interrupt.h> 。函数原型以下：

• 2.4 内核

int request_irq ( unsignedintirq, void (*handler)( int, void*, structpt_regs*), unsignedlongfrags, constchar*device, void*dev_id);

• 2.6 内核

request_irq( unsignedintirq,irq_handler_thandler, unsignedlongflags, constchar*name, void*dev);

参数说明：

在发生对应于第 1个参数  irq 的中断时，则调用第 2 个参数 handler 为要注册的中断服务函数(也就是把 handler() 中断服务函数注册到内核中 )。

第 3 个参数  flags 指定了 快速中断或中断共享等中断处理属性。在 2.6 教新的内核里(个人是 2.6.27 ~ 2.6.31 )，在 linux/interrupt.h 中定义操做这个参数的宏以下：

引用

/*
 * These correspond to the IORESOURCE_IRQ_* defines in
 * linux/ioport.h to select the interrupt line behaviour.  When
 * requesting an interrupt without specifying a IRQF_TRIGGER, the
 * setting should be assumed to be "as already configured", which
 * may be as per machine or firmware initialisation.

#define IRQF_TRIGGER_NONE0x00000000
#define IRQF_TRIGGER_RISING 0x00000001
#define IRQF_TRIGGER_FALLING 0x00000002   
#define IRQF_TRIGGER_HIGH 0x00000004                   指定中断触发类型：高电平有效。新增长的标志 
#define IRQF_TRIGGER_LOW 0x00000008
#define IRQF_TRIGGER_MASK (IRQF_TRIGGER_HIGH | IRQF_TRIGGER_LOW | \
IRQF_TRIGGER_RISING | IRQF_TRIGGER_FALLING)
#define IRQF_TRIGGER_PROBE 0x00000010

/*
* These flags used only by the kernel as part of the  irq handling routines.
*                registered first in an shared interrupt is considered for
*                performance reasons)
*/
#define IRQF_DISABLED           0x00000020         * IRQF_DISABLED - keep irqs disabled when calling the action handler
#define IRQF_SAMPLE_RANDOM      0x00000040 * IRQF_SAMPLE_RANDOM - irq is used to feed the random generator
#define IRQF_SHARED             0x00000080 * IRQF_SHARED - allow sharing the irq among several devices

#define IRQF_PROBE_SHARED       0x00000100 * IRQF_PROBE_SHARED - set by callers when they expect sharing mismatches to occur
#define IRQF_TIMER              0x00000200 * IRQF_TIMER - Flag to mark this interrupt as timer interrupt

#define IRQF_PERCPU             0x00000400 * IRQF_PERCPU - Interrupt is per cpu
#define IRQF_NOBALANCING        0x00000800 * IRQF_NOBALANCING - Flag to exclude this interrupt from irq balancing
#define IRQF_IRQPOLL            0x00001000 * IRQF_IRQPOLL - Interrupt is used for polling (only the interrupt that is
早期一点的 2.6 内核这里通常以 SA_ 前缀开头，如：

SA_INTERRUPT   表示禁止其余中断；(对应于 IRQF_DISABLED )
SA_SHIRQ             表示共享相同的中断号 (对应于 IRQF_SHARED )
SA_SAMPLE_RANDOM   此宏会影响到 RANDOM 的处理( 对应于 IRQF_SAMPLE_RANDOM )。

第 4 个参数 name，一般是 设备驱动程序的名称。改值用在 /proc/interrupt 系统 (虚拟) 文件上，或内核发生中断错误时使用。

第 5 个参数  dev_id 中断名称 可做为共享中断时的中断区别参数，也能够用来指定中断服务函数须要参考的数据地址。建议将设备结构指针做为dev_id参数

int request_irq(unsigned int irq, irq_handler_t handler,
        IRQF_SHARED, const char *devname, void *dev_id)

不少权威资料中都提到，中断共享注册时的注册函数中的dev_id参数是必不可少的，而且dev_id的值必须惟一。那么这里提供惟一的dev_id值的到底是作什么用的？

根据咱们前面中断模型的知识，能够看出发生中断时，内核并不判断到底是共享中断线上的哪一个设备产生了中断，它会循环执行全部该中断线上注册的中断处理函数（即irqaction->handler函数）。所以irqaction->handler函数有责任识别出是不是本身的硬件设备产生了中断，而后再执行该中断处理函数。一般是经过读取该硬件设备提供的中断flag标志位进行判断。那既然kernel循环执行该中断线上注册的全部irqaction->handler函数，把识别到底是哪一个硬件设备产生了中断这件事交给中断处理函数自己去作，那request_irq的dev_id参数到底是作什么用的？

不少资料中都建议将设备结构指针做为dev_id参数。在中断到来时，迅速地根据硬件寄存器中的信息比照传入的dev_id参数判断是不是本设备的中断，若不是，应迅速返回。这样的说法没有问题，也是咱们编程时都遵循的方法。但事实上并不可以说明为何中断共享必需要设置dev_id。

下面解释一下dev_id参数为何必须的，并且是必须惟一的。

当调用free_irq注销中断处理函数时（一般卸载驱动时其中断处理函数也会被注销掉），由于dev_id是惟一的，因此能够经过它来判断从共享中断线上的多个中断处理程序中删除指定的一个。若是没有这个参数，那么kernel不可能知道给定的中断线上到底要删除哪个处理程序。

 

注销函数定义在Kernel/irq/manage.c中定义： 
    void free_irq(unsigned int irq, void *dev_id)

返回值：
函数运行正常时返回 0 ，不然返回对应错误的负值。

示例代码片断：

引用

irqreturn_t xxx_interrupt (intirq,void*dev_id)
{
        ...

        return (IRQ_HANDLED);
}

int xxx_open (struct inode *inode,structfile*filp)
{
        if (!request_irq (XXX_IRQ,xxx_interruppt,IRQF_DISABLED,"xxx",NULL)){

                /*正常注册*/
        }

        return (0);}