GPIO及中断API函数

太过爱你忘了你带给我的痛 2022-08-10 00:50 195阅读 0赞

> \#include <linux/gpio.h> // 标准 GPIO\_API  
> 
> 
> int gpio\_request(unsigned gpio, const char \*label);
> 
>  获得并占有 GPIO port 的使用权，由参数 gpio 指定具体 port，非空的lables指针有助于诊断。主要是告诉内核这地址被占用了。当其它地方调用同一地址的gpio\_request就会报告错误，该地址已被申请。在/proc/iomem应该会有地址占用表描述。这种用法的保护作用前提是大家都遵守先申请再访问，有一个地方没遵守这个规则，这功能就失效了。好比进程互斥，必需大家在访问临界资源的时候都得先获取锁一样，其中一个没遵守约定，代码就废了。
> 
>   
> 
> 
>  例1：void gpio\_free(unsigned gpio)；//释放 GPIO port 的使用权，由gpio 指定具体 port。  
>   例2：gpio\_free(RK29\_PIN0\_PA0);//释放GPIO0\_A0  
> 
> 
>   
> 
> 
> int gpio\_direction\_input(unsigned gpio);//返回0
> 
> 例3：gpio\_direction\_input (RK29\_PIN0\_PA0);//把GPIO0\_A0设置为输入  
>  int gpio\_direction\_output(unsigned gpio, int value)；//返回0  
> 
> 
>  例4：gpio\_direction\_output(RK29\_PIN0\_PA0,GPIO\_LOW);//把GPIO0\_A0设置为输出口，且其电平拉低。 
> 
>   
> 
> 
>  int gpio\_get\_value(unsigned gpio);//返回value
> 
>  例5：ret = gpio\_get\_value (RK29\_PIN0\_PA0);// 读取GPIO0\_A0的电平,并赋值给变量ret。  
> 
> 
>   
> 
> 
> void gpio\_set\_value(unsigned gpio, int value);
> 
>  例6：gpio\_set\_value (RK29\_PIN0\_PA0, GPIO\_HIGH);// 设置RK29\_PIN0\_PA0电平为高。  
> 
> 
>  int **gpio\_pull\_updown**(unsigned gpio,unsigned value);
> 
>  value = 0, normal  
>   value = 1, pull up  
>   value = 2, pull down  
>   例7：gpio\_pull\_updown（RK29\_PIN0\_PA0，1）上拉  
> 
> 
>  int gpio\_cansleep(unsigned gpio);
> 
> 支持这种gpio的平台为了通过在这个函数中返回非零来区分其它类型的gpio（需要一个已经被 gpio\_request申请的gpio号）为了访问这些端口，定义了另一组函数接口：  
>   int gpio\_get\_value\_cansleep(unsigned gpio);  
>   void gpio\_set\_value\_cansleep(unsigned gpio, int value);  
>   只能在允许睡眠的上下文中访问这些端口，比如线程化的中断中，  
> 
> 
> static inline int gpio\_is\_valid(int number)//判断GPIO是否有效,有效返回0
> 
> int gpio\_export(unsigned gpio, bool direction\_may\_change);//返回0成功
> 
>  void gpio\_unexport(); //返回0成功
> 
>  int gpio\_export\_link(struct device \*dev, const char \*name, unsigned gpio) 
> 
> //创建到导出GPIO的 sysfs link ，第一个参数是在哪个dev下创建，第二个是参数名字，第三个是gpio编号  
>    
> 
> 
>   
> 
> 
> **中断部分的API:**
> 
> static inline int **gpio\_to\_irq**(unsigned gpio)
> 
>  例8：gpioToIrq = gpio\_to\_irq (RK29\_PIN0\_PA0); // 把GPIO0\_A0的PIN值转换为相应的IRQ值，并赋值给变量gpioToIrq。  
> 
> 
> gpio\_to\_irq()返回的中断编号可以传给request\_irq()和free\_irq()。
> 
> irq\_to\_gpio()返回的gpio编号通常用来调用gpio\_get\_value()，比如在沿触发的中断中获取引脚的状态。有些平台不支持这种映射，应该避免调用映射函数
> 
> static inline int \_\_must\_check request\_irq(unsigned int irq, irq\_handler\_t handler, unsigned long flags, const char \*name, void \*dev)；
> 
> 范例：irq是要申请的硬件中断号； handler是向系统登记的中断处理函数，是一个回调函数，中断发生时，系统调用这个函数，dev参数将被传递； flags是中断处理的属性，若设置SA\_INTERRUPT，标明中断处理程序是快速处理程序，快速处理程序被调用时屏蔽所有中断，慢速处理程序不屏蔽；若设置SA\_SHIRQ，则多个设备共享中断，\*dev在中断共享时会用到，一般设置为这个设备的device结构本身或者NULL。 当flags发生时，触发中断。
> 
> 例9：static irqreturn\_t PA0IntHandler(int irq, void \*dev\_id)  
>

> > \{ 
> 
> >  printk(KERN\_INFO "PA0IntHandler:irq=%d ",irq);
> 
> > return IRQ\_HANDLED;
> 
> > \}
> 
> > void main(void)
> 
> > \{

> > > // 把GPIO0\_A0的PIN值转换为相应的IRQ值，并赋值给变量gpioToIrq。
> 
> > > unsigned long req\_flags = IRQF\_TRIGGER\_RISING;
> 
> > int gpioToIrq = gpio\_to\_irq (RK29\_PIN0\_PA0);
> > 
> >   
> > 
> 
> > > If(gpioToIrq != -1)\{

> > > > //注册PA0IntHandler中断处理函数，中断号是RK29\_PIN0\_PA0，设置为上升沿触发
> 
> > > > request\_irq(gpioToIrq, PA0IntHandler,req\_flags, "PA0\_test", NULL);

> > > \}

> \}
> 
>   
>

void free\_irq(unsigned int irq, void \*dev\_id)//释放中断

> irq: 释放的中断号 dev\_id: 释放的dev\_id  
>  例10： free\_irq(gpio\_to\_irq(RK29\_PIN0\_PA0),NULL);// 释放GPIO0\_A0中断。  
> 
> 
> int set\_irq\_type(unsigned int irq, unsigned int type)
> 
> irq: 指定的中断号type : 设置的中断类型  
>  例11：set\_irq\_type(gpio\_to\_irq(RK2818\_PIN\_PA0),IRQF\_TRIGGER\_LOW);//设置GPIO0\_A0中断为低电平触发  
> 
> 
>  void disable\_irq\_nosync(unsigned int irq)
> 
> 强行关闭指定中断，不会等待当前中断处理程序执行完毕。，立即返回  
>  例12：disable\_irq\_nosync(gpio\_to\_irq(RK29\_PIN0\_PA0));//关闭GPIO0\_A0中断。  
> 
> 
>  void disable\_irq(unsigned int irq)
> 
> 将关闭硬件中断并等待（可能有的）中断处理完成才返回。  
>  例13：disable\_irq (gpio\_to\_irq(RK29\_PIN0\_PA0));//关闭GPIO0\_A0中断。  
> 
> 
>  void enable\_irq(unsigned int irq)
> 
> 使能一个指定的中断  
>  例14： enable\_irq (gpio\_to\_irq(RK29\_PIN0\_PA0));//使能GPIO0\_A0中断。  
>  注意：使能IRQ和不使能IRQ应该配对使用。  
>   若调用enable\_irq之前，并未关闭指定中断（如调用disable\_irq\_nosync 关闭指定中断），  
>   则调用enable\_irq会报警告（WARNING: at kernel/irq/manage.c:274 enable\_irq+0x48/0x68()；Unbalanced enable for IRQ 58），此为正常现象。  
> 
> 
>  int enable\_irq\_wake(unsigned int irq)//返回0成功
> 
>  int disable\_irq\_wake(unsigned int irq)//返回0成功
> 
>  要enable和disable的次数相同  
>

> > 例15：static inline int enable\_irq\_wake(unsigned int irq)
> 
> > \{ 
> 
> > > return set\_irq\_wake(irq, 1);
> 
> > \}
> 
> > static inline int disable\_irq\_wake(unsigned int irq)
> 
> > \{

> > > return set\_irq\_wake(irq, 0);

> \}
> 
>   
>

> void rk29\_gpio\_suspend(void)// 让GPIO进入省电睡眠模式
> 
> 调用此函数，是否会让GPIO进入省电睡眠模式，与enable\_irq\_wake和disable\_irq\_wake函数相关，  
>  例16：如果先调用了enable\_irq\_wake(gpio\_to\_irq(RK29\_PIN0\_PA0))，则即使调用了  
>   void rk29\_gpio\_resume(void)//唤醒GPIO