Linux驱动修炼之道-SPI驱动框架源码分析(上)【转】

转自：http://blog.csdn.net/lanmanck/article/details/6895318

SPI驱动架构，以前用过，不过没这个详细，跟各位一起分享：

来自：http://blog.csdn.net/woshixingaaa/article/details/6574215

SPI协议是一种同步的串行数据连接标准，由摩托罗拉公司命名，可工作于全双工模式。相关通讯设备可工作于m/s模式。主设备发起数据帧，允许多个从设备的存在。每个从设备

有独立的片选信号，SPI一般来说是四线串行总线结构。
接口：
SCLK——Serial Clock(output from master)时钟(主设备发出)
MOSI/SIMO——Master Output, Slave Input(output from master)数据信号线mosi(主设备发出)
MISO/SOMI——Master Input,Slave Outpu(output from slave)数据信号线(从设备)
SS——Slave Select(active low;output from master)片选信号

下面来看一下Linux中的SPI驱动。在Linux设备驱动框架的设计中，有一个重要的主机，外设驱动框架分离的思想，如下图。

外设a,b,c的驱动与主机控制器A,B,C的驱动不相关，主机控制器驱动不关心外设，而外设驱动也不关心主机，外设只是访问核心层的通用的API进行数据的传输，主机和外设之间可以进行任意的组合。如果我们不进行如图的主机和外设分离，外设a,b,c和主机A,B,C进行组合的时候，需要9种不同的驱动。设想一共有个主机控制器，n个外设，分离的结构是需要m+n个驱动，不分离则需要m*n个驱动。

下面介绍spi子系统的数据结构：
在Linux中，使用spi_master结构来描述一个SPI主机控制器的驱动。

view plain

  1. <span style="font-size:18px;">struct spi_master {
  2. struct device    dev;/*总线编号，从0开始*/
  3. s16    bus_num;/*支持的片选的数量，从设备的片选号不能大于这个数量*/
  4. u16 num_chipselect;
  5. u16  dma_alignment;/*改变spi_device的特性如：传输模式，字长，时钟频率*/
  6. int  (*setup)(struct spi_device *spi);/*添加消息到队列的方法，这个函数不可睡眠，他的任务是安排发生的传送并且调用注册的回调函数complete()*/
  7. int (*transfer)(struct spi_device *spi,struct spi_message *mesg);
  8. void   (*cleanup)(struct spi_device *spi);
  9. };</span>

分配，注册和注销的SPI主机的API由SPI核心提供：

view plain

  1. struct spi_master *spi_alloc_master(struct device *host, unsigned size);
  2. int spi_register_master(struct spi_master *master);
  3. void spi_unregister_master(struct spi_master *master);

在Linux中用spi_driver来描述一个SPI外设驱动。

view plain

  1. struct spi_driver {
  2. int   (*probe)(struct spi_device *spi);
  3. int   (*remove)(struct spi_device *spi);
  4. void  (*shutdown)(struct spi_device *spi);
  5. int   (*suspend)(struct spi_device *spi, pm_message_t mesg);
  6. int   (*resume)(struct spi_device *spi);
  7. struct device_driver  driver;
  8. };

可以看出，spi_driver结构体和platform_driver结构体有极大的相似性，都有probe(),remove(),suspend(),resume()这样的接口。

Linux用spi_device来描述一个SPI外设设备。

view plain

  1. struct spi_device {
  2. struct device        dev;
  3. struct spi_master   *master;       //对应的控制器指针u32
  4. max_speed_hz;  //spi通信的时钟u8
  5. chip_select;   //片选，用于区分同一总线上的不同设备
  6. u8  mode;
  7. #define    SPI_CPHA    0x01            /* clock phase */
  8. #define    SPI_CPOL    0x02            /* clock polarity */
  9. #define SPI_MODE_0  (0|0)           /* (original MicroWire) */#define   SPI_MODE_1  (0|SPI_CPHA)
  10. #define SPI_MODE_2  (SPI_CPOL|0)
  11. #define SPI_MODE_3  (SPI_CPOL|SPI_CPHA)#define  SPI_CS_HIGH 0x04            /* chipselect active high? */
  12. #define    SPI_LSB_FIRST   0x08            /* per-word bits-on-wire */
  13. #define  SPI_3WIRE   0x10            /* SI/SO signals shared */
  14. #define   SPI_LOOP    0x20            /* loopback mode */
  15. u8      bits_per_word;    //每个字长的比特数
  16. int      irq;              //使用的中断
  17. void     *controller_state;
  18. void     *controller_data;
  19. char     modalias[32];    //名字
  20. };

如下图，看这三个结构的关系，这里spi_device与spi_master是同一个父设备，这是在spi_new_device函数中设定的，一般这个设备是一个物理设备。

这里的spi_master_class,spi_bus_type又是什么呢，看下边两个结构体：

view plain

  1. struct bus_type spi_bus_type = {
  2. .name       = "spi",
  3. .dev_attrs  = spi_dev_attrs,
  4. .match    = spi_match_device,
  5. .uevent   = spi_uevent,
  6. .suspend  = spi_suspend,
  7. .resume   = spi_resume,
  8. };
  9. static struct class spi_master_class = {
  10. .name             = "spi_master",
  11. .owner           = THIS_MODULE,
  12. .dev_release    = spi_master_release,
  13. };

spi_bus_type对应spi中的spi bus总线，spidev的类定义如下：

view plain

  1. static struct class *spidev_class;

创建这个类的主要目的是使mdev/udev能在/dev下创建设备节点/dev/spiB.C。B代表总线，C代表片外设备的片选号。

下边来看两个板级的结构，其中spi_board_info用来初始化spi_device，s3c2410_spi_info用来初始化spi_master。这两个板级的结构需要在移植的时候在arch/arm/mach-s3c2440/mach-smdk2440.c中初始化。

view plain

  1. struct spi_board_info {
  2. char     modalias[32];   //设备与驱动匹配的唯一标识
  3. const void    *platform_data;
  4. void     *controller_data;
  5. int        irq;
  6. u32     max_speed_hz;
  7. u16        bus_num;       //设备所归属的总线编号
  8. u16      chip_select;
  9. u8      mode;
  10. };
  11. struct s3c2410_spi_info {
  12. int     pin_cs;         //芯片选择管脚
  13. unsigned int    num_cs;         //总线上的设备数
  14. int        bus_num;        //总线号
  15. void (*gpio_setup)(struct s3c2410_spi_info *spi, int enable);     //spi管脚配置函数
  16. void (*set_cs)(struct s3c2410_spi_info *spi, int cs, int pol);
  17. };

boardinfo是用来管理spi_board_info的结构，spi_board_info通过spi_register_board_info(struct spi_board_info const *info, unsigned n)交由boardinfo来管理，并挂到board_list链表上，list_add_tail(&bi->list,&board_list);

view plain

  1. struct boardinfo {
  2. /*用于挂到链表头board_list上*/
  3. struct list_head  list;
  4. /*管理的spi_board_info的数量*/
  5. unsigned  n_board_info;
  6. /*存放结构体spi_board_info*/
  7. struct spi_board_info    board_info[0];
  8. };

s3c24xx_spi是S3C2440的SPI控制器在Linux内核中的具体描述，该结构包含spi_bitbang内嵌结构，控制器时钟频率和占用的中断资源等重要成员，其中spi_bitbang具体负责SPI数据的传输。

view plain

  1. struct s3c24xx_spi {
  2. /* bitbang has to be first */
  3. struct spi_bitbang  bitbang;
  4. struct completion   done;
  5. void __iomem      *regs;
  6. int            irq;
  7. int             len;
  8. int             count;
  9. void         (*set_cs)(struct s3c2410_spi_info *spi,  int cs, int pol);
  10. /* data buffers */const unsigned char *tx;
  11. unsigned char       *rx;
  12. struct clk      *clk;
  13. struct resource        *ioarea;
  14. struct spi_master   *master;
  15. struct spi_device   *curdev;
  16. struct device       *dev;
  17. struct s3c2410_spi_info *pdata;
  18. };

为了解决多个不同的SPI设备共享SPI控制器而带来的访问冲突，spi_bitbang使用内核提供的工作队列(workqueue)。workqueue是Linux内核中定义的一种回调处理方式。采用这种方式需要传输数据时，不直接完成数据的传输，而是将要传输的工作分装成相应的消息(spi_message)，发送给对应的workqueue，由与workqueue关联的内核守护线程(daemon)负责具体的执行。由于workqueue会将收到的消息按时间先后顺序排列，这样就是对设备的访问严格串行化，解决了冲突。

view plain

  1. <span style="font-size:18px;">struct spi_bitbang {
  2. struct workqueue_struct *workqueue;      //工作队列头
  3. struct work_struct  work;            //每一次传输都传递下来一个spi_message，都向工作队列头添加一个
  4. workspinlock_t        lock;
  5. struct list_head   queue;           //挂接spi_message，如果上一次的spi_message还没有处理完，接下来的spi_message就挂接在queue上等待处理
  6. u8            busy;            //忙碌标志
  7. u8           use_dma;
  8. u8          flags;
  9. struct spi_master *master;/*一下3个函数都是在函数s3c24xx_spi_probe()中被初始化*/
  10. int  (*setup_transfer)(struct spi_device *spi,struct spi_transfer *t);   //设置传输模式
  11. void    (*chipselect)(struct spi_device *spi, int is_on);                    //片选
  12. #define    BITBANG_CS_ACTIVE   1   /* normally nCS, active low */
  13. #define   BITBANG_CS_INACTIVE 0/*传输函数，由s3c24xx_spi_txrx来实现*/
  14. int   (*txrx_bufs)(struct spi_device *spi, struct spi_transfer *t);
  15. u32    (*txrx_word[4])(struct spi_device *spi,unsigned nsecs,u32 word, u8 bits);
  16. };</span>

下面来看看spi_message：

view plain

  1. struct spi_message {
  2. struct list_head    transfers;   //此次消息的传输队列，一个消息可以包含多个传输段
  3. struct spi_device *spi;        //传输的目的设备
  4. unsigned      is_dma_mapped:1;  //如果为真，此次调用提供dma和cpu虚拟地址
  5. void          (*complete)(void *context);  //异步调用完成后的回调函数
  6. void         *context;                    //回调函数的参数
  7. unsigned      actual_length;               //此次传输的实际长度
  8. int         status;                      //执行的结果，成功被置0，否则是一个负的错误码
  9. struct list_head   queue;
  10. void          *state;
  11. };

在有消息需要传递的时候，会将spi_transfer通过自己的transfer_list字段挂到spi_message的transfers链表头上。spi_message用来原子的执行spi_transfer表示的一串数组传输请求。这个传输队列是原子的，这意味着在这个消息完成之前不会有其他消息占用总线。消息的执行总是按照FIFO的顺序。

下面看一看spi_transfer：

view plain

  1. struct spi_transfer {
  2. const void *tx_buf;  //要写入设备的数据(必须是dma_safe)，或者为NULL
  3. void       *rx_buf;  //要读取的数据缓冲(必须是dma_safe)，或者为NULL
  4. unsigned   len;      //tx和rx的大小(字节数),这里不是指它的和，而是各自的长度，他们总是相等的
  5. dma_addr_t    tx_dma;   //如果spi_message.is_dma_mapped是真，这个是tx的dma地址
  6. dma_addr_t rx_dma;   //如果spi_message.is_dma_mapped是真，这个是rx的dma地址
  7. unsigned   cs_change:1;    //影响此次传输之后的片选，指示本次tranfer结束之后是否要重新片选并调用setup改变设置，这个标志可以较少系统开销u8
  8. bits_per_word;  //每个字长的比特数，如果是0，使用默认值
  9. u16        delay_usecs;    //此次传输结束和片选改变之间的延时，之后就会启动另一个传输或者结束整个消息
  10. u32       speed_hz;       //通信时钟。如果是0，使用默认值
  11. struct list_head transfer_list; //用来连接的双向链表节点
  12. };
时间： 2024-02-20 10:59:16

Linux驱动修炼之道-SPI驱动框架源码分析(上)【转】的相关文章

YII框架源码分析(百度PHP大牛创作-原版-无广告无水印)

                        YII 框架源码分析             百度联盟事业部--黄银锋   目 录 1. 引言 3 1.1.Yii 简介 3 1.2.本文内容与结构 3 2.组件化与模块化 4 2.1.框架加载和运行流程 4 2.2.YiiBase 静态类 5 2.3.组件 6 2.4.模块 9 2.5 .App 应用   10 2.6 .WebApp 应用   11 3.系统组件 13 3.1.日志路由组件  13 3.2.Url 管理组件  15 3.3.异常

android 网络框架 源码分析

android 网络框架 源码分析 导语: 最近想开发一个协议分析工具,来监控android app 所有的网络操作行为, 由于android 开发分为Java层,和Native层, 对于Native层我们只要对linux下所有网络I/O接口进行拦截即可,对于java 层,笔者对android 网络框架不是很了解,所以这个工具开发之前,笔者需要对android 的网络框架进行一个简单的分析. 分析结论: 1. android 的网络框架都是基于Socket类实现的 2. java 层Socket

Android Small插件化框架源码分析

Android Small插件化框架源码分析 目录 概述 Small如何使用 插件加载流程 待改进的地方 一.概述 Small是一个写得非常简洁的插件化框架,工程源码位置:https://github.com/wequick/Small 插件化的方案,说到底要解决的核心问题只有三个: 1.1 插件类的加载 这个问题的解决和其它插件化框架的解决方法差不多.Android的类是由DexClassLoader加载的,通过反射可以将插件包动态加载进去.Small的gradle插件生成的是.so包,在初始

携程DynamicAPK插件化框架源码分析

携程DynamicAPK插件化框架源码分析 Author:莫川 插件核心思想 1.aapt的改造 分别对不同的插件项目分配不同的packageId,然后对各个插件的资源进行编译,生成R文件,然后与宿主项目的R文件进行id的合并. 要求:由于最终会将所有的资源文件id进行合并,因此,所有的资源名称均不能相同. 2.运行ClassLoader加载各Bundle 和MultiDex的思路是一样的,所有的插件都被加载到同一个ClassLoader当中,因此,不同插件中的Class必须保持包名和类名的唯一

Linux内核导出符号宏定义EXPORT_SYMBOL的源码分析

源代码: <include/linux/moudule.h> --. #ifndef MODULE_SYMBOL_PREFIX #define MODULE_SYMBOL_PREFIX "" #endif --. struct kernel_symbol       //内核符号结构 { unsignedlong value;  //该符号在内存地址中的地址 constchar *name;     //该符号的名称 }; -- #define __EXPORT_SYMBO

介绍开源的.net通信框架NetworkComms框架 源码分析

原文网址: http://www.cnblogs.com/csdev Networkcomms 是一款C# 语言编写的TCP/UDP通信框架  作者是英国人  以前是收费的 售价249英镑 我曾经花了2千多购买过此通讯框架, 目前作者已经开源  许可是:Apache License v2 开源地址是:https://github.com/MarcFletcher/NetworkComms.Net 这个框架给我的感觉是,代码很优美,运行很稳定,我有一个项目使用此框架已经稳定运行1年多.这个框架能够

CodeIgniter框架——源码分析之入口文件index.php

CodeIgniter框架的入口文件主要是配置开发环境,定义目录常量,加载CI的核心类core/CodeIgniter.php. 源码分析如下: <?php //这个文件是入口,后期所有的文件都要在这里执行. /*----------------------------------------------- * 系统环境配置常量 * 能够配置错误显示级别 * ----------------------------------------------- * 默认情况下: * developmen

CodeIgniter框架——源码分析之CodeIgniter.php

CodeIgniter.php中加载了很多外部文件,完成CI的一次完整流程. <?php /** * 详见 http://www.phpddt.com/tag/codeIgniter/ */ //如果入口文件系统目录常量BASEPATH没定义,就挂了 if ( ! defined('BASEPATH')) exit('No direct script access allowed'); //定义常量:CI_VERSION,CI_CORE define('CI_VERSION', '2.1.4')

CodeIgniter框架——源码分析之Config.php

CI框架的配置信息被存储在$config数组中,我们可以添加自己的配置信息或配置文件到$config中: $this->config->load('filename'); //加载配置文件 $this->config->item('xxx'); //获取配置信息 当然也可以在autoload.php中设置默认加载! <?php if ( ! defined('BASEPATH')) exit('No direct script access allowed');   clas