Awesome

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

alt text

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.

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] <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