SPI_IOC_MESSAGE(1)

SPI_IOC_MESSAGE(1) 是 Linux 内核提供的一种系统调用接口，主要用于高效地在用户空间和内核空间之间传输SPI（Serial Peripheral Interface）数据。这个宏定义允许用户通过IOCTL（Input/Output Control）操作来批量发送和接收一系列SPI交易。

当你需要发送一组连续的SPI交易（可能是多个命令字、读取的数据块等）时，可以使用SPI_IOC_MESSAGE来一次性发起多个请求。它接受四个参数：

1. **request**：这是ioctl操作码，例如`SIOCSPXXX`系列，其中的XXX取决于你要执行的具体SPI功能，比如`SIOCSPSend`用于发送数据，`SIOCSPRecv`用于接收数据。

2. **fd**：指向打开的设备文件描述符，通常是你使用的SPI设备文件。

3. **cmd**：一个struct spi_message指针，包含了一系列的SPI事务，包括命令、响应缓冲区和数据长度等。

4. **arg**：一个void*指针，指向cmd结构体的起始地址，用于传递额外的信息给驱动。

以下是使用SPI_IOC_MESSAGE的一个例子：

#define SIOCSP_SEND  _IOW('s', 150, struct spi_message)
#define SIOCSP_RECV  _IOR('s', 151, struct spi_message)

struct spi_message msg;
msg.descriptors = &descs[0];
msg.n_desc = num_of_descs;

struct spi_ioc_transfer *descs[] = {
    ... // 描述符数组，每个元素表示一个交易，包含CMD、Rx buf、Tx buf等信息
};

// 在用户空间
ssize_t ret = ioctl(fd, SIOCSP_SEND, &msg);

if (ret == -1) {
    perror("Failed to send");
} else {
    // 检查返回结果
}

// 对于接收，类似地使用SIOCSP_RECV替换SIOCSP_SEND

使用SPI_IOC_MESSAGE可以简化用户对SPI设备的交互，提高效率，尤其是在数据量大或者频繁传输的情况下。