SPI message 基础 Part 2
SPI message基础
Contents
.Part 1 - Linux SPI系统概览
.Part 2 - SPI message 基础
.Part 3 - 异步写
LinuxSPI 通信基础
在SPI总线上是通过封装一系列的spi_transfer到一个spi_message中，然后将spi_message提交到SPI子系统去。
下面是spi_transfer结构：
struct spi_transfer {
const void*tx_buf; //驱动提供的发送缓冲区dma,
void *rx_buf; //接收缓冲区
unsigned len;
dma_addr_ttx_dma; //发送dma，controller使用
dma_addr_t rx_dma; //接收dma
unsigned cs_change:1; //片选位
u8 bits_per_word; //每字长度
u16 delay_usecs; //延迟
u32 speed_hz; //速度
struct list_headtransfer_list; //transfer 链表
};
len is always the # of 8-bitbytes to clock, could be send ,receive or both.
tx_dma和rx_dma可通过dma_map_single()来初始化或者让controller来填充这些域。如果你手动的映射这些dma，就必须将spi_message.is_dma_mappped置为1，来告知controller你已经做好映射了。既然手动的做映射也必须手的unmapped掉。并不是所有的transfer都会使用dma，比如，有的控制器在transfer小于8字节时会使用PIO(ProgrammingI/O,cpu执行I/O端口指令进行读写，大数据交换是会提高cpu占有率)模式。
cs_change置1会引起CS线在spi_message序列中transfers间变高。通常，CS会在第一个transfer前变低并一直保持直至spi_message序列中最后一个transfer到来（这是本次spi_message中最后一个）。这种反转在和某些设备通信时会非常有用。
bit_per_word对于单个spi_transfer可用来覆盖spi_device.bits_per_word域。清零不做覆盖。
delay_usecs会在spi_message序列中一个transfer之后，CS状态改变前或者下一个transfer修正延迟。
speed_hz允许这个transfer可以有高于spi_device.max_speed_hz的速率。清零不作变化。
transfer_listspi_message序列中用于维护transfer的链表。
在spi_transfer中时常更改的域也许只有len，tx_buf和rx_buf。剩下的当以0来初始化。
单个spi_transfer可表示一次读，一次写或者是一次读写。在SPIcontroller驱动下，所有操作常是全双工的。向spi_transfer中rx_buf传递一个NULL，这就是一次只写操作，会丢弃MISO线上的数据。同样向tx_buf传递一个NULL，这就是一次只读操作了。spi_transfer中len域代表（已经多少字节数据流过总线了）howmany bytes to clock the bus。
spi_message结构：
struct spi_message {
struct list_head transfers;
struct spi_device *spi;
unsigned is_dma_mapped:1;
void (*complete)(void*context);
void *context;
unsigned actual_length;
int status;
struct list_head queue;
void *state;
};
transfer这个spi_message所包含有的spi_transfer链表头。
is_dma_mappedspi_transfer中tx_dma和rx_dma是否已经mapped。
complete回调函数
context 提供给complete的可选参数
actual_lengthspi_message已经传输了的字节数
status 出错与否，错误时返回errorcode
queue 和state 供controller驱动内部使用
在每次使用spi_message可以使用函数：
void spi_message_init(structspi_message *m);
来初始化。
向spi_message添加transfers可以使用spi_message_add_tail()函数：
void spi_message_add_tail(structspi_transfer *t, struct spi_message *m);
一旦你准备好了spi_message，就可以使用spi_async()来向SPI系统提交了：
int spi_async(struct spi_device *spi,struct spi_message *message);
因为是异步的，一提交就立马返回了，这也就是说需要同步机制（complete就是了）。他确保不会睡眠，可安全的在中断handler或其他不可休眠的代码中调用。稍后会念念他的好的。
使用spi_async()需要注意的是，在complete()未返回前不要轻易访问你一提交的spi_transfer中的buffer。也不能释放SPI系统正在使用的buffer。一旦你的complete返回了，这些buffer就又是你的了。
使用完成回调机制稍显复杂，可以使用SPI系统提供的另一个同步版本：spi_sync():
int spi_sync(struct spi_device *spi,struct spi_message *message);
因为是同步的，spi_sync提交完spi_message后不会立即返回，会一直等待其被处理。一旦返回就可以重新使用buffer了。spi_sync()在drivers/spi/spi.c中实现，其调用了spi_async()，并休眠直至complete返回。