/********************************************************************* * Flowcode CAL SPI File * * File: PIC16BIT_CAL_SPI.c * * (c) 2011 Matrix Multimedia Ltd. * http://www.matrixmultimedia.com * * Software License Agreement * * The software supplied herewith by Matrix Multimedia Ltd (the * “Company”) for its Flowcode graphical programming language is * intended and supplied to you, the Company’s customer, for use * solely and exclusively on the Company's products. The software * is owned by the Company, and is protected under applicable * copyright laws. All rights are reserved. Any use in violation * of the foregoing restrictions may subject the user to criminal * sanctions under applicable laws, as well as to civil liability * for the breach of the terms and conditions of this licence. * * THIS SOFTWARE IS PROVIDED IN AN “AS IS” CONDITION. NO WARRANTIES, * WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING, BUT NOT LIMITED * TO, IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A * PARTICULAR PURPOSE APPLY TO THIS SOFTWARE. THE COMPANY SHALL NOT, * IN ANY CIRCUMSTANCES, BE LIABLE FOR SPECIAL, INCIDENTAL OR * CONSEQUENTIAL DAMAGES, FOR ANY REASON WHATSOEVER. * * Changelog: * * date | by | description * -------+----+----------------------------------------------------- * 090911 | BR | Created * 050312 | BR | Updated to v5.1 CAL Schema * 200712 | BR | Added new macro to configure prescaler on the fly * 090812 | ST | Fixed initial clock polarity setting * 090812 | ST | Added comments to explain the BMODE settings and Master_Byte function * 170812 | BR | Removed unneeded #endif statements * 070912 | BR | Changed Remappable Functionality to be loaded from FCD * 110912 | BR | Added minor mod for SPI channel 2,3 and 4 for MX_SPICON devices * 140912 | BR | Chaned prescaler function to tie in with the FAT component * 181012 | LM | Dummy read to clear flags * 210613 | BR | Bug fix defines mod for HW SPI Prescaler - also related mods to init * 030713 | LM | Standard API calls * 280813 | LM | Removed MX_SPI_x define checks * 011214 | LM | dsPIC Manual: The SMP bit must be set only after setting the MSTEN bit. */ //When using hardware SPI channels override port and pin conns with FCD conn definitions //Only overwrite CS pin defines when using SPI in slave mode on a hardware channel //Also sort out postscale and prescale options for hardware channels //Setup Definitions #define MX_SPI_REF_X CAL_APPEND(MX_SPI_REF, MX_SPI_NUM) #define MX_SPI_CHANNEL_X CAL_APPEND(MX_SPI_CHANNEL_, MX_SPI_NUM) #define MX_SPI_MOSI_PIN_X CAL_APPEND(MX_SPI_MOSI_PIN_, MX_SPI_NUM) #define MX_SPI_MOSI_PORT_X CAL_APPEND(MX_SPI_MOSI_PORT_, MX_SPI_NUM) #define MX_SPI_MOSI_TRIS_X CAL_APPEND(MX_SPI_MOSI_TRIS_, MX_SPI_NUM) #define MX_SPI_MISO_PIN_X CAL_APPEND(MX_SPI_MISO_PIN_, MX_SPI_NUM) #define MX_SPI_MISO_PORT_X CAL_APPEND(MX_SPI_MISO_PORT_, MX_SPI_NUM) #define MX_SPI_MISO_TRIS_X CAL_APPEND(MX_SPI_MISO_TRIS_, MX_SPI_NUM) #define MX_SPI_SCK_PIN_X CAL_APPEND(MX_SPI_SCK_PIN_, MX_SPI_NUM) #define MX_SPI_SCK_PORT_X CAL_APPEND(MX_SPI_SCK_PORT_, MX_SPI_NUM) #define MX_SPI_SCK_TRIS_X CAL_APPEND(MX_SPI_SCK_TRIS_, MX_SPI_NUM) #define MX_SPI_CS_PIN_X CAL_APPEND(MX_SPI_CS_PIN_, MX_SPI_NUM) #define MX_SPI_CS_PORT_X CAL_APPEND(MX_SPI_CS_PORT_, MX_SPI_NUM) #define MX_SPI_CS_TRIS_X CAL_APPEND(MX_SPI_CS_TRIS_, MX_SPI_NUM) #define MX_SPI_BMODE_X CAL_APPEND(MX_SPI_BMODE_, MX_SPI_NUM) #define MX_SPI_PR_SCALE_X CAL_APPEND(MX_SPI_PR_SCALE_, MX_SPI_NUM) #define MX_SPI_PO_SCALE_X CAL_APPEND(MX_SPI_PO_SCALE_, MX_SPI_NUM) #define MX_SPI_INT_X CAL_APPEND(MX_SPI_INT_, MX_SPI_NUM) #define MX_SPI_REMAPPABLE_X CAL_APPEND(MX_SPI_REMAPPABLE_, MX_SPI_NUM) #define MX_SPI_REMAPPABLE_SCK_X CAL_APPEND(MX_SPI_REMAPPABLE_SCK_, MX_SPI_NUM) #define MX_SPI_MISO_RPINR_X CAL_APPEND(MX_SPI_MISO_RPINR_, MX_SPI_NUM) #define MX_SPI_MISO_RP_X CAL_APPEND(MX_SPI_MISO_RP_, MX_SPI_NUM) #define MX_SPI_MOSI_RPOR_X CAL_APPEND(MX_SPI_MOSI_RPOR_, MX_SPI_NUM) #define MX_SPI_MOSI_SDO_X CAL_APPEND(MX_SPI_MOSI_SDO_, MX_SPI_NUM) #define MX_SPI_CLK_RPOR_X CAL_APPEND(MX_SPI_CLK_RPOR_, MX_SPI_NUM) #define MX_SPI_CLK_SCK_X CAL_APPEND(MX_SPI_CLK_SCK_, MX_SPI_NUM) //Function Prototypes CALFUNCTION(void, FC_CAL_SPI_Master_Init_, (void)); CALFUNCTION(void, FC_CAL_SPI_Master_Uninit_, (void)); CALFUNCTION(MX_UINT8, FC_CAL_SPI_Master_Byte_, (MX_UINT8 DataOut)); CALFUNCTION(void, FC_CAL_SPI_SetPrescaler_, (MX_UINT8 Prescaler)); CALFUNCTION(void, FC_CAL_SPI_Slave_Init_, (void)); CALFUNCTION(void, FC_CAL_SPI_Slave_Uninit_, (void)); CALFUNCTION(void, FC_CAL_SPI_Slave_SetTxData_, (MX_UINT8 Data)); CALFUNCTION(MX_UINT8, FC_CAL_SPI_Slave_GetRxData_, (void)); #ifdef MX_SPI1CON #define SPI1CON1 SPI1CON #define SPI1CON1bits SPI1CONbits #define SPI2CON1 SPI2CON #define SPI2CON1bits SPI2CONbits #define SPI3CON1 SPI3CON #define SPI3CON1bits SPI3CONbits #define SPI4CON1 SPI4CON #define SPI4CON1bits SPI4CONbits #define SPI5CON1 SPI5CON #define SPI5CON1bits SPI5CONbits #define SPI6CON1 SPI6CON #define SPI6CON1bits SPI6CONbits #endif #if (MX_SPI_CHANNEL_X == 0) MX_UINT8 MX_PRESCALE_VAR_X = (MX_SPI_PR_SCALE_X / 2) - 1; #endif //Bus Mode - Bit0=CKP=CPOL, Bit1=CKE=!CPHA, Bit2=CSMP //CKP=CPOL - Clock Polarity - Idle State of the clock 0=0, 1=1 //CKE=CPHA - Clock Phase - Clock Edge 0=leading edge, 1=trailing edge //CSMP - Input Data Bit Sample Phase //CRAT - SPI Clock Rate 0=1/4, 1=1/16, 2=1/64 // There are 4 SPI clock modes as follows: // // SPI Mode | CKP (CPOL) | CKE (CPHA) | BMODE | Explanation //----------+------------+--------------------+------------------------------------------------ // 1 (0,1) | 0 (0) | 0 (1) | xx00 | idle low; data out on falling/trailing edge // 3 (1,1) | 1 (1) | 0 (1) | xx01 | idle high; data out on rising/trailing edge // 0 (0,0) | 0 (0) | 1 (0) | xx10 | idle low; data out on rising/leading edge // 2 (1,0) | 1 (1) | 1 (0) | xx11 | idle high; data out on falling/leading edge //----------+------------+--------------------------------------------------------------------- // // So: // BMODE & 0x01 = CKP = CPOL // BMODE & 0x02 = CKE = !CPHA CALFUNCTION(void, FC_CAL_SPI_Master_Init_, (void)) { FC_CAL_Bit_High_DDR (MX_SPI_MOSI_PORT_X, MX_SPI_MOSI_TRIS_X, MX_SPI_MOSI_PIN_X); // MOSI pin is default high FC_CAL_Bit_In_DDR (MX_SPI_MISO_PORT_X, MX_SPI_MISO_TRIS_X, MX_SPI_MISO_PIN_X); // MISO pin is a input #if (MX_SPI_BMODE_X & 0x01) FC_CAL_Bit_High_DDR (MX_SPI_SCK_PORT_X, MX_SPI_SCK_TRIS_X, MX_SPI_SCK_PIN_X); // Clock pin is default high #else FC_CAL_Bit_Low_DDR (MX_SPI_SCK_PORT_X, MX_SPI_SCK_TRIS_X, MX_SPI_SCK_PIN_X); // Clock pin is default low #endif #if (MX_SPI_REMAPPABLE_X == 1) MX_SPI_MISO_RPINR_X = MX_SPI_MISO_RP_X; MX_SPI_MOSI_RPOR_X = MX_SPI_MOSI_SDO_X; #if (MX_SPI_REMAPPABLE_SCK_X != 1) //1 == No Clock Available MX_SPI_CLK_RPOR_X = MX_SPI_CLK_SCK_X; //For some reason the SPI clock is not included in the remap on PIC32MX and PIC32MZ but is there on PIC32MM #endif #endif #if (MX_SPI_CHANNEL_X == 1) if (MX_SPI_BMODE_X & 0x01) //Clock Polarity SPI1CON1 |= 0x40; else SPI1CON1 &= 0xFFFFFFBF; if (MX_SPI_BMODE_X & 0x02) //Clock Edge SPI1CON1 |= 0x0100; else SPI1CON1 &= 0xFFFFFEFF; if (MX_SPI_BMODE_X & 0x04) //Sample Phase SPI1CON1 |= 0x0200; else SPI1CON1 &= 0xFFFFFDFF; SPI1BRG = MX_SPI_PR_SCALE_X; //Set Baud Rate SPI1CON1 |= 0x20; //Master Mode SPI1STAT &= 0xFFFFFFBF; SPI1CON1 &= 0xFFFFF7FF; SPI1CON1 |= 0x8000; //SPI On #endif #if (MX_SPI_CHANNEL_X == 2) if (MX_SPI_BMODE_X & 0x01) //Clock Polarity SPI2CON1 |= 0x40; else SPI2CON1 &= 0xFFFFFFBF; if (MX_SPI_BMODE_X & 0x02) //Clock Edge SPI2CON1 |= 0x0100; else SPI2CON1 &= 0xFFFFFEFF; if (MX_SPI_BMODE_X & 0x04) //Sample Phase SPI2CON1 |= 0x0200; else SPI2CON1 &= 0xFFFFFDFF; SPI2BRG = MX_SPI_PR_SCALE_X; //Set Baud Rate SPI2CON1 |= 0x20; //Master Mode SPI2STAT &= 0xFFFFFFBF; SPI2CON1 &= 0xFFFFF7FF; SPI2CON1 |= 0x8000; //SPI On #endif #if (MX_SPI_CHANNEL_X == 3) if (MX_SPI_BMODE_X & 0x01) //Clock Polarity SPI3CON1 |= 0x40; else SPI3CON1 &= 0xFFFFFFBF; if (MX_SPI_BMODE_X & 0x02) //Clock Edge SPI3CON1 |= 0x0100; else SPI3CON1 &= 0xFFFFFEFF; if (MX_SPI_BMODE_X & 0x04) //Sample Phase SPI3CON1 |= 0x0200; else SPI3CON1 &= 0xFFFFFDFF; SPI3BRG = MX_SPI_PR_SCALE_X; //Set Baud Rate SPI3CON1 |= 0x20; //Master Mode SPI3STAT &= 0xFFFFFFBF; SPI3CON1 &= 0xFFFFF7FF; SPI3CON1 |= 0x8000; //SPI On #endif #if (MX_SPI_CHANNEL_X == 4) if (MX_SPI_BMODE_X & 0x01) //Clock Polarity SPI4CON1 |= 0x40; else SPI4CON1 &= 0xFFFFFFBF; if (MX_SPI_BMODE_X & 0x02) //Clock Edge SPI4CON1 |= 0x0100; else SPI4CON1 &= 0xFFFFFEFF; if (MX_SPI_BMODE_X & 0x04) //Sample Phase SPI4CON1 |= 0x0200; else SPI4CON1 &= 0xFFFFFDFF; SPI4BRG = MX_SPI_PR_SCALE_X; //Set Baud Rate SPI4CON1 |= 0x20; //Master Mode SPI4STAT &= 0xFFFFFFBF; SPI4CON1 &= 0xFFFFF7FF; SPI4CON1 |= 0x8000; //SPI On #endif #if (MX_SPI_CHANNEL_X == 5) if (MX_SPI_BMODE_X & 0x01) //Clock Polarity SPI5CON1 |= 0x40; else SPI5CON1 &= 0xFFFFFFBF; if (MX_SPI_BMODE_X & 0x02) //Clock Edge SPI5CON1 |= 0x0100; else SPI5CON1 &= 0xFFFFFEFF; if (MX_SPI_BMODE_X & 0x04) //Sample Phase SPI5CON1 |= 0x0200; else SPI5CON1 &= 0xFFFFFDFF; SPI5BRG = MX_SPI_PR_SCALE_X; //Set Baud Rate SPI5CON1 |= 0x20; //Master Mode SPI5STAT &= 0xFFFFFFBF; SPI5CON1 &= 0xFFFFF7FF; SPI5CON1 |= 0x8000; //SPI On #endif #if (MX_SPI_CHANNEL_X == 6) if (MX_SPI_BMODE_X & 0x01) //Clock Polarity SPI6CON1 |= 0x40; else SPI6CON1 &= 0xFFFFFFBF; if (MX_SPI_BMODE_X & 0x02) //Clock Edge SPI6CON1 |= 0x0100; else SPI6CON1 &= 0xFFFFFEFF; if (MX_SPI_BMODE_X & 0x04) //Sample Phase SPI6CON1 |= 0x0200; else SPI6CON1 &= 0xFFFFFDFF; SPI6BRG = MX_SPI_PR_SCALE_X; //Set Baud Rate SPI6CON1 |= 0x20; //Master Mode SPI6STAT &= 0xFFFFFFBF; SPI6CON1 &= 0xFFFFF7FF; SPI6CON1 |= 0x8000; //SPI On #endif } CALFUNCTION(void, FC_CAL_SPI_Master_Uninit_, (void)) { #if (MX_SPI_CHANNEL_X == 1) SPI1CON1 = 0xFFFF7FFF; //SPI Off #endif #if (MX_SPI_CHANNEL_X == 2) SPI2CON1 = 0xFFFF7FFF; //SPI Off #endif #if (MX_SPI_CHANNEL_X == 3) SPI3CON1 = 0xFFFF7FFF; //SPI Off #endif #if (MX_SPI_CHANNEL_X == 4) SPI4CON1 = 0xFFFF7FFF; //SPI Off #endif #if (MX_SPI_CHANNEL_X == 5) SPI5CON1 = 0xFFFF7FFF; //SPI Off #endif #if (MX_SPI_CHANNEL_X == 6) SPI6CON1 = 0xFFFF7FFF; //SPI Off #endif //Reset Pins to Inputs FC_CAL_Bit_In_DDR (MX_SPI_MOSI_PORT_X, MX_SPI_MOSI_TRIS_X, MX_SPI_MOSI_PIN_X); FC_CAL_Bit_In_DDR (MX_SPI_MISO_PORT_X, MX_SPI_MISO_TRIS_X, MX_SPI_MISO_PIN_X); FC_CAL_Bit_In_DDR (MX_SPI_SCK_PORT_X, MX_SPI_SCK_TRIS_X, MX_SPI_SCK_PIN_X); } CALFUNCTION(MX_UINT8, FC_CAL_SPI_Master_Byte_, (MX_UINT8 DataOut)) { MX_UINT8 retVal = 0; #if (MX_SPI_CHANNEL_X == 0) MX_UINT8 i, idx; for (idx = 0; idx < 8; idx++) { retVal = retVal << 1; //If mode 1 or 3, switch the clock #if ((MX_SPI_BMODE_X & 0x02) == 0x00) //CKE = 0; (mode 1 or 3) Set SCK active before data #if ((MX_SPI_BMODE_X & 0x01) == 0x00) FC_CAL_Bit_High(MX_SPI_SCK_PORT_X, MX_SPI_SCK_PIN_X); //CKP = 0; (mode 1) #else FC_CAL_Bit_Low(MX_SPI_SCK_PORT_X, MX_SPI_SCK_PIN_X); //CKP = 1; (mode 3) #endif #endif //Data setup if (DataOut & 0x80) //Test Data bit FC_CAL_Bit_High(MX_SPI_MOSI_PORT_X, MX_SPI_MOSI_PIN_X); //Set SDO bit else FC_CAL_Bit_Low (MX_SPI_MOSI_PORT_X, MX_SPI_MOSI_PIN_X); //Clear SDO bit //Clock delay for (i=0; i