Связь · разбор

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() и отправляет байт, и возвращает пришедший.

Режим 0: байт туда и байт обратно за одни и те же восемь тактовздесь читают битCSSCKMOSI0xA5MISO0x3C1010010100111100Пунктир — значение на линии не важно; пока CS в единице, модуль молчит и отпускает MISO
Плата опускает CS, выставляет старший бит на MOSI и даёт восемь тактов на SCK. По каждому фронту вверх обе стороны читают бит, по спаду выставляют следующий. Поэтому SPI всегда работает в обе стороны: на каждый отправленный байт приходит ответный, даже если модулю нечего сказать.

Скорость задаёт ведущий. На Uno предел — 8 МГц, половина частоты кварца; если ничего не настраивать, SPI.begin() включает 4 МГц. Модули обычно выдерживают больше, а мешают длинные провода и макетка. Если обмен сбоит, первым делом снизьте частоту, например до 1 МГц.

Где SCK, MOSI и MISO на вашей плате

ПлатаSCKMOSIMISOSS по умолчанию
Uno, Nano13111210
Mega 256052515053
Leonardoтолько ICSP, ножка 3только ICSP, ножка 4только ICSP, ножка 1не выведен (светодиод RX)
Pro Micro151614не выведен (светодиод RX)
Nano Every1311128
UNO R4, Nano R413111210
ESP32 DevKit1823195
ESP32-C3 Super Mini4657
ESP32-S3 DevKitC12111310
ESP8266 NodeMCUD5 (14)D7 (13)D6 (12)D8 (15)
Raspberry Pi PicoGP18GP19GP16GP17
STM32 Blue PillPA5PA7PA6PA4

На 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.

РежимCPOLCPHAТакт в покоеБит читаютКто так работает
SPI_MODE0000по фронту вверхпочти все модули: карты microSD, RC522, 74HC595, MAX7219
SPI_MODE1010по спадувстречается редко
SPI_MODE2101по спадувстречается редко
SPI_MODE3111по фронту вверхнапример, акселерометр 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() двигает ещё восемь выходов.

Несколько устройств на одной шине

Три общих провода и свой провод выбора у каждого устройстваArduino UnoведущийD10выбор RC522D13SCKD11MOSID12MISOD4выбор картыRFID RC522SDA (CS)SCKMOSIMISOМодуль microSDSCKMOSIMISOCS
SCK, MOSI и MISO идут ко всем устройствам сразу, а провод выбора у каждого свой. Плата прижимает к земле CS того устройства, с которым говорит; остальные в это время обязаны молчать и отпустить линию MISO. Питание и землю модулей на схеме не показали: их подключают как обычно, по описанию модуля.

Правило одно: 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 scopeRaspberry 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 В.

176 ₽
В магазин
цена на 15.11.2026

Адаптер карт microSD, Trema-модуль

Адаптер в формате Trema-модулей — удобно, если проект собирается на Trema Shield. Питание 5 В.

198 ₽
В магазин
цена на 15.11.2026

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.