An NCurses-based TUI application for tracking activity over the CAN bus and decoding messages with provided EDS/OD files.
Project description
CANOpen Monitor
An NCurses-based TUI application for tracking activity over the CAN bus and decoding messages with provided EDS/OD files.
Quick Start
Install
$
pip install canopen-monitor
Run
Run the monitor, binding to can0
$
canopen-monitor -i can0
Use this for an extensive help menu
$
canopen-monitor --help
Configuration
The default configurations provided by CANOpen Monitor can be found in
canopen_monitor/assets. These are the default
assets provided. At runtime these configs are copied to
~/.config/canopen-monitor
where they can be modified and the changes
will persist.
EDS files are loaded from ~/.cache/canopen-monitor
Development and Contribution
Documentation
Check out our Read The Docs pages for more info on the application sub-components and methods.
Pre-Requisites
-
Linux 4.11 or greater (any distribution)
-
Python 3.8.5 or higher (pyenv is recommended for managing different python versions, see pyenv homepage for information)
Install Locally
Setup a virtual CAN signal generator
$
sudo apt-get install can-utils
Start a virtual CAN
$
sudo ip link add dev vcan0 type vcan
$
sudo ip link set up vcan0
Clone the repo
$
git clone https://github.com/Boneill3/CANopen-monitor.git
$
cd CANopen-monitor
$
pip install -e .[dev]
(Note: the -e
flag creates a symbolic-link to your local development version. Set it once, and forget it)
Generate random messages with socketcan-dev
$
chmod 700 socketcan-dev
$
./socketcan-dev.py --random-id --random-message -r
Start the monitor
$
canopen-monitor
Create documentation locally
$
make -C docs clean html
(Note: documentation is configured to auto-build with ReadTheDocs on every push to master)
Message Types + COB ID Ranges:
Wikipedia Table
Abridged Table:
Name | COB ID Range |
---|---|
SYNC | 080 |
EMCY | 080 + NodeID |
TPDO1 | 180 + NodeID |
RPDO1 | 200 + NodeID |
TPDO2 | 280 + NodeID |
RPDO2 | 300 + NodeID |
TPDO3 | 380 + NodeID |
RPDO3 | 400 + NodeID |
TPDO4 | 480 + NodeID |
RPDO4 | 500 + NodeID |
TSDO | 580 + NodeID |
RSDO | 600 + NodeID |
NMT (Heartbeat) | 700 + NodeID |
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for canopen_monitor-3.3.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b31f2f2066ddd48f739e41386ad14d87eb557c1a7a9a4e418c708b4dafbfc72e |
|
MD5 | 5449de40850313f0ad4048fd3be30252 |
|
BLAKE2b-256 | 7622cf1a1f8ee511eecae014c4530c184e157df568a6c5f62bc22eb63269f3d7 |