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.
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.
- 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!
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
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] <tty> [canif-name]
Options: -l (set transciever to listen mode)
-s <speed> (set CAN speed in bits per second)
-S <speed> (set UART speed in baud)
-e (set interface to extended id mode)
-F (stay in foreground; no daemonize)
-m <mode> (0: normal (default), 1: loopback, 2:silent, 3: loopback silent)
-h (show this help page)
Examples:
hlcand -m 2 -s 500000 /dev/ttyUSB0