> For the complete documentation index, see [llms.txt](https://man.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://man.bsdcn.org/man8/spi.8.md). # spi(8) `spi` — 与 SPI 总线上的从设备通信 ## 名称 `spi` ## 概要 `spi [-A] [-b] [-L] [-v] [-C command-bytes] [-c count] [-d r|w|rw] [-f device] [-m mode] [-S] [-s max-speed]` `spi [-i] [-v] [-f device]` `spi [-h]` ## 描述 `spi` 工具可用于通过 [spigen(4)](/man4/spigen.4.md) 设备与 SPI 总线上的设备执行原始数据传输（读、写或同时读写）。 每个 [spigen(4)](/man4/spigen.4.md) 设备都与 spibus 上一个特定的“片选”（cs）引脚相关联，因此需要指定。如果未在命令行指定设备名，`spi` 默认使用 “spigen0.0”。 关于 spigen 设备的更多信息，参见 [spigen(4)](/man4/spigen.4.md)。 选项如下： **`-A`** 指定 ASCII 模式。读和写的数据均以 2 字符十六进制值的形式输入和输出，可选择以空白字符分隔，例如 00 01 02 等。与 `-b` 标志组合使用时，stdin 上的数据仍为 ASCII 十六进制字节值序列，但输出恢复为二进制模式。 **`-b`** 二进制（输出）模式。仅在指定了 `-A` 时生效。将输出恢复为二进制（而非 ASCII），同时保持输入格式不变。与 `-A` 组合使用，可以像 “echo” 那样向 SPI 设备传递十六进制值，同时在 stdout 上以二进制形式输出接收到的数据。 **`-C`** `command-bytes` 发送一个或多个命令字节，跳过传输过程中读取的任何字节。字节值应以引号参数的形式指定，格式类似于 `-A` 中 stdin 上的数据格式，即 2 字符十六进制值，可选择以空白字符分隔。SPI 设备通常要求先发送命令，后跟数据字节。可使用此选项发送命令，而不在命令序列期间接收任何数据字节。 **`-c`** `count` 要传输的总字节数，以十进制整数表示。如果执行写或读/写事务，且从 stdin 读取的字节数少于此数目，剩余字节将以 “0” 值发送。如果能从输入文件大小确定长度，可使用 `count` 值 “-1” 以输入文件大小为基准进行传输。 **`-d`** `r`|`w`|`rw` 传输方向：`r` 为读，`w` 为写，`rw` 为同时读写。 **`-f`** `device` 要使用的 SPI 设备（默认为 **/dev/spigen0**）。 **`-h`** 将帮助文本打印到 stderr，解释命令行选项。 **`-i`** 将 SPI 设备信息显示到 stderr。指定此标志时，不读取或写入任何数据，模式和时钟速度也不会改变。 **`-L`** LSB 位序。默认为 MSB，即最高位先传输。指定 `-L` 使 LSB 先传输和读取。 **`-m`** `0`|`1`|`2`|`3` SPI 模式，0 到 3。根据 SPI 规范，定义读取和写入数据时的时钟相位和时序。 **`-S`** 持续从 stdin(3) 流式传输到 `spi` 总线。 **`-s`** `speed` 指定 SPI 时钟的最大速度，单位为 Hz。总线将在不超过此最大值的最高可用速度下运行。 **`-v`** 指定详细模式。诊断和信息写入 stderr。可多次指定 `-v` 以提高详细程度。 ## 实例 以下是使用 spi 工具的几个示例： ```sh spi -i ``` ```sh spi -f spigen0.1 -s 200000 -m 3 ``` ```sh spi -d r -C "00 01" -c 2 ``` ```sh echo "05" | spi -A -d rw -m 2 -s 500000 -c 2 ``` ```sh spi -d rw -c -1