Source: https://mokxi.com/libraries/spi Updated: 2026-11-02 Libraries / Core Arduino library · Core # The Arduino SPI library: fast four-wire talk with chips SPI.h is the Arduino library for the Serial Peripheral Interface, the bus SD cards, RFID readers, TFT screens, radios and many ADCs use. It has a clock line (SCK), a line out of the Arduino (MOSI, or COPI), a line back in (MISO, or CIPO), and one chip-select line per device that the sketch pulls LOW to talk to that device and HIGH when it is done. Open the example in the editor See the calls Built in on Mokxi: #include and it builds, with nothing to install. Free, and no account needed. ## What SPI does Every SPI byte is an exchange: transfer() clocks one byte out and returns the byte that came back at the same time. Devices differ in the clock speed they accept, which edge they sample on (the four SPI modes) and whether the most or least significant bit goes first, so modern sketches wrap each conversation in beginTransaction(SPISettings(...)) and endTransaction(). The bus pins are fixed by the chip: 13, 12 and 11 on an Uno or Nano, 52, 50 and 51 on a Mega, and only the ICSP header on a Leonardo. Chip select can be any pin, but on AVR boards pin 10 (53 on the Mega) must stay an output or the chip can drop out of controller mode. Library Manager name | SPI Author | Arduino Include | #include Boards | every board Mokxi compiles for In the simulator | Simulated: it runs against the part the way it does on the bench. Parts it drives | RFID reader, MFRC522, microSD card module ## Install it It builds on every board Mokxi compiles for. In Mokxi it is built in: #include and the sketch compiles, with no download, no zip and no Library Manager. On a real board it comes with the board package (Arduino), so the Arduino IDE has it as soon as the board is installed: there is nothing to add from the Library Manager. ESP32-C3 · Arduino Uno · Arduino Nano · Arduino Mega 2560 · Arduino Leonardo · SparkFun Pro Micro · Arduino Micro · ESP32-C6 · ATtiny85 · Raspberry Pi Pico · Raspberry Pi Pico W · Seeed XIAO SAMD21 · STM32 · STM32 Nucleo-F411RE · STM32 Blue Pill · micro:bit V2 · Arduino Uno R4 · ESP32 DevKit · ESP32-S3-DevKitC-1 · ESP8266 NodeMCU · Arduino Pro Mini 3.3 V · Seeed XIAO ESP32-C3 · ESP32-C3 SuperMini · Seeed XIAO ESP32-C6 · ESP32-DevKitC V4 · LOLIN32 Lite · Wemos D1 R32 · Cheap Yellow Display · TTGO T-Display · Seeed XIAO ESP32-S3 · Arduino Nano ESP32 · Arduino Nano RP2040 Connect · Seeed XIAO RP2040 · Waveshare RP2040-Zero · Arduino Uno R4 WiFi ## The calls you will use In the order a sketch meets them. ### SPI.begin() Sets SCK, MOSI and SS up as outputs and starts the bus. Call it once in setup() before any transfer. ### SPI.beginTransaction(SPISettings(1000000, MSBFIRST, SPI_MODE0)) Claims the bus with one device’s settings: clock speed in hertz, bit order and SPI mode 0 to 3. ### SPI.transfer(0x9F) Sends one byte and returns the byte received at the same time. Send a dummy byte, often 0x00 or 0xFF, to read. ### SPI.transfer16(0x1234) Sends and receives sixteen bits in one call, most significant byte first by default. ### SPI.endTransaction() Releases the bus so another library (an SD card on the same pins, say) can use its own settings. ### SPI.end() Turns the bus off and leaves the pins as they are. ## Example: RC522 RFID reader (SS 10, RST 9) On the Arduino Uno R3. It runs in the browser exactly as printed. sketch.ino · Arduino Uno R3 Open it in the editor, wired and ready to run · RC522 RFID reader (SS 10, RST 9): the project page ## Common errors and how to fix them ### Every byte read back is 0xFF or 0x00 The device is not answering: its chip-select pin is not going LOW, MISO is not connected, or the device has no power. Check that the sketch drives CS LOW before transfer() and HIGH after. ### Garbage data, but some bytes look almost right The SPI mode or bit order does not match the device’s data sheet, or the clock is too fast for long jumper wires. Set the right mode in SPISettings and try a slower clock such as 1 MHz. ### Two SPI devices work alone but not together Each needs its own chip-select pin, held HIGH when it is not in use. A device whose CS floats LOW answers along with the other one and corrupts MISO. Use beginTransaction() for each so their settings do not leak. ### An SPI module works on an Uno but not on a Leonardo with the same wiring Pins 11, 12 and 13 are not SPI on a Leonardo. Its SCK, MISO and MOSI are only on the 6-pin ICSP header, so wire the module there and keep chip select on any free pin. ## Projects that use SPI Built-in projects that include it. Each page has the full sketch and opens in the editor, already wired. Digital pot LED dimmer An MCP4131 digital potentiometer on SPI fades an LED up and down: a knob the Uno turns, with A0 reading the wiper. LoRa messenger Two Unos, a Ra-02 LoRa module each and no wire between them: one sends a numbered message every two seconds, the other prints it, and the sender shows its time on the air. RFID door An MFRC522 reader and four cards. ESP32 traffic emergency system with RFID Three roads’ lights take turns on an ESP32. Kiln and bath probes A K-type thermocouple on a MAX31855 for a kiln past 1000 C and a PT100 on a MAX31865 for the bath beside it, a tenth of a degree at a time. CYD touch paint Draw on the Cheap Yellow Display with a finger: the XPT2046 touch film on its own SPI pins, a palette and a clear button. ## Keep going ### Learn - SPI Explained: Clock, Data and Chip Select - Arduino SPI Master and Slave, Simulated ### Parts - RFID reader, MFRC522 - microSD card module ### More core libraries - Wire - EEPROM - FreeRTOS (Arduino_FreeRTOS) Every built-in library · Open the editor ## Try SPI without installing anything Open the example, change the sketch, and keep your version in a free account. Start building free Open the editor