Using CAN bus with NUCLEO boards (Demo for the CANnucleo library).

Dependencies:   CANnucleo mbed-dev

Dependents:   BMS_2 Can_sniffer_BMS_GER Can_sniffer_bms ECU_1

Using CAN bus with NUCLEO boards

Demo for the CANnucleo library


Information

Because CAN support has been finally implemented into the mbed library also for the STM boards there is no need to use the CANnucleo library anymore (however you may if you want). See the CAN_Hello example which is trying to demonstrate the mbed built-in CAN API using NUCLEO boards.

Two low cost STM32F103C8T6 boards are connected to the same CAN bus via transceivers (MCP2551 or TJA1040, or etc.). CAN transceivers are not part of NUCLEO boards, therefore must be added by you. Remember also that CAN bus (even a short one) must be terminated with 120 Ohm resitors at both ends.

Schematic

Zoom in

/media/uploads/hudakz/can_nucleo_hello.png

Hookup

/media/uploads/hudakz/20150724_080148.jpg Zoom in

The mbed boards in this example are transmitting CAN messages carrying two data items:

uint8_t   counter;  // one byte
float     voltage;  // four bytes

So in this case the total length of payload data is five bytes (must not exceed eight bytes).
For our convenience, the "<<" (append) operator is used to add data to the CAN message.
The usage of "<<" and ">>" operators is similar to the C++ io-streams operators. We can append data one at a time

txMsg << counter;
txMsg << voltage;

or combine all into one expression.

txMsg << counter << voltage;

The actual data length of a CAN message is automatically updated when using "<<" or ">>" operators.
After successful transmission the CAN message is printed to the serial terminal of the connected PC. So we can check the details (ID, type, format, length and raw data). If something goes wrong during transmission a "Transmission error" message is printed to the serial terminal.

On arrival of a CAN message it's also printed to the serial terminal of the connected PC. So we can see the details (ID, type, format, length and raw data). Then its ID is checked. If there is a match with the ID of awaited message then data is extracted from the CAN message (in the same sequence as it was appended before transmitting) using the ">>" (extract) operator one at a time

rxMsg >> counter;
rxMsg >> voltage;

or all in one shot

rxMsg >> counter >> voltage;

Important

Before compiling the project, in the mbed-dev library open the device.h file associated with the selected target board and add #undef DEVICE_CAN as follows:

device.h

#ifndef MBED_DEVICE_H
#define MBED_DEVICE_H

//=======================================
#define DEVICE_ID_LENGTH       24

#undef DEVICE_CAN

#include "objects.h"

#endif

NOTE: Failing to do so will result in compilation errors.

The same source code is used for both boards, but:

  • For board #1 compile the example without any change to main.cpp
  • For board #2 comment out the line #define BOARD1 1 before compiling

Once binaries have been downloaded to the boards, reset board #1.

NOTE:

The code published here was written for the official NUCLEO boards. When using STM32F103C8T6 boards, shown in the picture above (LED1 is connected to pin PC_13 and, via a resistor, to +3.3V),

  • Import the mbed-STM32F103C8T6 library into your project.
  • Include (uncomment) the line #define TARGET_STM32F103C8T6 1
  • Select NUCLEO-F103RB as target platform for the online compiler.

CAN bus related information

Revision:
10:66da8731bdb6
Parent:
7:2dce8ed51091
Child:
11:07d927da1a94
--- a/main.cpp	Wed Dec 23 10:38:02 2015 +0000
+++ b/main.cpp	Fri Mar 11 12:19:22 2016 +0000
@@ -7,14 +7,13 @@
  * CAN transceivers are not part of NUCLEO boards, therefore must be added by you. 
  * Remember also that CAN bus (even a short one) must be terminated with 120 Ohm resitors at both ends.
  *
- * For more details see the wiki page <https://developer.mbed.org/users/hudakz/code/CAN_Nucleo_Hello/>
+ * For more details see the wiki page <https://developer.mbed.org/users/hudakz/code/CANnucleo_Hello/>
  *
- * NOTE: If you'd like to use the official NUCLEO-F103RB boards
- *       comment out the line #define TARGET_STM32F103C8T6  1
+ * NOTE: If you'd like to use the official NUCLEO boards comment out line 25
  *
  * The same code is used for both NUCLEO boards, but:
  *      For board #1 compile the example without any change.
- *      For board #2 comment out the line #define BOARD1 1 before compiling 
+ *      For board #2 comment out line 26 before compiling 
  *
  * Once the binaries have been downloaded to the boards reset board #1.
  *
@@ -23,31 +22,34 @@
 #include "mbed.h"
 #include "CAN.h"
 
-#define BOARD1    1                 // comment out this line when compiling for board #2
+#define TARGET_STM32F103C8T6  1     // comment out this line when using official NUCLEO boards!                                    
+#define BOARD1                1     // comment out this line when compiling for board #2
 
-#if defined(BOARD1)
-    #define RX_ID   0x100
-    #define TX_ID   0x101
+#if defined(TARGET_STM32F103C8T6) 
+    #define   LED_PIN   PC_13 
+    const int OFF = 1;
+    const int ON  = 0;
 #else
-    #define RX_ID   0x101
-    #define TX_ID   0x100
+    #define   LED_PIN   LED1
+    const int OFF = 0;
+    const int ON  = 1;
 #endif
 
-// See wiki page <https://developer.mbed.org/users/hudakz/code/CAN_Nucleo_Hello/>
-//#define TARGET_STM32F103C8T6  1     // comment out this line if you'd like to use the official NUCLEO-F103RB boards
-                                    
-#if defined(TARGET_STM32F103C8T6)  
-    DigitalOut  led(PC_13);
+#if defined(BOARD1)
+    const unsigned int RX_ID = 0x100;
+    const unsigned int TX_ID = 0x101;
 #else
-    DigitalOut  led(LED1);
+    const unsigned int RX_ID = 0x101;
+    const unsigned int TX_ID = 0x100;
 #endif
 
-int             ledReceived;
-Timer           timer;
-CAN             can(PA_11, PA_12);  // CAN Rx pin name, CAN Tx pin name, Automatic recovery from bus-off state enabled by default
-CANMessage      rxMsg;
-CANMessage      txMsg;
-int             counter = 0;
+DigitalOut  led(LED_PIN);
+int         ledState;
+Timer       timer;
+CAN         can(PA_11, PA_12);  // CAN Rx pin name, CAN Tx pin name
+CANMessage  rxMsg;
+CANMessage  txMsg;
+int         counter = 0;
 volatile bool   msgAvailable = false;
 
 /**
@@ -72,37 +74,27 @@
     can.attach(&onMsgReceived, CAN::RxIrq);     // attach 'CAN receive-complete' interrupt handler
     
 #if defined(BOARD1)
-    #if defined(TARGET_STM32F103C8T6)
-        led = 0;    // turn LED on
-    #else
-        led = 1;    // turn LED on
-    #endif
-    timer.start();
+    led = ON;       // turn LED on
+    timer.start();  // start timer
 #else
-    #if defined(TARGET_STM32F103C8T6)
-        led = 1;    // turn LED off
-    #else
-        led = 0;    // turn LED off
-    #endif
+    led = OFF;      // turn LED off
 #endif
 
     while(1) {
         if(timer.read() >= 1.0) {               // check for timeout
             timer.stop();                       // stop timer
-            timer.reset();                      // reset timer (to avaoid repeated send)
+            timer.reset();                      // reset timer
             counter++;                          // increment counter
+            ledState = led.read();              // get led state
             txMsg.clear();                      // clear Tx message storage
             txMsg.id = TX_ID;                   // set ID
-            txMsg << counter;                   // append first data item (make sure that CAN message total data lenght <= 8 bytes!)
-            txMsg << led.read();                // append second data item (make sure that CAN message total data lenght <= 8 bytes!)
-            can.write(txMsg);                   // transmit message
-            printf("CAN message sent\r\n");
-            
-            #if defined(TARGET_STM32F103C8T6)
-                led = 1;                        // turn LED off
-            #else
-                led = 0;                        // turn LED off
-            #endif
+            txMsg << counter;                   // append first data item
+            txMsg << ledState;                  // append second data item (total data lenght must be <= 8 bytes!)
+            led = OFF;                          // turn LED off
+            if(can.write(txMsg))                // transmit message
+                printf("CAN message sent\r\n"); 
+            else
+                printf("Transmission error\r\n");
         }
         if(msgAvailable) {
             msgAvailable = false;               // reset flag for next use
@@ -115,13 +107,14 @@
             printf("  Data   =");            
             for(int i = 0; i < rxMsg.len; i++)
                 printf(" %x", rxMsg.data[i]);
-            printf("\r\n");            
-            if(rxMsg.id == RX_ID) {             // if ID matches
+            printf("\r\n");
+            // Filtering performed by software:           
+            if(rxMsg.id == RX_ID) {             // See comments in CAN.cpp for filtering performed by hadware
                 rxMsg >> counter;               // extract first data item
-                rxMsg >> ledReceived;           // extract second data item
-                led = ledReceived;              // set LED
+                rxMsg >> ledState;              // extract second data item
                 printf("counter = %d\r\n", counter);
-                timer.start();
+                led = ledState;                 // set LED
+                timer.start();                  // transmission lag
             }
         }
     }