Linux主机驱动与外设驱动分离思想

Linux主机驱动与外设驱动分离思想1主机、外设驱动分离的意义在Linux设备驱动框架的设计中，除了有分层设计实现以外，还有分隔的思想。

举一个简单的例子，假设我们要通过SPI总线访问某外设，在这个访问过程中，要通过操作CPU XXX 上的SPI控制器的寄存器来达到访问SPI外设YYY的目的，最简单的方法是：return_type xxx_write_spi_yyy(...){xxx_write_spi_host_ctrl_reg(ctrl);xxx_ write_spi_host_data_reg(buf);while(!(xxx_spi_host_status_reg()&SPI_DATA_TRANSFER_DONE));...}如果按照这种方式来设计驱动，结果是对于任何一个SPI外设来讲，它的驱动代码都是CPU 相关的。

也就是说，当然用在CPU XXX上的时候，它访问XXX的SPI主机控制寄存器，当用在XXX1的时候，它访问XXX1的SPI主机控制寄存器：return_type xxx1_write_spi_yyy(...){xxx1_write_spi_host_ctrl_reg(ctrl);xxx1_ write_spi_host_data_reg(buf);while(!(xxx1_spi_host_status_reg()&SPI_DATA_TRANSFER_DONE));...}这显然是不能接受的，因为这意味着外设YYY用在不同的CPU XXX和XXX1上的时候需要不同的驱动。

那么，我们可以用如图12.4的思想对主机控制器驱动和外设驱动进行分离。

这样的结构是，外设a、b、c的驱动与主机控制器A、B、C的驱动不相关，主机控制器驱动不关心外设，而外设驱动也不关心主机，外设只是访问核心层的通用的API进行数据传输，主机和外设之间可以进行任意的组合。

图12.4 Linux设备驱动的主机、外设驱动分离如果我们不进行如图12.4的主机和外设分离，外设a、b、c和主机A、B、C进行组合的时候，需要9个不同的驱动。

设想一共有m个主机控制器，n个外设，分离的结果是需要m+n个驱动，不分离则需要m*n个驱动。

Linux SPI、I2C、USB、ASoC（ALSA SoC）等子系统都典型地利用了这种分离的设计思想，在本章我们先以简单一些的SPI为例，而I2C、USB、ASoC等则在后续章节会进行详细介绍。

2 Linux SPI主机和设备驱动SPI（同步外设接口）是由摩托罗拉公司开发的全双工同步串行总线，其接口由MISO（串行数据输入），MOSI（串行数据输出），SCK（串行移位时钟），SS（从使能信号）四种信号构成，SS决定了唯一的与主设备通信的从设备，主设备通过产生移位时钟来发起通讯。

通讯时，数据由MOSI输出，MISO输入，数据在时钟的上升或下降沿由MOSI输出，在紧接着的下降或上升沿由MISO读入，这样经过8/16次时钟的改变，完成8/16位数据的传输。

SPI模块为了和外设进行数据交换，根据外设工作要求，其输出串行同步时钟极性（CPOL）和相位（CPHA）可以进行配置。

如果CPOL=0，串行同步时钟的空闲状态为低电平；如果CPOL=1，串行同步时钟的空闲状态为高电平。

如果CPHA=0，在串行同步时钟的第一个跳变沿（上升或下降）数据被采样；如果CPHA=1，在串行同步时钟的第二个跳变沿（上升或下降）数据被采样。

SPI接口时序如图12.5所示。

图12.5 SPI总线时序在Linux中，用代码清单12.12的spi_master结构体来描述一个SPI主机控制器驱动，其主要成员是主机控制器的序号（系统中可能存在多个SPI主机控制器）、片选数量、SPI 模式和时钟设置用到的函数、数据传输用到的函数等。

代码清单12.12 spi_master结构体1 struct spi_master {2 struct device dev;3 s16 bus_num;4 u16 num_chipselect;56 /* 设置模式和时钟*/7 int (*setup)(struct spi_device *spi);89 /* 双向数据传输*/10 int (*transfer)(struct spi_device *spi,11 struct spi_message *mesg);1213 void (*cleanup)(struct spi_device *spi);14 };分配、注册和注销SPI主机的API由SPI核心提供：struct spi_master * spi_alloc_master(struct device *host, unsigned size);int spi_register_master(struct spi_master *master);void spi_unregister_master(struct spi_master *master);在Linux中，用代码清单12.13的spi_driver结构体来描述一个SPI外设驱动，可以认为是spi_master的client驱动。

代码清单12.13 spi_driver结构体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()这样的接口。

是的，这几乎是一切client驱动的习惯模板。

在SPI外设驱动中，当透过SPI总线进行数据传输的时候，使用了一套与CPU无关的统一的接口。

这套接口的第1个关键数据结构就是spi_transfer，它用于描述SPI传输，如代码清单12.14。

代码清单12.14 spi_transfer结构体1 struct spi_transfer {2 const void *tx_buf;3 void *rx_buf;4 unsigned len;56 dma_addr_t tx_dma;7 dma_addr_t rx_dma;89 unsigned cs_change:1;10 u8 bits_per_word;11 u16 delay_usecs;12 u32 speed_hz;14 struct list_head transfer_list;15 };而一次完整的SPI传输流程可能不只包含1次spi_transfer，它可能包含1个或多个spi_transfer，这些spi_transfer最终通过spi_message组织在一起，其定义如代码清单12.15。

代码清单12.15 spi_message结构体1 struct spi_message {2 struct list_head transfers;34 struct spi_device *spi;56 unsigned is_dma_mapped:1;78 /* 完成被一个callback报告*/9 void (*complete)(void *context);10 void *context;11 unsigned actual_length;12 int status;1314 struct list_head queue;15 void *state;通过spi_message_init()可以初始化spi_message，而将spi_transfer添加到spi_message 队列的方法则是：void spi_message_add_tail(struct spi_transfer *t, struct spi_message *m);发起一次spi_message的传输有同步和异步两种方式，使用同步API时，会阻塞等待这个消息被处理完。

同步操作时使用的API是：int spi_sync(struct spi_device *spi, struct spi_message *message);使用异步API时，不会阻塞等待这个消息被处理完，但是可以在spi_message的complete 字段挂接一个回调函数，当消息被处理完成后，该函数会被调用。

异步操作时使用的API 是：int spi_async(struct spi_device *spi, struct spi_message *message);代码清单12.16是非常典型的初始化spi_transfer、spi_message并进行SPI数据传输的例子，同时它们也是SPI核心层的2个通用API，在SPI外设驱动中可以直接调用它们进行写和读操作。

代码清单12.16 SPI传输实例spi_write()、spi_read() API1 static inline int2 spi_write(struct spi_device *spi, const u8 *buf, size_t len)3 {4 struct spi_transfer t = {5 .tx_buf = buf,6 .len = len,7 };8 struct spi_message m;910 spi_message_init(&m);11 spi_message_add_tail(&t, &m);12 return spi_sync(spi, &m);13 }1415 static inline int16 spi_read(struct spi_device *spi, u8 *buf, size_t len)17 {18 struct spi_transfer t = {19 .rx_buf = buf,20 .len = len,21 };22 struct spi_message m;2324 spi_message_init(&m);25 spi_message_add_tail(&t, &m);26 return spi_sync(spi, &m);27 }LDD6410开发板所使用的S3C6410的SPI主机控制器驱动位于drivers/spi/spi_s3c.h和drivers/spi/spi_s3c.c这2个文件，其主体是实现了spi_master的setup()、transfer()等成员函数。