Difference between revisions of "CAN Protocol"

From Wiki
(Added hint to Rebel Joints article)
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
 +
'''Searching for igus Rebel robot or joints docs? Then please go to this page: [[Rebel Joint]] for specific documentation!'''
 +
 
Commonplace Robotics uses the CAN field bus to send position set point values from the robot controller to the  joint modules. The applied protocols are custom, but quite simple.  
 
Commonplace Robotics uses the CAN field bus to send position set point values from the robot controller to the  joint modules. The applied protocols are custom, but quite simple.  
  
Line 10: Line 13:
 
The joint modules answer with an error code that provides the current state.
 
The joint modules answer with an error code that provides the current state.
  
===CPR CAN Documentation and Demo Code===
+
==CPR CAN Documentation and Demo Code==
* '''Documentation: [http://www.cpr-robots.com/download/CAN/UserGuide_ProtocolCPRCAN_V04.pdf CAN protocol documentation]'''
+
* '''Documentation: [http://www.cpr-robots.com/download/CAN/UserGuide_ProtocolCPRCAN.pdf CAN protocol documentation]'''
 +
* [[Rebel_Joint|Rebel Joints and BLDC axes]] use a slightly modified protocol, you can find the documentation in the Rebel Joints article.
 
* Linux examples: C sources can be downloaded at [http://www.github.com/CPR-Robots www.github.com/CPR-Robots]
 
* Linux examples: C sources can be downloaded at [http://www.github.com/CPR-Robots www.github.com/CPR-Robots]
 
* '''C# demo: [http://www.cpr-robots.com/download/CAN/CPRMoverDemoCSharp.zip Source code] for Visual Studio Express 2012'''  
 
* '''C# demo: [http://www.cpr-robots.com/download/CAN/CPRMoverDemoCSharp.zip Source code] for Visual Studio Express 2012'''  
Line 17: Line 21:
 
Currently we are updating the example source code to the cprcanv2 protocol. Please get in contact if you need these sources.
 
Currently we are updating the example source code to the cprcanv2 protocol. Please get in contact if you need these sources.
  
===CAN Hardware / Drivers===
+
==CAN Hardware / Drivers==
Our robots and control electronics are usually supplied with a white [https://www.peak-system.com/PCAN-USB.199.0.html PCAN USB adapter].  
+
Most robots and control electronics are usually supplied with a white [https://www.peak-system.com/PCAN-USB.199.0.html PCAN USB adapter]. The robolink DCi robots are not supplied with a CAN adapter as the communication between PC and robot is via Ethernet and a CAN adapter is not required for operation and programming of the robot.
  
'''If you have a black PCAN adapter, [[Support Routes|get in touch with us]]. The following driver links will likely not work for you.'''
+
''If you have a black PCAN adapter, [[Support Routes|get in touch with us]]. The following driver links will likely not work for you.''
  
====for Windows 10, 8.1, 7 (32/64-bit)====
+
===for Windows 10, 8.1, 7 (32/64-bit)===
 
The PCAN USB Windows driver for the adapter can be found on the CPRog installation CD, if supplied, or downloaded here:  
 
The PCAN USB Windows driver for the adapter can be found on the CPRog installation CD, if supplied, or downloaded here:  
 
*[https://www.peak-system.com/quick/DrvSetup PCAN Windows driver], [[media:PCAN_Windows_Driver.zip | mirror]]
 
*[https://www.peak-system.com/quick/DrvSetup PCAN Windows driver], [[media:PCAN_Windows_Driver.zip | mirror]]
Line 28: Line 32:
 
*CAN Bus Monitor for debugging [https://www.peak-system.com/fileadmin/media/files/pcanview.zip PCAN View], [[media:PCAN_View.zip|mirror]]
 
*CAN Bus Monitor for debugging [https://www.peak-system.com/fileadmin/media/files/pcanview.zip PCAN View], [[media:PCAN_View.zip|mirror]]
  
====for Linux====
+
===for Linux===
 
For the ROS environment a Linux driver is required. It can be found here:
 
For the ROS environment a Linux driver is required. It can be found here:
 
* If you use ROS with example code from our [https://github.com/CPR-Robots/ git repos], you will notice that the documentation of the ROS repos will refer to this version of the driver [https://www.peak-system.com/fileadmin/media/linux/files/peak-linux-driver-7.10.tar.gz PEAK-Linux-driver-7.10], [[media:PCAN_linux_driver_7.10.tar.gz|mirror]]. This is what we tested our code with.
 
* If you use ROS with example code from our [https://github.com/CPR-Robots/ git repos], you will notice that the documentation of the ROS repos will refer to this version of the driver [https://www.peak-system.com/fileadmin/media/linux/files/peak-linux-driver-7.10.tar.gz PEAK-Linux-driver-7.10], [[media:PCAN_linux_driver_7.10.tar.gz|mirror]]. This is what we tested our code with.
Line 34: Line 38:
 
**[https://www.peak-system.com/fileadmin/media/linux/files/PCAN%20Driver%20for%20Linux_eng_7.1.pdf Manual], [[media:PCAN_linux_driver_manual_7.10.pdf |mirror]]
 
**[https://www.peak-system.com/fileadmin/media/linux/files/PCAN%20Driver%20for%20Linux_eng_7.1.pdf Manual], [[media:PCAN_linux_driver_manual_7.10.pdf |mirror]]
  
* Latest driver for Linux  
+
* Latest driver for Linux (still untested with our example code)
**https://www.peak-system.com/fileadmin/media/linux/files/peak-linux-driver-8.5.1.tar.gz PEAK Linux driver 8.5.1], [[media:peak-linux-driver-8.5.1.tar.gz|mirror]]
+
**Since mainline kernel 3.4, the driver is part of the kernel. However, we have not fully tested our code with this driver yet. It is on the "to do" list.
*[https://www.peak-system.com/fileadmin/media/linux/files/PCAN-Driver-Linux_UserMan_eng.pdf Manual], [[media:PCAN_linux_driver_manual_8.5.1.pdf|mirror]].
+
**PCAN offers a separate driver as well: https://www.peak-system.com/fileadmin/media/linux/files/peak-linux-driver-8.5.1.tar.gz PEAK Linux driver 8.5.1], [[media:peak-linux-driver-8.5.1.tar.gz|mirror]]
 +
**[https://www.peak-system.com/fileadmin/media/linux/files/PCAN-Driver-Linux_UserMan_eng.pdf Manual], [[media:PCAN_linux_driver_manual_8.5.1.pdf|mirror]].
 
**For installation instructions, please refer to the manual linked above.
 
**For installation instructions, please refer to the manual linked above.
  
  
 
[[Category:Downloads]]
 
[[Category:Downloads]]

Latest revision as of 11:23, 18 July 2022

Searching for igus Rebel robot or joints docs? Then please go to this page: Rebel Joint for specific documentation!

Commonplace Robotics uses the CAN field bus to send position set point values from the robot controller to the joint modules. The applied protocols are custom, but quite simple.

Two version are used

  • CPRCAN: 16 bit position data used for Mover4 and Mover6 robots and Slider platforms
  • CPRCANV2: 32 bit position data used for SRA and Mover6-2016 (understands both, CPRCAN and CPRCANV2) robots.

The position set point messages have to be send in a loop with e.g. 20 Hz. The application has to verify that this loop has a constant cycle time. If the jitter is too big the motion control modules might get into a communication loss error state. Additionally the application has to send state change messages like reset-all-errors and enable-motors.

The joint modules answer with an error code that provides the current state.

CPR CAN Documentation and Demo Code

Currently we are updating the example source code to the cprcanv2 protocol. Please get in contact if you need these sources.

CAN Hardware / Drivers

Most robots and control electronics are usually supplied with a white PCAN USB adapter. The robolink DCi robots are not supplied with a CAN adapter as the communication between PC and robot is via Ethernet and a CAN adapter is not required for operation and programming of the robot.

If you have a black PCAN adapter, get in touch with us. The following driver links will likely not work for you.

for Windows 10, 8.1, 7 (32/64-bit)

The PCAN USB Windows driver for the adapter can be found on the CPRog installation CD, if supplied, or downloaded here:

for Linux

For the ROS environment a Linux driver is required. It can be found here: