From f5c2e0a2282f9533b88366693da278d3cced647a Mon Sep 17 00:00:00 2001 From: Sebastian Nieto Date: Mon, 7 Sep 2026 00:46:21 -0300 Subject: [PATCH] Document and integrate OBD2 Bluetooth emulator script --- README.md | 124 +++++++++++++++++++++++---------------------- emulator/README.md | 34 +++++++++++++ 2 files changed, 98 insertions(+), 60 deletions(-) create mode 100644 emulator/README.md diff --git a/README.md b/README.md index f7a21f6..25140b6 100644 --- a/README.md +++ b/README.md @@ -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. diff --git a/emulator/README.md b/emulator/README.md new file mode 100644 index 0000000..16ecd40 --- /dev/null +++ b/emulator/README.md @@ -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