1 #ifndef Adafruit_SPIDevice_h 2 #define Adafruit_SPIDevice_h 6 #if !defined(SPI_INTERFACES_COUNT) || \ 7 (defined(SPI_INTERFACES_COUNT) && (SPI_INTERFACES_COUNT > 0)) 10 #define BUSIO_HAS_HW_SPI 13 enum { SPI_MODE0, SPI_MODE1, SPI_MODE2, _SPI_MODE4 };
14 typedef uint8_t SPIClass;
18 #if (defined(__AVR__) && !defined(ARDUINO_ARCH_MEGAAVR)) || \ 19 defined(ESP8266) || defined(TEENSYDUINO) || defined(SPARK) || \ 20 defined(ARDUINO_ARCH_SPRESENSE) || defined(MEGATINYCORE) || \ 21 defined(DXCORE) || defined(ARDUINO_AVR_ATmega4809) || \ 22 defined(ARDUINO_AVR_ATmega4808) || defined(ARDUINO_AVR_ATmega3209) || \ 23 defined(ARDUINO_AVR_ATmega3208) || defined(ARDUINO_AVR_ATmega1609) || \ 24 defined(ARDUINO_AVR_ATmega1608) || defined(ARDUINO_AVR_ATmega809) || \ 25 defined(ARDUINO_AVR_ATmega808) || defined(ARDUINO_ARCH_ARC32) || \ 26 defined(ARDUINO_ARCH_XMC) 28 typedef enum _BitOrder {
29 SPI_BITORDER_MSBFIRST = MSBFIRST,
30 SPI_BITORDER_LSBFIRST = LSBFIRST,
33 #elif defined(ESP32) || defined(__ASR6501__) || defined(__ASR6502__) 37 typedef enum _BitOrder {
38 SPI_BITORDER_MSBFIRST = SPI_MSBFIRST,
39 SPI_BITORDER_LSBFIRST = SPI_LSBFIRST,
44 #define SPI_BITORDER_MSBFIRST MSBFIRST 45 #define SPI_BITORDER_LSBFIRST LSBFIRST 46 typedef BitOrder BusIOBitOrder;
49 #if defined(__IMXRT1062__) // Teensy 4.x 61 #elif defined(ARDUINO_ARCH_XMC) 62 #undef BUSIO_USE_FAST_PINIO 64 #elif defined(__AVR__) || defined(TEENSYDUINO) 65 typedef volatile uint8_t BusIO_PortReg;
66 typedef uint8_t BusIO_PortMask;
67 #define BUSIO_USE_FAST_PINIO 69 #elif defined(ESP8266) || defined(ESP32) || defined(__SAM3X8E__) || \ 70 defined(ARDUINO_ARCH_SAMD) 71 typedef volatile uint32_t BusIO_PortReg;
72 typedef uint32_t BusIO_PortMask;
73 #define BUSIO_USE_FAST_PINIO 75 #elif (defined(__arm__) || defined(ARDUINO_FEATHER52)) && \ 76 !defined(ARDUINO_ARCH_MBED) && !defined(ARDUINO_ARCH_RP2040) && \ 77 !defined(ARDUINO_SILABS) && !defined(ARDUINO_UNOR4_MINIMA) && \ 78 !defined(ARDUINO_UNOR4_WIFI) 79 typedef volatile uint32_t BusIO_PortReg;
80 typedef uint32_t BusIO_PortMask;
81 #if !defined(__ASR6501__) && !defined(__ASR6502__) 82 #define BUSIO_USE_FAST_PINIO 86 #undef BUSIO_USE_FAST_PINIO 92 #ifdef BUSIO_HAS_HW_SPI 94 BusIOBitOrder dataOrder = SPI_BITORDER_MSBFIRST,
95 uint8_t dataMode = SPI_MODE0, SPIClass *theSPI = &SPI);
98 BusIOBitOrder dataOrder = SPI_BITORDER_MSBFIRST,
99 uint8_t dataMode = SPI_MODE0, SPIClass *theSPI =
nullptr);
102 uint32_t freq = 1000000,
103 BusIOBitOrder dataOrder = SPI_BITORDER_MSBFIRST,
104 uint8_t dataMode = SPI_MODE0);
108 bool read(uint8_t *buffer,
size_t len, uint8_t sendvalue = 0xFF);
109 bool write(
const uint8_t *buffer,
size_t len,
110 const uint8_t *prefix_buffer =
nullptr,
size_t prefix_len = 0);
112 uint8_t *read_buffer,
size_t read_len,
113 uint8_t sendvalue = 0xFF);
117 void transfer(uint8_t *buffer,
size_t len);
124 #ifdef BUSIO_HAS_HW_SPI 125 SPIClass *_spi =
nullptr;
126 SPISettings *_spiSetting =
nullptr;
128 uint8_t *_spi =
nullptr;
129 uint8_t *_spiSetting =
nullptr;
132 BusIOBitOrder _dataOrder;
134 void setChipSelect(
int value);
136 int8_t _cs, _sck, _mosi, _miso;
137 #ifdef BUSIO_USE_FAST_PINIO 138 BusIO_PortReg *mosiPort, *clkPort, *misoPort, *csPort;
139 BusIO_PortMask mosiPinMask, misoPinMask, clkPinMask, csPinMask;
144 #endif // Adafruit_SPIDevice_h bool write(const uint8_t *buffer, size_t len, const uint8_t *prefix_buffer=nullptr, size_t prefix_len=0)
Write a buffer or two to the SPI device, with transaction management.
Definition: Adafruit_SPIDevice.cpp:343
void beginTransactionWithAssertingCS()
Write a buffer or two to the SPI device, with transaction management.
Definition: Adafruit_SPIDevice.cpp:318
void endTransactionWithDeassertingCS()
Manually end a transaction (calls endTransaction if hardware SPI) with deasserting the CS pin...
Definition: Adafruit_SPIDevice.cpp:327
bool write_and_read(uint8_t *buffer, size_t len)
Write some data and read some data at the same time from SPI into the same buffer, with transaction management. This is basicaly a wrapper for transfer() with CS-pin and transaction management. This /does/ transmit-receive at the same time!
Definition: Adafruit_SPIDevice.cpp:502
uint8_t transfer(uint8_t send)
Transfer (send/receive) one byte over hard/soft SPI, without transaction management.
Definition: Adafruit_SPIDevice.cpp:273
~Adafruit_SPIDevice()
Release memory allocated in constructors.
Definition: Adafruit_SPIDevice.cpp:82
bool begin(void)
Initializes SPI bus and sets CS pin high.
Definition: Adafruit_SPIDevice.cpp:92
void endTransaction(void)
Manually end a transaction (calls endTransaction if hardware SPI)
Definition: Adafruit_SPIDevice.cpp:294
bool read(uint8_t *buffer, size_t len, uint8_t sendvalue=0xFF)
Read from SPI into a buffer from the SPI device, with transaction management.
Definition: Adafruit_SPIDevice.cpp:402
Adafruit_SPIDevice(int8_t cspin, uint32_t freq=1000000, BusIOBitOrder dataOrder=SPI_BITORDER_MSBFIRST, uint8_t dataMode=SPI_MODE0, SPIClass *theSPI=&SPI)
Create an SPI device with the given CS pin and settings.
Definition: Adafruit_SPIDevice.cpp:14
Definition: Adafruit_SPIDevice.h:90
void beginTransaction(void)
Manually begin a transaction (calls beginTransaction if hardware SPI)
Definition: Adafruit_SPIDevice.cpp:283
bool write_then_read(const uint8_t *write_buffer, size_t write_len, uint8_t *read_buffer, size_t read_len, uint8_t sendvalue=0xFF)
Write some data, then read some data from SPI into another buffer, with transaction management...
Definition: Adafruit_SPIDevice.cpp:438