{"id":3322,"date":"2019-02-12T16:09:02","date_gmt":"2019-02-12T16:09:02","guid":{"rendered":"https:\/\/cyflexdoc.wpengine.com\/usage-help-manual\/17-i-o-systems\/candbc\/"},"modified":"2025-11-04T14:10:32","modified_gmt":"2025-11-04T19:10:32","slug":"candbc","status":"publish","type":"page","link":"https:\/\/cyflex.com\/index.php\/usage-help-manual\/14-i-o-systems\/candbc\/","title":{"rendered":"CanDbc"},"content":{"rendered":"
\n

Purpose:<\/h3>\n<\/div>\n
\n
\n

Initialize CAN-AC1-PCI\/CAN-AC2-PCI cards or USB devices and capture data from up to 250 channels at a maximum of 50Hz. The program handles reconfiguration, diagnostics requests, and CCP protocol for CAN bus communications, encoding and decoding messages based on DBC file specifications. See Notes<\/strong> for\u00a0a description of how the .dbc file is composed.<\/p>\n<\/dd>\n<\/dl>\n

Enter:<\/h3>\n
\n
\n

CanDbc<\/strong> <filename.dbc> [usbpath1] [baud1=usbbaud1] <filename2.dbc>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 [usbpath2] [baud2=usbbaud2] [time=clock_time]
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 [name=reg_name] [seed=<hexvalue>] [cpu=CPU_bit] [priority] [debug]<\/p>\n<\/dd>\n<\/dl>\n

Where:<\/h3>\n
\n
\n
\n\n\n\n<\/colgroup>\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n

filename<\/p>\n<\/td>\n

\n

Specify the name of the DBC file describing the data monitor. The DBC file describes the communications on a single CAN Network.<\/p>\n<\/td>\n<\/tr>\n

\n

usbpath1<\/p>\n<\/td>\n

\n

Optional. Specify a USB device as desired.\u00a0<\/p>\n<\/td>\n<\/tr>\n

\n

baud1<\/p>\n<\/td>\n

\n

Optional. Specify a baud rate for a connected USB device.<\/p>\n<\/td>\n<\/tr>\n

\n

filename2<\/p>\n<\/td>\n

\n

Optional. Specify the name of a second DBC file to use to send a channel on an AC2 card. If specified, specify a second USB device.<\/p>\n<\/td>\n<\/tr>\n

\n

usbpath2<\/p>\n<\/td>\n

\n

Optional. Specify a second USB device.\u00a0<\/p>\n<\/td>\n<\/tr>\n

\n

baud2<\/p>\n<\/td>\n

\n

Optional. Specify the baud rate for a second connected USB device.\u00a0<\/p>\n<\/td>\n<\/tr>\n

\n

time<\/p>\n<\/td>\n

\n

Optional. Specify the update time. The default is 10.<\/p>\n<\/td>\n<\/tr>\n

\n

name<\/p>\n<\/td>\n

\n

Optional. Specify the desired register name. The default name is CanDbc.<\/p>\n<\/td>\n<\/tr>\n

\n

seed<\/p>\n<\/td>\n

\n

Optional. Specify a seed hex value for CCP protocol.<\/p>\n<\/td>\n<\/tr>\n

\n

cpu<\/p>\n<\/td>\n

\n

Optional. Specify a bit mask value to set on which CPU to function.<\/p>\n<\/td>\n<\/tr>\n

\n

priority<\/p>\n<\/td>\n

\n

Optional. Specify the task priority.<\/p>\n<\/td>\n<\/tr>\n

\n

debug<\/p>\n<\/td>\n

\n

Optional. Specify this option to display incoming messages to the console<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/dd>\n<\/dl>\n

Example:<\/h3>\n
\n
\n

CanDbc<\/strong> \/specs\/cyflex.dbc 12 &
\nThe above command starts\u00a0the task at priority 12 reading the \/specs\/cyflex.dbc.<\/p>\n

CanDbc<\/strong> \/specs\/cyflex.dbc time=10 12 &
\nThe above changes update time to 10, task at priority 12, reading the \/specs\/cyflex.dbc.<\/p>\n

CanDbc<\/strong> \/specs\/cyflex.dbc \/specs\/cyflex2.dbc 12 &
\nThe above command starts\u00a0the task at priority 12 reading the \/specs\/cyflex.dbc on one bus and reading \/specs\/cyflex2.dbc on a second bus.<\/p>\n

CanDbc<\/strong> \/specs\/cyflex.dbc \/dev\/pcanusb0 12 &
\nThe above uses USB can device \/dev\/pcanusb0 with priority 12<\/p>\n

CanDbc<\/strong> \/specs\/cyflex.dbc \/dev\/pcanusb0 baud1=250000 12 &
\nThe above uses USB can device \/dev\/pcanusb0 with priority 12 at baudrate 250000<\/p>\n

CanDbc<\/strong> \/specs\/cyflex.dbc \/dev\/pcanusb0 cyflex2.dbc \/dev\/pcanusb1 12 &
\nThe above uses USB can device \/dev\/pcanusb0 with priority 12 reading the \/specs\/cyflex.dbc on one bus and reading \/specs\/cyflex2.dbc on a second bus.<\/p>\n

CanDbc<\/strong> \/specs\/cyflex.dbc \/dev\/pcanusb0 baud1=250000
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \/specs\/cyflex2.dbc \/dev\/pcanusb1 baud2=125000 12 &
\nThe above uses USB can device \/dev\/pcanusb0 with priority 12 reading the \/specs\/cyflex.dbc at baudrate 250000 on one bus and reading \/specs\/cyflex2.dbc on a second bus at baudrate 125000.<\/p>\n

Candbc<\/strong> \/specs\/cyflex.dbc 12 seed=0x1234568 &
\nThe above command starts\u00a0the task at priority 12 reading the \/specs\/cyflex.dbc using a seed key of 12345678.<\/p>\n

Candbc<\/strong> \/specs\/cyflex.dbc 12 cpu=8 &
\nThe above command starts\u00a0the task at priority 12 reading the \/specs\/cyflex.dbc running on CPU 3.<\/p>\n<\/dd>\n<\/dl>\n

Notes:<\/h3>\n
\n
\n

Acceptable baud rates for USB are:
\n1000000
\n500000
\n250000
\n125000
\n50000
\n20000
\n10000
\n5000<\/p>\n

Acceptable baud rates for cards:
\n1000000
\n800000
\n500000
\n250000
\n125000
\n100000
\n50000
\n20000
\n10000<\/p>\n

Bit mask for a 4 core CPU:<\/p>\n<\/dd>\n<\/dl>\n

\n
\n

0,1 = CPU 0
\n2,3,6,7,10 = CPU 1
\n4,5 = CPU 2
\n8,9 = CPU3<\/p>\n

Can restart the bus connection by setting the event candbc_reset<\/p>\n

If you are having the problem: error while loading shared libraries: libpcan.so, then you may be missing a library. Check whether you have the library with the command: rpm -qa | grep pcandriver. If nothing shows up then you are missing the library. Install with: sudo yum install pcandriver<\/p>\n

Example .dbc file:
\nNormally the .dbc is generated by another application or already exists. Once the files exists, there are a few parameters that can be changed to determine what message is being sent or read. Here is a sample message from a .dbc, the carrots denote the number format and are not actually in the .dbc file:<\/p>\n

\u00a0\u00a0\u00a0<1>\u00a0 <2>\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<3>:\u00a0<4>\u00a0<5> \u00a0
\n\u00a0\u00a0\u00a0BO_\u00a03221225472\u00a0MSG_NAME:\u00a00\u00a0Vector__XXX \u00a0
\n\u00a0\u00a0\u00a0\u00a0\u00a0<6> <7> :<8>|<9>@<10><11> (<12>,<13>) [<14>|<15>]”<16>” <17> \u00a0
\n\u00a0\u00a0\u00a0\u00a0\u00a0SG_ Var1 : 48|16@1+\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0(1,0) [0|65000] “%”\u00a0\u00a0\u00a0\u00a0\u00a0Vector__XXX \u00a0
\n\u00a0\u00a0\u00a0\u00a0\u00a0SG_ Var2 : 32|16@1+\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0(1,0) [0|65000] “none”\u00a0\u00a0Vector__XXX \u00a0
\n\u00a0\u00a0\u00a0\u00a0\u00a0SG_ Var3 : 16|16@1+\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0(1,0) [0|65000] “none”\u00a0\u00a0Vector__XXX \u00a0
\n\u00a0\u00a0\u00a0\u00a0\u00a0SG_ Var4 :\u00a0\u00a00|16@1+\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0(1,0)\u00a0\u00a0[0|65000] “none” Vector__XXX<\/div>\n
    \n
  1. The BO_ indicates that this is a message<\/li>\n
  2. The number after the BO_ is the message ID in base 10. When making changes to the .dbc, most devices and manuals give the ID in hex. You need to manually convert that.<\/li>\n
  3. This is the message name<\/li>\n
  4. This does nothing in CyFlex.<\/li>\n
  5. This is just used as a brief description of the message and does 0nothing in CyFlex.<\/li>\n
  6. The SG_ indicates this is a signal for a variable<\/li>\n
  7. Is the variable name<\/li>\n
  8. the offest of bits at the start of a message. This indicates what bits to use when setting the cyflex variables. (This is normally stated in the device manual)<\/li>\n
  9. The size of the signal in bits. This indicates how many bits you use for the cyflex variable. (This is normally stated in the device manual)<\/li>\n
  10. This value indicates if the device and message being sent is LITTLE_ENDIAN or BIG_ENDIAN. 1 is LITTLE_ENDIAN, 0 is BIG_ENDIAN<\/li>\n
  11. The 10 is the ‘+’ sin above. – is for signed value, + is for unsigned.<\/li>\n
  12. This value is the factor used when calculating the value. It takes the raw value and multiples by the factor.<\/li>\n
  13. This value is the offset that is added after the factor has been multiplied.
    \nphysical_value = raw_value * factor + offset<\/li>\n
  14. Minimum value. The physical_value cannot be lower than this<\/li>\n
  15. Maximum value. The physical_value cannot be higher than this<\/li>\n
  16. This is the units to use in CyFlex<\/li>\n
  17. Just a description, not useful<\/li>\n<\/ol>\n<\/dd>\n<\/dl>\n

    See Also:<\/h3>\n

    \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 candbc_list<\/a>, candbc_set<\/a>, candbc_clear<\/a>, CAN Bus Interface Setup and Use<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"

    Purpose: Initialize CAN-AC1-PCI\/CAN-AC2-PCI cards or USB devices and capture data from up to 250 channels at a maximum of 50Hz. The program handles reconfiguration, diagnostics requests, and CCP protocol for CAN bus communications, encoding and decoding messages based on DBC file specifications. See Notes for\u00a0a description of how the .dbc file is composed. Enter: CanDbc […]<\/p>\n","protected":false},"author":47,"featured_media":0,"parent":1964,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-3322","page","type-page","status-publish","hentry"],"post_mailing_queue_ids":[],"_links":{"self":[{"href":"https:\/\/cyflex.com\/index.php\/wp-json\/wp\/v2\/pages\/3322","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cyflex.com\/index.php\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/cyflex.com\/index.php\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/cyflex.com\/index.php\/wp-json\/wp\/v2\/users\/47"}],"replies":[{"embeddable":true,"href":"https:\/\/cyflex.com\/index.php\/wp-json\/wp\/v2\/comments?post=3322"}],"version-history":[{"count":0,"href":"https:\/\/cyflex.com\/index.php\/wp-json\/wp\/v2\/pages\/3322\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/cyflex.com\/index.php\/wp-json\/wp\/v2\/pages\/1964"}],"wp:attachment":[{"href":"https:\/\/cyflex.com\/index.php\/wp-json\/wp\/v2\/media?parent=3322"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}