Linux-CAN / SocketCAN user space applications
 
 
 
 
Go to file
Oliver Hartkopp 27030b3e54 lib: make sprint_canframe the buffer size aware snprintf_canframe
Make sure the library functions to convert CAN frames into ASCII
represenation do not exceed the given buffer size. This also applies
to the long CAN frame output library function.

Signed-off-by: Oliver Hartkopp <socketcan@hartkopp.net>
2024-03-12 19:11:58 +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 rockchip_canfd 2023-12-11 09:37:33 +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 Linux v6.9 upstream 2024-02-14 20:18:29 +01:00
isobusfs Fixes musl build for ARMv7 2024-02-20 11:06:13 +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: ignore isobusfs dirstamp 2024-02-19 09:39:39 +01: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 cmake: fix build of isobusfs tools 2024-02-19 09:45:30 +01:00
GNUmakefile.am GNUmakefile: isobus: include scripts in tarball 2024-02-19 09:44:32 +01:00
Makefile Merge pull request #500 from marckleinebudde/isobus 2024-02-19 10:17:52 +01:00
README.md canlogserver: Update the description 2023-05-13 17:25:17 +02:00
asc2log.c lib: make sprint_canframe the buffer size aware snprintf_canframe 2024-03-12 19:11:58 +01: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 lib: make sprint_canframe the buffer size aware snprintf_canframe 2024-03-12 19:11:58 +01:00
canfdtest.c canfdtest: with -vvv verbosity also print the MSG_DONTROUTE and MSG_CONFIRM flags 2024-01-17 10:13:32 +01: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 lib: make sprint_canframe the buffer size aware snprintf_canframe 2024-03-12 19:11:58 +01:00
cangw.c remove obsolete char pointer casts 2022-03-14 18:21:45 +01:00
canlogserver.c lib: make sprint_canframe the buffer size aware snprintf_canframe 2024-03-12 19:11:58 +01:00
canplayer.c lib: make sprint_canframe the buffer size aware snprintf_canframe 2024-03-12 19:11:58 +01:00
cansend.c lib/cansend: update documentation for CAN XL frame format 2024-02-29 09:54:47 +01:00
cansequence.c cansequence: add missing "--strict" to long_options 2023-12-05 10:38:23 +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 isotprecv: add option to enable dynamic flow control parameters 2024-02-14 21:18:58 +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 isotpsniffer: simplify option for CAN FD link layer 2023-12-08 17:29:04 +01: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: make sprint_canframe the buffer size aware snprintf_canframe 2024-03-12 19:11:58 +01:00
lib.h lib: make sprint_canframe the buffer size aware snprintf_canframe 2024-03-12 19:11:58 +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 log: finalize unified buffer handling 2024-02-29 08:41:21 +01:00
log2long.c lib: make sprint_canframe the buffer size aware snprintf_canframe 2024-03-12 19:11:58 +01: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 slcanpty: print_usage(): factor out help text into separate function 2024-02-19 08:46:31 +01: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: