当前位置：首页 > news >正文

Wio Terminal SPI通信全解析：从原理到实战驱动屏幕与SD卡

news 2026/8/2 16:56:30

1. 为什么SPI对Wio Terminal如此重要？

如果你刚拿到Wio Terminal这块开发板，想驱动一块屏幕、读取一个传感器，或者连接一个无线模块，你很快就会发现，除了那几个简单的数字和模拟引脚，很多“高级”外设都需要一种更高效的通信方式。这时，你大概率会接触到三个缩写：I2C、UART和SPI。今天，我们就来深挖一下SPI（Serial Peripheral Interface），看看它如何在Wio Terminal上大显身手，以及如何避开那些新手常踩的坑。

Wio Terminal本身搭载了一块2.4英寸的LCD彩屏和多个内置传感器，这些部件很多就是通过SPI与主控芯片（ATSAMD51）通信的。这意味着，即使你什么都不接，你的代码已经在底层和SPI打交道了。而当你需要扩展功能时，比如连接一个高速的MicroSD卡模块来存储数据，或者驱动一个高分辨率的OLED显示屏，SPI几乎是唯一的选择，因为它提供了远超I2C的通信速度。理解SPI，就等于拿到了解锁Wio Terminal全部扩展潜力的钥匙。它不像I2C那样可以轻松挂载多个设备，也不像UART那样简单直接，但它的高速和全双工特性，在需要快速传输大量数据的场景下无可替代。

2. 拆解SPI：四根线背后的工作原理

在动手写代码之前，我们得先搞明白SPI到底是怎么工作的。它通常需要四根线，这比I2C的两根线多，但比并行总线少得多，是一种在速度和复杂度之间取得平衡的方案。

SCK (Serial Clock)：时钟线，由主设备（这里就是Wio Terminal）产生。所有的数据收发都根据这个时钟信号的边沿来同步。你可以把它想象成乐队指挥的指挥棒，大家必须跟着它的节奏来。

MOSI (Master Out Slave In)：主设备输出，从设备输入。这是主设备向从设备发送数据的通道。

MISO (Master In Slave Out)：主设备输入，从设备输出。这是从设备向主设备返回数据的通道。注意，SPI是全双工的，这意味着MOSI和MISO可以同时传输数据，效率很高。

SS/CS (Slave Select / Chip Select)：片选线。这是SPI管理多设备的关键。每个从设备都需要一根独立的片选线。当主设备想和某个从设备通信时，就将对应设备的片选线拉低（通常是低电平有效），其他设备的片选线保持高电平。这样，只有被选中的设备才会响应时钟信号，避免了总线冲突。这就像在一个大办公室里，你喊某个人的名字（拉低他的片选线），只有他才会站起来回答你。

SPI的通信协议相对简单：没有起始位、停止位，也没有地址帧。通信由主设备发起的时钟脉冲驱动，在每个时钟周期内，主从双方通过MOSI和MISO线各交换1比特（bit）数据。数据的采样时机（是在时钟上升沿还是下降沿采样）和时钟的空闲状态极性，构成了SPI的四种工作模式（Mode 0, 1, 2, 3）。这是配置SPI时最容易出错的地方之一，我们后面会详细说。

3. Wio Terminal的SPI硬件资源与引脚分配

Wio Terminal基于ATSAMD51微控制器，它提供了多个硬件SPI外设（Sercom）。Arduino框架已经为我们封装好了这些硬件资源，使得调用变得非常方便。最关键的是，你需要知道哪些引脚被固定用于SPI功能，因为硬件SPI的引脚是映射到芯片特定物理引脚上的，不能随意更改。

Wio Terminal有两个主要的SPI接口：

默认SPI (SPI)：通常用于连接板载设备或扩展槽。其引脚定义如下：
- SCK:PC27
- MOSI:PC28
- MISO:PC26
- 默认SS:PB31(但通常我们不用这个，而是为每个外设自定义一个数字引脚作为CS)
在Wio Terminal的侧边“Grove”接口和底部的“Raspberry Pi 兼容”40针接口中，这些SPI引脚也被引出，方便你连接外部模块。
LCD专用SPI (SPI1)：这个SPI接口专门用于驱动板载的2.4英寸LCD屏幕。除非你非常清楚自己在做什么，并且愿意承担重写底层驱动的风险，否则不建议用户程序占用这个SPI1，以免导致屏幕无法正常工作。

注意：在Arduino IDE中，当你使用#include <SPI.h>并创建SPI对象时，你操作的就是上面提到的默认SPI接口（SCK, MOSI, MISO）。你需要手动管理片选（CS）引脚。

那么，如何连接一个外设呢？我们以一个常见的MicroSD卡模块为例：

将模块的SCK接 Wio Terminal的SCK (PC27)。
将模块的MOSI接 Wio Terminal的MOSI (PC28)。
将模块的MISO接 Wio Terminal的MISO (PC26)。
将模块的CS接 Wio Terminal的任何一个空闲的数字I/O引脚，例如D8。
确保电源（3.3V/5V）和地线（GND）正确连接。Wio Terminal的逻辑电平是3.3V，务必确认你的外设兼容3.3V电平，否则需要电平转换。

4. 从零开始：配置SPI并驱动你的第一个外设

理论说再多，不如动手试一下。我们以连接一个SPI接口的OLED显示屏（例如SSD1306驱动芯片）为例，展示完整的流程。这里我们使用u8g2这个强大的图形库，它完美支持SPI模式的SSD1306。

4.1 环境准备与库安装

首先，在Arduino IDE中，你需要安装两个库：

U8g2库：在“项目” -> “加载库” -> “管理库”中，搜索 “U8g2”，找到由olikraus开发的版本并安装。这个库功能极其全面，支持上百种显示器。
SPI库：通常Arduino SAMD核心已经自带，无需额外安装。

4.2 硬件连接

参照上一节的引脚定义，将OLED模块与Wio Terminal连接：

OLED SCK -> Wio Terminal SCK
OLED MOSI -> Wio Terminal MOSI
OLED DC (数据/命令) -> Wio TerminalD9(任意数字引脚)
OLED RESET -> Wio TerminalD10(任意数字引脚)
OLED CS -> Wio TerminalD8(我们自定义的片选引脚)
OLED VCC -> 3.3V
OLED GND -> GND

4.3 代码实现与解析

#include <Arduino.h> #include <U8g2lib.h> // 引入图形库 #include <SPI.h> // 引入SPI库 // 使用硬件SPI构造函数，参数依次是：显示驱动型号、时钟、数据、片选、数据/命令、复位 // U8G2_SSD1306_128X64_NONAME_F_4W_HW_SPI u8g2(U8G2_R0, /* cs=*/ D8, /* dc=*/ D9, /* reset=*/ D10); // 更通用的写法，指定旋转方向、CS、DC、RESET引脚，SCK和MOSI使用硬件默认引脚 U8G2_SSD1306_128X64_NONAME_F_4W_HW_SPI u8g2(U8G2_R0, D8, D9, D10); void setup(void) { // 初始化串口，便于调试 Serial.begin(115200); while (!Serial); // 等待串口连接，实际产品中可去掉 // 初始化显示屏 u8g2.begin(); Serial.println("OLED Initialized!"); // 设置字体（u8g2内置了多种字体） u8g2.setFont(u8g2_font_ncenB08_tr); // 选择一种字体 u8g2.setFontPosTop(); // 设置绘制文本的基线位置 } void loop(void) { u8g2.clearBuffer(); // 清除内部缓冲区 u8g2.drawStr(0, 10, "Hello, Wio Terminal!"); // 在坐标(0,10)绘制字符串 u8g2.drawStr(0, 30, "SPI Demo Running..."); // 画一个简单的进度条边框 u8g2.drawFrame(10, 45, 108, 10); // 根据时间计算填充宽度 int width = (millis() / 50) % 108; u8g2.drawBox(10, 45, width, 10); u8g2.sendBuffer(); // 将缓冲区内容发送到显示屏 delay(10); // 短暂延迟 }

代码关键点解析：

构造函数：U8G2_SSD1306_128X64_NONAME_F_4W_HW_SPI这个长长的名字包含了所有信息：驱动芯片、分辨率、控制器型号、帧缓冲模式、4线硬件SPI。我们传入了我们自定义的CS(D8)、DC(D9)、RESET(D10)引脚。库内部会自动调用SPI.begin()并管理SPI传输。
双缓冲机制：clearBuffer()和sendBuffer()是U8g2的核心。所有绘图操作都在内存缓冲区中进行，完成后一次性通过SPI发送到屏幕。这避免了屏幕闪烁，也大大简化了编程。
SPI的透明性：你会发现，在整个代码中，我们并没有直接操作SPI对象的transfer()等方法。这是因为高级库（如U8g2、SD库）已经帮我们封装好了底层通信。这是我们使用SPI最常见的方式——依赖成熟的库。

5. 深入SPI配置：时钟、模式与性能调优

当你使用更底层的SPI操作，或者某个库需要你手动配置SPI参数时，你就需要了解以下几个核心设置。错误的配置会导致通信完全失败。

5.1 SPI模式（Mode）

这是最关键的配置，必须与外设数据手册的要求完全一致。它由时钟极性（CPOL）和时钟相位（CPHA）两个参数决定：

CPOL (Clock Polarity)：时钟空闲时的电平状态。
- 0：时钟空闲时为低电平。
- 1：时钟空闲时为高电平。
CPHA (Clock Phase)：数据在时钟的哪个边沿被采样。
- 0：数据在时钟的第一个边沿（如果CPOL=0，就是上升沿；CPOL=1，就是下降沿）被采样。
- 1：数据在时钟的第二个边沿被采样。

组合起来就是四种模式：

Mode 0: CPOL=0, CPHA=0 (最常用)
Mode 1: CPOL=0, CPHA=1
Mode 2: CPOL=1, CPHA=0
Mode 3: CPOL=1, CPHA=1

例如，很多SD卡和OLED屏使用Mode 0。你必须在你的外设数据手册中找到这个信息。

在Arduino中，可以使用SPI.beginTransaction(SPISettings(clockSpeed, bitOrder, dataMode))来临时设置SPI参数，确保在与特定设备通信时使用正确的模式。

5.2 时钟速度（Clock Speed）

SPI时钟频率决定了通信速度。Wio Terminal的ATSAMD51的SPI时钟可以设置得很高（理论可达几十MHz）。但并不是越高越好，原因有二：

外设极限：每个外设都有其支持的最高时钟频率。过高的时钟会导致数据错误。
信号完整性：导线较长或布局不佳时，高速信号容易产生振铃和干扰，导致通信不稳定。

一个实用的建议是：从较低的频率开始测试，例如1000000(1MHz)，通信稳定后再逐步提高。对于SD卡，初始化时通常需要用较低速度（如400kHz），初始化成功后可以切换到更高速度（如10-20MHz）。

5.3 位顺序（Bit Order）

决定数据是先发送最高位（MSBFIRST）还是最低位（LSBFIRST）。绝大多数SPI设备都是MSBFIRST，这也是Arduino的默认设置。除非数据手册明确说明，否则不要改动它。

5.4 实战配置示例

假设我们要手动配置SPI以Mode 0、8MHz时钟与一个设备通信：

#include <SPI.h> // 定义我们自定义的片选引脚 const int chipSelectPin = D8; void setup() { Serial.begin(115200); pinMode(chipSelectPin, OUTPUT); digitalWrite(chipSelectPin, HIGH); // 初始时取消选中设备 SPI.begin(); // 初始化SPI总线 } void communicateWithDevice() { // 创建SPI设置对象：时钟8MHz，MSB优先，Mode 0 SPISettings mySettings(8000000, MSBFIRST, SPI_MODE0); // 开始一个SPI事务，这会锁定SPI配置并防止其他中断干扰 SPI.beginTransaction(mySettings); digitalWrite(chipSelectPin, LOW); // 选中设备 delayMicroseconds(10); // 一些设备需要片选有效后的短暂稳定时间 // 发送一个命令字节 0xAA，并接收一个字节的回复 byte command = 0xAA; byte response = SPI.transfer(command); // 可以连续传输更多数据... // SPI.transfer(0x00); // SPI.transfer(0x01); digitalWrite(chipSelectPin, HIGH); // 取消选中设备 SPI.endTransaction(); // 结束事务，释放SPI总线 Serial.print("Received: 0x"); Serial.println(response, HEX); } void loop() { communicateWithDevice(); delay(1000); }

注意：SPI.beginTransaction()和SPI.endTransaction()非常重要。它们不仅应用了你的设置，还在多任务环境（如使用RTOS或中断服务程序中操作SPI）中提供了关键的保护，防止SPI配置在通信中途被意外更改。

6. 多设备管理与片选（CS）策略

SPI总线本身支持多从设备，但前提是每个设备有独立的片选（CS）线。主设备通过拉低某条CS线来激活对应的从设备。管理多个设备时，核心原则是：在任何时刻，只能有一条CS线处于有效（低电平）状态。

接线示意图：

Wio Terminal 设备A 设备B MOSI ----------> MOSI MOSI MISO <---------- MISO MISO SCK ----------> SCK SCK D8 (CS_A) --------> CS D9 (CS_B) -----------------------> CS

代码管理要点：

为每个设备定义一个CS引脚，并在setup()中将其设置为OUTPUT模式，并初始化为HIGH（不选中）。
在与某个设备通信前，先将其CS引脚拉低 (LOW)，并确保其他所有设备的CS引脚为高 (HIGH)。
通信结束后，立即将该设备的CS引脚拉高。

const int csSD = D2; // SD卡模块片选 const int csTFT = D3; // 另一个显示屏片选 void setup() { pinMode(csSD, OUTPUT); pinMode(csTFT, OUTPUT); digitalWrite(csSD, HIGH); digitalWrite(csTFT, HIGH); SPI.begin(); } void writeToSD() { digitalWrite(csTFT, HIGH); // 确保TFT不干扰 digitalWrite(csSD, LOW); // 选中SD卡 // ... 与SD卡通信 ... digitalWrite(csSD, HIGH); } void writeToTFT() { digitalWrite(csSD, HIGH); // 确保SD卡不干扰 digitalWrite(csTFT, LOW); // 选中TFT // ... 与TFT通信 ... digitalWrite(csTFT, HIGH); }

常见陷阱：忘记在通信间隔中将CS引脚拉高。有些设备会在CS持续为低时进入一种奇怪的状态，消耗电流或干扰MISO线。养成“即用即选，用完释放”的好习惯。

7. 实战排坑：SPI通信失败的诊断思路

即使连接和代码看起来都正确，SPI通信仍可能失败。以下是一个系统性的排查流程：

检查物理连接（最基础也最重要）：
- 用万用表通断档，逐一检查SCK、MOSI、MISO、CS、VCC、GND这六根线是否连通，有无虚焊、断线。
- 确认电源电压稳定（3.3V），且GND共地良好。电源不稳是许多灵异问题的根源。
确认逻辑电平兼容性：
- Wio Terminal是3.3V系统。如果你的外设是5V的，MOSI、SCK、CS从3.3V到5V可能勉强工作（很多5V设备能识别3.3V高电平），但MISO从5V到3.3V是绝对危险的，会损坏Wio Terminal的引脚！必须使用电平转换器（如TXB0104等双向电平转换芯片）。
验证SPI模式与时钟：
- 模式错误是头号杀手。再次仔细核对外设数据手册中的SPI模式要求。尝试四种模式逐一测试（虽然麻烦，但能救命）。
- 将时钟速度降到最低（如100000即100kHz）进行测试。如果低速下工作正常，高速不行，就是信号完整性问题或外设极限问题。
使用逻辑分析仪或示波器（终极武器）：
- 如果没有仪器，可以尝试“软件监听”。在SPI.transfer()前后打印发送和接收的数据，看是否有规律。例如，发送0xAA，收到的如果不是0xAA（回环测试）或设备约定的响应，而是0xFF或0x00，通常意味着物理层通信根本没建立（检查连线、电源、片选）。
- 0xFF常表示MISO线被上拉（处于空闲状态），从设备没有驱动它（设备未选中或未响应）。
- 0x00可能意味着MISO线被意外拉低。
检查库的依赖和冲突：
- 有些库在初始化时会修改SPI的默认设置。确保你使用的所有库兼容，或者使用SPI.beginTransaction()/endTransaction()来严格隔离不同设备的SPI配置。
- 检查是否有其他引脚（特别是与SPI引脚复用的功能）发生了冲突。
片选（CS）时序问题：
- 有些设备要求CS在时钟开始前有一个最小的建立时间（t_SU），或者在时钟结束后有一个最小的保持时间（t_HD）。在拉低CS后和开始发送时钟前，增加一个delayMicroseconds(1-10)；在通信结束拉高CS前，也增加一个短暂的延迟。

8. 进阶应用：SPI与SD卡、TFT屏幕的深度集成

掌握了基础，我们来看两个在Wio Terminal上最典型的SPI应用：文件存储和图形显示。

8.1 使用SD卡进行数据记录

Wio Terminal的底部有一个MicroSD卡槽，通过SPI连接。使用Arduino自带的SD库可以方便地进行操作。

#include <SPI.h> #include <SD.h> File myFile; void setup() { Serial.begin(115200); while (!Serial); Serial.print("Initializing SD card..."); // 参数“SS”在这里指的是SD卡槽的片选引脚，对于Wio Terminal内置卡槽，通常是固定引脚。 // 如果使用外置模块，则需要改为你连接的引脚，如 `D8`。 if (!SD.begin()) { Serial.println("initialization failed!"); return; } Serial.println("initialization done."); // 打开文件，如果不存在则创建（FILE_WRITE模式） myFile = SD.open("datalog.txt", FILE_WRITE); if (myFile) { myFile.println("Hello, SD Card! Timestamp: " + String(millis())); myFile.close(); // 非常重要！必须关闭文件以保存数据 Serial.println("Write successful."); } else { Serial.println("error opening datalog.txt"); } // 重新打开文件并读取 myFile = SD.open("datalog.txt"); if (myFile) { Serial.println("datalog.txt content:"); while (myFile.available()) { Serial.write(myFile.read()); } myFile.close(); } else { Serial.println("error opening file for reading"); } } void loop() { // 可以在loop中定期记录传感器数据 }

SD卡实操心得：

SD.begin()失败：最常见的原因是CS引脚不对、卡格式不支持（建议用电脑格式化为FAT32）、卡接触不良、或者电源不足（大容量SD卡启动电流较大）。尝试外接一个质量好的5V转3.3V稳压模块给SD卡单独供电，往往能解决很多问题。
文件操作后务必.close()：尤其是写操作，数据可能还留在缓存里，不关闭文件会导致数据丢失。
小心电源管理：在写入文件时，避免突然断电，可能损坏文件系统。对于关键数据记录，可以考虑增加后备电池或使用带有写保护功能的文件系统库。

8.2 驱动高性能SPI TFT显示屏

除了板载屏幕，你还可以连接更高级的SPI TFT屏（如ILI9341驱动）。TFT_eSPI库是Arduino平台上一个高效的选择，它针对不同硬件有高度优化的驱动。

安装并配置 TFT_eSPI 库：安装后，你需要修改库目录下的用户配置文件。找到Arduino/libraries/TFT_eSPI/User_Setup.h或User_Setup_Select.h文件。

选择/配置你的显示屏：在User_Setup_Select.h中，注释掉其他行，取消注释对应你显示屏驱动芯片的那一行，例如#include <User_Setups/Setup25_TTGO_T_Display.h>。或者直接编辑User_Setup.h，手动定义引脚：

#define ILI9341_DRIVER #define TFT_CS D8 // 你的片选引脚 #define TFT_DC D9 // 你的数据/命令引脚 #define TFT_RST D10 // 你的复位引脚（如果接了就定义，否则用-1） #define SPI_FREQUENCY 40000000 // SPI时钟频率，可调整 #define SPI_READ_FREQUENCY 20000000 // 读频率，通常低于写频率

编写测试代码：

#include <TFT_eSPI.h> TFT_eSPI tft = TFT_eSPI(); void setup() { tft.init(); tft.setRotation(1); // 根据屏幕方向调整 tft.fillScreen(TFT_BLACK); tft.setTextColor(TFT_GREEN, TFT_BLACK); tft.drawString("SPI TFT Ready!", 10, 50, 4); } void loop() { // 绘制动态图形 tft.fillCircle(random(tft.width()), random(tft.height()), 5, random(0xFFFF)); delay(50); }

TFT屏幕调试技巧：

白屏或花屏：首先检查SPI模式（ILI9341通常是Mode 0）和时钟频率是否过高。尝试降低SPI_FREQUENCY。
颜色错乱：检查TFT_eSPI库中关于颜色格式（RGB/BGR）的配置是否与你的屏幕匹配。
性能优化：TFT_eSPI提供了pushImage()等函数用于快速绘制位图。对于动画，尽量只更新屏幕变化的部分，而不是全屏刷新。

9. SPI通信的边界与高级话题

当你需要同时使用多个高速SPI设备，或者进行非常精确的时序控制时，可能会遇到一些瓶颈。

软件SPI (Bit-Banging)：如果硬件SPI引脚被占用，或者你需要非常规的时序，你可以用任何数字引脚通过软件模拟SPI时序。Arduino的SoftwareSPI库或自己写digitalWrite()和delayMicroseconds()可以实现。但代价是速度极慢（通常不超过几百KHz），且会占用大量CPU时间。除非万不得已，否则不要用软件SPI驱动屏幕或SD卡。

SPI总线负载与布线：当连接多个设备且通信频率很高时，总线电容会增加，可能导致信号边沿变缓，产生错误。此时需要：

缩短连接线，使用排线或屏蔽线。
在SCK和MOSI线上串联一个小电阻（如22-100欧姆）以阻尼振铃。
确保为每个设备提供干净、充足的电源，并在VCC附近放置去耦电容（0.1uF）。

DMA（直接存储器访问）：ATSAMD51支持DMA，可以在不占用CPU的情况下进行SPI数据搬运。这对于需要极高刷新率的屏幕或高速数据采集至关重要。但这需要更底层的寄存器编程或使用支持DMA的高级库（如Adafruit的某些库），超出了基础应用的范畴。当你发现即使优化了代码，SPI传输仍然严重拖慢主程序时，就该考虑研究DMA了。

在我自己的一个环境监测项目中，需要同时记录传感器数据到SD卡并刷新一个小型SPI OLED状态屏。最初直接使用库函数，在写SD卡时屏幕会明显卡顿。我的解决方案是：

将SD卡操作（特别是文件写入）放在一个独立的低优先级任务中，或者使用非阻塞的写法，避免在loop()中长时间阻塞。
为SD卡和OLED屏使用不同的SPI时钟设置。SD卡初始化后用setFrequency()提高到15MHz，而OLED保持默认的4MHz，两者通过beginTransaction()隔离。
优化屏幕刷新，只更新变化的数据区域，而不是全屏重绘。

这些调整使得系统能够流畅地并行处理数据存储和显示，核心就在于理解SPI总线是一个需要精心管理的共享资源。

查看全文

http://www.jsqmd.com/news/1314597/