AI 助理
备案控制台
开发者社区 开发与运维 文章 正文

SPI驱动框架源码分析(上)

2012-08-25 938
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： SPI协议是一种同步的串行数据连接标准，由摩托罗拉公司命名，可工作于全双工模式。相关通讯设备可工作于m/s模式。主设备发起数据帧，允许多个从设备的存在。每个从设备有独立的片选信号，SPI一般来说是四线串行总线结构。



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主机控制器的驱动。

Cpp代码 
  1. "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. };  

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

Cpp代码 
  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外设驱动。
Cpp代码 
  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外设设备。

Cpp代码 
  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又是什么呢，看下边两个结构体：

Cpp代码 
  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的类定义如下：

Cpp代码 
  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中初始化。

Cpp代码 
  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);

Cpp代码 
  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数据的传输。

Cpp代码 
  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会将收到的消息按时间先后顺序排列，这样就是对设备的访问严格串行化，解决了冲突。

Cpp代码 
  1. "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. };  
下面来看看spi_message：

Cpp代码 
  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：

Cpp代码 
  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. };  

文章标签：
Linux
C++
芯片
API
nothingfinal
目录
相关文章
Hello阿尔法
|
7月前
|
Perl
【ZYNQ】SPI 简介及 EMIO 模拟 SPI 驱动示例
【ZYNQ】SPI 简介及 EMIO 模拟 SPI 驱动示例
Hello阿尔法
663 0
Shepherd
|
Java 数据库连接 API
你知道Spring Boot插件开发模式思想—SPI机制是什么吗？
`SPI`全称`Service Provider Interface`，是Java提供的一套用来被第三方实现或者扩展的接口，它可以用来启用框架扩展和替换组件。 SPI的作用就是为这些被扩展的API寻找服务实现。本质是**将接口实现类的全限定名配置在文件中，并由服务加载器读取配置文件，加载实现类**。这样可以在运行时，动态为接口替换实现类。通过在ClassPath路径下的META-INF/services文件夹查找文件，自动加载文件里所定义的类，进而实现可插拔，解耦。
Shepherd
23108 4
征途黯然。
|
Dubbo Java 应用服务中间件
JDK SPI、Spring SPI、Dubbo SPI三种机制的细节与演化
Java SPI（Service Provider Interface）是JDK提供的一种服务发现机制，用于在运行时动态加载和扩展应用程序中的服务提供者。
征途黯然。
442 0
知了一笑
|
缓存 监控 druid
JDK中「SPI」原理分析
JDK中「SPI」原理分析SPI是JDK内置的服务提供加载机制，可以为服务接口加载实现类，解耦是其核心思想，也是很多框架和组件的常用手段；
知了一笑
117 0
JDK中「SPI」原理分析
爪哇缪斯
|
缓存 Dubbo Java
（一）Dubbo源码解析：增强SPI
（一）Dubbo源码解析：增强SPI
爪哇缪斯
99 0
zhaokk
|
Dubbo Java 应用服务中间件
【视频讲解配套PPT】Java SPI | Dubbo SPI |Spring SPI有什么区别
SPI（Service Provider Interface）是一种服务发现机制，它通过在类路径下的META-INF/services目录下的配置文件来发现服务实现类，实现了面向接口编程的扩展性。
zhaokk
263 0
【视频讲解配套PPT】Java SPI | Dubbo SPI |Spring SPI有什么区别
嵌入式软件开发
|
Linux API
Linux驱动分析之SPI驱动架构
Linux驱动分析之SPI驱动架构
嵌入式软件开发
241 0
dc73hre37f4my
|
druid Java 数据库
简述ServiceLoader与SPI
简述ServiceLoader与SPI
dc73hre37f4my
185 0
简述ServiceLoader与SPI
ST小智
|
传感器 Linux
Linux驱动提高篇了解----SPI驱动框架
Linux驱动提高篇了解----SPI驱动框架
ST小智
159 1
PPPHUANG
|
缓存 Dubbo 算法
如何在项目中引入SPI
开闭原则是面向对象程序设计的终极目标，它使软件实体拥有一定的适应性和灵活性的同时具备稳定性和延续性。当应用的需求改变时，在不修改软件实体的源代码或者二进制代码的前提下，可以扩展模块的功能，使其满足新的需求。SPI 就是开闭原则的一种实现。本文将带领同学们了解 SPI ，对比 Dubbo SPI 与 Java SPI ，同时用一个 Dubbo SPI 替换 Java SPI 的实践项目，来演示如何将 SPI 机制引入日常项目中。
PPPHUANG
534 0
如何在项目中引入SPI

热门文章

最新文章

  • 1
    天猫精灵开放平台-之小百科测评
  • 2
    语义检索系统：基于Milvus 搭建召回系统抽取向量进行检索，加速索引
  • 3
    3D立方体图片切换动画
  • 4
    模态对话框和非模态对话框
  • 5
    java03
  • 6
    冒泡排序
  • 7
    Windows XP客户端加域操作手册上
  • 8
    微信 6.5.1 for iOS发布 可以在朋友圈分享相册中的视频
  • 9
    Chapter 1: Creating the GUI Form and Adding Widgets
  • 10
    【Mockplus教程】帐号和购买
  • 1
    「Mac畅玩鸿蒙与硬件42」UI互动应用篇19 - 数字键盘应用
    34
  • 2
    赋能加速AI应用交付，F5 BIG-IP Next for Kubernetes方案解读
    29
  • 3
    RAG分块策略：主流方法（递归、jina-seg）+前沿推荐（Meta-chunking、Late chunking、SLM-SFT）
    25
  • 4
    Python学习的自我理解和想法（2）
    26
  • 5
    Transformer图解
    32
  • 6
    API安全专题：如何有效应对新型Bot攻击？
    17
  • 7
    Selenium IDE：Web自动化测试的得力助手
    31
  • 8
    《docker高级篇（大厂进阶）：5.Docker-compose容器编排》包括是什么能干嘛去哪下、Compose核心概念、Compose使用三个步骤、Compose常用命令、Compose编排微服务
    47
  • 9
    24/7全时守护：AI视频监控技术的深度实现与应用分享
    38
  • 10
    《docker高级篇（大厂进阶）：6.Docker轻量级可视化工具Portainer》
    25

    • 相关电子书

    更多
  • 面向领域的场景驱动设计
  • 低代码开发师（初级）实战教程
  • 阿里巴巴DevOps 最佳实践手册
    • 下一篇
    阿里云无影云电脑免费试用，最长可试用3个月