Man page - cangen(1)

Packages contains this manual

Package:  can-utils
apt-get install can-utils

Manuals in package:
• j1939spy(1)
• isotpperf(1)
• log2asc(1)
• cangen(1)
• isotpsniffer(1)
• canbusload(1)
• isotprecv(1)
• slcan_attach(1)
• j1939sr(1)
• slcanpty(1)
• j1939acd(1)
• can-calc-bit-timing(1)
• cansniffer(1)
• canplayer(1)
• canfdtest(1)
• cangw(1)
• asc2log(1)
• slcand(1)
• isotpdump(1)
• testj1939(1)
• cansequence(1)
• candump(1)
• cansend(1)
• isotptun(1)
• isotpserver(1)
• canlogserver(1)
• isotpsend(1)
• j1939cat(1)
Documentations in package:
• can-utils

Manual

CANGEN

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
Generation modes:
EXAMPLES

---

NAME

cangen - manual page for cangen 2023.03-1

SYNOPSIS

cangen [ options ] <CAN interface>

DESCRIPTION

cangen - CAN frames generator.

OPTIONS

-g <ms>

(gap in milli seconds - default: 200 ms)

	-a		(use absolute time for gap)
	-t		(use SO_TXTIME)

--start <ns>

(start time (UTC nanoseconds))

--mark <id>

(set SO_MARK to <id>, default 1)

	-e		(generate extended frame mode (EFF) CAN frames)
	-f		(generate CAN FD CAN frames)
	-b		(generate CAN FD CAN frames with bitrate switch (BRS))
	-E		(generate CAN FD CAN frames with error state (ESI))
	-R		(generate RTR frames)
	-8		(allow DLC values greater then 8 for Classic CAN frames)
	-m		(mix -e -f -b -E -R frames)

-I <mode>

(CAN ID generation mode - see below)

-L <mode>

(CAN data length code (dlc) generation mode - see below)

-D <mode>

(CAN data (payload) generation mode - see below)

-p <timeout>

(poll on -ENOBUFS to write frames with <timeout> ms)

-n <count>

(terminate after <count> CAN frames - default infinite)

	-i		(ignore -ENOBUFS return values on write() syscalls)
	-x		(disable local loopback of generated CAN frames)

-c <count>

(number of messages to send in burst, default 1)

-v

(increment verbose level for printing sent CAN frames)

Generation modes:

	’r’		=> random values (default)
	’e’		=> random values, even ID
	’o’		=> random values, odd ID
	’i’		=> increment values

<value> => fixed value (in hexadecimal for -I and -D )

=> nibbles written as ’x’ are randomized (only -D )

The gap value (in milliseconds) may have decimal places, e.g. ’-g 4.73’ When incrementing the CAN data the data length code minimum is set to 1. CAN IDs and data content are given and expected in hexadecimal values.

EXAMPLES

cangen vcan0 -g 4 -I 42A -L 1 -D i -v -v

(fixed CAN ID and length, inc. data)

cangen vcan0 -e -L i -v -v -v

(generate EFF frames, incr. length)

cangen vcan0 -D 11223344DEADBEEF -L 8

(fixed CAN data payload and length)

cangen vcan0 -D 11xx3344DEADBEEF -L 8

(fixed CAN data payload where 2. byte is randomized, fixed length)

cangen vcan0 -I 555 -D CCCCCCCCCCCCCCCC -L 8 -g 3.75

(generate a fix busload without bit-stuffing effects)

cangen vcan0 -g 0 -i -x

(full load test ignoring -ENOBUFS)

cangen vcan0 -g 0 -p 10 -x

(full load test with polling, 10ms timeout)

cangen vcan0

(my favourite default :)

---