Linux下的SPI总线驱动（一）

版权所有，转载请说明转自

一．SPI理论介绍

SPI总线全名，串行外围设备接口，是一种串行的主从接口，集成于很多微控制器内部。和I2C使用2根线相比，SPI总线使用4根线：MOSI (SPI 总线主机输出/ 从机输入)、 MISO (SPI总线主机输入/从机输出)、SCLK(，由主设备产生)、CS（从设备使能信号，由主设备控制）。由于SPI总线有专用的数据线用于数据的发送和接收，因此可以工作于全双工，当前市面上可以找到的SPI外围设备包括RF芯片、智能卡接口、E2PROM、RTC、触摸屏传感器、ADC。

SCLK信号线只由主设备控制，从设备不能控制信号线。同样，在一个基于SPI的设备中，至少有一个主控设备。这样传输的特点：这样的传输方式有一个优点，与普通的串行通讯不同，普通的串行通讯一次连续传送至少8位数据，而SPI允许数据一位一位的传送，甚至允许暂停，因为SCLK 时钟线由主控设备控制，当没有时钟跳变时，从设备不采集或传送数据。也就是说，主设备通过对SCLK时钟线的控制可以完成对通讯的控制。SPI还是一个数据交换协议：因为SPI的数据输入和输出线独立，所以允许同时完成数据的输入和输出。不同的SPI设备的实现方式不尽相同，主要是数据改变和采集的时间不同，在时钟信号上沿或下沿采集有不同定义，具体请参考相关器件的文档。在点对点的通信中，SPI接口不需要进行寻址操作，且为全双工通信，显得简单高效。在多个从设备的系统中，每个从设备需要独立的使能信号，硬件上比I2C 系统要稍微复杂一些。

二．SPI驱动移植

我们下面将的驱动的移植是针对Mini2440的SPI驱动的移植

Step1 ：在Linux Source Code中修改arch/arm/mach-s3c2440/mach-mini2440.c文件，加入头文件：

#include  

#include <../mach-s3c2410/include/mach/spi.h>

然后加入如下代码：

static struct spi_board_info s3c2410_spi0_board[] = 

{  

        [0] = {  

                .modalias = "spidev",   //设备的名称用来和驱动进行匹配

                .bus_num = 0,    //总线的编号，实际指对应的SPI寄存器

                .chip_select = 0,   //反映了这个芯片是不是被连接到SPI上

                .irq = IRQ_EINT9,    //设备的中断号

                .max_speed_hz = 500 * 1000,   //SPI的最大速率

                }  

};  

  

static struct s3c2410_spi_info s3c2410_spi0_platdata = { 

        .pin_cs = S3C2410_GPG(2), 

       .num_cs = 1,     //所有的片选信号

        .bus_num = 0,    //SPI多对应的总线编号

        .gpio_setup = s3c24xx_spi_gpiocfg_bus0_gpe11_12_13,   //引脚设置函数

};  

static struct spi_board_info s3c2410_spi1_board[] = 

{

       [0] = {  

               .modalias = "spidev", 

               .bus_num = 1, 

               .chip_select = 0, 

                .irq = IRQ_EINT2, 

                .max_speed_hz = 500 * 1000, 

                }  

};  

static struct s3c2410_spi_info s3c2410_spi1_platdata = { 

        .pin_cs = S3C2410_GPG(3), 

        .num_cs = 1, 

        .bus_num = 1, 

        .gpio_setup = s3c24xx_spi_gpiocfg_bus1_gpg5_6_7, 

}; 

Step2:在mini2440_devices[]平台数组中添加如下代码：

&s3c_device_spi0, 

&s3c_device_spi1,

Step3:最后在mini2440_machine_init函数中加入如下代码：

s3c_device_spi0.dev.platform_data= &s3c2410_spi0_platdata; 

spi_register_board_info(s3c2410_spi0_board, ARRAY_SIZE(s3c2410_spi0_board)); 

s3c_device_spi1.dev.platform_data= &s3c2410_spi1_platdata; 

spi_register_board_info(s3c2410_spi1_board, ARRAY_SIZE(s3c2410_spi1_board));

Step4:最后需要修改arch/arm/plat-s3c24xx/KConfig文件

找到

config S3C24XX_SPI_BUS0_GPE11_GPE12_GPE13 

        bool 

        help  

         SPI GPIO configuration code for BUS0 when connected to 

         GPE11, GPE12 and GPE13. 

  

config S3C24XX_SPI_BUS1_GPG5_GPG6_GPG7 

        bool 

       help  

          SPI GPIO configuration code for BUS 1 when connected to 

          GPG5, GPG6 and GPG7.

修改为

config S3C24XX_SPI_BUS0_GPE11_GPE12_GPE13 

        bool "S3C24XX_SPI_BUS0_GPE11_GPE12_GPE13" 

        help  

         SPI GPIO configuration code for BUS0 when connected to 

         GPE11, GPE12 and GPE13. 

  

config S3C24XX_SPI_BUS1_GPG5_GPG6_GPG7 

        bool "S3C24XX_SPI_BUS1_GPG5_GPG6_GPG7" 

       help  

          SPI GPIO configuration code for BUS 1 when connected to 

          GPG5, GPG6 and GPG7.

Step5:最后make menuconfig配置，选中System Type和SPI support相应文件

Step6：执行make生成zInage，将编译好的内核导入开发板，并且编译测试程序运行即可。

好了，我们的SPI驱动移植就做好了，我们可以编写SPI测试代码进行测试。

三．SPI设备和驱动的注册

在SPI子系统中，包含两类设备驱动。一类称之为.SPI主控设备驱动，用于驱动SPI主控设备，以和SPI总线交互，读写通信数据。另一类称之为SPI接口设备驱动，用于解析SPI主控设备驱动读取的数据，形成有意义的协议数据。下面我们就看看SPI主控设备的注册、SPI主控设备驱动的注册、SPI接口设备的添加、SPI接口设备的注册、SPI接口设备驱动的注册五个过程。

3.1SPI主控设备的注册

我们在移植的Step3:最后在mini2440_machine_init函数中加入如下代码：

s3c_device_spi0.dev.platform_data= &s3c2410_spi0_platdata; 

spi_register_board_info(s3c2410_spi0_board, ARRAY_SIZE(s3c2410_spi0_board)); 

s3c_device_spi1.dev.platform_data= &s3c2410_spi1_platdata; 

spi_register_board_info(s3c2410_spi1_board, ARRAY_SIZE(s3c2410_spi1_board));

这里面的s3c_device_spi0其实定义在\arch\arm\plat-s3c24xx\devs.c中，跟踪下

static struct resource s3c_spi0_resource[] = {

       [0] = {

              .start = S3C24XX_PA_SPI,

              .end   = S3C24XX_PA_SPI + 0x1f,

              .flags = IORESOURCE_MEM,

       },

       [1] = {

              .start = IRQ_SPI0,

              .end   = IRQ_SPI0,

              .flags = IORESOURCE_IRQ,

       }

};

static u64 s3c_device_spi0_dmamask = 0xffffffffUL;

struct platform_device s3c_device_spi0 = {

       .name               = "s3c2410-spi",

       .id             = 0,

       .num_resources       = ARRAY_SIZE(s3c_spi0_resource),

       .resource   = s3c_spi0_resource,

        .dev              = {

                .dma_mask = &s3c_device_spi0_dmamask,

                .coherent_dma_mask = 0xffffffffUL

        }

};

EXPORT_SYMBOL(s3c_device_spi0);

这样就能理解移植时添加s3c_device_spi0.dev.platform_data= &s3c2410_spi0_platdata代码，其实是把s3c2410_spi0_platdata作为平台设备的私有数据。在s3c_device_spi0中就包含了设备的寄存器地址，设备名称，设备所产生的总线号，总线挂载的数目，及各种配置函数。然后由函数platform_add_devices(smdk2440_devices, ARRAY_SIZE(smdk2440_devices));统一把2440所有设备进行注册。

然后看下这个platform_add_devices注册函数主要干了什么事情。在linux/drivers/base /platform.c中105行定义了这个函数。函数调用platform_device_register（）来进行注册。然后在platform_device_regisrer中调用device_initialize（pdev->dev）platform_device_add(pdev)这俩个函数，从函数名称上我们推断一个是初始化设备信息中的dev结构体，另一个是把这个设备增加到什么地方去。首先看初始化dev结构体。初看下初始化了kobj相关东西，初始化链表，同步锁，还有相关标志。然后看platform_device_add里面内容。把其中一个pdev->dev.bus=& platform_bus_type (全局变量)至此我们基本可以确定了，这个设备属于platform_bus_type。所以这个设备的总线信息就知道了，但是总线还不知道这个设备，不过放心，在接下来的初始化过程中有一个函数bus_add_device，会让总线知道这个函数。这样至此我们就把一个设备注册完毕，初始化了一些我们能初始化的东西。结果之一是设备在总线上可以找到。

3.2 SPI接口设备的添加

在移植的Step1中，曾经添加了如下代码

static struct spi_board_info s3c2410_spi0_board[] = 

{  

        [0] = {  

                .modalias = "spidev",   //设备的名称用来和驱动进行匹配

                .bus_num = 0,    //总线的编号，实际指对应的SPI寄存器

                .chip_select = 0,   //反映了这个芯片是不是被连接到SPI上

                .irq = IRQ_EINT9,    //设备的中断号

                .max_speed_hz = 500 * 1000,   //SPI的最大速率

                }  

};  

上面结构体来填充SPI接口的设备信息，然后通过函数spi_register_board_info(s3c2410_spi0_board,ARRAY_SIZE(s3c2410_spi0_board));注册。下面来跟踪下这个函数干了些什么事情。

int __init  spi_register_board_info(struct spi_board_info const *info, unsigned n)

{

       struct boardinfo     *bi;

       bi = kmalloc(sizeof(*bi) + n * sizeof *info, GFP_KERNEL);

       if (!bi)

              return -ENOMEM;

       bi->n_board_info = n;

//把s3c2410_spi0_board 的信息都拷贝到结构体

       memcpy(bi->board_info, info, n * sizeof *info);

       mutex_lock(&board_lock);

       list_add_tail(&bi->list, &board_list);

       mutex_unlock(&board_lock);

       return 0;

}

在这个函数里面，是把s3c2410_spi0_board的信息都拷贝到结构体

struct boardinfo {

       struct list_head       list;

       unsigned         n_board_info;

       struct spi_board_info     board_info[0];

};这里使用编程技巧定义个元素为0的数组，目的是接收s3c2410_spi0_borad里面的不确定元素，因为事先不知道元素的多少。然后在系统编译的时候会把board_info的内存默认为0，所以赋值的时候还要自动申请内存。memcpy(bi->board_info, info, n * sizeof *info);然后定义了同步锁，创建了链表。list_add_tail(&bi->list, &board_list);这部分好像就到这个地方了，系统把信息保存到一块内存中，我们可以通过全局变量board_list找到这块地方。

3.3 SPI主控设备驱动的注册

在spi_s3c24xx.c文件中

static int __init s3c24xx_spi_init(void)

{

        return platform_driver_probe(&s3c24xx_spi_driver, s3c24xx_spi_probe);

}

在platform_driver_probe中会调用platform_driver_register(drv);继续跟踪

int platform_driver_register(struct platform_driver *drv)

{

       drv->driver.bus = &platform_bus_type;  //总线类型

       if (drv->probe)

              drv->driver.probe = platform_drv_probe;

       if (drv->remove)

              drv->driver.remove = platform_drv_remove;

       if (drv->shutdown)

              drv->driver.shutdown = platform_drv_shutdown;

       return driver_register(&drv->driver);

}

看到没？这个和SPI主控设备的注册过程中的最终挂接的总线类型是一致的。这样SPI主控设备和SPI主控驱动都要注册到同一个总线上，总线再根据名称一样来进行匹配。

3.4 SPI接口设备的注册

我们继续看在spi_s3c24xx.c文件

在s3c24xx_spi_probe里面我们调用spi_bitbang_start(&hw->bitbang);这就是SPI接口驱动的注册。跟踪spi_bitbang_start函数，我们看到它调用了spi_register_master(bitbang->master);在函数spi_register_master()里面有一函数调用scan_boardinfo(master);用来扫描设备。

static void scan_boardinfo(struct spi_master *master)

{

      struct boardinfo     *bi;

      mutex_lock(&board_lock);

      list_for_each_entry(bi, &board_list, list) { //通过board_list遍历链表，取得设备信息

             struct spi_board_info     *chip = bi->board_info;

             unsigned         n;

             for (n = bi->n_board_info; n > 0; n--, chip++) {

                    if (chip->bus_num != master->bus_num)

                           continue;

                    (void) spi_new_device(master, chip);

             }

      }

      mutex_unlock(&board_lock);

}

我们跟踪scan_boardinfo中的spi_new_device函数发现，spi_new_device调用spi_alloc_device，而在spi_alloc_device函数中有一句spi->dev.bus = &spi_bus_type;这说明该设备就挂在全局变量spi_bus_type总线上了。然后在spi_new_device中调用spi_add_device函数，目的我们已经看到，最终SPI接口的设备注册到了spi_bus_type上了，如果把SPI接口设备的驱动也注册到这个总线上，然后根据名称进行匹配则device和driver就配对成功。

3.5 SPI接口设备驱动的注册

我们以spidev.c的驱动为例，来追踪该驱动的注册

static int __init spidev_init(void)

{

      int status;

      BUILD_BUG_ON(N_SPI_MINORS > 256);

      status = register_chrdev(SPIDEV_MAJOR, "spi", &spidev_fops); //注册字符设备

      if (status < 0)

             return status;

      spidev_class = class_create(THIS_MODULE, "spidev");

      if (IS_ERR(spidev_class)) {

             unregister_chrdev(SPIDEV_MAJOR, spidev_spi.driver.name);

             return PTR_ERR(spidev_class);

      }

      status = spi_register_driver(&spidev_spi); //注册SPI接口设备驱动

      if (status < 0) {

             class_destroy(spidev_class);

             unregister_chrdev(SPIDEV_MAJOR, spidev_spi.driver.name);

      }

      return status;

}

我们跟踪下spi_register_driver

int spi_register_driver(struct spi_driver *sdrv)

{

      sdrv->driver.bus = &spi_bus_type;

      if (sdrv->probe)

             sdrv->driver.probe = spi_drv_probe;

      if (sdrv->remove)

             sdrv->driver.remove = spi_drv_remove;

      if (sdrv->shutdown)

             sdrv->driver.shutdown = spi_drv_shutdown;

      return driver_register(&sdrv->driver);

}

好了，我们在spi_register_driver里看到了sdrv->driver.bus = &spi_bus_type;这说明我们的SPI设备驱动也接到了SPI总线上了，这个正好跟我们上面说的SPI接口设备的注册中提到的SPI设备也注册到SPI总线的，这样就可以通过驱动名匹配上了。