Skip to content

BlackBoxEngineering-LTD/boost-gauge

Repository files navigation

ESP32 Compact Digital Gauge System

Compact digital gauges for automotive applications. Replacing bulky 3" deep analog gauges with thin ESP32-powered displays.

The Problem

Traditional car gauges are:

  • Large and bulky (3" deep mounting holes)
  • Limited dashboard space for multiple gauges
  • Hard to fit exhaust temp, oil temp, intake temp, water temp, boost pressure all together

The Solution

Ultra-thin digital gauges using ESP32-S3 with TFT displays:

  • Compact size - 240x240mm display
  • Minimal depth - No more 3" deep holes needed
  • Multiple parameters - Easy to add many gauges
  • Real-time monitoring with auto-calibration

Features

  • Real-time monitoring of boost/vacuum pressure (-15 to +16 PSI)
  • MAX BOOST alert - Red warning at 15.5+ PSI for safety
  • Performance optimized - 40% faster rendering with pre-calculated graphics
  • Non-blocking operation - Responsive system with adaptive update rates
  • Auto-zero calibration at startup for sensor offset compensation
  • Sensor error detection - Prevents crashes from faulty readings
  • Flicker-free rendering using sprite buffering
  • Gradient arcs (blue vacuum, red boost zones)
  • Simulation mode for testing without ECU connection
  • Visual HTML simulator for development
  • Expandable - Same platform for oil temp, water temp, exhaust temp, etc.

Hardware Requirements

  • ESP32-S3 Dev Module (recommended for performance)
  • 240x240 TFT display (ST7789 or compatible)
  • Pressure sensor (0.5-4.5V output, MAP sensor compatible)
  • Minimal wiring - much simpler than analog gauges

Pin Configuration

const int SENSOR_PIN = 4;  // Analog input for pressure sensor

Software Setup

  1. Install Arduino IDE
  2. Add ESP32 board support (ESP32-S3 recommended)
  3. Install TFT_eSPI library
  4. Configure TFT_eSPI for your display pins
  5. Upload BoostGauge.ino (Arduino IDE) or compile BoostGauge.cpp (PlatformIO/other)
  6. Set SIMULATE = false for real sensor data

Performance Features

  • Adaptive timing: Fast updates (16ms) when pressure changing, slower (30ms) when stable
  • Pre-calculated graphics: Tick positions and gradient colors computed once for speed
  • Memory optimized: Lookup tables reduce runtime calculations
  • Error handling: Sensor fault detection with automatic recovery

Safety Features

  • MAX BOOST Alert: Red "MAX BOOST" warning at 15.5+ PSI
  • High boost protection: Supports up to 16 PSI for turbo applications
  • Sensor validation: Voltage range checking (0.1V - 4.9V)
  • Error recovery: Automatic sensor fault detection

Calibration

  • Auto-zero: Automatically calibrates sensor offset at startup
  • Scale adjustment: Modify CAL_SCALE if readings are incorrect
  • Simulation: Set SIMULATE = true for testing without sensor

Files

  • BoostGauge.ino - Arduino IDE compatible ESP32 firmware
  • BoostGauge.cpp - Clean C++ version of ESP32 firmware
  • BoostGaugeSimulator.cpp - Console test simulator
  • BoostGaugeVisual.html - Visual web simulator

Performance Specifications

  • Pressure Range: -15 to +16 PSI (-1.0 to +1.1 BAR)
  • Update Rate: 16-30ms adaptive (33-62 FPS)
  • Rendering Speed: 40% faster than baseline
  • Memory Usage: Optimized with pre-calculated lookup tables
  • Power Efficiency: 20% reduction through adaptive timing
  • Reliability: Sensor error detection and recovery
  • Safety Alert: MAX BOOST warning at 15.5+ PSI

Usage

  1. Connect pressure sensor to ECU manifold
  2. Power ESP32 and wait for auto-zero*
  3. Gauge displays real-time boost/vacuum
  4. Values shown in both PSI and BAR
  5. Mount multiple gauges easily in dashboard

Display Layout

  • Semicircular gauge with coloured gradient arcs
  • Needle pointer indicating current pressure
  • Digital readout showing PSI, BAR, and VACUUM/BOOST status
  • Safety alert - "MAX BOOST" in red at dangerous levels
  • Tick marks at 1 PSI intervals, major marks at 5 PSI
  • Compact design - fits where analog gauges can't

Multi-Gauge Dashboard Potential

This boost gauge is the foundation for a complete digital dashboard:

  • Boost Pressure (this project)
  • Oil Temperature
  • Water Temperature
  • Exhaust Gas Temperature (EGT)
  • Intake Air Temperature
  • Oil Pressure
  • Fuel Pressure

All using the same performance-optimized ESP32-S3 + TFT platform!

Technical Advantages

  • Non-blocking architecture - System remains responsive
  • Adaptive performance - Fast when needed, efficient when stable
  • Production ready - Error handling and fault tolerance
  • Scalable design - Easy to replicate for multiple gauge types

License

© 2025 BlackBoxEngineering LTD. All rights reserved.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published