Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/PlotJuggler/plotjuggler-CAN-dbs
Plugin to visualize CAN .dbs files in PlotJuggler
https://github.com/PlotJuggler/plotjuggler-CAN-dbs
Last synced: 3 months ago
JSON representation
Plugin to visualize CAN .dbs files in PlotJuggler
- Host: GitHub
- URL: https://github.com/PlotJuggler/plotjuggler-CAN-dbs
- Owner: PlotJuggler
- License: mit
- Created: 2021-03-28T15:09:31.000Z (over 3 years ago)
- Default Branch: development
- Last Pushed: 2023-12-16T10:21:43.000Z (11 months ago)
- Last Synced: 2024-04-16T06:07:31.979Z (7 months ago)
- Language: C++
- Size: 2.54 MB
- Stars: 35
- Watchers: 5
- Forks: 7
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-canbus - PlotJuggler::CAN-dbs - Plugin to visualize CAN .dbs (or .dbc?) files in PlotJuggler. (Utils / GUI Tools)
README
# plotjuggler-CAN-dbs
Plugins to visualize CAN .dbs files and streams in PlotJuggler.
Using the plugins, One can;
* Visualize CAN logs created by `candump -L` in PlotJuggler using a can database file (for ex. .dbc)
* Visualize CAN streams
# Prerequisites
* PlotJuggler (3.2 or later)
* Qt5 SerialBus (Optional, required for DataStreamCAN)
# Building the CAN plugins
To build any plugin, PlotJuggler must be installed in your system.
For instance, in Linux, you should perform a full compilation and installation:
```BASH
git clone --recurse-submodules https://github.com/facontidavide/PlotJuggler.git
cd PlotJuggler
mkdir build; cd build
cmake ..
make -j
sudo make install
```
After successfull installation of PlotJuggler, one can build DataLoadCAN and DataStreamCAN plugins as follows.
```BASH
git clone --recurse-submodules https://github.com/PlotJuggler/plotjuggler-CAN-dbs.git
cd plotjuggler-CAN-dbs
mkdir build; cd build
cmake ..
make
```
An alternative approach is including this project in a local copy of PlotJuggler. This approach might be preferable on Windows or AppImage builds
```BASH
git clone --recurse-submodules https://github.com/facontidavide/PlotJuggler.git
cd PlotJuggler/plotjuggler_plugins
git clone --recurse-submodules https://github.com/PlotJuggler/plotjuggler-CAN-dbs.git
# Add the following line in the CMakeList.txt of the PlotJuggler, just after other plugin include lines
# add_subdirectory( plotjuggler_plugins/plotjuggler-CAN-dbs )
cd ../; mkdir build; cd build # Create a build folder in the root of PlotJuggler
cmake ..
make -j
sudo make install # In this approach, system-wide install is optional, you can diretly use the PJ inside the bin with CAN plugins included
```
# Using the plugins
After building the plugins, one needs to include build directory to the plugins directory of the PlotJuggler.
App -> Preferences -> Plugins
## DataLoadCAN
If DataLoadCAN plugin is loaded, you will be able to import `.log` files. When a `.log` file is choosen, another dialog will be opened for selecting the database (`.dbc`) and the protocol (`RAW`, `NMEA2K` or `J1939`).
## DataStreamCAN
CAN Streamer plugin is only built if Qt5 SerialBus plugin is installed in your machine (surprisingly, it is not possible to install via apt on Ubuntu 18.04).
If you want to use CAN Streamer plugin (and your machine does not have the plugin), you can check [this gist](https://gist.github.com/awesomebytes/ed90785324757b03c8f01e3ffa36d436) for instructions on how to install Qt5 Serialbus.
When you start CAN Streamer plugin, a connect dialog will be opened as in the figures below. After choosing the correct backend and interface, one need to click `Load CAN Database`, which opens another dialog for selecting the database (`.dbc` only for now) and the protocol (`RAW`, `NMEA2K` or `J1939`). Only after the database dialog is accepted, OK button will be enabled for you to start the streamer.
# Details about the plugins
RAW CAN signals are added to the plot in the following format:
`can_frames//`
NMEA2K signals are added to the plot in the following formats:
* When the received PGN is PDU Format 1:
* `nmea2k_msg/PDUF1/ ()///`
* When the received PGN is PDU Format 2 (i.e. broadcast type):
* `nmea2k_msg/PDUF2/ ()//`
J1939 signals are added to the plot just like the NMEA2K ones, with only difference being the the use of prefix `j1939_msg` instead of `nmea2k_msg`.