Linux下SPI驱动常用结构体解释

spi_transfer结构体

struct spi_transfer {
     const void *tx_buf;/*常量指针，用于指向发送数据的缓存区，保存发送的数据*/
     void *rx_buf;		/*指向用于接收数据的缓冲区，保存接收到的数据*/
     unsigned len;		/*传输数据的长度*/
     dma_addr_t tx_dma;/*发送缓冲区的DMA的地址*/
     dma_addr_t rx_dma;/*接收缓冲区的DMA的地址*/
     struct sg_table tx_sg;/*发送数据的散列和聚集，将存放在不同地址的数据记录在表中，让spi根据表中信息连续发送*/
     struct sg_table rx_sg;/*接收数据的散列和聚集*/
     unsigned cs_change:1;/*位域，设置为1则传输结束后片选信号发生变化，否则不变*/
     unsigned tx_nbits:3;/*设置发送数据的位宽*/
     unsigned rx_nbits:3;/*设置接收数据位宽*/
     #define SPI_NBITS_SINGLE 0x01 /* 1bit transfer */
     #define SPI_NBITS_DUAL 0x02 /* 2bits transfer */
     #define SPI_NBITS_QUAD 0x04 /* 4bits transfer */
     u8 bits_per_word;/*表示传输的数据位置 如果传输的数据为8位 bits_per_word=8 16位也是一样*/
     u16 delay_usecs;/*本次传输距下次传输的时间us*/
     u32 speed_hz;/*spi时钟频率*/
     struct list_head transfer_list;/*用于将多个transfer结构体组成链表，方便连续传输*/
};

spi_message结构体

struct spi_message {
    /*链表头，用于连接一系列的 struct spi_transfer 结构体*/
	struct list_head	transfers;
    /*指向与该消息相关的 struct spi_device 结构体的指针*/
	struct spi_device	*spi;
    /*这是一个位域，占 1 位。用于标记该消息是否使用 DMA，使用DMA则为1，否则为0*/
	unsigned		is_dma_mapped:1;
    /*complete 是一个函数指针，指向一个回调函数。当整个 SPI 消息传输完成后，会调用这个回调函数。*/
	void			(*complete)(void *context);
    /*context 是传递给回调函数的上下文指针，用于在回调函数中传递必要的数据。*/
	void			*context;
    /*表示整个 SPI 消息的预期传输长度，单位是字节。这个值是所有 struct spi_transfer 结构体中数据长度的总和。*/
	unsigned		frame_length;
    /*表示实际完成的传输长度，单位是字节。在消息传输完成后，这个值会被更新为实际传输的字节数*/
	unsigned		actual_length;
    /*传输状态标志位，传输成功返回0，传输失败返回错误码*/
	int			status;
    /*链表头，用于将该消息添加到某个队列中。通常由 SPI 主控驱动使用，用于管理待处理的消息队列*/
	struct list_head	queue;
	void			*state;
};