Skip to main content

USB Mode

This screen is displayed when the CAN Bus Debugger tool is under control by a PC. While in this state, physical tool controls are limited, however, pressing the ✔ button will toggle the tool's internal terminator state.


Enable USB control using an application that supports the gs_usb protocol. Some applications supporting this protocol are listed below in the PC Applications section.

PC Applications

CAN Bus Debugger is compatible with a range of PC utilities for analysing and interacting with CAN networks. Some of these utilities are listed below.

Alternatively, analyse .pcap captures created and stored on the CAN Bus Debugger tool in handheld mode at a later date using tools such as Wireshark. See the Log Files page for further information.

canutils​

The canutils suite is a collection of command-line utilities for working with CAN interfaces on Linux systems. These tools allow you to send, receive, and monitor CAN traffic, as well as configure CAN devices. Common utilities include candump (for monitoring CAN traffic), cansend (for sending CAN frames), and canconfig (for configuring CAN interfaces).

Supported Operating Systems​

  • Linux

These tools are included in many Linux distributions and work seamlessly with USB CAN adapters like the CAN Bus Debugger using the gs_usb protocol. Ensure the gs_usb kernel module is loaded in your Linux distribution for any gs_usb compatible device to function. Support for the CAN Bus Debugger was added to the gs_usb driver in Linux kernel version 5.18+. If you use an older kernel, manually compile and install a newer version of the gs_usb kernel module to ensure compatibility.

Refer to your Linux distribution's documentation for installation instructions, or see the canutils GitHub page for more details.

python-can​

python-can is a Python library that provides an interface for working with CAN networks. It supports sending and receiving CAN messages, and works with a variety of CAN hardware and drivers, including gs_usb compatible devices like the CAN Bus Debugger.

Supported Operating Systems​

  • Linux
  • Windows
  • macOS (untested with gs_usb devices)

Refer to the python-can documentation for installation instructions and more details.

cangaroo​

cangaroo is a cross-platform graphical application for analysing and visualising CAN traffic. It supports a range of CAN hardware, including gs_usb-compatible devices like the CAN Bus Debugger. cangaroo provides features such as message filtering, logging, and graphical data representation, making it suitable for diagnostics and development work.

Development of cangaroo stalled several years ago, but recent forks have added new features. The current official release does not support gs_usb devices using high-speed USB, so modifications are required for compatibility. A version that supports CAN Bus Debugger tools is available here.

Supported Operating Systems​

  • Windows

Refer to the cangaroo GitHub page for installation instructions and more details.

SavvyCAN​

SavvyCAN is an open-source, cross-platform CAN bus analysis tool with a graphical user interface. SavvyCAN is mainly used as a reverse engineering tool while offering features such as logging, graphing, fuzzing etc. It is popular for automotive and industrial CAN analysis.

The current main release of SavvyCAN does not support gs_usb devices on Windows (it uses socketCAN on Linux). There is currently a Pull Request to add support, but it is still awaiting final review. Once merged, full support will be available. Until then, a Windows version supporting the CAN Bus Debugger tool is available here.

Supported Operating Systems​

  • Linux
  • Windows
  • macOS (untested with gs_usb devices)

Refer to the SavvyCAN website for installation instructions, downloads, and documentation.