Linux驱动学习--初识PCI驱动(二)

一、初始化设备模块
当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);
        pci_set_drvdata() //pci_set_drvdata((struct pci_dev *pdev, void *data);为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>。

获取/设置驱动私有数据：

void *pci_get_drvdata(struct pci_dev *pdev);

void pci_set_drvdata((struct pci_dev *pdev, void *data);

二、打开设备模块

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;
     
     /* ... */

释放设备模块主要负责释放对设备的控制权，释放占用的内存和中断等，所做的事情正好与打开设备模块相反。