obdsim(1) Simulate an ELM327 device

SYNOPSIS

obdsim [ options ]

OPTIONS

-g|--generator <generator-name>
Choose a generator. A list of valid ones is output by --help. See section titled MULTIPLE ECUS below for more information.
-s|--seed <seed>
Generator-specific seed. See section titled PLUGIN SEEDS below for more information. The -s option must immediately follow the generator
-d|--customdelay <delay-in-ms>
Generator-specific delay. This is effectively a processing time for the ECU it is being added for. The -d option must immediately follow the generator
-l|--list-generators
Print a terse list of compiled in generators
-L|--list-protocols
Print a list of all protocols
-p|--protocol <OBDII protocol>
Launch as this protocol. Protocol is of form [A]{digit}, where optional "A" prefix means automatic and the digit is from --list-protocols
-n|--benchmark <time>
Change time to print samplerate to stdout. 'samples' are successful value returns, not AT commands or NO DATA/? responses. 'queries' are any and all client queries. Argument is in seconds, zero to disable.
-q|--logfile <logfile>
Write all serial comms to this logfile
-o|--launch-logger
Takes an [admittedly weak and hard-coded] attempt at launching obdgpslogger attached to the simulator in question. POSIX only.
-c|--launch-screen
Takes an [admittedly weak and hard-coded] attempt at launching screen attached to the simulator in question. To close that screen window, use ctrl-a, k. POSIX only.
-t|--tty-device
Instead of opening a pty, try to open this entry in /dev instead. POSIX only.
-w|--com-port <comport>
Specify virtual com port to be used on windows [eg "COM1"]. Windows only.
-e|--genhelp <generator-name>
Print out help for the specified generator, and exit.
-V|--elm-version <version string>
Pretend to be this when someone resets with ATZ or similar
-D|--elm-device <device string>
Pretend to be this when someone calls [email protected]
-b|--bluetooth
Listen on bluetooth. See section titled BLUETOOTH below
-v|--version
Print out version number and exit.
-h|--help
Print out help and exit.
 

BLUETOOTH

At time of writing, bluetooth is only supported on Linux. In order to make bluetooth work, you may need to set your bluetooth device to advertise that it's capable of the appropriate serial protocols.

On my system here, I use the following two commands to set it temporarily [you'll want to substitute your own hardware address]:


sudo rfcomm bind 0 00:02:72:14:41:C4 1
sudo sdptool add SP

AUTHORS

Gary "Chunky Ks" Briggs <[email protected]>