直接用spidev接口最可行，需open()打开设备节点并用ioctl配置模式、位宽和速率；单独read()返回0xFF因无时钟，必须用SPI_IOC_MESSAGE发起完整读写传输。
直接用 spidev 接口是最可行的路径，Linux 内核已封装好驱动，不需要自己写裸机寄存器或模拟时序。但必须注意：C++ 本身不提供 SPI 原生支持，所有操作都依赖系统调用和 ioctl，稍有不慎就会读到全 0xFF（即 255）。
怎么打开并配置 spidev 设备节点
树莓派、Jetson 或大多数 ARM Linux 板卡上，SPI 设备通常挂载为 /dev/spidev0.0 或 /dev/spidev1.0。数字后缀中，前一个表示 SPI 总线号（如 spi0），后一个表示片选号（CS0）。注意：不是所有 CS 都默认启用，需确认设备树或 config.txt 中已启用对应总线。
- 用
open()以读写模式打开，必须加O_RDWR，只读或只写会失败 - 用
ioctl(fd, SPI_IOC_WR_MODE, &mode)设置工作模式，常见的是SPI_MODE_0（CPOL=0, CPHA=0）或SPI_MODE_3（CPOL=1, CPHA=1），务必和从设备 datasheet 一致 - 用
ioctl(fd, SPI_IOC_WR_BITS_PER_WORD, &bits)设置字长，多数传感器是 8，但有些 ADC 是 16，设错会导致移位错乱 - 用
ioctl(fd, SPI_IOC_WR_MAX_SPEED_HZ, &speed)设置速率，别盲目填最大值——很多 Flash 芯片在 20MHz 下稳定，但温湿度传感器可能只支持 1MHz
为什么 read() 单独调用总是返回 255
这是最常踩的坑：read() 系统调用不会触发 SCLK，它只是从内核缓冲区取数据。而 SPI 是同步协议，没有时钟就没有数据交换。所以仅 read(fd, buf, len) 实际上是在读空闲总线上的悬空电平，硬件上常表现为高阻态被上拉成 0xFF。
- 必须用
ioctl(fd, SPI_IOC_MESSAGE(1), &msg)发起一次完整传输 - 哪怕只想读一个字节，也要构造一个两段
spi_ioc_transfer：第一段发命令（如寄存器地址），第二段发 dummy byte（如0x00）来生成时钟并采样 MISO - 不能把 tx 和 rx 合并在一个 buffer 里靠偏移区分——
spidev要求每个 transfer 结构体明确指定tx_buf和rx_buf
怎么组织一次寄存器读操作（典型场景）
比如读 BMP280 的芯片 ID（寄存器 0xD0），流程是：先发带读标志的地址（0xD0 | 0x80），再收 1 字节。这不能拆成两次 ioctl，必须在一个 spi_message 中完成，否则中间 CS 可能释放导致从机退出传输状态。
- 定义两个
spi_ioc_transfer结构体：第一个tx_buf指向&addr，len = 1，rx_buf = nullptr；第二个tx_buf指向 dummy（如&dummy），len = 1，rx_buf指向接收变量 - 两个结构体的
cs_change都设为 0，确保 CS 在整个 message 期间保持拉低 - 设置
speed_hz和bits_per_word时，以两个 transfer 中更严格的那个为准（比如第一个要 10MHz，第二个只要 1MHz，则统一用 1MHz）
硬件连线和电平匹配不能跳过验证
即使代码完全正确，如果 MOSI 没接、CS 没拉低、或 5V 传感器直连树莓派 3.3V GPIO，结果仍是全 0xFF 或随机乱码。逻辑分析仪不是可选项，是必需项。
- 先用万用表量 CS 是否在传输时确实变低（注意：有些设备要求低有效，有些高有效）
- MISO 线空载时应为高阻态，若测出固定低电平，说明从机没上电或未响应
- 若用 5V 设备（如某些 OLED），必须加双向电平转换芯片（如 TXB0104），电阻分压只适用于单向输出（如 MOSI→从机），不适用于 MISO（从机→主）
- 树莓派的
spidev0.0默认使用 CE0（GPIO 8），不要误接到 GPIO 7（CE1）还去开spidev0.0
真正难的从来不是写几行 ioctl，而是确认 CPOL/CPHA 和设备手册对得上、CS 时序没被驱动层悄悄改掉、以及 dummy byte 的数量刚好匹配从机的响应延迟。这些细节不出现在任何 C++ 教程里，只藏在示波器波形和 datasheet 的 timing diagram 里。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
