如果你開始學習 Arduino、ESP32、Raspberry Pi、STM32、TFT 顯示器、SD 卡、Flash 記憶體或高速 ADC,很快就會遇到 SPI。它使用同步時鐘逐 bit 傳輸,線路比 I²C 多,但速度通常更高,通訊控制也更直接。
SPI 的難點不在於接上四條線,而在於雙方必須同時設定正確的 Clock Frequency、Bit Order、Word Length、CPOL 與 CPHA;多個裝置共用總線時,也要正確管理每一條 CS 以及 MISO 三態輸出。
這篇文章將從最基礎開始介紹 SPI,包含:
- SCK、MOSI、MISO、CS/SS 的功能
- Controller/Peripheral 與全雙工移位原理
- CPOL、CPHA 與 SPI Mode 0~3
- MSB First、LSB First 與資料字長
- Command、Address、Dummy Cycles 與資料 Frame
- 多裝置共用、獨立 CS 與 Daisy Chain
- 3-wire、Dual SPI、Quad SPI 與 QSPI
- 時序參數、最高時鐘與訊號完整性
- Arduino、ESP32、Raspberry Pi 與 STM32 實作
- 邏輯分析儀、示波器、錯誤排查、實驗與 FAQ
只要先記住三件事:SPI 沒有通用位址與 ACK、CS 必須在正確時機選取目標、Mode 與 bit order 必須完全符合 datasheet,就能避免大多數入門問題。
SPI 是什麼
SPI 是 Serial Peripheral Interface 的縮寫,中文常稱序列周邊介面。它是一種同步串列通訊架構,由 Controller 產生時鐘並選擇 Peripheral,資料可在兩個方向同時移動。
Controller
SCK ─────────→ Peripheral
MOSI ─────────→ Peripheral
MISO ←───────── Peripheral
CS ─────────→ Peripheral
SPI 是廣泛採用的介面慣例,但不像 I²C 有一套單一規範涵蓋所有裝置。每顆晶片的 CS 時序、Command、Address、Mode、最大頻率與資料格式都要查 datasheet。
SPI 常見在哪裡
- TFT/OLED 顯示器與觸控控制器
- microSD 卡與 SPI Flash
- 高速 ADC、DAC 與電流感測器
- 無線模組、LoRa、RFID 與 Ethernet Controller
- 加速度計、陀螺儀與磁力計
- LED Driver、數位電位器與 GPIO Expander
SPI 的四條基本訊號
| 訊號 | 全名 | 方向與用途 |
|---|---|---|
| SCK/SCLK | Serial Clock | Controller 輸出時鐘 |
| MOSI | Master Out Slave In | Controller 傳向 Peripheral |
| MISO | Master In Slave Out | Peripheral 傳向 Controller |
| CS/SS | Chip Select/Slave Select | 通常 LOW 有效,選擇目標裝置 |
較新的文件也可能用 COPI/CIPO,分別代表 Controller Out Peripheral In 與 Controller In Peripheral Out。名稱不同,電氣方向相同。
Controller 與 Peripheral
Controller 產生 SCK、控制 CS,並決定每次交易何時開始。Peripheral 只有在自己的 CS 被啟用時,才應解讀時鐘與資料,並在需要時驅動 MISO。
Controller 決定:
• SCK 頻率
• SPI Mode
• Bit Order
• CS 開始與結束
• 要送出多少個 Clock
舊文件常使用 Master/Slave,本篇以 Controller/Peripheral 為主,保留 MOSI/MISO 是因為現有晶片、模組與函式庫仍大量使用。
SPI 是同步通訊
SPI 有獨立 SCK,所以接收端不需要像 UART 一樣事先以各自時鐘估算 bit 時間。每一個 SCK 週期推進一個 bit,取樣邊緣由 CPOL 與 CPHA 決定。
SCK: _/‾\_/‾\_/‾\_/‾\_
MOSI: ==D7==D6==D5==D4==
MISO: ==Q7==Q6==Q5==Q4==
同步不代表可以忽略時序。高頻時仍要滿足資料 setup/hold、Clock-to-Output、線路延遲與 CS 時序。
SPI 為什麼可以全雙工
Controller 與 Peripheral 各有一個移位暫存器。每個 Clock 邊緣,一端送出一個 bit,同時接收另一端的一個 bit;完成 8 個 Clock 後,雙方各交換一個 byte。
Controller Shift Register ⇄ Peripheral Shift Register
MOSI ─────→
MISO ←─────
8 個 Clock 同時交換 8 個 bit
即使應用只想讀資料,Controller 仍要送出 Dummy Byte 以產生 SCK;即使只想寫資料,Controller 的接收暫存器也會收到某些值。
SPI 沒有 Start Stop ACK 與位址
SPI 不像 I²C 有標準 Start、Stop、Address 與 ACK。一般以 CS 的有效區間界定交易,Command 與 Address 由特定 Peripheral 協定自行定義。
| 功能 | I²C | SPI |
|---|---|---|
| 交易開始 | Start Condition | 通常 CS 進入有效 |
| 裝置選擇 | 7-bit/10-bit 位址 | 獨立 CS 或 Daisy Chain |
| 確認接收 | ACK/NACK | 通常沒有通用 ACK |
| 交易結束 | Stop Condition | 通常 CS 取消有效 |
CS 與 SS 是什麼
CS/SS 通常為 LOW 有效。Controller 先把目標 CS 拉 LOW,再產生 Clock 與傳送資料;交易完成後把 CS 拉 HIGH。
CS ‾‾‾\________________/‾‾‾
SCK _____/‾\_/‾\_/‾\_/‾\_____
MOSI ----- Command / Data -----
MISO ----- Response / Data ----
時序注意:CS 到第一個有效 SCK 邊緣的建立時間(tCSS)、最後 Clock 到 CS 釋放的保持時間(tCSH)以及交易間最短 CS 高電平時間,均依目標器件資料表。示意波形僅說明概念,不能當作定量時序規格。
有些裝置要求整個 Command、Address 與 Data 期間 CS 持續 LOW;有些裝置在 CS 上升時才鎖存資料。不能隨意在每個 byte 間切換 CS。
CS 不一定都是 LOW 有效
多數 SPI Peripheral 使用低有效 CS,但仍有高有效或特殊 Enable 行為。CS 極性、最短建立時間與保持時間都應查 datasheet。
Bit Order 是什麼
SPI 可以先送最高有效位 MSB,也可以先送最低有效位 LSB。多數感測器與 Flash 使用 MSB First,但不是絕對。
數值 0x96 = 1001 0110
MSB First:1 0 0 1 0 1 1 0
LSB First:0 1 1 0 1 0 0 1
若 bit order 設反,Clock 與 CS 看起來可能正常,但收到的 byte 會發生位元反轉。
資料字長不一定是 8 bit
常見 SPI Library 以 byte 操作,但硬體 Peripheral 可能使用 9、12、16、24 或其他字長。例如部分 TFT 以第 9 bit 區分 Command/Data,某些 ADC 輸出 12 或 16 bit。
控制器周邊是否支援特定字長、位元對齊方式與 Endian,都要依 MCU Reference Manual 與裝置 datasheet 設定。
CPOL 是什麼
CPOL 是 Clock Polarity,決定 SCK 的 Idle 電平。
| CPOL | SCK Idle | Leading Edge |
|---|---|---|
| 0 | LOW | Rising 上升沿 |
| 1 | HIGH | Falling 下降沿 |
CPHA 是什麼
CPHA 是 Clock Phase,決定資料在第一個有效邊緣或第二個有效邊緣取樣。為避免只背編號,應直接對照 datasheet 的 CPOL/CPHA 與波形。
| CPHA | 取樣時機 | 資料切換時機 |
|---|---|---|
| 0 | 第一個邊緣取樣 | 第二個邊緣切換 |
| 1 | 第二個邊緣取樣 | 第一個邊緣切換 |
SPI Mode 0 到 3
四種標準模式快速對照:Mode 0=CPOL 0/CPHA 0,Idle LOW、第一邊緣上升取樣;Mode 1=0/1,Idle LOW、第二邊緣下降取樣;Mode 2=1/0,Idle HIGH、第一邊緣下降取樣;Mode 3=1/1,Idle HIGH、第二邊緣上升取樣。「取樣」指常見模式下接收端擷取資料的邊緣,實際仍應核對器件 Timing Diagram。
| Mode | CPOL | CPHA | SCK Idle | 取樣邊緣 |
|---|---|---|---|---|
| 0 | 0 | 0 | LOW | Rising |
| 1 | 0 | 1 | LOW | Falling |
| 2 | 1 | 0 | HIGH | Falling |
| 3 | 1 | 1 | HIGH | Rising |
Mode 設錯時,資料可能整體偏一個 bit、只在低速偶爾正確,或完全無法解碼。
Mode 0 波形概念
Mode 0 的 SCK Idle 為 LOW,資料在 Rising Edge 取樣、Falling Edge 切換。CS 拉 LOW 後,第一個資料 bit 必須在第一個 Rising Edge 前穩定。
Mode 0
CS ‾‾\____________________/‾‾
SCK ___/‾\_/‾\_/‾\_/‾\_____
Data ==D7==D6==D5==D4========
↑ ↑ ↑ ↑
Rising Edge 取樣
Mode 3 波形概念
Mode 3 的 SCK Idle 為 HIGH,資料在 Rising Edge 取樣、Falling Edge 切換。雖然取樣邊緣同樣是 Rising,Idle 與第一個邊緣順序和 Mode 0 不同。
Mode 3
CS ‾‾\____________________/‾‾
SCK ‾‾\_/‾\_/‾\_/‾\_/‾‾‾‾
Data ==D7==D6==D5==D4========
↑ ↑ ↑
Rising Edge 取樣
第一個 bit 為什麼特別容易出錯
CPHA = 0 時,第一個資料 bit 必須在第一個取樣邊緣前準備好。若 CS 到第一個 Clock 的時間太短,或軟體控制 CS 後立刻啟動高速 SCK,可能違反 tCSS。
CPHA = 1 時第一個邊緣先用於切換資料,但仍需滿足 CS、Clock 與輸出啟用時序。
SPI Frequency 怎麼選
最高 SCK 不只由 MCU 決定,也受 Peripheral 規格、VDD、溫度、Mode、線長、負載與 Level Shifter 影響。建議先以 100kHz~1MHz 驗證功能,再逐步提高。
| 現象 | 可能原因 |
|---|---|
| 低速正常、高速錯誤 | 訊號完整性、Level Shifter、時序裕量不足 |
| 任何速度都錯 | 接線、Mode、CS、bit order 或命令錯 |
| 第一個 byte 錯 | CS 建立時間或 CPHA 問題 |
| 最後一個 byte 錯 | CS 過早釋放或尚未傳送完成 |
常見 SPI Transaction 結構
SPI 本身不規定封包內容。許多裝置會在 CS 有效期間依序接收 Command、Address、Dummy Cycles 與 Data。
CS LOW
↓
Command
↓
Address
↓
Dummy Cycles 可選
↓
Read/Write Data
↓
CS HIGH
Dummy Byte 與 Dummy Cycles
讀取時 Controller 必須送出 Clock,通常會傳 0x00 或 0xFF 作 Dummy Byte;某些 Flash 在 Command 與 Data 間要求額外 Dummy Cycles,讓內部資料準備完成。
Dummy 值、數量與是否計入位元階段由 datasheet 定義。多送或少送一個 Clock,後續資料都可能錯位。
為什麼讀取時也要傳資料
SCK 由 Controller 產生,而 SPI 是同時移位。Controller 只有在送出某些 bit 時才會產生 Clock,Peripheral 才能把回覆移到 MISO。
收到 1 byte 的條件
Controller 傳 Dummy 0x00
↓ 8 個 SCK
Peripheral 回傳 Data 0x5A
多個 SPI 裝置如何共用
共享 MISO 的前提:所有未選取的 Peripheral 都必須將 MISO 釋放為高阻抗;部分模組具有外接緩衝器、電平轉換或非三態輸出,CS 未選取時仍可能驅動 MISO,應核對電路,不能只把線並在一起。
SCK、MOSI 與 MISO 可以共用,每個 Peripheral 使用獨立 CS。Controller 一次只拉低一條 CS。
Controller SCK ─────┬── Device A
Controller MOSI ─────┼── Device B
Controller MISO ─────┴── Device C
CS_A ────────────────→ Device A
CS_B ────────────────→ Device B
CS_C ────────────────→ Device C
每增加一個裝置通常多占一個 GPIO 作 CS。若 GPIO 不足,可使用 Decoder、GPIO Expander 或某些裝置支援的 Daisy Chain。
MISO 為什麼需要三態
未被選取的 Peripheral 必須將 MISO 變成 High-Impedance,避免與被選取裝置同時驅動。若兩個輸出一個推 HIGH、另一個推 LOW,會造成 Bus Contention 與過大電流。
- 確認所有未選取裝置的 CS 維持非有效。
- MCU 開機期間以 Pull-up/Pull-down 讓 CS 有確定狀態。
- 有些模組上的 Buffer 可能在未選取時仍驅動 MISO。
- 若 MISO 無法共用,可加入三態 Buffer 或分開 SPI Bus。
多個裝置可以使用不同 Mode 嗎
可以,但 Controller 必須在每次交易前切換到該裝置需要的 Frequency、Bit Order 與 Mode,且 CS 切換期間不能產生誤時鐘。Arduino 的 SPI.beginTransaction() 就是為這種情況準備。
Daisy Chain 是什麼
某些 Shift Register、LED Driver 或 DAC 支援串接:前一顆的資料輸出接到下一顆輸入,所有裝置共用 Clock 與 Latch/CS。Controller 一次送出多顆裝置的位元串。
Controller MOSI → Device 1 → Device 2 → Device 3
Controller SCK ──────┴────────┴────────
Controller CS ──────┴────────┴────────
一般感測器與 Flash 不一定支援 Daisy Chain。只有 datasheet 明確定義串接協定時才能這樣使用。
3-wire SPI 是什麼
3-wire SPI 可能把 MOSI 與 MISO 合併為一條雙向 SDIO,再加 SCK 與 CS。讀寫切換時,Controller 與 Peripheral 必須在正確 Clock 釋放或接管資料線。
3-wire 的定義與時序沒有完全一致的單一規格,不能只把 MOSI、MISO 直接短接。
Dual SPI Quad SPI 與 QSPI
| 介面 | 資料線數 | 常見用途 |
|---|---|---|
| Single SPI | 1 條輸出 + 1 條輸入 | 感測器、一般 Peripheral |
| Dual SPI | 2 條雙向 I/O | Serial Flash 加速 |
| Quad SPI | 4 條雙向 I/O | 高吞吐量 Flash |
| Octal SPI | 8 條 I/O | 高效能外部記憶體 |
QSPI 有時指 Quad data lines,有時指 MCU 的 Quad-SPI 周邊。Command、Address、Dummy 與 Data 各階段可能使用不同線寬,必須依 Flash 規格設定。
SPI Flash 讀取範例概念
常見 Serial Flash 讀取會先送 Read Command,再送 24-bit 或更長 Address,之後送 Dummy Clock 並接收 Data。
CS LOW
03h Read Command
00h 12h 34h Address
XXh XXh ... Dummy TX,同時接收 Data
CS HIGH
這只是概念示例。Command、Address 長度、Dummy Cycles 與最高頻率會因 Flash 型號與讀取模式不同。
SPI 沒有 Flow Control
標準 SPI 沒有像 UART RTS/CTS 或 I²C Clock Stretching 的通用流量控制。Peripheral 若需要時間,通常透過 Busy Pin、Status Register、固定延遲或 CS 間隔通知。
SPI 需要共地嗎
SCK、MOSI、MISO 與 CS 都是單端邏輯訊號,需要共同參考地。兩塊板子分別供電時,通常仍要連接 GND,並確認不會形成危險地電位差。
SPI 主要用於板級短距離。跨設備、長線或高雜訊環境應評估差動 SPI Extender、隔離器、RS-485、CAN 或 Ethernet。
3.3V 與 5V SPI 能不能直接接
SPI 常用 Push-Pull,因此每個方向都要獨立檢查輸出電壓、VIH/VIL 與輸入最大額定。5V MOSI、SCK、CS 直接進入不耐 5V 的 3.3V Peripheral,可能造成損壞。
| 方向 | 要檢查 |
|---|---|
| Controller → Peripheral | SCK、MOSI、CS 的 HIGH 電壓與輸入耐壓 |
| Peripheral → Controller | MISO 的 VOH 是否達 Controller VIH |
SPI 該使用什麼 Level Shifter
SPI 多為單向 Push-Pull 訊號,可依方向選擇 Buffer 或 Level Translator。高速應選具足夠頻寬、低延遲與正確方向控制的元件。
- SCK、MOSI、CS 通常由 Controller 指向 Peripheral。
- MISO 通常由 Peripheral 指向 Controller。
- 3-wire SDIO 是雙向線,需要可切換方向的方案。
- BSS138 類 I²C 自動雙向模組通常不適合高速 Push-Pull SPI。
SPI 訊號完整性
即使 SCK 頻率只有幾 MHz,GPIO 邊緣仍可能非常快。當線路延遲相對於上升時間不可忽略時,就要把連線視為傳輸線,處理反射、串音與回流路徑。
- 保持 SCK、MOSI、MISO、CS 短且有連續地平面。
- 排線中可穿插 GND,避免多條高速線緊鄰。
- 在訊號源附近加入小型串聯電阻,可降低過衝與振鈴。
常見作法是在訊號驅動端串聯約 22Ω~100Ω 作為初始評估範圍,並依 Driver 輸出阻抗、走線特性阻抗、邊緣速度與示波器實測調整。這不是所有 SPI 線路都必須安裝的固定值;短而低速的連接未必需要終端。
- 使用示波器在接收端量測,而不是只在 Controller 腳位量。
串聯終端電阻怎麼選
常見做法是在驅動端串聯約 22Ω~100Ω,使輸出阻抗加電阻接近線路阻抗,減少第一次反射。精確值要依 Driver、PCB/線材阻抗與波形實測。
每一條單向線的驅動端不同:SCK、MOSI、CS 的電阻靠近 Controller;MISO 的電阻靠近 Peripheral。
Arduino Uno R3 硬體 SPI 預設 D13=SCK、D11=MOSI、D12=MISO、D10=SS;ICSP 排針也引出硬體 SPI。即使另選腳位作軟體 CS,ATmega328P 的硬體 SS(D10)仍應在 Controller 模式妥善設為 OUTPUT,避免遭拉 LOW 而影響主機模式。不同 Arduino 板型不可直接套用 Uno 腳位。
#include <SPI.h>
const byte CS_PIN = 10;
void setup() {
Serial.begin(115200);
pinMode(CS_PIN, OUTPUT);
digitalWrite(CS_PIN, HIGH);
SPI.begin();
}
void loop() {
SPI.beginTransaction(SPISettings(1000000, MSBFIRST, SPI_MODE0));
digitalWrite(CS_PIN, LOW);
byte response = SPI.transfer(0x9F); // 僅示範一個Byte同步傳送/接收
digitalWrite(CS_PIN, HIGH);
SPI.endTransaction();
Serial.print("RX=0x"); Serial.println(response, HEX);
delay(1000);
}
// 注意:0x9F在部分Flash是JEDEC ID指令,但只傳一個byte不會得到完整JEDEC ID。
| 參數 | 意義 | 風險 |
|---|---|---|
| tCSS | CS 有效到第一個 Clock | 太短會錯第一個 bit |
| tCSH | 最後 Clock 到 CS 取消 | 太短會截斷交易 |
| tSU | 資料在取樣前的 Setup | 不足會讀到不確定值 |
| tH | 資料在取樣後的 Hold | 不足會誤判下一個 bit |
| tCO | Clock 到輸出資料有效 | 限制 MISO 最高速度 |
Arduino Uno 的 SPI 腳位
| Arduino Uno | SPI 訊號 | 說明 |
|---|---|---|
| D13 | SCK | Controller 時鐘輸出 |
| D11 | MOSI | Controller 資料輸出 |
| D12 | MISO | Controller 資料輸入 |
| D10 | SS/常用 CS | 可作 CS;Controller 模式需注意 |
| ICSP Header | SCK/MOSI/MISO | Shield 常從此接取硬體 SPI |
Uno 是 5V 邏輯。連接 microSD、TFT 或 3.3V 感測器前,要確認模組是否已有電平轉換與穩壓。
Arduino SPI 基本傳送
#include <SPI.h>
const byte CS_PIN = 10;
void setup()
{
pinMode(CS_PIN, OUTPUT);
digitalWrite(CS_PIN, HIGH);
SPI.begin();
}
void loop()
{
SPI.beginTransaction(SPISettings(1000000, MSBFIRST, SPI_MODE0));
digitalWrite(CS_PIN, LOW);
byte received = SPI.transfer(0x9F);
digitalWrite(CS_PIN, HIGH);
SPI.endTransaction();
delay(1000);
}
SPI.transfer() 在送出 byte 的同時回傳 MISO 收到的 byte。0x9F 是否為有效 Command 取決於 Peripheral,本例只示範交易結構。
Arduino 為什麼要使用 beginTransaction
SPI.beginTransaction() 套用該裝置需要的 Clock、Bit Order 與 Mode,並協助函式庫管理共享 SPI Bus。每個裝置可有自己的 SPISettings。
SPISettings sensorSettings(1000000, MSBFIRST, SPI_MODE3);
SPISettings displaySettings(8000000, MSBFIRST, SPI_MODE0);
正確順序是 beginTransaction、CS LOW、傳輸、CS HIGH、endTransaction。不要在 CS 仍為 LOW 時切換 Mode。
// 以下僅為 readRegister 範例的延伸片段,假設前文已定義 CS_PIN、startRegister、length、buffer,並初始化 SPI。
SPI.beginTransaction(SPISettings(1000000, MSBFIRST, SPI_MODE0));
digitalWrite(CS_PIN, LOW);
SPI.transfer(startRegister | 0x80); // 假設最高位為Read;依datasheet調整
for (size_t i = 0; i < length; ++i) {
buffer[i] = SPI.transfer(0x00);
}
digitalWrite(CS_PIN, HIGH);
SPI.endTransaction();
// 多位址自動遞增與CS保持條件由目標晶片規格決定。
以下是假設性裝置:Read bit 為 Register Address 的 bit7,Mode 0,最高 1MHz。實際定義必須換成目標 datasheet。
byte readRegister(byte reg)
{
SPI.beginTransaction(SPISettings(1000000, MSBFIRST, SPI_MODE0));
digitalWrite(CS_PIN, LOW);
SPI.transfer(reg | 0x80); // 假設 bit7 = Read
byte value = SPI.transfer(0x00);
digitalWrite(CS_PIN, HIGH);
SPI.endTransaction();
return value;
}
在原版 ESP32(例如常見 ESP32-WROOM 開發板)使用 Arduino 核心時,VSPI 常見腳位為 SCK GPIO18、MISO GPIO19、MOSI GPIO23、CS GPIO5;此配置不是 ESP32-S2/S3/C3 等各系列的通用腳位。必須先核對實際晶片、板子標示與核心版本,並避開 Flash/PSRAM 與開機限制腳位。
#include <SPI.h>
// 範例僅針對支援VSPI名稱的經典ESP32 Arduino核心配置
SPIClass bus(VSPI);
const int CS_PIN = 5;
void setup() {
pinMode(CS_PIN, OUTPUT);
digitalWrite(CS_PIN, HIGH);
bus.begin(18, 19, 23, CS_PIN); // SCK, MISO, MOSI, SS
}
void loop() {
bus.beginTransaction(SPISettings(1000000, MSBFIRST, SPI_MODE0));
digitalWrite(CS_PIN, LOW);
(void)bus.transfer(0x00); // 無設備時只作範例
digitalWrite(CS_PIN, HIGH);
bus.endTransaction();
delay(1000);
}
某些裝置還要設定 Auto-Increment bit;有些則會自動遞增。CS 是否能在 byte 間保持 LOW 也由裝置規格決定。
ESP32 的 SPI
ESP32 系列通常提供多組 SPI Host。Arduino 框架常見預設 VSPI 腳位為 SCK GPIO18、MISO GPIO19、MOSI GPIO23、CS GPIO5,但不同晶片與開發板可能不同,且腳位可重新映射。
#include <SPI.h>
SPIClass bus(VSPI);
void setup()
{
bus.begin(18, 19, 23, 5); // SCK, MISO, MOSI, SS
}
ESP32 是 3.3V 邏輯,不可直接接 5V MISO 或被 5V 邏輯驅動。板載 Flash 使用的 SPI 腳位也不可任意占用。
Raspberry Pi 的 SPI
| 功能 | BCM GPIO | 40-pin 實體腳位 |
|---|---|---|
| MOSI | GPIO10 | Pin 19 |
| MISO | GPIO9 | Pin 21 |
| SCLK | GPIO11 | Pin 23 |
| CE0 | GPIO8 | Pin 24 |
| CE1 | GPIO7 | Pin 26 |
| GND | — | 例如 Pin 6 |
Raspberry Pi GPIO 是 3.3V 邏輯。啟用 SPI 後,Linux 常提供 /dev/spidev0.0 與 /dev/spidev0.1;實際名稱取決於 Device Tree 與系統設定。
STM32 的 SPI
STM32 SPI 設定通常包含 Mode、Baud Prescaler、Data Size、First Bit、NSS 管理、CRC、Full/Half Duplex、Interrupt 或 DMA,以及 Alternate Function 腳位。
硬體 NSS 不一定符合所有 Peripheral 的 CS 時序。複雜 Command 或多裝置系統常用 GPIO 手動控制 CS,再由硬體 SPI 傳資料。
microSD 卡與 SPI
microSD 卡內部是 3.3V 裝置。許多 Arduino 模組附穩壓與電平轉換,但裸卡座或簡化模組可能沒有。初始化通常先使用較低 SCK,再切換到較高速。
- 確認模組供電輸入與卡片實際 I/O 電壓。
- 確認 MISO Level 是否能被 Controller 正確判斷。
- CS 在開機期間保持 HIGH,避免干擾其他裝置。
- 多裝置共享時,確認 SD Library 正確釋放 MISO。
TFT 顯示器的 SPI
SPI TFT 常有 SCK、MOSI、CS、DC、RESET,部分讀取功能才需要 MISO。DC 用來區分 Command 與 Display Data,不是 SPI 標準線。
Controller ── SCK/MOSI ── TFT
GPIO ───────── CS
GPIO ───────── DC
GPIO ───────── RESET
可選 MISO ←── TFT
顯示更新量大,速度受 SCK、函式庫、像素格式與繪圖方法影響。先確認低速與 Mode 正確,再提高 Clock。
如何用邏輯分析儀檢查 SPI
連接 SCK、MOSI、MISO、CS 與 GND,先設定 Mode、Bit Order、Bits per Word,再選擇正確 CS 極性。
- 檢查順序
- CS 是否選到正確裝置
- SCK Idle 是否符合 CPOL
- 資料在第幾個邊緣取樣
- MSB/LSB First
- Command、Address、Dummy、Data 邊界
- CS 是否過早上升
如果 Decoder 全是錯誤,先用示波器或原始數位波形確認 Mode。只調整解碼器而不檢查實際 MCU 設定,容易得到假象。
如何用示波器檢查 SPI
示波器適合檢查 SCK 過衝、振鈴、上升下降時間、MISO tCO、資料 setup/hold 與 CS 時序。探棒應靠近接收端並使用短接地。
建議同時觀察
CH1:SCK
CH2:MOSI 或 MISO
CH3:CS
觸發:CS Falling Edge
SPI 沒有資料回來的排查順序
- 確認 GND、VCC 與每條線方向。
- 確認 CS 腳位、有效極性與 Idle 狀態。
- 先把 SCK 降到 100kHz~1MHz。
- 依 datasheet 確認 Mode、Bit Order 與 Word Length。
- 確認 Command、Register Address、Read bit 與 Dummy Cycles。
- 確認 CS 在整個 Frame 期間保持正確狀態。
- 確認 Peripheral 是否需要 Reset、Enable、Busy 或啟動延遲。
- 確認 3.3V/5V 電壓與 Level Shifter 方向。
- 若多裝置共用,逐一拔除並檢查 MISO 是否三態。
- 用邏輯分析儀比較實際 byte 與 datasheet 時序。
- 用示波器在接收端量過衝、振鈴與 setup/hold。
- 最後檢查函式庫版本、CS 控制與 DMA/Buffer。
SPI 常見的 12 個錯誤
1 MOSI 和 MISO 接反
應依 Controller 與 Peripheral 的方向配對。
2 忘記共地
單端邏輯需要共同電壓參考。
3 CS 一直為 HIGH
Peripheral 從未被選取,不會回應。
4 CS 在 byte 間錯誤切換
會讓 Peripheral 重置 Frame 狀態。
5 SPI Mode 設錯
資料會偏移、亂碼或完全無法解碼。
6 MSB First 與 LSB First 設反
每個 byte 的 bit 順序顛倒。
7 只看 SCK 頻率不看時序
tCSS、tCO、setup/hold 仍可能不符合。
8 讀取時沒有送 Dummy Clock
Peripheral 沒有 Clock 可移出資料。
9 多個 Peripheral 同時驅動 MISO
會造成 Bus Contention 與錯碼。
10 5V 訊號直接接 3.3V 裝置
可能超過輸入最大額定值。
11 用 I²C 雙向模組轉換高速 SPI
電路不適合 Push-Pull 與高速邊緣。
#include <SPI.h>
const byte CS_PIN = 10;
const byte testData[] = {0x00, 0x55, 0xAA, 0xFF};
void setup() {
Serial.begin(115200);
pinMode(CS_PIN, OUTPUT); digitalWrite(CS_PIN, HIGH);
SPI.begin();
// 斷電後短接Uno D11(MOSI)與D12(MISO),再上電測試。
}
void loop() {
SPI.beginTransaction(SPISettings(100000, MSBFIRST, SPI_MODE0));
bool pass = true;
for (byte i = 0; i < sizeof(testData); ++i) {
byte rx = SPI.transfer(testData[i]);
Serial.print("TX=0x"); Serial.print(testData[i], HEX);
Serial.print(" RX=0x"); Serial.println(rx, HEX);
if (rx != testData[i]) pass = false;
}
SPI.endTransaction();
Serial.println(pass ? "PASS" : "FAIL");
delay(2000);
}
每顆 Peripheral 的協定都要查 datasheet。
Loopback 測試前,務必先斷開所有其他 SPI 裝置;不得把 MISO 與外部器件輸出同時接在被 MOSI 驅動的線上,以免輸出對衝。結果 PASS 僅代表測試配置下資料回送一致,不等於高速時序及實際周邊協定已驗證。
實驗一 Arduino SPI Loopback
在 Arduino Uno 斷電時短接 MOSI D11 與 MISO D12,程式送出多個測試 byte,確認 SPI.transfer() 收到相同資料。
byte testData[] = {0x00, 0x55, 0xAA, 0xFF};
for (byte i = 0; i < 4; i++) {
byte rx = SPI.transfer(testData[i]);
Serial.println(rx, HEX);
}
74HC595 選做實驗前先確認:其 DS 與 SHCP 由 MCU 對應的 MOSI/SCK 驅動;STCP 使用獨立 GPIO 產生鎖存脈波;/OE 與 /MR 必須固定在合法狀態。每顆 LED 都要配置限流,且須遵守 74HC595 單腳與整體輸出電流額定。74HC595 並不是具 MISO/CS 的一般 SPI Peripheral。
Loopback 只能驗證 Controller SPI 路徑與接線,不能證明 Peripheral 的 Mode、CS 與 Command 正確。
// Arduino Uno + 3.3V SPI Flash:接線需先完成5V→3.3V電平轉換!
// 假設setup中已 SPI.begin()、CS_PIN=OUTPUT且預設HIGH
SPI.beginTransaction(SPISettings(1000000, MSBFIRST, SPI_MODE0));
digitalWrite(CS_PIN, LOW);
SPI.transfer(0x9F);
byte manufacturer = SPI.transfer(0x00);
byte memoryType = SPI.transfer(0x00);
byte capacity = SPI.transfer(0x00);
digitalWrite(CS_PIN, HIGH);
SPI.endTransaction();
// 請在主程式列印以上3個byte並對照該Flash datasheet驗證。
// 此為交易片段;不是完整可單獨編譯的Sketch。
74HC595 以資料、Clock 與 Latch 接收串列位元,概念接近只寫 SPI。先用低速 Mode 0 傳送 0x01、0x02、0x04,觀察 LED 逐位移動。
digitalWrite(LATCH_PIN, LOW);
SPI.transfer(pattern);
digitalWrite(LATCH_PIN, HIGH);
確認 74HC595 的電壓、輸出限流與 LED 電阻。Latch 不是標準 SPI CS,但可用類似方式界定資料更新。
實驗三 讀取 SPI Flash JEDEC ID
若使用支援 0x9F Read JEDEC ID 的 SPI Flash,可送出 Command 後連續讀取 Manufacturer、Memory Type 與 Capacity。
Mode 測試不能假設所有模式錯誤時必然讀不到資料;在低速、資料圖樣與特定電路下,錯誤模式可能偶爾讀出貌似正確的數值。以多次一致性、時序波形及 datasheet 要求的模式作驗收。4MHz 僅在所用模組和接線允許時測試。
digitalWrite(CS_PIN, LOW);
SPI.transfer(0x9F);
byte manufacturer = SPI.transfer(0x00);
byte memoryType = SPI.transfer(0x00);
byte capacity = SPI.transfer(0x00);
digitalWrite(CS_PIN, HIGH);
先查 Flash datasheet 確認電壓、Mode、Command 與最大初始時鐘。不要把示例直接套到型號不明的晶片。
實驗四 比較 Mode 與頻率
選用已知 Mode 的感測器,固定讀取同一個 WHO_AM_I Register,分別測試 Mode 0~3 與不同 SCK。
- 記錄只有正確 Mode 能穩定讀到的識別值。
- 從 100kHz、1MHz、4MHz 逐步提高。
- 邏輯分析儀確認取樣邊緣與 bit order。
- 示波器比較高頻時 SCK 過衝與 MISO setup margin。
SPI 學習順序建議
| 階段 | 學習內容 | 完成標準 |
|---|---|---|
| 1 | SCK、MOSI、MISO、CS | 能完成 Loopback |
| 2 | Mode 與 Bit Order | 能手動解碼一個 byte |
| 3 | Command 與 Register | 能讀取裝置識別值 |
| 4 | 多裝置與 SPISettings | 每顆裝置可用不同 Mode |
| 5 | 時序與訊號完整性 | 能量測 tCSS、tCO 與振鈴 |
| 6 | DMA、QSPI 與效能 | 能處理大量資料傳輸 |
SPI FAQ 常見問題
SPI 一定需要四條訊號線嗎
不一定。只寫裝置可省 MISO;3-wire 會合併資料線;多裝置還需要更多 CS。
SPI 有固定最高速度嗎
沒有,取決於 Controller、Peripheral、電壓、線路與時序。
SPI 可以一對多嗎
可以,共用 SCK/MOSI/MISO並為每顆裝置配置 CS,或使用裝置支援的 Daisy Chain。
為什麼讀到的資料全是 0xFF
可能 MISO 浮空、CS 未選取、裝置未上電、Mode 錯或 Dummy 階段錯。
為什麼讀到的資料全是 0x00
可能 MISO 被拉低、裝置重置、線路短路或命令不正確。
MOSI 和 MISO 要交叉嗎
Controller MOSI 接 Peripheral 的資料輸入;Controller MISO 接 Peripheral 的資料輸出,依方向名稱對接。
SPI 需要上拉電阻嗎
資料與 Clock 通常是 Push-Pull,不靠上拉形成 HIGH;CS 可加弱上拉確保開機未選取。
多個裝置可以不同速度嗎
可以,每次交易前設定該裝置的 Clock、Mode 與 Bit Order。
SPI 可以長距離傳輸嗎
Rev1.0 技術審查聲明:文中的 SPI Mode、電壓門檻、CS 時序、最高頻率、Command、Arduino/ESP32腳位均須以特定晶片型號、開發板及函式庫版本的 Datasheet/官方文件為準;範例尚未經實體硬體驗證。
We-Blog 相關技術文章(待正式網址):TTL/CMOS 邏輯位準(接線耐壓);GPIO(CS 與特殊腳位);I²C(協定比較);UART(同步與非同步);ADC/DAC(SPI周邊應用);Ethernet(SPI Ethernet Controller)。延伸實驗:Arduino SPI SD卡、TFT顯示、LoRa模組。此處為編輯導覽標題,發布時請填入實際有效的站內網址。
原生 SPI 主要適合板級短距離;長距離應使用 Extender、差動方案或其他介面。
何時選 I²C 而不是 SPI
裝置多、GPIO 少、資料量較低時常選 I²C;高速或持續資料流常選 SPI。
結論
SPI 是由 Controller 產生 SCK、以 CS 選擇 Peripheral,並透過 MOSI 與 MISO 同步交換資料的串列介面。它速度高、控制直接,但沒有通用位址、ACK 或封包格式,因此每顆裝置的 Mode、Command 與時序都必須依 datasheet 設定。
CS 有效
↓
設定 Clock、Mode、Bit Order
↓
Command
↓
Address/Dummy 可選
↓
Write/Read Data
↓
等待最後一個 Clock 完成
↓
CS 取消有效
實際接線前,要確認電壓、MOSI/MISO 方向、CS 極性與 SPI Mode;遇到問題時,先降速,再依序檢查 CS、SCK Idle、取樣邊緣、bit order、Command、Dummy 與 MISO 三態。最後用示波器確認 tCSS、tCO、setup/hold 與訊號完整性。