一、SPI总线驱动介绍

        SPI总线总共需要四根线，包括MOSI、MISO、CLK和CS。本文首先从SPI设备注册开始来讲述SPI总线驱动。

二、设备注册

        在系统启动的时候，会按照顺序执行一些初始化程序，比如device_initcall和module_init等宏。这些宏是按照顺序执行的，
比如device_initcall的优先级高于module_init，现在我们看下在系统启动的时候注册的spi设备信息。

        程序如下：

        注意到此处共定义两个设备，使用spi_register_board_info()函数对spi设备进行注册，程序如下：

        对于此处，n为1，在程序中首先创建相应的内存，在for循环中，将信息保存到内存中，然后插入board_list链表，接着遍历
spi_master_list链表，注意此处，由于device_initcall的优先级高于module_init，所以此时spi_master_list链表为空，那么还
不能调用spi_match_master_to_boardinfo函数创建spi设备，具体的创建设备将在spi总线驱动的探测函数中，使用spi_register_master()
函数创建设备。

三、总线驱动探测、退出和电源管理函数

3.1、探测函数gsc3280_spi_probe

    程序如下：

        说明：

        1) 首先是总线资源的注册，包括申请IO空间和中断。

        2) 接下来注册了中断函数。

        3) 然后注册了spi_master所需要的函数，包括清除、设置和传输等函数，在四中会讲述。

        4) gsc3280_spi_hw_init函数初始化了SPI总线寄存器，接下来讲述。

        5) 总线驱动采用queue机制实现多设备SPI读写，接下来初始化和启动了queue，接下来讲述。

        6) 使用spi_register_master函数注册master，此函数即实现创建了SPI设备结构体，接下来讲述。

        SPI总线寄存器初始化函数gsc3280_spi_hw_init：

        由程序可以看出，此函数首先禁止SPI，屏蔽中断，然后设置fifo深度，最后使能SPI。

        初始化queue函数gsc3280_init_queue：

        由程序看出，此函数主要完成初始化队列的作用，包括对queue函数的初始化，最后创建了queue。
        开始queue函数gsc3280_start_queue：

        此函数首先对queue的状态进行判断，然后初始化相关成员变量，最后调度queue。

        最后看下master注册函数spi_register_master：

        说明：

        1) 首先对master成员变量进行检查。

        2) 初始化成员变量。

        3) 将master->list插入到spi_master_list链表中。

        4) 语句list_for_each_entry(bi, &board_list, list)实现遍历board_list链表，在二设备注册中已经讲述了将设备插入到
board_list链表中。此时的board_list链表不为空，已经有相应设备结构体信息了。

        5) 语句spi_match_master_to_boardinfo(master, &bi->board_info);实现设备的创建，函数程序如下：

        说明：

        1) 函数首先判断master的总线号和设备的总线号是否相等，如果不等直接返回。

        2) 函数spi_new_device(master, bi);实现设备创建，如下：

        说明：

        1) 首先调用spi_alloc_device函数创建设备内存，从spi_alloc_device函数中可以看到，首先申请内存，然后对设备程序进行赋值。

        2) 接下来将芯片的信息赋值给设备结构体，包括片选、最大速率、模式、中断和名称等。此处名称尤为重要，在spi设备的注册函数
spi_register_driver中，就是通过名称找到相应的设备信息结构体的。

        3) 程序status = spi_add_device(proxy);实现添加spi设备信息。此函数在--Linux spi驱动分析(二)----spi内核中讲述。

3.2、移除函数gsc3280_spi_remove

        程序如下：

        说明：

        1) 首先获得总线结构体

        2) 然后删除queue

        3) 最后禁止SPI，释放中断和IO，最后注销master。

3.3、挂起函数gsc3280_spi_suspend

        程序如下：

        程序中首先停止queue，然后禁止SPI。

        停止queue函数内容如下：

        程序首先遍历queue链表，查看是否还有queue没有执行，总共尝试50次，如果还有queue没有执行或者设备忙，则错误返回，否
则置正确queue状态。

3.4、恢复函数gsc3280_spi_resume

        程序如下：

        程序主要初始化SPI寄存器，然后开始运行queue。

四、spi master支持函数

4.1、清除函数gsc3280_spi_cleanup

        程序首先获取设备指针，然后释放内存。

4.2、设置函数gsc3280_spi_setup

        此函数是一个回调函数，spi核心中的spi_setup()函数会调用此函数，程序如下：

        说明：

        1) 首先判断参数，如果参数错误，直接返回。

        2) 获取spi控制数据，如果没有，则申请内存创建设备。

        3) 接下来根据实际情况对设备结构体赋值。

4.3、传输函数gsc3280_spi_transfer

        此函数尤为重要，SPI设备传输数据时，就是调用此函数实现数据传输的，此函数主要完成结构体成员变量的
初始化，具体的传输在中断中进行。

        说明：

        1) 首先判断queue状态，如果是停止状态，则退出。

        2) 对传送结构体成员变量赋值。

        3) 判断当前是否有数据在收发，如果有，就先直接返回。

        4) 如果没有，则调用queue_work()函数，调度函数gsc3280_spi_pump_messages()。程序如下：

        说明：

        1) 此函数在两种情况下会被调用：

            a) 当第一次开始SPI传输时，会调用此函数，设置message结构体变量。

            b) 当传输完一个message后，如果判断还有message没有被传输，则调用此函数获取新的message。

        2) 程序首先对变量进行检查，有两种退出情况，第一种是队列已经处于停止状态，第二种是传输msg链表为空。

        3) 上锁，获取新的传输message，如果获取失败，直接解锁退出。

        4) 如果获取msg成功，先删除获取成功msg的链表，然后对SPI总线驱动结构体变量赋初值。
        5) 解锁，使能片选信号CS。
        6) 获取传输的第一个transfer。

        7) 调度gsc3280_spi_pump_transfers函数，函数如下：

        说明：

        1) 首先对msg变量进行检测。

        2) 如果变量正确，获取此次传输的分频系数和每次传输几个字节。
        3) 设置SPI控制寄存器和分频寄存器，
        4) 设置SPI总线驱动结构体中的传输或者接收数据指针，打开中断，开始数据传输。

        5) 每传输一个transfer，都会调用此函数一次。

        实际的传输数据在中断中进行，程序如下：

        说明：

        1) 首先读取中断状态，如果是空中断，退出中断。

        2) 判断当前是否有msg在传输，如果没有，退出中断。

        3) 判断是否是错误中断，包括溢出等，如果是，屏蔽中断，退出中断。
        4) 如果是接收满中断，则首先接收数据。然后退出中断。

        4) 如果是发送空中断，则发送数据，发送完成后，退出中断。
        现在看下发送数据函数spi_gsc_write()：

        说明：

        1) 首先屏蔽中断。

        2) 发送数据。

        3) 如果发送完成，执行gsc3280_spi_xfer_done(gscs)函数。

        4) 如果没有完成，打开中断，继续发数据。

        对于gsc3280_spi_xfer_done()函数，如下：

        1) 获取下一个transfer，如果还有，则调度gsc3280_spi_pump_transfers()函数准备开始传输。

        2) 如果没有transfer需要传输，调用函数gsc3280_spi_giveback(gscs)，说明此时已经处理完成了一个msg。

        gsc3280_spi_giveback(gscs)函数如下：

        说明：

        1) 首先屏蔽中断。

        2) 禁止片选。

        3) 设置完成msg。

        4) 上锁，初始化SPI总线结构体变量。

        5) 调用gsc3280_spi_pump_messages()函数，处理下一个msg。

        中断接收数据函数spi_gsc_read(gscs)如下：

        说明：

        1) 首先接收数据，如果接收成功，调用gsc3280_spi_xfer_done(gscs);。

        到此，SPI总线驱动就全部讲述完成了，在总线驱动中，使用了queue和tasklet两种机制，queue实现了不同
msg的传输，tasklet实现了msg中不同transfer的传输。