|
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386 |
-
-
- #ifndef _SPI_H_INCLUDED
- #define _SPI_H_INCLUDED
-
- #include <Arduino.h>
-
- #if defined(__arm__) && defined(TEENSYDUINO)
- #if defined(__has_include) && __has_include(<EventResponder.h>)
-
-
- #define SPI_HAS_TRANSFER_ASYNC 1
- #include <DMAChannel.h>
- #include <EventResponder.h>
- #endif
- #endif
-
-
-
- #define SPI_HAS_TRANSACTION 1
-
-
-
-
-
-
-
-
-
-
- #define SPI_HAS_TRANSFER_BUF 1
-
-
- #ifndef LSBFIRST
- #define LSBFIRST 0
- #endif
- #ifndef MSBFIRST
- #define MSBFIRST 1
- #endif
-
- #define SPI_MODE0 0x00
- #define SPI_MODE1 0x04
- #define SPI_MODE2 0x08
- #define SPI_MODE3 0x0C
-
- #define SPI_CLOCK_DIV4 0x00
- #define SPI_CLOCK_DIV16 0x01
- #define SPI_CLOCK_DIV64 0x02
- #define SPI_CLOCK_DIV128 0x03
- #define SPI_CLOCK_DIV2 0x04
- #define SPI_CLOCK_DIV8 0x05
- #define SPI_CLOCK_DIV32 0x06
-
- #define SPI_MODE_MASK 0x0C
- #define SPI_CLOCK_MASK 0x03
- #define SPI_2XCLOCK_MASK 0x01
-
-
-
-
-
-
- #if defined(__AVR__)
- #define SPI_ATOMIC_VERSION 1
-
- #if defined(EIMSK)
- #define SPI_AVR_EIMSK EIMSK
- #elif defined(GICR)
- #define SPI_AVR_EIMSK GICR
- #elif defined(GIMSK)
- #define SPI_AVR_EIMSK GIMSK
- #endif
-
- class SPISettings {
- public:
- SPISettings(uint32_t clock, uint8_t bitOrder, uint8_t dataMode) {
- if (__builtin_constant_p(clock)) {
- init_AlwaysInline(clock, bitOrder, dataMode);
- } else {
- init_MightInline(clock, bitOrder, dataMode);
- }
- }
- SPISettings() {
- init_AlwaysInline(4000000, MSBFIRST, SPI_MODE0);
- }
- private:
- void init_MightInline(uint32_t clock, uint8_t bitOrder, uint8_t dataMode) {
- init_AlwaysInline(clock, bitOrder, dataMode);
- }
- void init_AlwaysInline(uint32_t clock, uint8_t bitOrder, uint8_t dataMode)
- __attribute__((__always_inline__)) {
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- uint8_t clockDiv;
-
-
-
-
-
- if (__builtin_constant_p(clock)) {
- if (clock >= F_CPU / 2) {
- clockDiv = 0;
- } else if (clock >= F_CPU / 4) {
- clockDiv = 1;
- } else if (clock >= F_CPU / 8) {
- clockDiv = 2;
- } else if (clock >= F_CPU / 16) {
- clockDiv = 3;
- } else if (clock >= F_CPU / 32) {
- clockDiv = 4;
- } else if (clock >= F_CPU / 64) {
- clockDiv = 5;
- } else {
- clockDiv = 6;
- }
- } else {
- uint32_t clockSetting = F_CPU / 2;
- clockDiv = 0;
- while (clockDiv < 6 && clock < clockSetting) {
- clockSetting /= 2;
- clockDiv++;
- }
- }
-
-
- if (clockDiv == 6)
- clockDiv = 7;
-
-
- clockDiv ^= 0x1;
-
-
- spcr = _BV(SPE) | _BV(MSTR) | ((bitOrder == LSBFIRST) ? _BV(DORD) : 0) |
- (dataMode & SPI_MODE_MASK) | ((clockDiv >> 1) & SPI_CLOCK_MASK);
- spsr = clockDiv & SPI_2XCLOCK_MASK;
- }
- uint8_t spcr;
- uint8_t spsr;
- friend class SPIClass;
- };
-
-
-
- class SPIClass { // AVR
- public:
- // Initialize the SPI library
- static void begin();
-
- // If SPI is used from within an interrupt, this function registers
- // that interrupt with the SPI library, so beginTransaction() can
- // prevent conflicts. The input interruptNumber is the number used
- // with attachInterrupt. If SPI is used from a different interrupt
- // (eg, a timer), interruptNumber should be 255.
- static void usingInterrupt(uint8_t interruptNumber);
-
- // Before using SPI.transfer() or asserting chip select pins,
- // this function is used to gain exclusive access to the SPI bus
- // and configure the correct settings.
- inline static void beginTransaction(SPISettings settings) {
- if (interruptMode > 0) {
- #ifdef SPI_AVR_EIMSK
- if (interruptMode == 1) {
- interruptSave = SPI_AVR_EIMSK;
- SPI_AVR_EIMSK &= ~interruptMask;
- } else
- #endif
- {
- uint8_t tmp = SREG;
- cli();
- interruptSave = tmp;
- }
- }
- #ifdef SPI_TRANSACTION_MISMATCH_LED
- if (inTransactionFlag) {
- pinMode(SPI_TRANSACTION_MISMATCH_LED, OUTPUT);
- digitalWrite(SPI_TRANSACTION_MISMATCH_LED, HIGH);
- }
- inTransactionFlag = 1;
- #endif
- SPCR = settings.spcr;
- SPSR = settings.spsr;
- }
-
- // Write to the SPI bus (MOSI pin) and also receive (MISO pin)
- inline static uint8_t transfer(uint8_t data) {
- SPDR = data;
- asm volatile("nop");
- while (!(SPSR & _BV(SPIF))) ; // wait
- return SPDR;
- }
- inline static uint16_t transfer16(uint16_t data) {
- union { uint16_t val; struct { uint8_t lsb; uint8_t msb; }; } in, out;
- in.val = data;
- if ((SPCR & _BV(DORD))) {
- SPDR = in.lsb;
- asm volatile("nop");
- while (!(SPSR & _BV(SPIF))) ;
- out.lsb = SPDR;
- SPDR = in.msb;
- asm volatile("nop");
- while (!(SPSR & _BV(SPIF))) ;
- out.msb = SPDR;
- } else {
- SPDR = in.msb;
- asm volatile("nop");
- while (!(SPSR & _BV(SPIF))) ;
- out.msb = SPDR;
- SPDR = in.lsb;
- asm volatile("nop");
- while (!(SPSR & _BV(SPIF))) ;
- out.lsb = SPDR;
- }
- return out.val;
- }
- inline static void transfer(void *buf, size_t count) {
- if (count == 0) return;
- uint8_t *p = (uint8_t *)buf;
- SPDR = *p;
- while (--count > 0) {
- uint8_t out = *(p + 1);
- while (!(SPSR & _BV(SPIF))) ;
- uint8_t in = SPDR;
- SPDR = out;
- *p++ = in;
- }
- while (!(SPSR & _BV(SPIF))) ;
- *p = SPDR;
- }
- static void setTransferWriteFill(uint8_t ch ) {_transferWriteFill = ch;}
- static void transfer(const void * buf, void * retbuf, uint32_t count);
-
- // After performing a group of transfers and releasing the chip select
- // signal, this function allows others to access the SPI bus
- inline static void endTransaction(void) {
- #ifdef SPI_TRANSACTION_MISMATCH_LED
- if (!inTransactionFlag) {
- pinMode(SPI_TRANSACTION_MISMATCH_LED, OUTPUT);
- digitalWrite(SPI_TRANSACTION_MISMATCH_LED, HIGH);
- }
- inTransactionFlag = 0;
- #endif
- if (interruptMode > 0) {
- #ifdef SPI_AVR_EIMSK
- if (interruptMode == 1) {
- SPI_AVR_EIMSK = interruptSave;
- } else
- #endif
- {
- SREG = interruptSave;
- }
- }
- }
-
- // Disable the SPI bus
- static void end();
-
- // This function is deprecated. New applications should use
- // beginTransaction() to configure SPI settings.
- inline static void setBitOrder(uint8_t bitOrder) {
- if (bitOrder == LSBFIRST) SPCR |= _BV(DORD);
- else SPCR &= ~(_BV(DORD));
- }
- // This function is deprecated. New applications should use
- // beginTransaction() to configure SPI settings.
- inline static void setDataMode(uint8_t dataMode) {
- SPCR = (SPCR & ~SPI_MODE_MASK) | dataMode;
- }
- // This function is deprecated. New applications should use
- // beginTransaction() to configure SPI settings.
- inline static void setClockDivider(uint8_t clockDiv) {
- SPCR = (SPCR & ~SPI_CLOCK_MASK) | (clockDiv & SPI_CLOCK_MASK);
- SPSR = (SPSR & ~SPI_2XCLOCK_MASK) | ((clockDiv >> 2) & SPI_2XCLOCK_MASK);
- }
- // These undocumented functions should not be used. SPI.transfer()
- // polls the hardware flag which is automatically cleared as the
- // AVR responds to SPI's interrupt
- inline static void attachInterrupt() { SPCR |= _BV(SPIE); }
- inline static void detachInterrupt() { SPCR &= ~_BV(SPIE); }
-
- private:
- static uint8_t interruptMode; // 0=none, 1=mask, 2=global
- static uint8_t interruptMask; // which interrupts to mask
- static uint8_t interruptSave; // temp storage, to restore state
- #ifdef SPI_TRANSACTION_MISMATCH_LED
- static uint8_t inTransactionFlag;
- #endif
- static uint8_t _transferWriteFill;
- };
-
-
-
- /**********************************************************/
- /* 32 bit Teensy 3.x */
- /**********************************************************/
-
- #elif defined(__arm__) && defined(TEENSYDUINO) && defined(KINETISK)
-
- #define SPI_HAS_NOTUSINGINTERRUPT 1
- #define SPI_ATOMIC_VERSION 1
-
- class SPISettings {
- public:
- SPISettings(uint32_t clock, uint8_t bitOrder, uint8_t dataMode) {
- if (__builtin_constant_p(clock)) {
- init_AlwaysInline(clock, bitOrder, dataMode);
- } else {
- init_MightInline(clock, bitOrder, dataMode);
- }
- }
- SPISettings() {
- init_AlwaysInline(4000000, MSBFIRST, SPI_MODE0);
- }
- private:
- void init_MightInline(uint32_t clock, uint8_t bitOrder, uint8_t dataMode) {
- init_AlwaysInline(clock, bitOrder, dataMode);
- }
- void init_AlwaysInline(uint32_t clock, uint8_t bitOrder, uint8_t dataMode)
- __attribute__((__always_inline__)) {
- uint32_t t, c = SPI_CTAR_FMSZ(7);
- if (bitOrder == LSBFIRST) c |= SPI_CTAR_LSBFE;
- if (__builtin_constant_p(clock)) {
- if (clock >= F_BUS / 2) {
- t = SPI_CTAR_PBR(0) | SPI_CTAR_BR(0) | SPI_CTAR_DBR
- | SPI_CTAR_CSSCK(0);
- } else if (clock >= F_BUS / 3) {
- t = SPI_CTAR_PBR(1) | SPI_CTAR_BR(0) | SPI_CTAR_DBR
- | SPI_CTAR_CSSCK(0);
- } else if (clock >= F_BUS / 4) {
- t = SPI_CTAR_PBR(0) | SPI_CTAR_BR(0) | SPI_CTAR_CSSCK(0);
- } else if (clock >= F_BUS / 5) {
- t = SPI_CTAR_PBR(2) | SPI_CTAR_BR(0) | SPI_CTAR_DBR
- | SPI_CTAR_CSSCK(0);
- } else if (clock >= F_BUS / 6) {
- t = SPI_CTAR_PBR(1) | SPI_CTAR_BR(0) | SPI_CTAR_CSSCK(0);
- } else if (clock >= F_BUS / 8) {
- t = SPI_CTAR_PBR(0) | SPI_CTAR_BR(1) | SPI_CTAR_CSSCK(1);
- } else if (clock >= F_BUS / 10) {
- t = SPI_CTAR_PBR(2) | SPI_CTAR_BR(0) | SPI_CTAR_CSSCK(0);
- } else if (clock >= F_BUS / 12) {
- t = SPI_CTAR_PBR(1) | SPI_CTAR_BR(1) | SPI_CTAR_CSSCK(1);
- } else if (clock >= F_BUS / 16) {
- t = SPI_CTAR_PBR(0) | SPI_CTAR_BR(3) | SPI_CTAR_CSSCK(2);
- } else if (clock >= F_BUS / 20) {
- t = SPI_CTAR_PBR(2) | SPI_CTAR_BR(1) | SPI_CTAR_CSSCK(0);
- } else if (clock >= F_BUS / 24) {
- t = SPI_CTAR_PBR(1) | SPI_CTAR_BR(3) | SPI_CTAR_CSSCK(2);
- } else if (clock >= F_BUS / 32) {
- t = SPI_CTAR_PBR(0) | SPI_CTAR_BR(4) | SPI_CTAR_CSSCK(3);
- } else if (clock >= F_BUS / 40) {
- t = SPI_CTAR_PBR(2) | SPI_CTAR_BR(3) | SPI_CTAR_CSSCK(2);
- } else if (clock >= F_BUS / 56) {
- t = SPI_CTAR_PBR(3) | SPI_CTAR_BR(3) | SPI_CTAR_CSSCK(2);
- } else if (clock >= F_BUS / 64) {
- t = SPI_CTAR_PBR(0) | SPI_CTAR_BR(5) | SPI_CTAR_CSSCK(4);
- } else if (clock >= F_BUS / 96) {
- t = SPI_CTAR_PBR(1) | SPI_CTAR_BR(5) | SPI_CTAR_CSSCK(4);
- } else if (clock >= F_BUS / 128) {
- t = SPI_CTAR_PBR(0) | SPI_CTAR_BR(6) | SPI_CTAR_CSSCK(5);
- } else if (clock >= F_BUS / 192) {
- t = SPI_CTAR_PBR(1) | SPI_CTAR_BR(6) | SPI_CTAR_CSSCK(5);
- } else if (clock >= F_BUS / 256) {
- t = SPI_CTAR_PBR(0) | SPI_CTAR_BR(7) | SPI_CTAR_CSSCK(6);
- } else if (clock >= F_BUS / 384) {
- t = SPI_CTAR_PBR(1) | SPI_CTAR_BR(7) | SPI_CTAR_CSSCK(6);
- } else if (clock >= F_BUS / 512) {
- t = SPI_CTAR_PBR(0) | SPI_CTAR_BR(8) | SPI_CTAR_CSSCK(7);
- } else if (clock >= F_BUS / 640) {
- t = SPI_CTAR_PBR(2) | SPI_CTAR_BR(7) | SPI_CTAR_CSSCK(6);
- } else { /* F_BUS / 768 */
- t = SPI_CTAR_PBR(1) | SPI_CTAR_BR(8) | SPI_CTAR_CSSCK(7);
- }
- } else {
- for (uint32_t i=0; i<23; i++) {
- t = ctar_clock_table[i];
- if (clock >= F_BUS / ctar_div_table[i]) break;
- }
- }
- if (dataMode & 0x08) {
- c |= SPI_CTAR_CPOL;
- }
- if (dataMode & 0x04) {
- c |= SPI_CTAR_CPHA;
- t = (t & 0xFFFF0FFF) | ((t & 0xF000) >> 4);
- }
- ctar = c | t;
- }
- static const uint16_t ctar_div_table[23];
- static const uint32_t ctar_clock_table[23];
- uint32_t ctar;
- friend class SPIClass;
- };
-
-
-
- class SPIClass { // Teensy 3.x
- public:
- #if defined(__MK20DX128__) || defined(__MK20DX256__)
- static const uint8_t CNT_MISO_PINS = 2;
- static const uint8_t CNT_MOSI_PINS = 2;
- static const uint8_t CNT_SCK_PINS = 2;
- static const uint8_t CNT_CS_PINS = 9;
- #elif defined(__MK64FX512__) || defined(__MK66FX1M0__)
- static const uint8_t CNT_MISO_PINS = 4;
- static const uint8_t CNT_MOSI_PINS = 4;
- static const uint8_t CNT_SCK_PINS = 3;
- static const uint8_t CNT_CS_PINS = 11;
- #endif
- typedef struct {
- volatile uint32_t &clock_gate_register;
- uint32_t clock_gate_mask;
- uint8_t queue_size;
- uint8_t spi_irq;
- uint32_t max_dma_count;
- uint8_t tx_dma_channel;
- uint8_t rx_dma_channel;
- void (*dma_rxisr)();
- uint8_t miso_pin[CNT_MISO_PINS];
- uint32_t miso_mux[CNT_MISO_PINS];
- uint8_t mosi_pin[CNT_MOSI_PINS];
- uint32_t mosi_mux[CNT_MOSI_PINS];
- uint8_t sck_pin[CNT_SCK_PINS];
- uint32_t sck_mux[CNT_SCK_PINS];
- uint8_t cs_pin[CNT_CS_PINS];
- uint32_t cs_mux[CNT_CS_PINS];
- uint8_t cs_mask[CNT_CS_PINS];
- } SPI_Hardware_t;
- static const SPI_Hardware_t spi0_hardware;
- static const SPI_Hardware_t spi1_hardware;
- static const SPI_Hardware_t spi2_hardware;
-
- enum DMAState { notAllocated, idle, active, completed};
- public:
- constexpr SPIClass(uintptr_t myport, uintptr_t myhardware)
- : port_addr(myport), hardware_addr(myhardware) {
- }
- // Initialize the SPI library
- void begin();
-
- // If SPI is to used from within an interrupt, this function registers
- // that interrupt with the SPI library, so beginTransaction() can
- // prevent conflicts. The input interruptNumber is the number used
- // with attachInterrupt. If SPI is used from a different interrupt
- // (eg, a timer), interruptNumber should be 255.
- void usingInterrupt(uint8_t n) {
- if (n == 3 || n == 4 || n == 24 || n == 33) {
- usingInterrupt(IRQ_PORTA);
- } else if (n == 0 || n == 1 || (n >= 16 && n <= 19) || n == 25 || n == 32) {
- usingInterrupt(IRQ_PORTB);
- } else if ((n >= 9 && n <= 13) || n == 15 || n == 22 || n == 23
- || (n >= 27 && n <= 30)) {
- usingInterrupt(IRQ_PORTC);
- } else if (n == 2 || (n >= 5 && n <= 8) || n == 14 || n == 20 || n == 21) {
- usingInterrupt(IRQ_PORTD);
- } else if (n == 26 || n == 31) {
- usingInterrupt(IRQ_PORTE);
- }
- }
- void usingInterrupt(IRQ_NUMBER_t interruptName);
- void notUsingInterrupt(IRQ_NUMBER_t interruptName);
-
- // Before using SPI.transfer() or asserting chip select pins,
- // this function is used to gain exclusive access to the SPI bus
- // and configure the correct settings.
- void beginTransaction(SPISettings settings) {
- if (interruptMasksUsed) {
- __disable_irq();
- if (interruptMasksUsed & 0x01) {
- interruptSave[0] = NVIC_ICER0 & interruptMask[0];
- NVIC_ICER0 = interruptSave[0];
- }
- #if NVIC_NUM_INTERRUPTS > 32
- if (interruptMasksUsed & 0x02) {
- interruptSave[1] = NVIC_ICER1 & interruptMask[1];
- NVIC_ICER1 = interruptSave[1];
- }
- #endif
- #if NVIC_NUM_INTERRUPTS > 64 && defined(NVIC_ISER2)
- if (interruptMasksUsed & 0x04) {
- interruptSave[2] = NVIC_ICER2 & interruptMask[2];
- NVIC_ICER2 = interruptSave[2];
- }
- #endif
- #if NVIC_NUM_INTERRUPTS > 96 && defined(NVIC_ISER3)
- if (interruptMasksUsed & 0x08) {
- interruptSave[3] = NVIC_ICER3 & interruptMask[3];
- NVIC_ICER3 = interruptSave[3];
- }
- #endif
- __enable_irq();
- }
- #ifdef SPI_TRANSACTION_MISMATCH_LED
- if (inTransactionFlag) {
- pinMode(SPI_TRANSACTION_MISMATCH_LED, OUTPUT);
- digitalWrite(SPI_TRANSACTION_MISMATCH_LED, HIGH);
- }
- inTransactionFlag = 1;
- #endif
- if (port().CTAR0 != settings.ctar) {
- port().MCR = SPI_MCR_MDIS | SPI_MCR_HALT | SPI_MCR_PCSIS(0x3F);
- port().CTAR0 = settings.ctar;
- port().CTAR1 = settings.ctar| SPI_CTAR_FMSZ(8);
- port().MCR = SPI_MCR_MSTR | SPI_MCR_PCSIS(0x3F);
- }
- }
-
- // Write to the SPI bus (MOSI pin) and also receive (MISO pin)
- uint8_t transfer(uint8_t data) {
- port().SR = SPI_SR_TCF;
- port().PUSHR = data;
- while (!(port().SR & SPI_SR_TCF)) ; // wait
- return port().POPR;
- }
- uint16_t transfer16(uint16_t data) {
- port().SR = SPI_SR_TCF;
- port().PUSHR = data | SPI_PUSHR_CTAS(1);
- while (!(port().SR & SPI_SR_TCF)) ; // wait
- return port().POPR;
- }
-
- void inline transfer(void *buf, size_t count) {transfer(buf, buf, count);}
- void setTransferWriteFill(uint8_t ch ) {_transferWriteFill = ch;}
- void transfer(const void * buf, void * retbuf, size_t count);
-
- // Asynch support (DMA )
- #ifdef SPI_HAS_TRANSFER_ASYNC
- bool transfer(const void *txBuffer, void *rxBuffer, size_t count, EventResponderRef event_responder);
-
- friend void _spi_dma_rxISR0(void);
- friend void _spi_dma_rxISR1(void);
- friend void _spi_dma_rxISR2(void);
-
- inline void dma_rxisr(void);
- #endif
-
-
- // After performing a group of transfers and releasing the chip select
- // signal, this function allows others to access the SPI bus
- void endTransaction(void) {
- #ifdef SPI_TRANSACTION_MISMATCH_LED
- if (!inTransactionFlag) {
- pinMode(SPI_TRANSACTION_MISMATCH_LED, OUTPUT);
- digitalWrite(SPI_TRANSACTION_MISMATCH_LED, HIGH);
- }
- inTransactionFlag = 0;
- #endif
- if (interruptMasksUsed) {
- if (interruptMasksUsed & 0x01) {
- NVIC_ISER0 = interruptSave[0];
- }
- #if NVIC_NUM_INTERRUPTS > 32
- if (interruptMasksUsed & 0x02) {
- NVIC_ISER1 = interruptSave[1];
- }
- #endif
- #if NVIC_NUM_INTERRUPTS > 64 && defined(NVIC_ISER2)
- if (interruptMasksUsed & 0x04) {
- NVIC_ISER2 = interruptSave[2];
- }
- #endif
- #if NVIC_NUM_INTERRUPTS > 96 && defined(NVIC_ISER3)
- if (interruptMasksUsed & 0x08) {
- NVIC_ISER3 = interruptSave[3];
- }
- #endif
- }
- }
-
- // Disable the SPI bus
- void end();
-
- // This function is deprecated. New applications should use
- // beginTransaction() to configure SPI settings.
- void setBitOrder(uint8_t bitOrder);
-
- // This function is deprecated. New applications should use
- // beginTransaction() to configure SPI settings.
- void setDataMode(uint8_t dataMode);
-
- // This function is deprecated. New applications should use
- // beginTransaction() to configure SPI settings.
- void setClockDivider(uint8_t clockDiv) {
- if (clockDiv == SPI_CLOCK_DIV2) {
- setClockDivider_noInline(SPISettings(12000000, MSBFIRST, SPI_MODE0).ctar);
- } else if (clockDiv == SPI_CLOCK_DIV4) {
- setClockDivider_noInline(SPISettings(4000000, MSBFIRST, SPI_MODE0).ctar);
- } else if (clockDiv == SPI_CLOCK_DIV8) {
- setClockDivider_noInline(SPISettings(2000000, MSBFIRST, SPI_MODE0).ctar);
- } else if (clockDiv == SPI_CLOCK_DIV16) {
- setClockDivider_noInline(SPISettings(1000000, MSBFIRST, SPI_MODE0).ctar);
- } else if (clockDiv == SPI_CLOCK_DIV32) {
- setClockDivider_noInline(SPISettings(500000, MSBFIRST, SPI_MODE0).ctar);
- } else if (clockDiv == SPI_CLOCK_DIV64) {
- setClockDivider_noInline(SPISettings(250000, MSBFIRST, SPI_MODE0).ctar);
- } else { /* clockDiv == SPI_CLOCK_DIV128 */
- setClockDivider_noInline(SPISettings(125000, MSBFIRST, SPI_MODE0).ctar);
- }
- }
- void setClockDivider_noInline(uint32_t clk);
-
- // These undocumented functions should not be used. SPI.transfer()
- // polls the hardware flag which is automatically cleared as the
- // AVR responds to SPI's interrupt
- void attachInterrupt() { }
- void detachInterrupt() { }
-
- // Teensy 3.x can use alternate pins for these 3 SPI signals.
- void setMOSI(uint8_t pin);
- void setMISO(uint8_t pin);
- void setSCK(uint8_t pin);
-
- // return true if "pin" has special chip select capability
- uint8_t pinIsChipSelect(uint8_t pin);
- bool pinIsMOSI(uint8_t pin);
- bool pinIsMISO(uint8_t pin);
- bool pinIsSCK(uint8_t pin);
- // return true if both pin1 and pin2 have independent chip select capability
- bool pinIsChipSelect(uint8_t pin1, uint8_t pin2);
- // configure a pin for chip select and return its SPI_MCR_PCSIS bitmask
- // setCS() is a special function, not intended for use from normal Arduino
- // programs/sketches. See the ILI3941_t3 library for an example.
- uint8_t setCS(uint8_t pin);
-
- private:
- KINETISK_SPI_t & port() { return *(KINETISK_SPI_t *)port_addr; }
- const SPI_Hardware_t & hardware() { return *(const SPI_Hardware_t *)hardware_addr; }
- void updateCTAR(uint32_t ctar);
- uintptr_t port_addr;
- uintptr_t hardware_addr;
- uint8_t miso_pin_index = 0;
- uint8_t mosi_pin_index = 0;
- uint8_t sck_pin_index = 0;
- uint8_t interruptMasksUsed = 0;
- uint32_t interruptMask[(NVIC_NUM_INTERRUPTS+31)/32] = {};
- uint32_t interruptSave[(NVIC_NUM_INTERRUPTS+31)/32] = {};
- #ifdef SPI_TRANSACTION_MISMATCH_LED
- uint8_t inTransactionFlag = 0;
- #endif
-
- uint8_t _transferWriteFill = 0;
-
- // DMA Support
- #ifdef SPI_HAS_TRANSFER_ASYNC
- bool initDMAChannels();
- DMAState _dma_state = DMAState::notAllocated;
- uint32_t _dma_count_remaining = 0; // How many bytes left to output after current DMA completes
- DMAChannel *_dmaTX = nullptr;
- DMAChannel *_dmaRX = nullptr;
- EventResponder *_dma_event_responder = nullptr;
- #endif
- };
-
-
-
- /**********************************************************/
- /* 32 bit Teensy-LC */
- /**********************************************************/
-
- #elif defined(__arm__) && defined(TEENSYDUINO) && defined(KINETISL)
- #define SPI_ATOMIC_VERSION 1
-
- class SPISettings {
- public:
- SPISettings(uint32_t clock, uint8_t bitOrder, uint8_t dataMode) {
- if (__builtin_constant_p(clock)) {
- init_AlwaysInline(clock, bitOrder, dataMode);
- } else {
- init_MightInline(clock, bitOrder, dataMode);
- }
- }
- SPISettings() {
- init_AlwaysInline(4000000, MSBFIRST, SPI_MODE0);
- }
- private:
- void init_MightInline(uint32_t clock, uint8_t bitOrder, uint8_t dataMode) {
- init_AlwaysInline(clock, bitOrder, dataMode);
- }
- void init_AlwaysInline(uint32_t clock, uint8_t bitOrder, uint8_t dataMode)
- __attribute__((__always_inline__)) {
- uint8_t c = SPI_C1_MSTR | SPI_C1_SPE;
- if (dataMode & 0x04) c |= SPI_C1_CPHA;
- if (dataMode & 0x08) c |= SPI_C1_CPOL;
- if (bitOrder == LSBFIRST) c |= SPI_C1_LSBFE;
- c1 = c;
- if (__builtin_constant_p(clock)) {
- if (clock >= F_BUS / 2) { c = SPI_BR_SPPR(0) | SPI_BR_SPR(0);
- } else if (clock >= F_BUS / 4) { c = SPI_BR_SPPR(1) | SPI_BR_SPR(0);
- } else if (clock >= F_BUS / 6) { c = SPI_BR_SPPR(2) | SPI_BR_SPR(0);
- } else if (clock >= F_BUS / 8) { c = SPI_BR_SPPR(3) | SPI_BR_SPR(0);
- } else if (clock >= F_BUS / 10) { c = SPI_BR_SPPR(4) | SPI_BR_SPR(0);
- } else if (clock >= F_BUS / 12) { c = SPI_BR_SPPR(5) | SPI_BR_SPR(0);
- } else if (clock >= F_BUS / 14) { c = SPI_BR_SPPR(6) | SPI_BR_SPR(0);
- } else if (clock >= F_BUS / 16) { c = SPI_BR_SPPR(7) | SPI_BR_SPR(0);
- } else if (clock >= F_BUS / 20) { c = SPI_BR_SPPR(4) | SPI_BR_SPR(1);
- } else if (clock >= F_BUS / 24) { c = SPI_BR_SPPR(5) | SPI_BR_SPR(1);
- } else if (clock >= F_BUS / 28) { c = SPI_BR_SPPR(6) | SPI_BR_SPR(1);
- } else if (clock >= F_BUS / 32) { c = SPI_BR_SPPR(7) | SPI_BR_SPR(1);
- } else if (clock >= F_BUS / 40) { c = SPI_BR_SPPR(4) | SPI_BR_SPR(2);
- } else if (clock >= F_BUS / 48) { c = SPI_BR_SPPR(5) | SPI_BR_SPR(2);
- } else if (clock >= F_BUS / 56) { c = SPI_BR_SPPR(6) | SPI_BR_SPR(2);
- } else if (clock >= F_BUS / 64) { c = SPI_BR_SPPR(7) | SPI_BR_SPR(2);
- } else if (clock >= F_BUS / 80) { c = SPI_BR_SPPR(4) | SPI_BR_SPR(3);
- } else if (clock >= F_BUS / 96) { c = SPI_BR_SPPR(5) | SPI_BR_SPR(3);
- } else if (clock >= F_BUS / 112) { c = SPI_BR_SPPR(6) | SPI_BR_SPR(3);
- } else if (clock >= F_BUS / 128) { c = SPI_BR_SPPR(7) | SPI_BR_SPR(3);
- } else if (clock >= F_BUS / 160) { c = SPI_BR_SPPR(4) | SPI_BR_SPR(4);
- } else if (clock >= F_BUS / 192) { c = SPI_BR_SPPR(5) | SPI_BR_SPR(4);
- } else if (clock >= F_BUS / 224) { c = SPI_BR_SPPR(6) | SPI_BR_SPR(4);
- } else if (clock >= F_BUS / 256) { c = SPI_BR_SPPR(7) | SPI_BR_SPR(4);
- } else if (clock >= F_BUS / 320) { c = SPI_BR_SPPR(4) | SPI_BR_SPR(5);
- } else if (clock >= F_BUS / 384) { c = SPI_BR_SPPR(5) | SPI_BR_SPR(5);
- } else if (clock >= F_BUS / 448) { c = SPI_BR_SPPR(6) | SPI_BR_SPR(5);
- } else if (clock >= F_BUS / 512) { c = SPI_BR_SPPR(7) | SPI_BR_SPR(5);
- } else if (clock >= F_BUS / 640) { c = SPI_BR_SPPR(4) | SPI_BR_SPR(6);
- } else /* F_BUS / 768 */ { c = SPI_BR_SPPR(5) | SPI_BR_SPR(6);
- }
- } else {
- for (uint32_t i=0; i<30; i++) {
- c = br_clock_table[i];
- if (clock >= F_BUS / br_div_table[i]) break;
- }
- }
- br[0] = c;
- if (__builtin_constant_p(clock)) {
- if (clock >= (F_PLL/2) / 2) { c = SPI_BR_SPPR(0) | SPI_BR_SPR(0);
- } else if (clock >= (F_PLL/2) / 4) { c = SPI_BR_SPPR(1) | SPI_BR_SPR(0);
- } else if (clock >= (F_PLL/2) / 6) { c = SPI_BR_SPPR(2) | SPI_BR_SPR(0);
- } else if (clock >= (F_PLL/2) / 8) { c = SPI_BR_SPPR(3) | SPI_BR_SPR(0);
- } else if (clock >= (F_PLL/2) / 10) { c = SPI_BR_SPPR(4) | SPI_BR_SPR(0);
- } else if (clock >= (F_PLL/2) / 12) { c = SPI_BR_SPPR(5) | SPI_BR_SPR(0);
- } else if (clock >= (F_PLL/2) / 14) { c = SPI_BR_SPPR(6) | SPI_BR_SPR(0);
- } else if (clock >= (F_PLL/2) / 16) { c = SPI_BR_SPPR(7) | SPI_BR_SPR(0);
- } else if (clock >= (F_PLL/2) / 20) { c = SPI_BR_SPPR(4) | SPI_BR_SPR(1);
- } else if (clock >= (F_PLL/2) / 24) { c = SPI_BR_SPPR(5) | SPI_BR_SPR(1);
- } else if (clock >= (F_PLL/2) / 28) { c = SPI_BR_SPPR(6) | SPI_BR_SPR(1);
- } else if (clock >= (F_PLL/2) / 32) { c = SPI_BR_SPPR(7) | SPI_BR_SPR(1);
- } else if (clock >= (F_PLL/2) / 40) { c = SPI_BR_SPPR(4) | SPI_BR_SPR(2);
- } else if (clock >= (F_PLL/2) / 48) { c = SPI_BR_SPPR(5) | SPI_BR_SPR(2);
- } else if (clock >= (F_PLL/2) / 56) { c = SPI_BR_SPPR(6) | SPI_BR_SPR(2);
- } else if (clock >= (F_PLL/2) / 64) { c = SPI_BR_SPPR(7) | SPI_BR_SPR(2);
- } else if (clock >= (F_PLL/2) / 80) { c = SPI_BR_SPPR(4) | SPI_BR_SPR(3);
- } else if (clock >= (F_PLL/2) / 96) { c = SPI_BR_SPPR(5) | SPI_BR_SPR(3);
- } else if (clock >= (F_PLL/2) / 112) { c = SPI_BR_SPPR(6) | SPI_BR_SPR(3);
- } else if (clock >= (F_PLL/2) / 128) { c = SPI_BR_SPPR(7) | SPI_BR_SPR(3);
- } else if (clock >= (F_PLL/2) / 160) { c = SPI_BR_SPPR(4) | SPI_BR_SPR(4);
- } else if (clock >= (F_PLL/2) / 192) { c = SPI_BR_SPPR(5) | SPI_BR_SPR(4);
- } else if (clock >= (F_PLL/2) / 224) { c = SPI_BR_SPPR(6) | SPI_BR_SPR(4);
- } else if (clock >= (F_PLL/2) / 256) { c = SPI_BR_SPPR(7) | SPI_BR_SPR(4);
- } else if (clock >= (F_PLL/2) / 320) { c = SPI_BR_SPPR(4) | SPI_BR_SPR(5);
- } else if (clock >= (F_PLL/2) / 384) { c = SPI_BR_SPPR(5) | SPI_BR_SPR(5);
- } else if (clock >= (F_PLL/2) / 448) { c = SPI_BR_SPPR(6) | SPI_BR_SPR(5);
- } else if (clock >= (F_PLL/2) / 512) { c = SPI_BR_SPPR(7) | SPI_BR_SPR(5);
- } else if (clock >= (F_PLL/2) / 640) { c = SPI_BR_SPPR(4) | SPI_BR_SPR(6);
- } else /* (F_PLL/2) / 768 */ { c = SPI_BR_SPPR(5) | SPI_BR_SPR(6);
- }
- } else {
- for (uint32_t i=0; i<30; i++) {
- c = br_clock_table[i];
- if (clock >= (F_PLL/2) / br_div_table[i]) break;
- }
- }
- br[1] = c;
- }
- static const uint8_t br_clock_table[30];
- static const uint16_t br_div_table[30];
- uint8_t c1, br[2];
- friend class SPIClass;
- };
-
-
- class SPIClass { // Teensy-LC
- public:
- static const uint8_t CNT_MISO_PINS = 2;
- static const uint8_t CNT_MMOSI_PINS = 2;
- static const uint8_t CNT_SCK_PINS = 2;
- static const uint8_t CNT_CS_PINS = 2;
- typedef struct {
- volatile uint32_t &clock_gate_register;
- uint32_t clock_gate_mask;
- uint8_t br_index;
- uint8_t tx_dma_channel;
- uint8_t rx_dma_channel;
- void (*dma_isr)();
- uint8_t miso_pin[CNT_MISO_PINS];
- uint32_t miso_mux[CNT_MISO_PINS];
- uint8_t mosi_pin[CNT_MMOSI_PINS];
- uint32_t mosi_mux[CNT_MMOSI_PINS];
- uint8_t sck_pin[CNT_SCK_PINS];
- uint32_t sck_mux[CNT_SCK_PINS];
- uint8_t cs_pin[CNT_CS_PINS];
- uint32_t cs_mux[CNT_CS_PINS];
- uint8_t cs_mask[CNT_CS_PINS];
- } SPI_Hardware_t;
- static const SPI_Hardware_t spi0_hardware;
- static const SPI_Hardware_t spi1_hardware;
- enum DMAState { notAllocated, idle, active, completed};
- public:
- constexpr SPIClass(uintptr_t myport, uintptr_t myhardware)
- : port_addr(myport), hardware_addr(myhardware) {
- }
- // Initialize the SPI library
- void begin();
-
- // If SPI is to used from within an interrupt, this function registers
- // that interrupt with the SPI library, so beginTransaction() can
- // prevent conflicts. The input interruptNumber is the number used
- // with attachInterrupt. If SPI is used from a different interrupt
- // (eg, a timer), interruptNumber should be 255.
- void usingInterrupt(uint8_t n) {
- if (n == 3 || n == 4) {
- usingInterrupt(IRQ_PORTA);
- } else if ((n >= 2 && n <= 15) || (n >= 20 && n <= 23)) {
- usingInterrupt(IRQ_PORTCD);
- }
- }
- void usingInterrupt(IRQ_NUMBER_t interruptName) {
- uint32_t n = (uint32_t)interruptName;
- if (n < NVIC_NUM_INTERRUPTS) interruptMask |= (1 << n);
- }
- void notUsingInterrupt(IRQ_NUMBER_t interruptName) {
- uint32_t n = (uint32_t)interruptName;
- if (n < NVIC_NUM_INTERRUPTS) interruptMask &= ~(1 << n);
- }
-
- // Before using SPI.transfer() or asserting chip select pins,
- // this function is used to gain exclusive access to the SPI bus
- // and configure the correct settings.
- void beginTransaction(SPISettings settings) {
- if (interruptMask) {
- __disable_irq();
- interruptSave = NVIC_ICER0 & interruptMask;
- NVIC_ICER0 = interruptSave;
- __enable_irq();
- }
- #ifdef SPI_TRANSACTION_MISMATCH_LED
- if (inTransactionFlag) {
- pinMode(SPI_TRANSACTION_MISMATCH_LED, OUTPUT);
- digitalWrite(SPI_TRANSACTION_MISMATCH_LED, HIGH);
- }
- inTransactionFlag = 1;
- #endif
- port().C1 = settings.c1;
- port().BR = settings.br[hardware().br_index];
- }
-
- // Write to the SPI bus (MOSI pin) and also receive (MISO pin)
- uint8_t transfer(uint8_t data) {
- port().DL = data;
- while (!(port().S & SPI_S_SPRF)) ; // wait
- return port().DL;
- }
- uint16_t transfer16(uint16_t data) {
- port().C2 = SPI_C2_SPIMODE;
- port().S;
- port().DL = data;
- port().DH = data >> 8;
- while (!(port().S & SPI_S_SPRF)) ; // wait
- uint16_t r = port().DL | (port().DH << 8);
- port().C2 = 0;
- port().S;
- return r;
- }
- void transfer(void *buf, size_t count) {
- if (count == 0) return;
- uint8_t *p = (uint8_t *)buf;
- while (!(port().S & SPI_S_SPTEF)) ; // wait
- port().DL = *p;
- while (--count > 0) {
- uint8_t out = *(p + 1);
- while (!(port().S & SPI_S_SPTEF)) ; // wait
- __disable_irq();
- port().DL = out;
- while (!(port().S & SPI_S_SPRF)) ; // wait
- uint8_t in = port().DL;
- __enable_irq();
- *p++ = in;
- }
- while (!(port().S & SPI_S_SPRF)) ; // wait
- *p = port().DL;
- }
-
- void setTransferWriteFill(uint8_t ch ) {_transferWriteFill = ch;}
- void transfer(const void * buf, void * retbuf, size_t count);
-
- // Asynch support (DMA )
- #ifdef SPI_HAS_TRANSFER_ASYNC
- bool transfer(const void *txBuffer, void *rxBuffer, size_t count, EventResponderRef event_responder);
-
- friend void _spi_dma_rxISR0(void);
- friend void _spi_dma_rxISR1(void);
- inline void dma_isr(void);
- #endif
-
- // After performing a group of transfers and releasing the chip select
- // signal, this function allows others to access the SPI bus
- void endTransaction(void) {
- #ifdef SPI_TRANSACTION_MISMATCH_LED
- if (!inTransactionFlag) {
- pinMode(SPI_TRANSACTION_MISMATCH_LED, OUTPUT);
- digitalWrite(SPI_TRANSACTION_MISMATCH_LED, HIGH);
- }
- inTransactionFlag = 0;
- #endif
- if (interruptMask) {
- NVIC_ISER0 = interruptSave;
- }
- }
-
- // Disable the SPI bus
- void end();
-
- // This function is deprecated. New applications should use
- // beginTransaction() to configure SPI settings.
- void setBitOrder(uint8_t bitOrder) {
- uint8_t c = port().C1 | SPI_C1_SPE;
- if (bitOrder == LSBFIRST) c |= SPI_C1_LSBFE;
- else c &= ~SPI_C1_LSBFE;
- port().C1 = c;
- }
-
- // This function is deprecated. New applications should use
- // beginTransaction() to configure SPI settings.
- void setDataMode(uint8_t dataMode) {
- uint8_t c = port().C1 | SPI_C1_SPE;
- if (dataMode & 0x04) c |= SPI_C1_CPHA;
- else c &= ~SPI_C1_CPHA;
- if (dataMode & 0x08) c |= SPI_C1_CPOL;
- else c &= ~SPI_C1_CPOL;
- port().C1 = c;
- }
-
- // This function is deprecated. New applications should use
- // beginTransaction() to configure SPI settings.
- void setClockDivider(uint8_t clockDiv) {
- unsigned int i = hardware().br_index;
- if (clockDiv == SPI_CLOCK_DIV2) {
- port().BR = (SPISettings(12000000, MSBFIRST, SPI_MODE0).br[i]);
- } else if (clockDiv == SPI_CLOCK_DIV4) {
- port().BR = (SPISettings(4000000, MSBFIRST, SPI_MODE0).br[i]);
- } else if (clockDiv == SPI_CLOCK_DIV8) {
- port().BR = (SPISettings(2000000, MSBFIRST, SPI_MODE0).br[i]);
- } else if (clockDiv == SPI_CLOCK_DIV16) {
- port().BR = (SPISettings(1000000, MSBFIRST, SPI_MODE0).br[i]);
- } else if (clockDiv == SPI_CLOCK_DIV32) {
- port().BR = (SPISettings(500000, MSBFIRST, SPI_MODE0).br[i]);
- } else if (clockDiv == SPI_CLOCK_DIV64) {
- port().BR = (SPISettings(250000, MSBFIRST, SPI_MODE0).br[i]);
- } else { /* clockDiv == SPI_CLOCK_DIV128 */
- port().BR = (SPISettings(125000, MSBFIRST, SPI_MODE0).br[i]);
- }
- }
-
- // These undocumented functions should not be used. SPI.transfer()
- // polls the hardware flag which is automatically cleared as the
- // AVR responds to SPI's interrupt
- void attachInterrupt() { }
- void detachInterrupt() { }
-
- // Teensy LC can use alternate pins for these 3 SPI signals.
- void setMOSI(uint8_t pin);
- void setMISO(uint8_t pin);
- void setSCK(uint8_t pin);
- // return true if "pin" has special chip select capability
- bool pinIsChipSelect(uint8_t pin);
- bool pinIsMOSI(uint8_t pin);
- bool pinIsMISO(uint8_t pin);
- bool pinIsSCK(uint8_t pin);
- // return true if both pin1 and pin2 have independent chip select capability
- bool pinIsChipSelect(uint8_t pin1, uint8_t pin2) { return false; }
- // configure a pin for chip select and return its SPI_MCR_PCSIS bitmask
- // setCS() is a special function, not intended for use from normal Arduino
- // programs/sketches. See the ILI3941_t3 library for an example.
- uint8_t setCS(uint8_t pin);
-
- private:
- KINETISL_SPI_t & port() { return *(KINETISL_SPI_t *)port_addr; }
- const SPI_Hardware_t & hardware() { return *(const SPI_Hardware_t *)hardware_addr; }
- uintptr_t port_addr;
- uintptr_t hardware_addr;
- uint32_t interruptMask = 0;
- uint32_t interruptSave = 0;
- uint8_t mosi_pin_index = 0;
- uint8_t miso_pin_index = 0;
- uint8_t sck_pin_index = 0;
- #ifdef SPI_TRANSACTION_MISMATCH_LED
- uint8_t inTransactionFlag = 0;
- #endif
- uint8_t _transferWriteFill = 0;
- #ifdef SPI_HAS_TRANSFER_ASYNC
- // DMA Support
- bool initDMAChannels();
-
- DMAState _dma_state = DMAState::notAllocated;
- uint32_t _dma_count_remaining = 0; // How many bytes left to output after current DMA completes
- DMAChannel *_dmaTX = nullptr;
- DMAChannel *_dmaRX = nullptr;
- EventResponder *_dma_event_responder = nullptr;
- #endif
- };
-
-
-
- /**********************************************************/
- /* 32 bit Teensy 4.x */
- /**********************************************************/
-
- #elif defined(__arm__) && defined(TEENSYDUINO) && (defined(__IMXRT1052__) || defined(__IMXRT1062__))
- #define SPI_ATOMIC_VERSION 1
-
- //#include "debug/printf.h"
-
-
- class SPISettings {
- public:
- SPISettings(uint32_t clockIn, uint8_t bitOrderIn, uint8_t dataModeIn) : _clock(clockIn) {
- init_AlwaysInline(bitOrderIn, dataModeIn);
- }
-
- SPISettings() : _clock(4000000) {
- init_AlwaysInline(MSBFIRST, SPI_MODE0);
- }
- private:
- void init_AlwaysInline(uint8_t bitOrder, uint8_t dataMode)
- __attribute__((__always_inline__)) {
- tcr = LPSPI_TCR_FRAMESZ(7); // TCR has polarity and bit order too
-
- // handle LSB setup
- if (bitOrder == LSBFIRST) tcr |= LPSPI_TCR_LSBF;
-
- // Handle Data Mode
- if (dataMode & 0x08) tcr |= LPSPI_TCR_CPOL;
-
- // Note: On T3.2 when we set CPHA it also updated the timing. It moved the
- // PCS to SCK Delay Prescaler into the After SCK Delay Prescaler
- if (dataMode & 0x04) tcr |= LPSPI_TCR_CPHA;
- }
-
- inline uint32_t clock() {return _clock;}
-
- uint32_t _clock;
- uint32_t tcr; // transmit command, pg 2664 (RT1050 ref, rev 2)
- friend class SPIClass;
- };
-
- class SPIClass { // Teensy 4
- public:
- static const uint8_t CNT_MISO_PINS = 1;
- static const uint8_t CNT_MOSI_PINS = 1;
- static const uint8_t CNT_SCK_PINS = 1;
- static const uint8_t CNT_CS_PINS = 1;
- typedef struct {
- volatile uint32_t &clock_gate_register;
- const uint32_t clock_gate_mask;
- uint8_t tx_dma_channel;
- uint8_t rx_dma_channel;
- void (*dma_rxisr)();
- const uint8_t miso_pin[CNT_MISO_PINS];
- const uint32_t miso_mux[CNT_MISO_PINS];
- const uint8_t mosi_pin[CNT_MOSI_PINS];
- const uint32_t mosi_mux[CNT_MOSI_PINS];
- const uint8_t sck_pin[CNT_SCK_PINS];
- const uint32_t sck_mux[CNT_SCK_PINS];
- const uint8_t cs_pin[CNT_CS_PINS];
- const uint32_t cs_mux[CNT_CS_PINS];
-
- volatile uint32_t &sck_select_input_register;
- volatile uint32_t &sdi_select_input_register;
- volatile uint32_t &sdo_select_input_register;
- volatile uint32_t &pcs0_select_input_register;
- const uint8_t sck_select_val;
- const uint8_t sdi_select_val;
- const uint8_t sdo_select_val;
- const uint8_t pcs0_select_val;
- } SPI_Hardware_t;
- static const SPI_Hardware_t spiclass_lpspi4_hardware;
- #if defined(__IMXRT1062__)
- static const SPI_Hardware_t spiclass_lpspi3_hardware;
- static const SPI_Hardware_t spiclass_lpspi1_hardware;
- #endif
- public:
- constexpr SPIClass(uintptr_t myport, uintptr_t myhardware)
- : port_addr(myport), hardware_addr(myhardware) {
- }
- // constexpr SPIClass(IMXRT_LPSPI_t *myport, const SPI_Hardware_t *myhardware)
- // : port(myport), hardware(myhardware) {
- // }
- // Initialize the SPI library
- void begin();
-
- // If SPI is to used from within an interrupt, this function registers
- // that interrupt with the SPI library, so beginTransaction() can
- // prevent conflicts. The input interruptNumber is the number used
- // with attachInterrupt. If SPI is used from a different interrupt
- // (eg, a timer), interruptNumber should be 255.
- void usingInterrupt(uint8_t n) {
- if (n >= CORE_NUM_DIGITAL) return;
- volatile uint32_t *gpio = portOutputRegister(n);
- switch((uint32_t)gpio) {
- case (uint32_t)&GPIO1_DR:
- usingInterrupt(IRQ_GPIO1_0_15);
- usingInterrupt(IRQ_GPIO1_16_31);
- break;
- case (uint32_t)&GPIO2_DR:
- usingInterrupt(IRQ_GPIO2_0_15);
- usingInterrupt(IRQ_GPIO2_16_31);
- break;
- case (uint32_t)&GPIO3_DR:
- usingInterrupt(IRQ_GPIO3_0_15);
- usingInterrupt(IRQ_GPIO3_16_31);
- break;
- case (uint32_t)&GPIO4_DR:
- usingInterrupt(IRQ_GPIO4_0_15);
- usingInterrupt(IRQ_GPIO4_16_31);
- break;
- }
- }
- void usingInterrupt(IRQ_NUMBER_t interruptName);
- void notUsingInterrupt(IRQ_NUMBER_t interruptName);
-
- // Before using SPI.transfer() or asserting chip select pins,
- // this function is used to gain exclusive access to the SPI bus
- // and configure the correct settings.
- void beginTransaction(SPISettings settings) {
- if (interruptMasksUsed) {
- __disable_irq();
- if (interruptMasksUsed & 0x01) {
- interruptSave[0] = NVIC_ICER0 & interruptMask[0];
- NVIC_ICER0 = interruptSave[0];
- }
- if (interruptMasksUsed & 0x02) {
- interruptSave[1] = NVIC_ICER1 & interruptMask[1];
- NVIC_ICER1 = interruptSave[1];
- }
- if (interruptMasksUsed & 0x04) {
- interruptSave[2] = NVIC_ICER2 & interruptMask[2];
- NVIC_ICER2 = interruptSave[2];
- }
- if (interruptMasksUsed & 0x08) {
- interruptSave[3] = NVIC_ICER3 & interruptMask[3];
- NVIC_ICER3 = interruptSave[3];
- }
- if (interruptMasksUsed & 0x10) {
- interruptSave[4] = NVIC_ICER4 & interruptMask[4];
- NVIC_ICER4 = interruptSave[4];
- }
- __enable_irq();
- }
- #ifdef SPI_TRANSACTION_MISMATCH_LED
- if (inTransactionFlag) {
- pinMode(SPI_TRANSACTION_MISMATCH_LED, OUTPUT);
- digitalWrite(SPI_TRANSACTION_MISMATCH_LED, HIGH);
- }
- inTransactionFlag = 1;
- #endif
-
- //printf("trans\n");
- if (settings.clock() != _clock) {
- static const uint32_t clk_sel[4] = {664615384, // PLL3 PFD1
- 720000000, // PLL3 PFD0
- 528000000, // PLL2
- 396000000}; // PLL2 PFD2
-
- // First save away the new settings..
- _clock = settings.clock();
-
- uint32_t cbcmr = CCM_CBCMR;
- uint32_t clkhz = clk_sel[(cbcmr >> 4) & 0x03] / (((cbcmr >> 26 ) & 0x07 ) + 1); // LPSPI peripheral clock
-
- uint32_t d, div;
- d = _clock ? clkhz/_clock : clkhz;
-
- if (d && clkhz/d > _clock) d++;
- if (d > 257) d= 257; // max div
- if (d > 2) {
- div = d-2;
- } else {
- div =0;
- }
-
- _ccr = LPSPI_CCR_SCKDIV(div) | LPSPI_CCR_DBT(div/2);
-
- }
- //Serial.printf("SPI.beginTransaction CCR:%x TCR:%x\n", _ccr, settings.tcr);
- port().CR = 0;
- port().CFGR1 = LPSPI_CFGR1_MASTER | LPSPI_CFGR1_SAMPLE;
- port().CCR = _ccr;
- port().TCR = settings.tcr;
- port().CR = LPSPI_CR_MEN;
-
- }
-
- // Write to the SPI bus (MOSI pin) and also receive (MISO pin)
- uint8_t transfer(uint8_t data) {
- // TODO: check for space in fifo?
- port().TDR = data;
- while (1) {
- uint32_t fifo = (port().FSR >> 16) & 0x1F;
- if (fifo > 0) return port().RDR;
- }
- //port().SR = SPI_SR_TCF;
- //port().PUSHR = data;
- //while (!(port().SR & SPI_SR_TCF)) ; // wait
- //return port().POPR;
- }
- uint16_t transfer16(uint16_t data) {
- uint32_t tcr = port().TCR;
- port().TCR = (tcr & 0xfffff000) | LPSPI_TCR_FRAMESZ(15); // turn on 16 bit mode
- port().TDR = data; // output 16 bit data.
- while ((port().RSR & LPSPI_RSR_RXEMPTY)) ; // wait while the RSR fifo is empty...
- port().TCR = tcr; // restore back
- return port().RDR;
- }
-
- void inline transfer(void *buf, size_t count) {transfer(buf, buf, count);}
- void setTransferWriteFill(uint8_t ch ) {_transferWriteFill = ch;}
- void transfer(const void * buf, void * retbuf, size_t count);
-
- // Asynch support (DMA )
- #ifdef SPI_HAS_TRANSFER_ASYNC
- bool transfer(const void *txBuffer, void *rxBuffer, size_t count, EventResponderRef event_responder);
-
- friend void _spi_dma_rxISR0(void);
- inline void dma_rxisr(void);
- #endif
-
-
- // After performing a group of transfers and releasing the chip select
- // signal, this function allows others to access the SPI bus
- void endTransaction(void) {
- #ifdef SPI_TRANSACTION_MISMATCH_LED
- if (!inTransactionFlag) {
- pinMode(SPI_TRANSACTION_MISMATCH_LED, OUTPUT);
- digitalWrite(SPI_TRANSACTION_MISMATCH_LED, HIGH);
- }
- inTransactionFlag = 0;
- #endif
- if (interruptMasksUsed) {
- if (interruptMasksUsed & 0x01) NVIC_ISER0 = interruptSave[0];
- if (interruptMasksUsed & 0x02) NVIC_ISER1 = interruptSave[1];
- if (interruptMasksUsed & 0x04) NVIC_ISER2 = interruptSave[2];
- if (interruptMasksUsed & 0x08) NVIC_ISER3 = interruptSave[3];
- if (interruptMasksUsed & 0x10) NVIC_ISER4 = interruptSave[4];
- }
- //Serial.printf("SPI.endTransaction CCR:%x TCR:%x\n", port().CCR, port().TCR);
- }
-
- // Disable the SPI bus
- void end();
-
- // This function is deprecated. New applications should use
- // beginTransaction() to configure SPI settings.
- void setBitOrder(uint8_t bitOrder);
-
- // This function is deprecated. New applications should use
- // beginTransaction() to configure SPI settings.
- void setDataMode(uint8_t dataMode);
-
- // This function is deprecated. New applications should use
- // beginTransaction() to configure SPI settings.
- void setClockDivider(uint8_t clockDiv) {
- if (clockDiv == SPI_CLOCK_DIV2) {
- setClockDivider_noInline(12000000);
- } else if (clockDiv == SPI_CLOCK_DIV4) {
- setClockDivider_noInline(4000000);
- } else if (clockDiv == SPI_CLOCK_DIV8) {
- setClockDivider_noInline(2000000);
- } else if (clockDiv == SPI_CLOCK_DIV16) {
- setClockDivider_noInline(1000000);
- } else if (clockDiv == SPI_CLOCK_DIV32) {
- setClockDivider_noInline(500000);
- } else if (clockDiv == SPI_CLOCK_DIV64) {
- setClockDivider_noInline(250000);
- } else { /* clockDiv == SPI_CLOCK_DIV128 */
- setClockDivider_noInline(125000);
- }
- }
- void setClockDivider_noInline(uint32_t clk);
-
- // These undocumented functions should not be used. SPI.transfer()
- // polls the hardware flag which is automatically cleared as the
- // AVR responds to SPI's interrupt
- void attachInterrupt() { }
- void detachInterrupt() { }
-
- // Teensy 3.x can use alternate pins for these 3 SPI signals.
- void setMOSI(uint8_t pin);
- void setMISO(uint8_t pin);
- void setSCK(uint8_t pin);
-
- // return true if "pin" has special chip select capability
- uint8_t pinIsChipSelect(uint8_t pin);
- bool pinIsMOSI(uint8_t pin);
- bool pinIsMISO(uint8_t pin);
- bool pinIsSCK(uint8_t pin);
- // return true if both pin1 and pin2 have independent chip select capability
- bool pinIsChipSelect(uint8_t pin1, uint8_t pin2);
- // configure a pin for chip select and return its SPI_MCR_PCSIS bitmask
- // setCS() is a special function, not intended for use from normal Arduino
- // programs/sketches. See the ILI3941_t3 library for an example.
- uint8_t setCS(uint8_t pin);
-
- private:
- private:
- IMXRT_LPSPI_t & port() { return *(IMXRT_LPSPI_t *)port_addr; }
- const SPI_Hardware_t & hardware() { return *(const SPI_Hardware_t *)hardware_addr; }
- uintptr_t port_addr;
- uintptr_t hardware_addr;
-
- uint32_t _clock = 0;
- uint32_t _ccr = 0;
-
- //KINETISK_SPI_t & port() { return *(KINETISK_SPI_t *)port_addr; }
- // IMXRT_LPSPI_t * const port;
- // const SPI_Hardware_t * const hardware;
- void updateCTAR(uint32_t ctar);
- uint8_t miso_pin_index = 0;
- uint8_t mosi_pin_index = 0;
- uint8_t sck_pin_index = 0;
- uint8_t interruptMasksUsed = 0;
- uint32_t interruptMask[(NVIC_NUM_INTERRUPTS+31)/32] = {};
- uint32_t interruptSave[(NVIC_NUM_INTERRUPTS+31)/32] = {};
- #ifdef SPI_TRANSACTION_MISMATCH_LED
- uint8_t inTransactionFlag = 0;
- #endif
-
- uint8_t _transferWriteFill = 0;
-
- // DMA Support
- #ifdef SPI_HAS_TRANSFER_ASYNC
- bool initDMAChannels();
- enum DMAState { notAllocated, idle, active, completed};
- enum {MAX_DMA_COUNT=32767};
- DMAState _dma_state = DMAState::notAllocated;
- uint32_t _dma_count_remaining = 0; // How many bytes left to output after current DMA completes
- DMAChannel *_dmaTX = nullptr;
- DMAChannel *_dmaRX = nullptr;
- EventResponder *_dma_event_responder = nullptr;
- #endif
- };
-
-
-
-
-
-
-
-
-
-
- #endif
-
-
-
- extern SPIClass SPI;
- #if defined(__MKL26Z64__)
- extern SPIClass SPI1;
- #endif
- #if defined(__MK64FX512__) || defined(__MK66FX1M0__) || defined(__IMXRT1062__)
- extern SPIClass SPI1;
- extern SPIClass SPI2;
- #endif
- #endif
|