libcanardbc is a partial fork of cantools.sourceforge.net from rev47 (SVN). This fork has been made to remove dependencies on hdf5 and matio, and to fix compilation issues on Mac OS X in libdbc.
Only the DBC parser/lexer and associated library has been kept from the original project.
The original cantools project is licensed under GPLv3, this means you can't link the libraries of this project with a proprietary tool. This choice has been made on purpose by Andreas Heitmann and so this fork inherits of the license.
You will only need to install:
- automake
- autoconf
- libtool
- flex
- bison
- json-glib-1.0 (on Debian/Ubuntu: libjson-glib-dev; on other OSes probably a similar name)
and a C compiler (gcc or clang) to compile the library.
To install, just run the usual dance, ./configure && make install. Run
./autogen.sh first to generate the configure script if required.
The directory tools contains several tools related to libcanardbc:
-
dbc2json converts a DBC file to a JSON file. It's up to you to adapt it to your needs. This program is linked to libcanardbc so it is licensed under GPLv3.
-
json2dbc.py converts a JSON file to a DBC file. It is usually easier to write a JSON file by hand than a DBC one.
-
json2html renders a JSON file (DBC) to an HTML page. This program is distributed under BSD 3-Clause license.
Another project named caneton uses the generated JSON file of DBC to decode CAN messages.
The syntax of signals in DBC file is:
<object> <name> : <start bit>|<length>@<endiannes ex. 0 for Motorola, 1 for Intel><signedness ex. + (unsigned) or - (signed)> (<factor>,<offset>) <range, ex. 0|360> "<unit>" <nodes>
You can see an example of a valid JSON file here. Below is the description of the schema it uses:
{
"filename": "<filename>.dbc (optional)",
"version": "<dbc_version> (optional)",
"attribute_definitions": {
"<attribute_name>": {
"0": "<enum_value_0>",
"<n>": "<enum_value_<n>>"
}
}
"messages": {
"<can_id>": {
"name": "<message_name>",
"sender": "<sending_node>",
"length": <message_length_in_bytes>,
"has_multiplexor (optional) ": <true|false>,
"attributes": {
"<attribute_name_1>": "<attribute_value_1>",
"<attribute_name_<n>>": "<attribute_value_<n>>"
}
"signals": {
"signal_1": {
"bit_start": <signal_data_offset_in_message>,
"length": <signal_data_length_in_bits>,
"little_endian": <0|1>,
"signed": <0|1>,
"value_type": "<integer|float|double>",
"factor": <factor_applied_to_signal_numerical_value>,
"offset": <offset_applied_to_signal_numerical_value>,
"min": <min_applied_to_signal_numerical_value>,
"max": <max_applied_to_signal_numerical_value>,
"unit": "<signal_data_unit (optional)>",
"multiplexor (optional)": <does_the_signal_define_multiplex_ids>,
"multiplexing (optional)": <multiplex_id_in_which_the_signal_exists>,
"enums (optional)" : {
"<enum_0_value>": "<enum_0_name>",
"<enum_<n>_value>": "<enum_<n>_name>"
}
},
"
}
}
}
}
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent