-
Notifications
You must be signed in to change notification settings - Fork 29
/
README
executable file
·87 lines (70 loc) · 2.99 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
General Information
===================
cantools is a set of libraries and command line tools for handling
ASC, BLF, CLG, VSB, MDF, and DBC files from Vector-Informatik and
others. The tools can be used to analyze and convert the data to other
formats:
* dbcls lists the contents of a DBC file.
* cantomat converts log files in ASC, BLF, CLG, VSB format to a MAT
* file (MATLAB format)
* mdftomat converts log files in MDF format to a MAT file (up to MDF
version 3.x)
Some tools are available for testing of converters:
* matdump displays the content of a MAT file as ASCII text
* dbccopy copies a DBC file
The tools 'cantomat' and 'mdftomat' require the package matio,
which in turn requires the package hdf5. Support for these
tools is optional; either disable them with '--disable-matlab'
configure option or make sure hdf5 and matio dependencies are
installed first (see instructions below).
Since hdf5 is intended only for native builds,
it is recommended to disable the optional tools on cross-compile
builds of cantools in order to avoid this dependency
https://support.hdfgroup.org/HDF5/faq/compile.html#cross
Shared libraries for parsing and accessing these files are also
provided:
* libcandbc, libcanasc, libcanblf, libcanclg, libcanvsb, libcanmdf for
parsing of DBC, ASC, BLF, CLG, VSB, MDF files
Installation of hdf5 (cygwin)
=============================
Prerequisites: zlib, zlib-devel, bison , flex, make, gcc
matio can be built with libhdf5, here is how to:
1) download:
wget https://support.hdfgroup.org/ftp/HDF5/current/src/hdf5-1.10.5.tar.bz2
2) unpack:
tar xjf hdf5-1.10.5.tar.bz2
3) build:
cd hdf5-1.10.5
./configure --with-zlib=/usr/include,/lib --prefix=/usr --with-default-api-version=v110
CFLAGS=-std=c99 make
CFLAGS=-std=c99 make check
4) install:
make install
Installation of matio (cygwin)
==============================
Prerequisites: autotools, zlib, zlib-devel, make, gcc
1) download matio-1.5.17.tar.gz:
wget 'http://downloads.sourceforge.net/matio/matio-1.5.17.tar.gz?use_mirror=' -O matio-1.5.17.tar.gz
or
curl -o matio-1.5.17.tar.gz -L 'http://downloads.sourceforge.net/matio/matio-1.5.17.tar.gz?use_mirror='
2) unpack:
tar xzf matio-1.5.17.tar.gz
3) configure:
cd matio-1.5.17
./configure --with-zlib=/ --with-hdf5=/ --prefix=/usr
4) build and install:
make ; make install
Installation of zlib, hdf5, matio (linux)
=======================================
sudo apt-get install cmake gcc libz-dev libmatio-dev flex bison libbison-dev
Building cantools
=================
Prerequisites (cygwin): cmake, bison, flex, make, gcc, zlib, zlib-devel, pkg-config
Prerequisites (linux): cmake, libz-dev, libmatio-dev, flex, bison, libbison-dev, make, gcc, pkg-config
git clone https://github.com/aheit/cantools cantools-code
cd cantools
cmake -S . -B build
cmake --build build
CMAKE configurations options (can be combined):
cmake -DMATLAB=OFF (default: ON) - only build tools without MATLAB backend
cmake -DMALLOC=ON (default: OFF) - build with dmalloc debug library