pci设备驱动

原文地址：https://www.cnblogs.com/xiaoya901109/archive/2012/12/14/2818057.html

一，初始化设备模块

当Linux内核启动并完成对所有PCI设备进行扫描、登录和分配资源等初始化操作的同时，会建立起系统中所有PCI设备的拓扑结构，此后当PCI驱动程序需要对设备进行初始化时，一般都会调用如下的代码：

 static int __init example_init_module (void)   {/* 注册硬件驱动程序 */if(!pci_register_driver(&example_pci_driver)){pci_unregister_driver(&example_pci_driver);return-ENODEV;}/* ... */return 0;}

从上面的省略号可以看出，这仅仅只是核心的一部分，其他的东西，就要看你具体的应用是在什么地方。

仅仅使用上面的init函数是不够的，因为此时你并不知道你的设备是什么样的，是不是都已经准备好了，因此，还有更重要的一步---probe。探测完成对硬件的检测工作。

我们先将相关代码进行列示：

 static int __init example_probe(struct pci_dev *pci_dev,conststruct pci_device_id *pci_id)    
{struct example_pci *my_pci;/* 启动PCI设备 */if(pci_enable_device(pci_dev))return-EIO;/* 设备DMA标识 */if(pci_set_dma_mask(pci_dev, EXAMPLE_DMA_MASK))return-ENODEV;/* 在内核空间中动态申请内存 */if((my_pci = kmalloc(sizeof(struct example_pci), GFP_KERNEL))== NULL){printk(KERN_ERR "example_pci: out of memory\n");return-ENOMEM;}memset(my_pci,0,sizeof(*my_pci));/* 读取PCI配置信息 */my_pci->iobase = pci_resource_start(pci_dev,1);my_pci->pci_dev = pci_dev;my_pci->pci_id = pci_id->device;my_pci->irq = pci_dev->irq;my_pci->next= devs;my_pci->magic = EXAMPLE_MAGIC;/* 设置成总线主DMA模式 */pci_set_master(pci_dev);/* 申请I/O资源 */request_region(my_pci->iobase,64,my_pci_names[pci_id->driver_data]);return 0;
}

整个程序的思路很清晰，并不需要去太多的讲解，只是对里面的一些函数需要进行一下讲解.

1.pci_enable_device

激活PCI设备，在驱动程序可以访问PCI设备的任何设备资源之前(I/O区域或者中断)，驱动程序必须调用该函数：

   int pci_enable_device(struct pci_dev *dev);                       /*driver/pci/pci.c*/

该函数实际的激活设备。它把设备唤醒，在某些情况下还指派它的中断线和I/O区域。

2.访问PCI地址空间

在驱动程序检测到设备之后，它通常需要读取或写入三个地址空间：内存，端口和配置。对驱动程序来说，对配置空间的访问至关重要，因为这是它找到设备映射到内存和I/O空间的什么位置的唯一途径。

因而，首先来看看配置空间的访问：

Linux内核为我们想的很周到，在内核中就已经提供了访问配置空间的标准接口，我们只要去直接调用就好了。

对于驱动程序而言，可通过8位，16位，32位的数据传输访问配置空间。相关函数定义在<linux/pci.h>中:

    int pci_read_config_byte(conststruct pci_dev *dev,intwhere, u8 *val);/*8位，读入一个字节*/int pci_read_config_word(conststruct pci_dev *dev,intwhere, u16 *val);/*16位，读入两个字节*/int pci_read_config_dword(conststruct pci_dev *dev,intwhere, u32 *val);/*32位，读入四个字节*/

const struct pci_dev *dev：由dev标识的设备配置空间；

int where：从配置空间起始位置计算的字节偏移量；

u8/u16/u32 *val：从配置空间获得的值通过val指针返回；

函数本身返回的值是错误码。

注意：word和dword函数会将读取到的little-endian值转换成处理器固有的字节序。我们自己无需处理字节序。

上面的是读的情况，写的情况也是类似的<linux/pci.h>:

    int pci_write_config_byte(conststruct pci_dev *dev,intwhere, u8 *val);/*8位，写入一个字节*/int pci_write_config_word(conststruct pci_dev *dev,intwhere, u16 *val);/*16位，写入两个字节*/int pci_write_config_dword(conststruct pci_dev *dev,intwhere, u32 *val);/*32位，写入四个字节*/

因此，我们可以利用上面的函数读取和修改设备的信息。

讲完配置空间，接下来唠叨一下I/O和内存空间。

一个PCI设备可实现多达6个I/O地址区域，每个区域既可以使内存也可以是I/O地址。在内核中PCI设备的I/O区域已经被集成到通用资源管理器。因此，我们无需访问配置变量来了解设备被映射到内存或者I/O空间的何处。获得区域信息的首选接口是下面的宏定义：

  #define pci_resource_start(dev, bar)((dev)->resource[(bar)].start)

该宏返回六个PCI I/O区域之一的首地址(内存地址或者I/O端口号).该区域由整数的bar(base address register，基地址寄存器)指定，bar取值为0到5。

    #define pci_resource_end(dev, bar)((dev)->resource[(bar)].end)

该宏返回第bar个I/O区域的首地址。注意这是最后一个可用的地址，而不是该区域之后的第一个地址。

    #define pci_resource_flags(dev, bar)((dev)->resource[(bar)].flags)

该宏返回和该资源相关联的标志。

资源标志用来定义单个资源的特性，对与PCI I/O区域相关的PCI资源，该信息从基地址寄存器中获得，但对于和PCI无关的资源，它可能来自其他地方。所有资源标志定义在<linux/ioport.h>。

二，打开设备模块

static int example_open(struct inode *inode, struct file *file)    
{/* 申请中断，注册中断处理程序 */request_irq(my_pci->irq, &example_interrupt, SA_SHIRQ, my_pci_names[pci_id->driver_data], my_pci)) ;/* 检查读写模式 */if(file->f_mode & FMODE_READ) {/* ... */}if(file->f_mode & FMODE_WRITE) {/* ... */}/* 申请对设备的控制权 */down(&my_pci->open_sem);while(my_pci->open_mode & file->f_mode) {if (file->f_flags & O_NONBLOCK) {/* NONBLOCK模式，返回-EBUSY */up(&my_pci->open_sem);return -EBUSY;} else {/* 等待调度，获得控制权 */my_pci->open_mode |= f_mode & (FMODE_READ | FMODE_WRITE);up(&my_pci->open_sem);/* 设备打开计数增1 */MOD_INC_USE_COUNT;/* ... */}}
}

在这个模块里主要实现申请中断、检查读写模式以及申请对设备的控制权等。在申请控制权的时候，非阻塞方式遇忙返回，否则进程主动接受调度，进入睡眠状态，等待其它进程释放对设备的控制权。

三，数据读写和信息控制模块

static int example_ioctl(struct inode *inode, struct file *file, unsigned int cmd, unsigned long arg)   
{/* ... */switch(cmd) {case EXAMPLE_RDATA:/* 从I/O端口读取4字节的数据 */val = inl(my_pci->iobae + 0x10);/* 将读取的数据传输到用户空间 */return 0;}/* ... */
}

PCI设备驱动程序可以通过example_fops结构中的函数example_ioctl( )，向应用程序提供对硬件进行控制的接口。例如，通过它可以从I/O寄存器里读取一个数据，并传送到用户空间里。

四，中断模块

    static void example_interrupt(int irq, void *dev_id, struct pt_regs *regs){struct example_pci *my_pci = (struct example_pci *)dev_id;u32 status;spin_lock(&my_pci->lock);/* 中断 */status = inl(my_pci->iobase + GLOB_STA);if(!(status & INT_MASK)) {spin_unlock(&my_pci->lock);return; /* not for us */}/* 告诉设备已经收到中断 */outl(status & INT_MASK, my_pci->iobase + GLOB_STA);spin_unlock(&my_pci->lock);/* 其它进一步的处理 */}

PCI的中断资源比较有限，只有0~15的中断号，因此大部分外部设备都是以共享的形式申请中断号的。当中断发生的时候，中断处理程序首先负责对中断进行识别，然后再做进一步的处理。

五，释放设备模块

static int example_release(struct inode *inode, struct file *file)    
{/* ... *//* 释放对设备的控制权 */my_pci->open_mode &= (FMODE_READ | FMODE_WRITE);/* 唤醒其它等待获取控制权的进程 */wake_up(&my_pci->open_wait);up(&my_pci->open_sem);/* 释放中断 */free_irq(my_pci->irq, my_pci);/* 设备打开计数增1 */MOD_DEC_USE_COUNT;/* ... */