Linux-CAN / SocketCAN user space applications
 
 
 
 
Go to file
Marc Kleine-Budde 88f0c75334
Merge pull request #476 from marckleinebudde/cansequence
cansequence: cleanups and add support for CAN-FD
2023-11-29 18:35:43 +01:00
.github/workflows Create codeql-analysis.yml 2022-06-13 17:42:33 +02:00
LICENSES Add license texts as files 2019-09-26 15:45:43 +02:00
calc-bit-timing can-calc-bit-timing: add verbose mode to print bit timing limits 2023-11-29 11:39:56 +01:00
cmake CMake first pass (#90) 2018-08-17 09:50:30 +02:00
config/m4 add autotools infrastructure 2010-04-19 12:12:18 +00:00
include/linux include: update includes to latest Linux v6.2 upstream 2023-02-25 14:55:00 +01:00
mcp251xfd mcp251xfd-dump: add support for dumps created with Linux kernel >= v5.18 2023-01-03 20:31:54 +01:00
.clang-format Add .clang-format 2023-09-05 10:50:54 +02:00
.gitignore gitignore: add ccls related files 2023-08-01 21:45:43 +02:00
.travis.yml travis: fix env for ppc64le 2020-10-19 14:37:30 +02:00
Android.mk [fix] Adding lib.c to rule of slcanpty build 2023-03-22 14:51:39 +01:00
CMakeLists.txt Don't compile programs using fork() on MMU-less systems 2023-05-08 18:30:50 +02:00
GNUmakefile.am can-calc-bit-timing: move kernel compatibility stuff into own header 2023-08-01 21:45:43 +02:00
Makefile Don't compile programs using fork() on MMU-less systems 2023-05-08 18:30:50 +02:00
README.md canlogserver: Update the description 2023-05-13 17:25:17 +02:00
asc2log.c timestamp formatting: always use 64-bit for timesstamp formatting. 2023-11-28 08:30:27 +08:00
autogen.sh do not use --symlink for autoreconf 2014-07-02 16:03:34 +02:00
bcmserver.c custom if statement reordering 2020-10-12 23:48:38 -07:00
can-j1939-install-kernel-module.md can utils [can-j1939-install-kernel-module.md]: better explanation for adding backports, fixed typos and grammar (#247) 2020-10-06 15:33:57 +02:00
can-j1939-kickstart.md can-j1939-kickstart.md: fix example in documentation 2020-05-30 19:32:32 +02:00
can-j1939.md Fix spelling in various files 2019-11-11 14:21:49 +01:00
can-tc-init-etf.sh can-tc-init-etf: document required kernel config options 2022-12-13 22:13:37 +01:00
canbusload.c canbusload: main(): switch from pselect() to select() 2023-10-06 12:32:42 +02:00
candump.c timestamp formatting: always use 64-bit for timesstamp formatting. 2023-11-28 08:30:27 +08:00
canfdtest.c canfdtest: Follow Bash exit status when signaled 2023-03-20 10:23:01 +09:00
canframelen.c canbusload: count databitrate seperately 2021-06-24 14:44:50 +02:00
canframelen.h canbusload: count databitrate seperately 2021-06-24 14:44:50 +02:00
cangen.c cangen: update CAN FD check to cope with CAN XL interfaces 2023-05-09 14:30:16 +02:00
cangw.c remove obsolete char pointer casts 2022-03-14 18:21:45 +01:00
canlogserver.c timestamp formatting: always use 64-bit for timesstamp formatting. 2023-11-28 08:30:27 +08:00
canplayer.c timestamp formatting: always use 64-bit for timesstamp formatting. 2023-11-28 08:30:27 +08:00
cansend.c cansend: update CAN FD check to cope with CAN XL interfaces 2023-05-09 14:21:46 +02:00
cansequence.c cansequence: add option to ignore classical CAN frames 2023-11-29 18:28:32 +01:00
cansniffer.c cansniffer: Follow Bash exit status when signaled 2023-03-20 10:22:21 +09:00
check_cc.sh Don't compile programs using fork() on MMU-less systems 2023-05-08 18:30:50 +02:00
configure.ac Don't compile programs using fork() on MMU-less systems 2023-05-08 18:30:50 +02:00
fork_test.c Don't compile programs using fork() on MMU-less systems 2023-05-08 18:30:50 +02:00
isotpdump.c timestamp formatting: always use 64-bit for timesstamp formatting. 2023-11-28 08:30:27 +08:00
isotpperf.c timestamp formatting: always use 64-bit for timesstamp formatting. 2023-11-28 08:30:27 +08:00
isotprecv.c remove obsolete char pointer casts 2022-03-14 18:21:45 +01:00
isotpsend.c isotpsend: add support for transmission without flow control 2022-05-13 20:00:45 +02:00
isotpserver.c remove obsolete char pointer casts 2022-03-14 18:21:45 +01:00
isotpsniffer.c timestamp formatting: always use 64-bit for timesstamp formatting. 2023-11-28 08:30:27 +08:00
isotptun.c isotptun: Follow Bash exit status when signaled 2023-03-20 10:22:30 +09:00
j1939acd.c j1939acd: Follow Bash exit status when signaled 2023-03-20 10:23:10 +09:00
j1939cat.c timestamp formatting: always use 64-bit for timesstamp formatting. 2023-11-28 08:30:27 +08:00
j1939spy.c timestamp formatting: always use 64-bit for timesstamp formatting. 2023-11-28 08:30:27 +08:00
j1939sr.c clang-tidy: sort includes alphabetically 2020-10-12 23:28:58 -07:00
lib.c lib: snprintf_can_error_frame(): don't bail out if CAN_ERR_CNT is set 2023-09-27 16:26:50 +02:00
lib.h lib.h: add forgotten declaration 2022-12-19 15:31:23 +01:00
libj1939.c clang-tidy: sort includes alphabetically 2020-10-12 23:28:58 -07:00
libj1939.h libj1939.h: fix typo 2022-01-03 10:58:05 +01:00
log2asc.c timestamp formatting: always use 64-bit for timesstamp formatting. 2023-11-28 08:30:27 +08:00
log2long.c clang-tidy: sort includes alphabetically 2020-10-12 23:28:58 -07:00
page.theme import sample program & help page 2013-11-20 11:14:44 +01:00
slcan_attach.c slcan: increase BTR char limit to 8 for 32bit BTR 2023-02-23 16:36:33 +01:00
slcand.c slcand: Follow Bash exit status when signaled 2023-03-20 10:23:18 +09:00
slcanpty.c timestamp formatting: always use 64-bit for timesstamp formatting. 2023-11-28 08:30:27 +08:00
style.css import sample program & help page 2013-11-20 11:14:44 +01:00
terminal.h Add SPDX identifiers 2019-06-19 12:24:24 +02:00
testj1939.c closes #master: Fixed typo erros in slcan and testj1939 2022-02-01 19:55:27 +05:30

README.md

SocketCAN logo

SocketCAN userspace utilities and tools

This repository contains some userspace utilities for Linux CAN subsystem (aka SocketCAN):

Basic tools to display, record, generate and replay CAN traffic

  • candump : display, filter and log CAN data to files
  • canplayer : replay CAN logfiles
  • cansend : send a single frame
  • cangen : generate (random) CAN traffic
  • cansequence : send and check sequence of CAN frames with incrementing payload
  • cansniffer : display CAN data content differences

CAN access via IP sockets

  • canlogserver : log CAN frames and serves them
  • bcmserver : interactive BCM configuration (remote/local)
  • socketcand : use RAW/BCM/ISO-TP sockets via TCP/IP sockets
  • cannelloni : UDP/SCTP based SocketCAN tunnel

CAN in-kernel gateway configuration

  • cangw : CAN gateway userspace tool for netlink configuration

CAN bus measurement and testing

  • canbusload : calculate and display the CAN busload
  • can-calc-bit-timing : userspace version of in-kernel bitrate calculation
  • canfdtest : Full-duplex test program (DUT and host part)

ISO-TP tools ISO15765-2:2016 for Linux

  • isotpsend : send a single ISO-TP PDU
  • isotprecv : receive ISO-TP PDU(s)
  • isotpsniffer : 'wiretap' ISO-TP PDU(s)
  • isotpdump : 'wiretap' and interpret CAN messages (CAN_RAW)
  • isotpserver : IP server for simple TCP/IP <-> ISO 15765-2 bridging (ASCII HEX)
  • isotpperf : ISO15765-2 protocol performance visualisation
  • isotptun : create a bi-directional IP tunnel on CAN via ISO-TP

J1939/ISOBus tools

  • j1939acd : address claim daemon
  • j1939cat : take a file and send and receive it over CAN
  • j1939spy : spy on J1939 messages using SOC_J1939
  • j1939sr : send/recv from stdin or to stdout
  • testj1939 : send/receive test packet

Follow the link to see examples on how this tools can be used: Kickstart guide to can-j1939 on linux

Log file converters

  • asc2log : convert ASC logfile to compact CAN frame logfile
  • log2asc : convert compact CAN frame logfile to ASC logfile
  • log2long : convert compact CAN frame representation into user readable

Serial Line Discipline configuration (for slcan driver)

  • slcan_attach : userspace tool for serial line CAN interface configuration
  • slcand : daemon for serial line CAN interface configuration
  • slcanpty : creates a pty for applications using the slcan ASCII protocol

CMake Project Generator

  • Place your build folder anywhere, passing CMake the path. Relative or absolute.
  • Some examples using a build folder under the source tree root:
  • Android : cmake -DCMAKE_TOOLCHAIN_FILE=~/Android/Sdk/ndk-bundle/build/cmake/android.toolchain.cmake -DANDROID_PLATFORM=android-21 -DANDROID_ABI=armeabi-v7a .. && make
  • Android Studio : Copy repo under your project's app folder, add add_subdirectory(can-utils) to your CMakeLists.txt file after cmake_minimum_required(). Generating project will build Debug/Release for all supported EABI types. ie. arm64-v8a, armeabi-v7a, x86, x86_64.
  • Raspberry Pi : cmake -DCMAKE_TOOLCHAIN_FILE=~/rpi/tools/build/cmake/rpi.toolchain.cmake .. && make
  • Linux : cmake -GNinja .. && ninja
  • Linux Eclipse Photon (Debug) : CC=clang cmake -G"Eclipse CDT4 - Unix Makefiles" ../can-utils/ -DCMAKE_BUILD_TYPE=Debug -DCMAKE_ECLIPSE_VERSION=4.8.0
  • To override the base installation directory use: CMAKE_INSTALL_PREFIX ie. CC=clang cmake -DCMAKE_INSTALL_PREFIX=./out .. && make install

Additional Information: