The SPI module is available with a number of the dsPIC30/33 and PIC24 MCUs. The mikroC PRO for dsPIC30/33 and PIC24 provides a library (driver) for working with mikroElektronika's CANSPI Add-on boards (with MCP2515 or MCP2510) via SPI interface.

In the mikroC PRO for dsPIC30/33 and PIC24, each routine of the CAN library has its own CANSPI counterpart with identical syntax. For more information on Controller Area Network, consult the CAN Library. Note that an effective communication speed depends on SPI and certainly is slower than "real" CAN.

Data transfer rates depend on distance. For example, 1 Mbit/s can be achieved at network lengths below 40m while 250 Kbit/s can be achieved at network lengths below 250m. The greater distance the lower maximum bitrate that can be achieved. The lowest bitrate defined by the standard is 200Kbit/s. Cables used are shielded twisted pairs.

CAN supports two message formats:

• Standard format, with 11 identifier bits and
• Extended format, with 29 identifier bits

  Important :

• Consult the CAN standard about CAN bus termination resistance.
• An effective CANSPI communication speed depends on SPI and certainly is slower than “real” CAN.
• The library uses the SPI module for communication. User must initialize appropriate SPI module before using the CANSPI Library.
• For MCUs with multiple SPI modules it is possible to initialize both of them and then switch by using the SPI_Set_Active routine.
• Number of SPI modules per MCU differs from chip to chip. Please, read the appropriate datasheet before utilizing this library.
• CANSPI module refers to mikroElektronika's CANSPI Add-on board connected to SPI module of MCU.

Library Dependency Tree

External dependencies of CANSPI Library

Library Routines

• CANSPISetOperationMode
• CANSPIGetOperationMode
• CANSPIInitialize
• CANSPISetBaudRate
• CANSPISetMask
• CANSPISetFilter
• CANSPIRead
• CANSPIWrite

CANSPISetOperationMode

// set the CANSPI module into configuration mode (wait inside CANSPISetOperationMode until this mode is set)
CANSPISetOperationMode(_CANSPI_MODE_CONFIG, 0xFF);

CANSPIGetOperationMode

// check whether the CANSPI module is in Normal mode and if it is do something.
if (CANSPIGetOperationMode() == _CANSPI_MODE_NORMAL) {
  ...
}

CANSPIInitialize

// CANSPI module connections
sbit CanSpi_CS  at  RF0_bit;
sbit CanSpi_CS_Direction  at  TRISF0_bit;
sbit CanSpi_Rst at  RF1_bit;
sbit CanSpi_Rst_Direction at  TRISF1_bit;
// End CANSPI module connections

// initialize the CANSPI module with the appropriate baud rate and message acceptance flags along with the sampling rules
char CANSPI_Init_Flags;
  ...  
  CANSPI_Init_Flags = _CANSPI_CONFIG_SAMPLE_THRICE &  // form value to be used
                      _CANSPI_CONFIG_PHSEG2_PRG_ON &  // with CANSPIInitialize
                      _CANSPI_CONFIG_XTD_MSG &
                      _CANSPI_CONFIG_DBL_BUFFER_ON &
                      _CANSPI_CONFIG_VALID_XTD_MSG;
  ...
  SPI1_Init();                               // initialize SPI1 module
  CANSPIInitialize(1,3,3,3,1,CANSPI_Init_Flags);   // initialize external CANSPI module

CANSPISetBaudRate

// set required baud rate and sampling rules
char CANSPI_CONFIG_FLAGS;
...  
CANSPISetOperationMode(_CANSPI_MODE_CONFIG,0xFF);           // set CONFIGURATION mode (CANSPI module must be in config mode for baud rate settings)
CANSPI_CONFIG_FLAGS = _CANSPI_CONFIG_SAMPLE_THRICE &
                   _CANSPI_CONFIG_PHSEG2_PRG_ON &
                   _CANSPI_CONFIG_STD_MSG       &
                   _CANSPI_CONFIG_DBL_BUFFER_ON &
                   _CANSPI_CONFIG_VALID_XTD_MSG &
                   _CANSPI_CONFIG_LINE_FILTER_OFF;
CANSPISetBaudRate(1, 1, 3, 3, 1, CANSPI_CONFIG_FLAGS);

CANSPISetMask

// set the appropriate filter mask and message type value
CANSPISetOperationMode(_CANSPI_MODE_CONFIG,0xFF);              // set CONFIGURATION mode (CANSPI module must be in config mode for mask settings)

// Set all B1 mask bits to 1 (all filtered bits are relevant):
// Note that -1 is just a cheaper way to write 0xFFFFFFFF.
// Complement will do the trick and fill it up with ones.
CANSPISetMask(_CANSPI_MASK_B1, -1, _CANSPI_CONFIG_MATCH_MSG_TYPE & _CANSPI_CONFIG_XTD_MSG);

CANSPISetFilter

// set the appropriate filter value and message type
CANSPISetOperationMode(_CANSPI_MODE_CONFIG,0xFF);                  // set CONFIGURATION mode (CANSPI module must be in config mode for filter settings)

// Set id of filter B1_F1 to 3 :
CANSPISetFilter(_CANSPI_FILTER_B1_F1, 3, _CANSPI_CONFIG_XTD_MSG);

CANSPIRead

// check the CANSPI module for received messages. If any was received do something. 
unsigned short msg_rcvd, rx_flags, data_len;
char data[8];
unsigned long msg_id;
...
CANSPISetOperationMode(_CANSPI_MODE_NORMAL,0xFF);                  // set NORMAL mode (CANSPI module must be in mode in which receive is possible)
...
rx_flags = 0;                                                // clear message flags
if (msg_rcvd = CANSPIRead(msg_id, data, data_len, rx_flags)) {
  ...
}

CANSPIWrite

// send message extended CAN message with the appropriate ID and data
unsigned short tx_flags;
char data[8];
long msg_id;
...
CANSPISetOperationMode(CANSPI_MODE_NORMAL,0xFF);                  // set NORMAL mode (CANSPI must be in mode in which transmission is possible)

tx_flags = _CANSPI_TX_PRIORITY_0 & _CANSPI_TX_XTD_FRAME;   // set message flags
CANSPIWrite(msg_id, data, 2, tx_flags);

CANSPI Constants

There is a number of constants predefined in the CANSPI library. You need to be familiar with them in order to be able to use the library effectively. Check the example at the end of the chapter.

CANSPI_OP_MODE Constants

The CANSPI_OP_MODE constants define CANSPI operation mode. Function CANSPISetOperationMode expects one of these as it's argument:

Copy Code To Clipboard

const unsigned int
    _CANSPI_MODE_BITS   = 0xE0,   // Use this to access opmode  bits
    _CANSPI_MODE_NORMAL = 0x00,
    _CANSPI_MODE_SLEEP  = 0x20,
    _CANSPI_MODE_LOOP   = 0x40,
    _CANSPI_MODE_LISTEN = 0x60,
    _CANSPI_MODE_CONFIG = 0x80;

CANSPI_CONFIG_FLAGS Constants

The CANSPI_CONFIG_FLAGS constants define flags related to the CANSPI module configuration. The functions CANSPIInit, CANSPISetBaudRate, CANSPISetMask and CANSPISetFilter expect one of these (or a bitwise combination) as their argument:

Copy Code To Clipboard

const unsigned int
    _CANSPI_CONFIG_DEFAULT        = 0xFF,   // 11111111

    _CANSPI_CONFIG_PHSEG2_PRG_BIT = 0x01,
    _CANSPI_CONFIG_PHSEG2_PRG_ON  = 0xFF,   // XXXXXXX1
    _CANSPI_CONFIG_PHSEG2_PRG_OFF = 0xFE,   // XXXXXXX0

    _CANSPI_CONFIG_LINE_FILTER_BIT = 0x02,
    _CANSPI_CONFIG_LINE_FILTER_ON  = 0xFF,   // XXXXXX1X
    _CANSPI_CONFIG_LINE_FILTER_OFF = 0xFD,   // XXXXXX0X

    _CANSPI_CONFIG_SAMPLE_BIT      = 0x04,
    _CANSPI_CONFIG_SAMPLE_ONCE     = 0xFF,   // XXXXX1XX
    _CANSPI_CONFIG_SAMPLE_THRICE   = 0xFB,   // XXXXX0XX

    _CANSPI_CONFIG_MSG_TYPE_BIT    = 0x08,
    _CANSPI_CONFIG_STD_MSG         = 0xFF,   // XXXX1XXX
    _CANSPI_CONFIG_XTD_MSG         = 0xF7,   // XXXX0XXX

    _CANSPI_CONFIG_DBL_BUFFER_BIT  = 0x10,
    _CANSPI_CONFIG_DBL_BUFFER_ON   = 0xFF,   // XXX1XXXX
    _CANSPI_CONFIG_DBL_BUFFER_OFF  = 0xEF,   // XXX0XXXX

    _CANSPI_CONFIG_MSG_BITS        = 0x60,
    _CANSPI_CONFIG_ALL_MSG         = 0xFF,   // X11XXXXX
    _CANSPI_CONFIG_VALID_XTD_MSG   = 0xDF,   // X10XXXXX
    _CANSPI_CONFIG_VALID_STD_MSG   = 0xBF,   // X01XXXXX
    _CANSPI_CONFIG_ALL_VALID_MSG   = 0x9F;   // X00XXXXX

You may use bitwise AND (&) to form config byte out of these values. For example:

Copy Code To Clipboard

init = _CANSPI_CONFIG_SAMPLE_THRICE &
       _CANSPI_CONFIG_PHSEG2_PRG_ON &
       _CANSPI_CONFIG_STD_MSG       &
       _CANSPI_CONFIG_DBL_BUFFER_ON &
       _CANSPI_CONFIG_VALID_XTD_MSG &
       _CANSPI_CONFIG_LINE_FILTER_OFF;
...
CANSPIInit(1, 1, 3, 3, 1, init);   // initialize CANSPI

CANSPI_TX_MSG_FLAGS Constants

CANSPI_TX_MSG_FLAGS are flags related to transmission of a CANSPI message:

Copy Code To Clipboard

const unsigned int
    _CANSPI_TX_PRIORITY_BITS = 0x03,
    _CANSPI_TX_PRIORITY_0    = 0xFC,   // XXXXXX00
    _CANSPI_TX_PRIORITY_1    = 0xFD,   // XXXXXX01
    _CANSPI_TX_PRIORITY_2    = 0xFE,   // XXXXXX10
    _CANSPI_TX_PRIORITY_3    = 0xFF,   // XXXXXX11

    _CANSPI_TX_FRAME_BIT     = 0x08,
    _CANSPI_TX_STD_FRAME     = 0xFF,    // XXXXX1XX
    _CANSPI_TX_XTD_FRAME     = 0xF7,    // XXXXX0XX

    _CANSPI_TX_RTR_BIT       = 0x40,
    _CANSPI_TX_NO_RTR_FRAME  = 0xFF,    // X1XXXXXX
    _CANSPI_TX_RTR_FRAME     = 0xBF;    // X0XXXXXX

You may use bitwise AND (&) to adjust the appropriate flags. For example:

Copy Code To Clipboard

// form value to be used as sending message flag :
send_config = _CANSPI_TX_PRIORITY_0 &
              _CANSPI_TX_XTD_FRAME  &
              _CANSPI_TX_NO_RTR_FRAME;
...
CANSPIWrite(id, data, 1, send_config);

CANSPI_RX_MSG_FLAGS Constants

CANSPI_RX_MSG_FLAGS are flags related to reception of CANSPI message. If a particular bit is set then corresponding meaning is TRUE or else it will be FALSE.

Copy Code To Clipboard

const unsigned int
    _CANSPI_RX_FILTER_BITS  = 0x07,   // Use this to access filter bits
    _CANSPI_RX_FILTER_1     = 0x00,
    _CANSPI_RX_FILTER_2     = 0x01,
    _CANSPI_RX_FILTER_3     = 0x02,
    _CANSPI_RX_FILTER_4     = 0x03,
    _CANSPI_RX_FILTER_5     = 0x04,
    _CANSPI_RX_FILTER_6     = 0x05,

    _CANSPI_RX_OVERFLOW     = 0x08,   // Set if Overflowed else cleared
    _CANSPI_RX_INVALID_MSG  = 0x10,   // Set if invalid else cleared
    _CANSPI_RX_XTD_FRAME    = 0x20,   // Set if XTD message else cleared
    _CANSPI_RX_RTR_FRAME    = 0x40,  // Set if RTR message else cleared
    _CANSPI_RX_DBL_BUFFERED = 0x80;  // Set if this message was hardware double-buffered

You may use bitwise AND (&) to adjust the appropriate flags. For example:

Copy Code To Clipboard

if (MsgFlag & _CANSPI_RX_OVERFLOW != 0) {
  ...
  // Receiver overflow has occurred.
  // We have lost our previous message.
}

CANSPI_MASK Constants

The CANSPI_MASK constants define mask codes. Function CANSPISetMask expects one of these as it's argument:

Copy Code To Clipboard

const unsigned int
    _CANSPI_MASK_B1 = 0,
    _CANSPI_MASK_B2 = 1;

CANSPI_FILTER Constants

The CANSPI_FILTER constants define filter codes. Functions CANSPISetFilter expects one of these as it's argument:

Copy Code To Clipboard

const unsigned int
    _CANSPI_FILTER_B1_F1 = 0,
    _CANSPI_FILTER_B1_F2 = 1,
    _CANSPI_FILTER_B2_F1 = 2,
    _CANSPI_FILTER_B2_F2 = 3,
    _CANSPI_FILTER_B2_F3 = 4,
    _CANSPI_FILTER_B2_F4 = 5;

Library Example

This is a simple demonstration of CANSPI Library routines usage. First node initiates the communication with the second node by sending some data to its address. The second node responds by sending back the data incremented by 1. First node then does the same and sends incremented data back to second node, etc.

Code for the first CANSPI node:

Copy Code To Clipboard

sbit CanSpi_CS at RF0_bit;                                // Chip select line
sbit CanSpi_Rst at RF1_bit;                               // Reset line
sbit CanSpi_CS_Direction at TRISF0_bit;                   // Direction of the Chip Select pin
sbit CanSpi_Rst_Direction at TRISF1_bit;                  // Direction of the Reset pin

unsigned int Can_Init_Flags, Can_Send_Flags, Can_Rcv_Flags;  // Can flags
unsigned int Rx_Data_Len;                                    // Received data length in bytes
char RxTx_Data[8];                                           // Can rx/tx data buffer
char Msg_Rcvd;                                               // Reception flag
unsigned long Tx_ID, Rx_ID;                                  // Can rx and tx ID

void main() {
  ADPCFG = 0xFFFF;
  PORTB = 0;
  TRISB = 0;

  Can_Init_Flags = 0;                              //
  Can_Send_Flags = 0;                              // Clear flags
  Can_Rcv_Flags  = 0;                              //
  
  Can_Send_Flags = _CANSPI_TX_PRIORITY_0 &         // Form value to be used
                   _CANSPI_TX_XTD_FRAME &          //  with CANSPI1Write
                   _CANSPI_TX_NO_RTR_FRAME;
                   
  Can_Init_Flags = _CANSPI_CONFIG_SAMPLE_THRICE &  // Form value to be used
                   _CANSPI_CONFIG_PHSEG2_PRG_ON &  //  with CANSPI1Init
                   _CANSPI_CONFIG_XTD_MSG &
                   _CANSPI_CONFIG_DBL_BUFFER_ON &
                   _CANSPI_CONFIG_VALID_XTD_MSG;

  SPI1_Init();                                                     // Initialize SPI1 module
  CANSPIInitialize(1,3,3,3,1,Can_Init_Flags);                      // Initialize external CANSPI module

  CANSPISetOperationMode(_CANSPI_MODE_CONFIG,0xFF);                // Set CONFIGURATION mode

  CANSPISetMask(_CANSPI_MASK_B1,-1,_CANSPI_CONFIG_XTD_MSG);        // Set all mask1 bits to ones
  CANSPISetMask(_CANSPI_MASK_B2,-1,_CANSPI_CONFIG_XTD_MSG);        // Set all mask2 bits to ones
  CANSPISetFilter(_CANSPI_FILTER_B2_F4,3,_CANSPI_CONFIG_XTD_MSG);  // Set id of filter B1_F1 to 3
  
  CANSPISetOperationMode(_CANSPI_MODE_NORMAL,0xFF);                // Set NORMAL mode

  RxTx_Data[0] = 9;                                                // Set initial data to be sent
  
  Tx_ID = 12111;                                                   // Set transmit ID
  
  CANSPIWrite(Tx_ID, RxTx_Data, 1, Can_Send_Flags);                // Send initial message
  
  while(1) {                                                                   // Endless loop
    Msg_Rcvd = CANSPIRead(&Rx_ID , RxTx_Data , &Rx_Data_Len, &Can_Rcv_Flags);  // Receive message
    if ((Rx_ID == 3u) && Msg_Rcvd) {                                           // If message received check id
      PORTB = RxTx_Data[0];                                                    // Id correct, output data at PORTB
      RxTx_Data[0]++;                                                         // Increment received data
      Delay_ms(10);
      CANSPIWrite(Tx_ID, RxTx_Data, 1, Can_Send_Flags);                        // Send incremented data back
    }
  }
}

Code for the second CANSPI node:

Copy Code To Clipboard

sbit CanSpi_CS at RF0_bit;                                // Chip select line
sbit CanSpi_Rst at RF1_bit;                               // Reset line
sbit CanSpi_CS_Direction at TRISF0_bit;                   // Direction of the Chip Select pin
sbit CanSpi_Rst_Direction at TRISF1_bit;                  // Direction of the Reset pin

unsigned int Can_Init_Flags, Can_Send_Flags, Can_Rcv_Flags;  // Can flags
unsigned int Rx_Data_Len;                                    // Received data length in bytes
char RxTx_Data[8];                                           // Can rx/tx data buffer
char Msg_Rcvd;                                               // Reception flag
unsigned long Tx_ID, Rx_ID;                                  // Can rx and tx ID

void main() {
  ADPCFG = 0xFFFF;
  PORTB = 0;
  TRISB = 0;

  Can_Init_Flags = 0;                              //
  Can_Send_Flags = 0;                              // Clear flags
  Can_Rcv_Flags  = 0;                              //
  
  Can_Send_Flags = _CANSPI_TX_PRIORITY_0 &         // Form value to be used
                   _CANSPI_TX_XTD_FRAME &          //  with CANSPI1Write
                   _CANSPI_TX_NO_RTR_FRAME;
                   
  Can_Init_Flags = _CANSPI_CONFIG_SAMPLE_THRICE &  // Form value to be used
                   _CANSPI_CONFIG_PHSEG2_PRG_ON &  //  with CANSPI1Init
                   _CANSPI_CONFIG_XTD_MSG &
                   _CANSPI_CONFIG_DBL_BUFFER_ON &
                   _CANSPI_CONFIG_VALID_XTD_MSG &
                   _CANSPI_CONFIG_LINE_FILTER_OFF;

  SPI1_Init();                                                        // Initialize SPI1 module
  CANSPIInitialize(1,3,3,3,1,Can_Init_Flags);                         // Initialize CANSPI module

  CANSPISetOperationMode(_CANSPI_MODE_CONFIG,0xFF);                   // Set CONFIGURATION mode

  CANSPISetMask(_CANSPI_MASK_B1,-1,_CANSPI_CONFIG_XTD_MSG);           // Set all mask1 bits to ones
  CANSPISetMask(_CANSPI_MASK_B2,-1,_CANSPI_CONFIG_XTD_MSG);           // Set all mask2 bits to ones
  CANSPISetFilter(_CANSPI_FILTER_B2_F3,12111,_CANSPI_CONFIG_XTD_MSG); // Set id of filter B1_F1 to 3
  
  CANSPISetOperationMode(_CANSPI_MODE_NORMAL,0xFF);                   // Set NORMAL mode
  
  Tx_ID = 3;                                                          // Set tx ID
  
  while (1) {                                                                  // Endless loop
    Msg_Rcvd = CANSPIRead(&Rx_ID , RxTx_Data , &Rx_Data_Len, &Can_Rcv_Flags);  // Receive message
    if ((Rx_ID == 12111u) && Msg_Rcvd) {                                       // If message received check id
      PORTB = RxTx_Data[0];                                                    // Id correct, output data at PORTB
      RxTx_Data[0]++;                                                         // Increment received data
      CANSPIWrite(Tx_ID, RxTx_Data, 1, Can_Send_Flags);                        // Send incremented data back
    }
  }
}

HW Connection

Example of interfacing CAN transceiver MCP2510 with MCU via SPI interface

Want more examples and libraries? 
Find them on