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 # OBD2 Gauge (ESP32 Bluetooth)
## This repository has been archived and is no longer maintained. (October 24th, 2025) ## This repository has been archived and is no longer maintained. (October 24th, 2025)
A fully functional code-updated A fully functional code-updated
Last Update: September 27th, 2024 Last Update: September 27th, 2024
This is an ESP32 OBD2 Gauge for vehicles that are compatible with OBD2 This is an ESP32 OBD2 Gauge for vehicles that are compatible with OBD2
(Special made for FORD vehicle) (Special made for FORD vehicle)
- Prototype https://youtu.be/PkQaUJbzTNM - Prototype https://youtu.be/PkQaUJbzTNM
- Current Model Short Demo https://youtu.be/vvBIeim7XTE - Current Model Short Demo https://youtu.be/vvBIeim7XTE
![](/picture/page.jpg) ![](/picture/page.jpg)
![](/picture/config.jpg) ![](/picture/config.jpg)
![](enclosure/enclosure.jpg) ![](enclosure/enclosure.jpg)
## Software: ## Software:
- Arduino IDE 2.3.2 + ESP32 arduino core 2.0.17 - Arduino IDE 2.3.2 + ESP32 arduino core 2.0.17
- * IMPORTANT * this project won't work with ESP32 arduiino core 3.x.x - * IMPORTANT * this project won't work with ESP32 arduiino core 3.x.x
- modified TFT_eSPI library 2.5.43 - modified TFT_eSPI library 2.5.43
## Hardware ## Hardware
- ESP32 TFT2.8 320x240 with "RESISTIVE" touch board. - ESP32 TFT2.8 320x240 with "RESISTIVE" touch board.
buy here https://s.click.aliexpress.com/e/_Ew95gMl buy here https://s.click.aliexpress.com/e/_Ew95gMl
- ELM327 Bluetooth adaptor (recommended v1.5 not v2.1) - ELM327 Bluetooth adaptor (recommended v1.5 not v2.1)
Highly recommend ELM327 Bluetooth adaptor https://s.click.aliexpress.com/e/_oo3THvG 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 small speaker for mobile phone 1 Watt 8 ohm 9x28 mmm.
- A push button 6x6x5 2 legs - A push button 6x6x5 2 legs
- 3d print enclosure - 3d print enclosure
- 12v to 5v dc micro usb power regulator module - 12v to 5v dc micro usb power regulator module
- Gauge magnetic stand - Gauge magnetic stand
## Features: ## Features:
- Show vehicle data 7 pids - Show vehicle data 7 pids
* MAP - manifold air pressure (PSI) * MAP - manifold air pressure (PSI)
* PCM - pcm voltage (volt) * PCM - pcm voltage (volt)
* ENG LOAD - engine load (%) * ENG LOAD - engine load (%)
* ENG SPD - engine speed (RPM) * ENG SPD - engine speed (RPM)
* Coolant - coolant temperature (c) * Coolant - coolant temperature (c)
* Oil Temp - engine oil temperature (c) * Oil Temp - engine oil temperature (c)
* TFT - Ford transmission fluid temperature (c) * TFT - Ford transmission fluid temperature (c)
- 8 layout page selectable display - 8 layout page selectable display
- DTC read and clear function (Engine warning light only) - DTC read and clear function (Engine warning light only)
- Warning when parameter reaches setting value - Warning when parameter reaches setting value
- Adjustable warning value for each PIDs - Adjustable warning value for each PIDs
- Configurable CPU overheat protection - Configurable CPU overheat protection
- Configurable gauge Auto turn on/off - Configurable gauge Auto turn on/off
- Auto screen brightness - Auto screen brightness
- Change off screen to user screen with micro SDcard - Change off screen to user screen with micro SDcard
- Firmware updatable (micro SDcard and WiFi) - Firmware updatable (micro SDcard and WiFi)
- VIN Read on the About page. - VIN Read on the About page.
## [Flash Firmware Online](https://vaandcob.github.io/webpage/src/index.html) ## [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) [![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