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.

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