USB CAN Converter (UCCB)

UCCBViewer is GUI program for USBCanConveterBasic device. uCCBViewer functionalities are: frame reception, transmission, filtering, listen-only or loopback configuration. To run this program Java Runtime Enviroment(JRE) needs to be installed. To run UCCBViewer on Linux remember to run this program as superuser. sudo java -jar uCCBViewer-2.1.jar
Download newest release
Sources for UCCBViewer

uCCBlib is JAVA library for CAN converter.
Download UCCBLib_v1.2.jar (2016-11-21)
Sources for UCCBlib

python-can libray is supporting UCCB for capabilities of python tools see this tutorial

pyUSBtin is python Library that partialy works with UCCB (filtering not working). Library can be found on https://github.com/fishpepper/pyUSBtin.

JAVA SCRIPT tools are under development.

UCCB has alternative firmware for that implments the gs_usb protocol. This is supported by the mainline Linux kernel and SocketCAN. It does not require use of slcand and should be more reliable at high bitrates. For this reason, GSUSB is recommended if you are only using UCCB on Linux. The GSYSB firmware was written by Hubert Denkmair, and is released under the MIT license. The source code is available on Github. Thanks to Hubert for his work on this project! To see how to flash new firmware look to Sources tab.

UCCB_GSUSB firmware hex files

To use UCCB with GSUSB You need upload new software. Binaries can be found GitHub Release. Sources are on GitHub

Using UCCB_GSUSB firware

Ensure the gs_usb kernel module is enabled:

sudo modprobe gs_usb 
sudo modprobe can_dev

Connect device to USB, and check if initialized properly

ip link list

There should be sth like this

10: can0: NOARP,ECHO mtu 16 qdisc noop state DOWN mode DEFAULT group default qlen 10 link/can 

Connect UCCB device to CAN network.
Configure the device:

sudo ip link set can0 type can bitrate 500000

Replace can0 with the name of your device, and 500000 with the desired bitrate.
Bring the device up:

sudo ifconfig can0 up

Use the device with SocketCAN. For example, candump can0. See SocketCAN for more information.

CsharpUSBtinLib is c# Library that partially works with UCCB (filtering not working). Library can be found on https://github.com/leonel85/CsharpUSBtinLib.

Full support C# tools are under development.

UCCB is compatible with official Linux CAN implementation. Here is step by step guide on UBUNTU:

Load kernel modules

	 $ sudo modprobe can
	 $ sudo modprobe can-raw
	 $ sudo modprobe slcan

Discover serial device name

If You plug it by USB port it should be something like ttyACM0. If you connect it by side UART connector you should use one of Your existing serial ports ttyS1 or ttyUSB if you are using usb to serial adapter.

CAN-utils compilation

This is done only once. You need to have git installed. If you have one ignore first line

	 $ sudo apt-get install git
	 $ git clone https://github.com/vitroTV/can-utils.git
	 $ cd can-utils
	 $ make

Start CAN interace

See options for slcan_attach by executing

$ ./slcan_attach

You should get

Options: -o         (send open command 'O\r')
	-l         (send listen only command 'L\r', overrides -o)
	-c         (send close command 'C\r')
	-f         (read status flags with 'F\r' to reset error states)
	-s speed (set CAN speed 0..8)
	-b btr   (set bit time register value)
	-d         (only detach line discipline)
	-w         (attach - wait for keypess - detach)
	-n name  (assign created netdevice name)

	Examples:
	slcan_attach -w -o -f -s6 -c /dev/ttyS1
	slcan_attach /dev/ttyS1
	slcan_attach -d /dev/ttyS1
	slcan_attach -w -n can15 /dev/ttyS1

s0..8 stand for bound rate from 10Kbps to 1Mbps for sampling point 75%. See source code or slcan documentation for details.

Example with opening for 250Kbs speed connected to ttyACM0.

	$ sudo ./slcan_attach -f -s5 -o /dev/ttyACM0
		attached tty /dev/ttyACM0 to netdevice slcan0
	$ sudo ./slcand ttyACM0 slcan0
	$ sudo ifconfig slcan0 up

Test CAN-utils

There is several features of CAN-utils see folder contests and check all executables for description here are examples.

List all received CAN messages.

$ ./candump slcan0

Wireshark support

For CAN frame analysis You can use Wireshark. This works only on Linux. To install Wireshark type:

$ sudo apt-get install Wireshark

After installation run Wireshark, "slcan0" interface should be visible and You are ready to go!

Known Issues

If You get timeout message on connecting to ttyACM then try to remove modemmanager.

sudo apt-get --purge remove modemmanager