Linux内核API enable_irq_wake|极客笔记

enable_irq_wake函数功能描述：函数enable_irq_wake( )在实现过程中调用了函数irq_set_irq_wake( )，在调用时传递的第二个参数是1。enable_irq_wake( )使中断能够从睡眠状态唤醒，增加其唤醒深度wake_depth的值，并且改变当前的状态，使其处于唤醒状态。

enable_irq_wake文件包含

#include<linux/interrupt.h>

enable_irq_wake函数定义

在内核源码中的位置：linux-3.19.3/include/linux/interrupt.h

函数定义格式：

static inline int enable_irq_wake(unsigned int irq)
{
    return irq_set_irq_wake(irq, 1);
}

enable_irq_wake输入参数说明

此函数的参数是int型变量，代表操作中断对应的中断号，与数组irq_desc中元素的下标相对应，根据它查找对应设备的中断服务例程，其取值范围是0～NR_IRQS-1，其中NR_IRQS的值是16640。

enable_irq_wake返回参数说明

此函数的返回值是整数，代表执行的结果，可能的取值为-6、0。返回-6说明当前中断号对应的irq_desc[]数组中元素的chip字段的set_wake字段值为NULL，此时函数的相应功能无法实现，即函数既不改变中断唤醒的深度也不改变当前中断的状态。对于函数enable_irq_wake( )返回0说明其功能实现，即既改变唤醒的深度也改变了当前中断的状态。

enable_irq_wake实例解析

编写测试文件：enable_irq_wake.c

头文件引用及全局变量定义：

#include<linux/module.h>
#include<linux/interrupt.h>
MODULE_LICENSE("GPL");
static int irq=3;  //定义中断号

中断处理函数定义：

// 自定义中断处理函数，在此只有显示功能
static irqreturn_t irq_handler(int data, void *dev_id)
{
    printk("the data is :%d\n", data);  //data是对应的中断号
    printk("in the interrupt handler function\n");
    return IRQ_NONE;
}

模块加载函数定义及验证函数调用：

static int __init enable_irq_wake_init(void)
{
    int result=0, result1=0;
    printk("into enable_irq_wake_init\n");
    result=request_irq(irq, irq_handler, IRQF_DISABLED, "A_New_Device", NULL);
                                  // 申请中断
    result1=enable_irq_wake(irq); //调用enable_irq_wake( )函数改变中断的状态及唤醒深度
    printk("the request_irq result is: %d\n", result); //显示函数request_irq( )返回结果
    printk("the enable_irq_wake result is :%d\n", result1);
                                  //显示函数enable_irq_wake( )返回结果
    printk("out enable_irq_wake_init\n");
    return 0;
}

模块卸载函数定义：

static void __exit enable_irq_wake_exit(void)
{
    free_irq(irq, NULL);           //释放申请的中断
    printk("Goodbye enable_irq_wake\n");
    return;
}

模块加载及卸载函数调用：

module_init(enable_irq_wake_init);
module_exit(enable_irq_wake_exit);

实例运行结果及分析：

编译模块，执行命令insmod enable_irq_wake.ko插入模块，然后输入命令dmesg -c查看内核输出信息，出现如图A所示的结果。

Linux内核API enable_irq_wake

在模块卸载之前，输入命令cat /proc/interrupts查看文件/proc/interrupts内容，出现图B所示的信息。

Linux内核API enable_irq_wake

结果分析：

由图A可以看出函数request_irq( )的返回值是0，说明申请中断成功，图B的显示信息也能说明这一点。函数enable_irq_wake( )的返回值是0，说明enable_irq_wake( )的功能可实现，以及与申请的中断号对应的irq_desc[]数组中元素的chip的字段不为NULL，所以返回0。