seba/obd2_gauge
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Document and integrate OBD2 Bluetooth emulator script

Browse source
This commit is contained in:
Sebastián Nieto 2026-09-07 00:46:21 -03:00
parent ac7e3e353e
commit f5c2e0a228
2 changed files with 98 additions and 60 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

124
README.md
View file

@ -1,60 +1,64 @@
# ESP32-Bluetooth-OBD2-Gauge
## This repository has been archived and is no longer maintained. (October 24th, 2025)
A fully functional code-updated
Last Update: September 27th, 2024
This is an ESP32 OBD2 Gauge for vehicles that are compatible with OBD2
(Special made for FORD vehicle)
- Prototype https://youtu.be/PkQaUJbzTNM
- Current Model Short Demo https://youtu.be/vvBIeim7XTE
![](/picture/page.jpg)
![](/picture/config.jpg)
![](enclosure/enclosure.jpg)
## Software:
- Arduino IDE 2.3.2 + ESP32 arduino core 2.0.17
- * IMPORTANT * this project won't work with ESP32 arduiino core 3.x.x
- modified TFT_eSPI library 2.5.43
## Hardware
- ESP32 TFT2.8 320x240 with "RESISTIVE" touch board.
buy here https://s.click.aliexpress.com/e/_Ew95gMl
- ELM327 Bluetooth adaptor (recommended v1.5 not v2.1)
Highly recommend ELM327 Bluetooth adaptor https://s.click.aliexpress.com/e/_oo3THvG
- A small speaker for mobile phone 1 Watt 8 ohm 9x28 mmm.
- A push button 6x6x5 2 legs
- 3d print enclosure
- 12v to 5v dc micro usb power regulator module
- Gauge magnetic stand
## Features:
- Show vehicle data 7 pids
* MAP - manifold air pressure (PSI)
* PCM - pcm voltage (volt)
* ENG LOAD - engine load (%)
* ENG SPD - engine speed (RPM)
* Coolant - coolant temperature (c)
* Oil Temp - engine oil temperature (c)
* TFT - Ford transmission fluid temperature (c)
- 8 layout page selectable display
- DTC read and clear function (Engine warning light only)
- Warning when parameter reaches setting value
- Adjustable warning value for each PIDs
- Configurable CPU overheat protection
- Configurable gauge Auto turn on/off
- Auto screen brightness
- Change off screen to user screen with micro SDcard
- Firmware updatable (micro SDcard and WiFi)
- VIN Read on the About page.
## [Flash Firmware Online](https://vaandcob.github.io/webpage/src/index.html)
-------------------------------------------------------
[![Buy Me a Coffee](https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20coffee&emoji=☕&slug=vaandcob&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=ffffff)](https://www.buymeacoffee.com/vaandcob)
# OBD2 Gauge (ESP32 Bluetooth)
## This repository has been archived and is no longer maintained. (October 24th, 2025)
A fully functional code-updated
Last Update: September 27th, 2024
This is an ESP32 OBD2 Gauge for vehicles that are compatible with OBD2
(Special made for FORD vehicle)
- Prototype https://youtu.be/PkQaUJbzTNM
- Current Model Short Demo https://youtu.be/vvBIeim7XTE
![](/picture/page.jpg)
![](/picture/config.jpg)
![](enclosure/enclosure.jpg)
## Software:
- Arduino IDE 2.3.2 + ESP32 arduino core 2.0.17
- * IMPORTANT * this project won't work with ESP32 arduiino core 3.x.x
- modified TFT_eSPI library 2.5.43
## Hardware
- ESP32 TFT2.8 320x240 with "RESISTIVE" touch board.
buy here https://s.click.aliexpress.com/e/_Ew95gMl
- ELM327 Bluetooth adaptor (recommended v1.5 not v2.1)
Highly recommend ELM327 Bluetooth adaptor https://s.click.aliexpress.com/e/_oo3THvG
- A small speaker for mobile phone 1 Watt 8 ohm 9x28 mmm.
- A push button 6x6x5 2 legs
- 3d print enclosure
- 12v to 5v dc micro usb power regulator module
- Gauge magnetic stand
## Features:
- Show vehicle data 7 pids
* MAP - manifold air pressure (PSI)
* PCM - pcm voltage (volt)
* ENG LOAD - engine load (%)
* ENG SPD - engine speed (RPM)
* Coolant - coolant temperature (c)
* Oil Temp - engine oil temperature (c)
* TFT - Ford transmission fluid temperature (c)
- 8 layout page selectable display
- DTC read and clear function (Engine warning light only)
- Warning when parameter reaches setting value
- Adjustable warning value for each PIDs
- Configurable CPU overheat protection
- Configurable gauge Auto turn on/off
- Auto screen brightness
- Change off screen to user screen with micro SDcard
- Firmware updatable (micro SDcard and WiFi)
- VIN Read on the About page.
## [Flash Firmware Online](https://vaandcob.github.io/webpage/src/index.html)
-------------------------------------------------------
[![Buy Me a Coffee](https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20coffee&emoji=☕&slug=vaandcob&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=ffffff)](https://www.buymeacoffee.com/vaandcob)
## Emulador OBD2 / ELM327 Bluetooth incluido
En la carpeta se incluye el script para emular un adaptador ELM327 v1.5 y la ECU del vehículo vía Bluetooth SPP en Linux. Permite probar y validar la pantalla CYD en banco de pruebas sin necesidad de conectarse a un auto real.
Consulta [emulator/README.md](emulator/README.md) para ver requisitos y modo de uso.

34
emulator/README.md Normal file
View file

@ -0,0 +1,34 @@
# Emulador Bluetooth OBD-II / ELM327 v1.5
Script en Python que emula un adaptador OBD-II Bluetooth ELM327 v1.5 completo y la ECU del vehículo para realizar pruebas en banco con la pantalla ESP32 CYD sin necesidad de conectarse a un auto real.
## Requisitos en Linux (Ubuntu/Debian)
- BlueZ (stack Bluetooth de Linux)
- Python 3 con soporte D-Bus y GLib:
```bash
sudo apt install python3-dbus python3-gi
```
## Uso
1. Configura el adaptador Bluetooth de la PC/notebook para que sea visible como `OBDII`:
```bash
sudo hciconfig hci0 name "OBDII"
sudo hciconfig hci0 piscan
```
2. Ejecuta el emulador:
```bash
python3 emulator/obd2_emulator.py
```
3. Enciende la pantalla ESP32 CYD. Se conectará automáticamente por Bluetooth SPP (Canal 1 RFCOMM).
4. El emulador responderá a los PIDs estándar de OBD2:
- `0105`: Temperatura de Refrigerante (ECT)
- `010C`: Revoluciones por minuto (RPM)
- `010D`: Velocidad (Speed)
- `0142`: Voltaje de batería PCM
- `010B`: Presión absoluta del múltiple (MAP)
- `0104`: Carga del motor (Engine Load)
- `221E1C` / `015C`: Temperatura de aceite y fluido de transmisión Ford