ReverseGear can be installed with pip: pip3 install reversegear.
A variety of techniques exist for reverse engineering components by analyzing vehicle logs. ReverseGear aims to provide tools for automating these techniques. It is only intended for working offline, using logs of network traffic. For an online tool, see caringcaraboo.
Currently, only candump format logs files are supported. To generate a log using candump, the -l (or -L) flag must be used.
For example, to log from the can0 interface:
candump -l can0
ReverseGear uses a number of subcommands. In general, you can get help with reversegear --help, and reversegear [subcommand] --help.
Subcommand for generating arbitration ID statistics.
Usage: reversegear uds [-h] tx_id rx_id inputs [inputs ...]
Example: reversegear ids log.txt
Subcommand for decoding Unified Diagnostic Services (ISO14229) traffic. Requires the arbitration ID transmitted by the client/scan tool (tx_id) and the arbitration ID received by the client/scan tool (rx_id).
Usage: reversegear uds [-h] tx_id rx_id inputs [inputs ...]
Example: reversegear uds 0x7F1 0x7F9 log.txt
Subcommand for displaying unique arbitration IDs in two files.
Usage: reversegear iddiff [-h] a b
Example reversegear iddiff log_one.txt log_two.txt