Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alexmohr/usb-can
USB-CAN Analyzer Linux Support
https://github.com/alexmohr/usb-can
can can-bus canbus driver drivers hl-340 kernel-driver kernel-module linux qinheng-electronics usb-id-1a86-7523
Last synced: about 2 months ago
JSON representation
USB-CAN Analyzer Linux Support
- Host: GitHub
- URL: https://github.com/alexmohr/usb-can
- Owner: alexmohr
- License: gpl-2.0
- Fork: true (kobolt/usb-can)
- Created: 2018-12-27T00:32:20.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-05-22T22:45:32.000Z (over 1 year ago)
- Last Synced: 2024-04-16T06:07:35.782Z (5 months ago)
- Topics: can, can-bus, canbus, driver, drivers, hl-340, kernel-driver, kernel-module, linux, qinheng-electronics, usb-id-1a86-7523
- Language: C
- Homepage:
- Size: 378 KB
- Stars: 35
- Watchers: 4
- Forks: 13
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-canbus - Seeed-USB-CAN-Linux - CLI Linux Support for noname Chinese USB-CAN adapter. (Utils / Other Utils)
README
[](https://travis-ci.com/alexmohr/usb-can)
# USB-CAN Analyzer Linux Support
This repository implements a kernel module which adds support for QinHeng Electronics HL-340 USB-Serial adapter
It is based on the works https://github.com/kobolt/usb-can and the linux slcan driver.
Adapters like the one below are supported
The adapters can be found everywhere on Ebay nowadays, but there is no official Linux support. Only a Windows binary file [stored directly on GitHub](https://github.com/SeeedDocument/USB-CAN_Analyzer).
When plugged in, it will show something like this:
```
Bus 002 Device 006: ID 1a86:7523 QinHeng Electronics HL-340 USB-Serial adapter
```
And the whole thing is actually a USB to serial converter, for which Linux will provide the 'ch341-uart' driver and create a new /dev/ttyUSB device. So this program simply implements part of that serial protocol.
## Requirements
* can-utils
* kernel-headers (i.e. sudo apt install linux-headers-$(uname -r))
**Please note that this module cannot be used together with slcan, make sure the module is not loaded and won't be loaded automatically!**
## Building & Installation
To build the module and the userspace tools run ``make`` in ``src`` and ``src/modules`` or run
````
./build.sh
````
If you need to sign the module, on Ubuntu machines you can run something like
````
kmodsign sha512 /var/lib/shim-signed/mok/MOK.priv /var/lib/shim-signed/mok/MOK.der src/module/hlcan.ko
````
To install run ``make install`` in the folders listed above or
````
./build.sh install
````
or to remove
````
./build.sh remove
````
## Usage
Load the kernel module
````
modprobe can-dev
insmod hlcan.ko
````
Start hlcand
Listen only
````
hlcand -m 2 -s 500000 /dev/ttyUSB0
````
Foreground
````
hlcand -F -s 500000 /dev/ttyUSB0
````
Extended Frames
````
hlcand -e -s 500000 /dev/ttyUSB0
````
Enable the interface
````
ip link set can0 up
````
Help
````
Usage: ./hlcand [options] [canif-name]
Options: -l (set transciever to listen mode)
-s (set CAN speed in bits per second)
-S (set UART speed in baud)
-e (set interface to extended id mode)
-F (stay in foreground; no daemonize)
-m (0: normal (default), 1: loopback, 2:silent, 3: loopback silent)
-h (show this help page)
Examples:
hlcand -m 2 -s 500000 /dev/ttyUSB0
````