ELM327-emulator 2.1.0

ELM327 Emulator for testing software interfacing OBDII via ELM327 adapter

ELM327-emulator

A Python emulator of the ELM327 OBD-II adapter connected to a vehicle.

ELM327-emulator provides an emulated OBD-II interface to client applications via TCP/IP networking, or serial communication (using the pseudo-terminal function on UNIX/Linux, or the pyserial library, or the standard communication library) and simulates an ELM327 adapter connected to a vehicle. It includes a command-line interface for extensive monitoring and controlling.

ELM327-emulator is agnostic of the client application accessing the serial port and has been tested with python-OBD. It supports TCP/IP, Bluetooth, serial COM ports and pseudo-tty devices.

An internal dictionary (named ObdMessage) allows configuring the emulation, which is currently set to reproduce the message flow generated by a Toyota Auris Hybrid car (through the scenario car option), including custom PIDs and can be easily configured to statically and dynamically update its dictionary to simulate OBD-II answers produced by other vehicles.

ELM327-emulator supports all protocols allowed by python-OBD; the included dictionary uses the ISO 15765-4 CAN 11 bit ID 500 kbaud protocol.

ELM327-emulator also includes an auxiliary feature (obd_dictionary) that builds the PID dictionary of a specific vehicle by automatically querying all standard PIDs one by one (as well as querying additional custom PIDs specified by the user via CSV file). The dictionary can then be used to emulate the specific car.

Full information and usage details at the ELM327-emulator GitHub repository.