Difference between revisions of "CAN bus Linux driver"

From ArmadeusWiki
Jump to: navigation, search
m
 
(56 intermediate revisions by 8 users not shown)
Line 1: Line 1:
== WORK IN PROGRESS ==
 
 
The current CAN bus driver uses SocketCAN API which is now the official CAN API for Linux.
 
The current CAN bus driver uses SocketCAN API which is now the official CAN API for Linux.
 
 
SocketCAN is based on the Linux socket. Further details can be found on the links at the bottom of this page.
 
SocketCAN is based on the Linux socket. Further details can be found on the links at the bottom of this page.
 +
 +
{{Warning|Please ensure that you use a recent version of armadeus BSP (kernel version more than 2.6.38 is required) before trying the instructions described on this page! With older kernel versions you may not be able to change the bitrate.}}
  
 
==Driver installation==
 
==Driver installation==
 +
* Nothing has to be done for the [[APF51Dev]], the [[APF28Dev]], [[APF6Dev]] and the [[OPOS6ULDev]].
 +
* For the [[APF27Dev|APF27DevFull]]:
 +
<pre class="host">
 
  $ make linux-menuconfig
 
  $ make linux-menuconfig
 +
</pre>
  
in '''Device Drivers  ---> SPI support  ---> ''' select '''<M> Freescale iMX SPI controller''' as module
+
<pre class="config">
 
+
Networking support --->
in '''Networking  ---> ''' select '''<M>  CAN bus subsystem support'''  as module
+
    <M>  CAN bus subsystem support --->
in '''Networking  ---> CAN bus subsystem support --> ''' select '''<M> Raw CAN Protocol'''  as module
+
        --- CAN bus subsystem support
in '''Networking  ---> CAN bus subsystem support --> ''' select '''<M> Broadcast Manager CAN Protocol'''  as module
+
        <M>   Raw CAN Protocol (raw access with CAN-ID filtering)
in '''Networking  ---> CAN bus subsystem support --> CAN Device Drivers --> ''' select '''<M> Virtual Local CAN Interface'''  as module
+
        <M>   Broadcast Manager CAN Protocol (with content filtering)
in '''Networking  ---> CAN bus subsystem support --> CAN Device Drivers --> ''' select '''<M> Microchip 251x series SPI CAN Controller'''  as module
+
              CAN Device Drivers --->
 +
                  <M> Virtual Local CAN Interface (vcan)
 +
                  <M> Platform CAN drivers with Netlink support
 +
                  [*]  CAN bit-timing calculation 
 +
                  <M> Microchip 251x series SPI CAN Controller
 +
</pre>
  
 +
<pre class="host">
 +
$ make linux
 +
$ make
 +
</pre>
 +
* Reflash kernel and rootfs
  
 
==Usage==
 
==Usage==
* load all the needed drivers:
+
* Load all the required drivers (not needed on [[OPOS6UL]]):
insmod /lib/modules/drivers/spi/spi_imx.ko
+
<pre class="apf">
insmod /lib/modules/2.6.23.1/kernel/net/can/can.ko
+
# modprobe can
insmod /lib/modules/2.6.23.1/kernel/net/can/candev.ko
+
# modprobe can-dev
insmod /lib/modules/2.6.23.1/kernel/net/can/can-raw.ko
+
# modprobe can-raw
insmod /lib/modules/2.6.23.1/kernel/drivers/net/can/mcp251x.ko
+
</pre>
 +
{| border="1" cellpadding="10" cellspacing="0" summary="CAN bus modules depending on board" class="wikitable"
 +
|- style="background:#efefef;" align="center"
 +
! APF27 & APF51 || APF6
 +
|---
 +
|<pre class="apf">
 +
# modprobe mcp251x         
 +
</pre>
 +
|<pre class="apf">
 +
# modprobe flexcan       
 +
</pre>
 +
|}
 +
* Set the bitrate before all operations
 +
Example:
 +
Set the bitrate of the can0 interface to 125kbps:
 +
<pre class="apf">
 +
# ip link set can0 up type can bitrate 125000
 +
</pre>
  
==Quick test==
+
{{Note| An error occurs when you try to set the bitrate with an old Linux kernel. In that case, ''echo 125000 > /sys/devices/platform/FlexCAN.0/bitrate'' was reported to be a good alternative.}}
Once the driver installed, the CAN interface has to be started like a standard net interface
+
ifconfig can0 up
+
and can be stopped like that:
+
ifconfig can0 down
+
  
The socketCAN version can be retrieved like that:
+
* If the following error occurs when you do the last instruction :
cat /proc/net/can/version
+
<pre class="apf">
 +
ip: either "dev" is duplicate, or "type" is garbage
 +
</pre>
  
The socketCAN statistics can be retrieved like that:
+
check that this command:
  cat /proc/net/can/stats
+
 
 +
<pre class="apf">
 +
# which ip
 +
</pre>
 +
 
 +
return this message:
 +
 
 +
<pre class="apf">
 +
/sbin/ip
 +
</pre>
 +
 
 +
and not this one :
 +
 
 +
<pre class="apf">
 +
/bin/ip
 +
</pre>
 +
 
 +
If the binary is installed in ''/bin'' instead of ''/sbin'', the executable file is a link to busybox and the command to set the bitrate doesn't work on busybox, so try the following instructions:
 +
 
 +
<pre class="host">
 +
$ make busybox-clean
 +
$ make busybox-dirclean
 +
$ make menuconfig
 +
</pre>
 +
 
 +
<pre class="config">
 +
Package Selection for the target  --->
 +
    Networking applications  --->
 +
        [*] iproute2
 +
</pre>
 +
 
 +
<pre class="host">
 +
$ make
 +
</pre>
 +
 
 +
Then, reflash your rootfs.
 +
 
 +
==Quick test==
 +
* Once the driver is installed and the bitrate is set, the CAN interface has to be started like a standard net interface:
 +
<pre class="apf">
 +
# ifconfig can0 up
 +
</pre>
 +
* and can be stopped like that:
 +
<pre class="apf">
 +
# ifconfig can0 down
 +
</pre>
 +
* The socketCAN version can be retrieved this way:
 +
<pre class="apf">
 +
# cat /proc/net/can/version
 +
</pre>
 +
* The socketCAN statistics can be retrieved this way:
 +
<pre class="apf">
 +
  # cat /proc/net/can/stats
 +
</pre>
  
 
==Userspace tools==
 
==Userspace tools==
*Several tools are provided by socketCAN:
+
Several tools are provided by socketCAN:
**'''candump''': dump traffic on a CAN network
+
*'''candump''': dump traffic on a CAN network
**'''cansend''': simple command line tool to send CAN-frames via CAN_RAW sockets
+
The following command shows the received message from the CAN bus
**'''cangen''': CAN frames generator for testing purpose
+
<pre class="apf">
**'''canplayer''': send CAN frames from a file to a CAN interface
+
candump can0
 +
</pre>
 +
*'''cansend''': simple command line tool to send CAN-frames via CAN_RAW sockets  
 +
exemple :
 +
The following command sends 3 bytes on the bus (0x1E, 0x10, 0x10) with the identifier 500.
 +
<pre class="apf">
 +
cansend can0 500#1E.10.10
 +
</pre>
 +
You can send a remote request message
 +
<pre class="apf">
 +
cansend can0 500#R
 +
</pre>
 +
The information with the identifier 500 will be available on the bus when the device receive the remote request message
 +
*'''cangen''': CAN frames generator for testing purpose
 +
*'''canplayer''': send CAN frames from a file to a CAN interface
 +
 
 +
These tools can be compiled and installed on the target by means of the Buildroot menuconfig:
 +
<pre class="host">
 +
$ make menuconfig
 +
</pre>
 +
<pre class="config">
 +
Package Selection for the target  --->
 +
    Networking  --->
 +
        [*]  Socket CAN
 +
</pre>
 +
<pre class="host">
 +
$ make
 +
</pre>
 +
then, reflash your rootfs.
  
*These tools can be compiled and installed on the target by means of the buildroot menuconfig:
+
==Automatically launch CAN interface at startup==
[armadeus]$ make menuconfig
+
* Add the following lines to ''/etc/network/interfaces'' configuration file:
[[Image:Menuconfig_package.png]]
+
<pre class="APF">
<br> <br>
+
auto can0
[[Image:Menuconfig_package_net.png]]
+
iface can0 inet manual
<br> <br>
+
        pre-up /sbin/ip link set $IFACE type can bitrate 125000 on
[[Image:Menuconfig_package_socketcan.png]]
+
        up /sbin/ifconfig $IFACE up
 +
        down /sbin/ifconfig $IFACE down
 +
</pre>
  
 
==Links==
 
==Links==
 +
* https://www.ridgerun.com/developer/wiki/index.php/How_to_configure_and_use_CAN_bus (How to configure and use CAN bus)
 
* http://developer.berlios.de/projects/socketcan/ (CAN Linux Driver)
 
* http://developer.berlios.de/projects/socketcan/ (CAN Linux Driver)
 
* http://ww1.microchip.com/downloads/en/DeviceDoc/21801e.pdf (MCP2515 datasheet)
 
* http://ww1.microchip.com/downloads/en/DeviceDoc/21801e.pdf (MCP2515 datasheet)
 
* http://www.kvaser.com/can/protocol/index.htm (CAN introduction)
 
* http://www.kvaser.com/can/protocol/index.htm (CAN introduction)
 +
* [[User:KevinJ#Communication_with_the_CAN_Bus_of_a_car|Communication with a car's CAN bus]]
  
 
[[Category:Linux drivers]]
 
[[Category:Linux drivers]]
 +
[[Category:CAN bus]]

Latest revision as of 10:10, 31 July 2018

The current CAN bus driver uses SocketCAN API which is now the official CAN API for Linux. SocketCAN is based on the Linux socket. Further details can be found on the links at the bottom of this page.

Warning Warning: Please ensure that you use a recent version of armadeus BSP (kernel version more than 2.6.38 is required) before trying the instructions described on this page! With older kernel versions you may not be able to change the bitrate.


Driver installation

 $ make linux-menuconfig
Networking support  --->
    <M>   CAN bus subsystem support ---> 
        --- CAN bus subsystem support
        <M>   Raw CAN Protocol (raw access with CAN-ID filtering)
        <M>   Broadcast Manager CAN Protocol (with content filtering)
              CAN Device Drivers  --->
                  <M> Virtual Local CAN Interface (vcan)
                  <M> Platform CAN drivers with Netlink support
                  [*]   CAN bit-timing calculation   
                  <M> Microchip 251x series SPI CAN Controller
 $ make linux
 $ make
  • Reflash kernel and rootfs

Usage

  • Load all the required drivers (not needed on OPOS6UL):
# modprobe can
# modprobe can-dev
# modprobe can-raw
APF27 & APF51 APF6
# modprobe mcp251x          
# modprobe flexcan         
  • Set the bitrate before all operations

Example: Set the bitrate of the can0 interface to 125kbps:

# ip link set can0 up type can bitrate 125000
Note Note: An error occurs when you try to set the bitrate with an old Linux kernel. In that case, echo 125000 > /sys/devices/platform/FlexCAN.0/bitrate was reported to be a good alternative.


  • If the following error occurs when you do the last instruction :
ip: either "dev" is duplicate, or "type" is garbage

check that this command:

# which ip

return this message:

/sbin/ip

and not this one :

/bin/ip

If the binary is installed in /bin instead of /sbin, the executable file is a link to busybox and the command to set the bitrate doesn't work on busybox, so try the following instructions:

$ make busybox-clean
$ make busybox-dirclean
$ make menuconfig
Package Selection for the target  --->
    Networking applications  --->
        [*] iproute2
$ make 

Then, reflash your rootfs.

Quick test

  • Once the driver is installed and the bitrate is set, the CAN interface has to be started like a standard net interface:
 # ifconfig can0 up
  • and can be stopped like that:
 # ifconfig can0 down
  • The socketCAN version can be retrieved this way:
 # cat /proc/net/can/version
  • The socketCAN statistics can be retrieved this way:
 # cat /proc/net/can/stats

Userspace tools

Several tools are provided by socketCAN:

  • candump: dump traffic on a CAN network

The following command shows the received message from the CAN bus

candump can0
  • cansend: simple command line tool to send CAN-frames via CAN_RAW sockets

exemple : The following command sends 3 bytes on the bus (0x1E, 0x10, 0x10) with the identifier 500.

cansend can0 500#1E.10.10

You can send a remote request message

cansend can0 500#R

The information with the identifier 500 will be available on the bus when the device receive the remote request message

  • cangen: CAN frames generator for testing purpose
  • canplayer: send CAN frames from a file to a CAN interface

These tools can be compiled and installed on the target by means of the Buildroot menuconfig:

$ make menuconfig
Package Selection for the target  --->
    Networking  --->
        [*]   Socket CAN
$ make

then, reflash your rootfs.

Automatically launch CAN interface at startup

  • Add the following lines to /etc/network/interfaces configuration file:
auto can0
iface can0 inet manual
        pre-up /sbin/ip link set $IFACE type can bitrate 125000 on
        up /sbin/ifconfig $IFACE up
        down /sbin/ifconfig $IFACE down

Links