Связь · разбор
SPI в Arduino: MOSI, MISO, SCK и CS — подключение, режимы и ошибки
SPI — самая быстрая из трёх шин Arduino: через неё работают карты памяти, RFID-модули, цветные дисплеи и сдвиговые регистры. Проводов больше, чем у I²C, зато нет адресов: плата сама выбирает, с кем говорить, отдельным проводом. Ниже — где эти провода на вашей плате и почему старый код с SPI не собирается на новых платах.
Четыре провода и один ведущий
На шине SPI всегда есть ведущий — плата — и одно или несколько ведомых устройств. Проводов четыре:
- SCK — такт. Его задаёт только плата, и обмен идёт ровно столько тактов, сколько она дала.
- MOSI — данные от платы к модулю (Master Out, Slave In). На модулях встречается подпись SDI или DIN, в новых описаниях Arduino — COPI.
- MISO — данные от модуля к плате (Master In, Slave Out), на модулях — SDO или DOUT, в новых описаниях Arduino — CIPO.
- CS, он же SS, — выбор устройства. Модуль слушает шину, только пока его CS прижат к земле. У RFID-модуля RC522 этот вывод подписан SDA, и это не I²C.
Обмен всегда идёт в обе стороны сразу: за восемь тактов плата отдаёт байт и в те же такты получает ответный. Поэтому SPI.transfer() и отправляет байт, и возвращает пришедший.
Скорость задаёт ведущий. На Uno предел — 8 МГц, половина частоты кварца; если ничего не настраивать, SPI.begin() включает 4 МГц. Модули обычно выдерживают больше, а мешают длинные провода и макетка. Если обмен сбоит, первым делом снизьте частоту, например до 1 МГц.
Где SCK, MOSI и MISO на вашей плате
| Плата | SCK | MOSI | MISO | SS по умолчанию |
|---|---|---|---|---|
| Uno, Nano | 13 | 11 | 12 | 10 |
| Mega 2560 | 52 | 51 | 50 | 53 |
| Leonardo | только ICSP, ножка 3 | только ICSP, ножка 4 | только ICSP, ножка 1 | не выведен (светодиод RX) |
| Pro Micro | 15 | 16 | 14 | не выведен (светодиод RX) |
| Nano Every | 13 | 11 | 12 | 8 |
| UNO R4, Nano R4 | 13 | 11 | 12 | 10 |
| ESP32 DevKit | 18 | 23 | 19 | 5 |
| ESP32-C3 Super Mini | 4 | 6 | 5 | 7 |
| ESP32-S3 DevKitC | 12 | 11 | 13 | 10 |
| ESP8266 NodeMCU | D5 (14) | D7 (13) | D6 (12) | D8 (15) |
| Raspberry Pi Pico | GP18 | GP19 | GP16 | GP17 |
| STM32 Blue Pill | PA5 | PA7 | PA6 | PA4 |
На Uno, Nano и Mega те же три сигнала выведены ещё и на шестиконтактный разъём ICSP: ножка 1 — MISO, 3 — SCK, 4 — MOSI. Ножку 1 отмечают точкой или скосом на плате. Ethernet-шилд и другие аккуратно сделанные шилды берут SPI с ICSP, поэтому одинаково работают на Uno и на Mega. Но многие недорогие шилды с картой памяти или экраном берут шину с выводов 11–13. На Mega там SPI нет, и такой шилд на ней молчит.
У Leonardo SPI есть только на ICSP: модуль, подключённый к 11–13-му выводам по схеме для Uno, будет молчать. У Pro Micro разъёма ICSP нет вовсе, шина выведена на боковые выводы: 15 — SCK, 16 — MOSI, 14 — MISO. У Micro она есть и на ICSP, и на ножках с подписями MISO, MOSI и SCK. Распиновка всех трёх плат — на странице про Leonardo и Pro Micro.
CS — любой свободный вывод, «SS по умолчанию» из таблицы — лишь привычный выбор. Но на Uno, Nano и Mega у аппаратного SS есть особенность: он должен оставаться выходом. SPI.begin() сам делает его выходом, а комментарий в коде библиотеки SPI предупреждает: если этот вывод станет входом и окажется в нуле, шина перейдёт в режим ведомого и перестанет работать. Поэтому кнопку на 10-й вывод Uno при занятой шине SPI лучше не вешать.
У ESP8266 своя ловушка: вывод D8 (GPIO15) при включении должен быть в нуле, иначе плата не загрузится. Модуль, который подтягивает свой CS к питанию, на D8 может помешать старту — берите для CS другой вывод.
Режимы 0–3, частота и SPISettings
Режим определяет, какой уровень у такта в покое и по какому фронту читается бит. Перепутанный режим — частая причина, когда модуль отвечает мусором при верных проводах. Нужный режим пишут в даташите модуля, иногда в виде CPOL и CPHA.
| Режим | CPOL | CPHA | Такт в покое | Бит читают | Кто так работает |
|---|---|---|---|---|---|
SPI_MODE0 | 0 | 0 | 0 | по фронту вверх | почти все модули: карты microSD, RC522, 74HC595, MAX7219 |
SPI_MODE1 | 0 | 1 | 0 | по спаду | встречается редко |
SPI_MODE2 | 1 | 0 | 1 | по спаду | встречается редко |
SPI_MODE3 | 1 | 1 | 1 | по фронту вверх | например, акселерометр ADXL345 |
Режим, частоту и порядок бит передают перед каждым обменом: SPI.beginTransaction(SPISettings(4000000, MSBFIRST, SPI_MODE0)), а после — SPI.endTransaction(). На Uno частота здесь — потолок: плата берёт ближайшую, которая его не превышает, — 8, 4, 2 МГц и ниже. Зачем каждый раз: на одной шине могут сидеть устройства с разными режимами и скоростями, и каждое получает свои настройки, не мешая соседу.
Старые скетчи и библиотеки вместо этого вызывали SPI.setClockDivider(), SPI.setDataMode() и SPI.setBitOrder(). На Uno, Mega, Nano Every, SAMD и ESP32 такой код ещё собирается. На UNO R4 этих функций нет совсем. На Raspberry Pi Pico функции остались, но констант от SPI_CLOCK_DIV2 до SPI_CLOCK_DIV128 нет, и строка setClockDivider(SPI_CLOCK_DIV4) не собирается. Строки ошибок — в таблице в конце страницы.
Проверка шины одним проводком
Прежде чем искать беду в модуле, проверьте саму плату. Соедините перемычкой MOSI и MISO — на Uno это выводы 11 и 12, на ESP32 DevKit — 23 и 19, на Pico — GP19 и GP16 — и залейте скетч ниже. Каждый отправленный байт должен вернуться обратно: что ушло по MOSI, то пришло по MISO.
// Проверка шины SPI без всяких модулей: перемычка между MOSI и MISO.
// На Uno и Nano это выводы 11 и 12. Что ушло — то и должно вернуться.
#include <SPI.h>
void setup() {
Serial.begin(9600);
SPI.begin();
}
void loop() {
byte sent = random(256);
SPI.beginTransaction(SPISettings(1000000, MSBFIRST, SPI_MODE0));
byte received = SPI.transfer(sent);
SPI.endTransaction();
Serial.print("Отправлено 0x");
Serial.print(sent, HEX);
Serial.print(", получено 0x");
Serial.print(received, HEX);
Serial.println(sent == received ? " — шина в порядке" : " — не совпало");
delay(1000);
}
С перемычкой в мониторе порта раз в секунду идёт «шина в порядке». Без неё почти всегда «не совпало»: линия MISO висит в воздухе, и приходит что попало. Если с перемычкой не совпадает, проблема не в модуле: выбрана не та плата или перепутаны выводы.
Сдвиговый регистр 74HC595: восемь выходов по SPI
74HC595 — самый простой способ увидеть SPI в работе. Регистр ничего не отвечает, поэтому MISO не нужен: такт — на SH_CP (ножка 11), данные — на DS (ножка 14), а защёлка ST_CP (ножка 12) — на 10-й вывод, он здесь вместо CS. Байт задвигается во внутренний регистр, выходы при этом не меняются; фронт вверх на защёлке переносит его на Q0–Q7 разом, без мерцания промежуточных состояний.
// Бегущий огонь на восьми светодиодах через сдвиговый регистр 74HC595.
// Uno: SCK (13) → SH_CP, ножка 11; MOSI (11) → DS, ножка 14;
// вывод 10 → ST_CP, ножка 12. OE (13) — на GND, MR (10) — на 5 В.
// Светодиоды — на Q0…Q7 (ножки 15 и 1–7), каждый через резистор 470 Ом.
#include <SPI.h>
const byte LATCH = 10;
void show(byte pattern) {
SPI.beginTransaction(SPISettings(4000000, MSBFIRST, SPI_MODE0));
digitalWrite(LATCH, LOW);
SPI.transfer(pattern);
digitalWrite(LATCH, HIGH); // фронт на ST_CP переносит байт на выходы
SPI.endTransaction();
}
void setup() {
pinMode(LATCH, OUTPUT);
SPI.begin();
}
void loop() {
for (byte i = 0; i < 8; i++) {
show(1 << i);
delay(100);
}
}
Скетч занимает 1 044 байта флеша и 10 байт ОЗУ — сама шина SPI почти ничего не стоит. Выводы OE и MR нельзя оставлять в воздухе: OE — на землю, иначе выходы могут отключиться, MR — на 5 В, иначе регистр может сбрасываться. С резисторами 470 Ом выходит около 6 мА на светодиод, и все восемь вместе укладываются в предел микросхемы — 70 мА на корпус. Между 16-й ножкой и землёй, поближе к корпусу, поставьте конденсатор 0,1 мкФ. Регистров нужно больше — соедините их цепочкой: Q7′ (ножка 9) первого — на DS следующего, и каждый лишний SPI.transfer() двигает ещё восемь выходов.
Несколько устройств на одной шине
Правило одно: SCK, MOSI и MISO общие, CS у каждого свой. На Ethernet-шилде так и сделано: сетевой чип выбирается 10-м выводом, карта памяти — 4-м.
- Все CS — в единицу до первого обмена. Пока библиотека одного модуля разговаривает со своим устройством, другой, ещё не настроенный, тоже слушает шину, если его CS болтается в воздухе. Поднимите все CS выходами в HIGH в самом начале
setup(). - MISO должен освобождаться. Невыбранное устройство обязано отпустить линию MISO. У части недорогих модулей карт памяти её держит буфер уровней, и тогда соседу ответить нечем: по отдельности всё работает, вместе — нет. Проверяется просто: снимите модуль карты и посмотрите, ожил ли второй.
- Разные режимы и скорости — не беда, если каждая библиотека обращается к шине через
beginTransaction(). Старые библиотеки без него могут оставить шину в чужом режиме. - Напряжение. Карты памяти и RC522 работают от 3,3 В. Модули карт для Arduino несут свой стабилизатор и преобразователь уровней и питаются от 5 В. Как подключать RC522 к Uno, разобрано на странице про RFID.
Карта microSD: журнал на SPI
Самое частое SPI-устройство в проектах — карта памяти. Библиотека SD уже входит и в Trema IDE, и в Arduino IDE. Скетч раз в 10 секунд дописывает в файл время и показание входа A0; модуль карты подключён к общей шине, CS — на 4-й вывод.
// Журнал на карте microSD: раз в 10 секунд дописываем строку в log.txt.
// Модуль карты: CS — вывод 4, SCK, MOSI и MISO — на 13, 11 и 12 (Uno, Nano).
// Карта — до 32 ГБ, файловая система FAT32 или FAT16.
#include <SPI.h>
#include <SD.h>
const byte SD_CS = 4;
bool cardOk = false;
void setup() {
Serial.begin(9600);
cardOk = SD.begin(SD_CS);
Serial.println(cardOk ? "Карта на месте" : "Карта не отвечает: проверьте CS, провода и формат");
}
void loop() {
if (cardOk) {
File file = SD.open("/log.txt", FILE_WRITE); // на Uno FILE_WRITE дописывает в конец файла
if (file) {
file.print(millis() / 1000);
file.print(" с: A0 = ");
file.println(analogRead(A0));
file.close(); // без close() строка остаётся в буфере и пропадает
}
}
delay(10000);
}
- Карта. До 32 ГБ, в FAT32 или FAT16. Карты больше 32 ГБ продаются в exFAT, а его библиотека SD не читает. Имена файлов — только короткие: до восьми знаков и три после точки.
- Память. Скетч занимает 11 326 байт флеша и 966 байт ОЗУ — почти половину Uno. Большую часть забирает буфер блока карты в 512 байт.
- close() обязателен. Пока файл не закрыт, строка лежит в буфере, и при отключении питания пропадёт.
- ESP32. У него своя библиотека SD, и отличий два.
FILE_WRITEтам стирает файл при каждом открытии, для дозаписи нуженFILE_APPEND. И имя файла пишут от корня, со слешем:SD.open("/log.txt", FILE_APPEND). Без слеша файл не откроется, а скетч об этом промолчит. В скетче выше слеш уже стоит: библиотека SD для Uno его тоже понимает.
Карту сначала опрашивают на 250 кГц — стандарт SD при запуске разрешает не больше 400 — и только потом разгоняют шину. Логгер в формате CSV и разбор ошибок карты — в статье про SD-карту.
Ошибки и что за ними стоит
| Сообщение или симптом | Что случилось |
|---|---|
| 'SPI' was not declared in this scope | В скетче вызывается SPI, а строки #include <SPI.h> нет — допишите её в начало скетча. Подсказку компилятора «suggested alternative: 'SPIE'» (на UNO R4 — 'PI') не слушайте: это совсем другие имена. |
| 'class arduino::ArduinoSPI' has no member named 'setClockDivider' | UNO R4 или Nano R4: старый код настраивает шину через setClockDivider(), setDataMode() или setBitOrder(), а их тут нет — та же строка бывает и про 'setDataMode', и про 'setBitOrder'. Перепишите на SPI.beginTransaction(SPISettings(…)) или обновите библиотеку модуля. Следом обычно идёт ещё и строка про SPI_CLOCK_DIV4. |
| 'SPI_CLOCK_DIV4' was not declared in this scope | Raspberry Pi Pico, а на UNO R4 — второй строкой после ошибки про setClockDivider: констант делителя частоты в пакете нет. Подсказка компилятора «CGC_SYS_CLOCK_DIV_4» не поможет. Лечится так же — через SPISettings. |
| initialization failed. Things to check: | Пример библиотеки SD не дождался ответа карты. Вывод CS в скетче не тот, к которому подключён модуль; карта больше 32 ГБ или в exFAT; перепутаны MOSI и MISO; модуль без своего стабилизатора питается от 5 В. |
| Каждый модуль работает отдельно, а вместе — нет | Сообщения нет, есть симптом. Чаще всего второе устройство не отпускает MISO или его CS не поднят в единицу до начала обмена с первым. Проверьте, снимая модули по одному. |
| Модуль отвечает одними 0x00 или 0xFF | Модуль не отвечает: он не выбран, не запитан или провод не тот. Сначала проверьте саму шину перемычкой — как, написано выше. |
Что купить
Для журнала из этой статьи подойдёт любой из двух модулей карт: оба рассчитаны на питание 5 В и работают с картами microSDHC до 32 ГБ.
SPI адаптер карт microSD
Выводы подписаны прямо на плате: CS, SCK, MOSI, MISO. Питание 4,5–5,5 В, понимает логику и 3,3, и 5 В.
Адаптер карт microSD, Trema-модуль
Адаптер в формате Trema-модулей — удобно, если проект собирается на Trema Shield. Питание 5 В.
SPI в Trema IDE
Библиотеки SPI в каталоге нет и быть не должно: она приходит вместе с пакетом платы. Если сборка пишет, что SPI.h не найден, Trema IDE так и объяснит — файл входит в пакет платы, значит, пакет установлен не полностью, — и не станет предлагать чужую библиотеку с тем же именем.
Библиотека SD лежит в установщике и работает без интернета. Библиотеки модулей — RC522, дисплеев, радиомодулей — ставятся из каталога с российского зеркала, вместе со всем, от чего они зависят.
Вопросы и ответы
Коротко о главном
Если чего-то не хватает — напишите нам через форму поддержки, мы дополняем страницы по реальным вопросам.
Что такое MOSI, MISO, SCK и CS?
Четыре провода шины SPI. SCK — такт, его задаёт плата. MOSI — данные от платы к модулю, MISO — от модуля к плате. CS, он же SS, — выбор устройства: модуль слушает шину, только пока его CS прижат к земле. На модулях MOSI бывает подписан SDI или DIN, MISO — SDO или DOUT, а у RC522 вывод выбора называется SDA.
Какие выводы SPI у Arduino Uno и Nano?
SCK — 13, MOSI — 11, MISO — 12. CS можно взять любой свободный вывод, обычно 10. Те же сигналы выведены на шестиконтактный разъём ICSP: ножка 1 — MISO, 3 — SCK, 4 — MOSI. У Mega шина на выводах 52, 51 и 50, у Leonardo — только на разъёме ICSP, у Pro Micro — на выводах 15, 16 и 14.
Можно ли подключить к одной шине SPI несколько устройств?
Да: SCK, MOSI и MISO общие, а у каждого устройства свой вывод CS. Все CS поднимите в единицу в начале setup(), до первого обмена. Если по отдельности модули работают, а вместе нет, один из них не отпускает линию MISO — так ведут себя некоторые недорогие модули карт памяти.
Почему SPI-модуль не работает на Leonardo или Pro Micro?
На выводах 11, 12 и 13 у этих плат шины SPI нет. У Leonardo MOSI, MISO и SCK есть только на разъёме ICSP: ножка 1 — MISO, 3 — SCK, 4 — MOSI. У Pro Micro разъёма ICSP нет, шина на боковых выводах: 15 — SCK, 16 — MOSI, 14 — MISO. Вывод CS — любой свободный.
Чем SPI отличается от I2C?
SPI быстрее — на Uno до 8 МГц против 100 или 400 кГц у I2C — и проще устроен: адресов нет, устройство выбирают отдельным проводом CS. Плата за это — провода: три общих плюс по одному на каждое устройство, тогда как I2C обходится двумя на всех.
Почему SD-карта не определяется и пишет initialization failed?
Карта не ответила на запуск. Проверьте, что вывод CS в скетче совпадает с подключённым, что MOSI и MISO не перепутаны, что карта не больше 32 ГБ и отформатирована в FAT32 или FAT16: exFAT библиотека SD не читает. Модулю со своим стабилизатором нужно 5 В, а голой карте и модулю без стабилизатора — только 3,3 В.
Почему старый скетч с SPI не собирается на UNO R4 или Raspberry Pi Pico?
В нём частота задаётся через SPI.setClockDivider() и константы вроде SPI_CLOCK_DIV4. На UNO R4 такой функции нет, на Pico нет этих констант. Перепишите настройку на SPI.beginTransaction(SPISettings(4000000, MSBFIRST, SPI_MODE0)) или обновите библиотеку модуля.
Какой режим SPI выбрать?
Тот, что указан в даташите модуля, иногда в виде CPOL и CPHA. Почти все модули для Arduino — карты памяти, RC522, 74HC595, MAX7219 — работают в режиме 0. Режим 3 встречается, например, у акселерометра ADXL345.
Дальше по теме
Две другие шины — UART и I²C. Модуль на SPI с разбором до байта — RFID RC522. Сколько памяти съедают библиотеки — Память Arduino.
