Cluster Dashboard
The Cluster Dashboard (/cluster) is a high-fidelity automotive instrument cluster visualization. It mirrors the live state of the virtual ECU in real time — the same readout a technician would see on a vehicle’s dashboard — and lets you inject faults to trigger DTC events without writing a single byte manually.
Speedometer & RPM with live needle animation
Engine, ABS, Battery, Oil, Temp, Fuel, Brake, ESP
Powertrain, Brakes/ABS/ESP, Body, Network
Full interactive telemetry sync & fault injection
Interactive Cluster Simulator
Test how diagnostic requests affect the cluster gauges and telltales in real time. Use the sliders to adjust vehicle speed and engine RPM, click any telltale lamp to inject a DTC fault, and watch the live UDS CAN frames update below:
Virtual Instrument Cluster & DID Inspection
Overview
The Cluster Dashboard is a companion to the main Simulator. While the Simulator handles raw UDS frame exchange, the Cluster gives you a visual ground truth — confirming that what the ECU reports matches what appears on an actual vehicle instrument panel.
When to use it:
- Validate DID reads: Confirm that reading vehicle speed () or RPM () matches the gauge positions.
- Inject DTC faults: Populate diagnostic trouble codes in the ECU before testing (Read DTC) or (Clear DTC).
- Demonstrate ECU behaviour: Present vehicle states to engineering and non-technical stakeholders without decoding raw hex payloads.
The Cluster, Simulator, and Protocol State Dashboard all share the same global UDSContext. State changes triggered in one view reflect immediately across all tools.
UI Components & Gauges
Speedometer & RPM Gauges
Two high-precision circular gauges occupy the left and right sides of the cluster panel:
| Gauge | DID Source | Range | Red Zone |
|---|---|---|---|
| Speedometer | 0x0101 Vehicle Speed | 0 – 260 km/h | none |
| RPM (Tachometer) | 0x0104 Engine RPM | 0 – 8000 rpm | > 6500 rpm |
Needle animation is driven by the vehicleState values in UDSContext. When an external tester or diagnostic script sends a request, the positive response updates the internal model and the needle animates smoothly to the new position.
Center Digital Speed Display
Positioned between the gauges, this digital HUD provides an instant numeric readout of vehicle speed in km/h, the current gear, and the odometer reading.
PRND Gear Selector
A vertical or horizontal gear indicator (P, R, N, D, 1, 2, 3) highlights the current transmission gear reported by the powertrain ECU. The active gear is illuminated with a high-contrast cyan glow.
Protocol State Telemetry
An embedded panel showing the active UDS diagnostic session (0x01 Default, 0x02 Programming, 0x03 Extended), the real-time S3 watchdog timer countdown, and the ECU power status.
Telltale Warning Indicators
Eight automotive warning lamps mirror the internal Diagnostic Trouble Code (DTC) state of the virtual ECU:
| Telltale | Color | Lights When | DTC Category & Prefix |
|---|---|---|---|
| Engine (MIL) | Amber | Powertrain fault detected (MAF, misfire, emissions) | P-codes (0x01xxxx) |
| ABS Warning | Amber | Wheel speed sensor or ABS pump motor malfunction | C-codes (0x02xxxx) |
| Battery / Charge | Red | 12V system voltage drops below operational threshold | B-codes (0x03xxxx) |
| Oil Pressure | Red | Engine oil pressure sensor reads below minimum limit | P-codes (0x01xxxx) |
| Coolant Temperature | Red | Coolant temp exceeds threshold (>115°C) | P-codes (0x01xxxx) |
| Low Fuel | Amber | Fuel tank level falls below reserve volume | P-codes (0x01xxxx) |
| Brake Wear / System | Red | Brake pad wear contact triggered or fluid low | C-codes (0x02xxxx) |
| ESP / Traction Control | Amber | Loss of CAN communication with chassis controller | U-codes (0x04xxxx) |
Ignition & Power Rail States
The cluster reflects the physical vehicle ignition status:
| State | Terminal | Meaning | Diagnostic Behaviour |
|---|---|---|---|
| OFF | KL30 only | ECU powered down or standby | No response to diagnostic frames |
| ACC | KL15A | Accessories active (infotainment) | Limited diagnostic services available |
| ON | KL15 | Normal operational state (Key-On) | All standard UDS services enabled |
| CRANK | KL50 | Starter motor engaged | Transient state; some services return NRC 0x22 |
DTC Fault Injection & Diagnostic Testing Workflow
The DTC Management Panel in the cluster lets you arm faults on demand:
Fault Injection & Clear Diagnostic Execution Pipeline
Arm Fault in Cluster Panel
Simulate hardware fault (e.g., MAF Circuit Range)
Technician/tester triggers a physical or sensor fault without sending raw CAN frames. Sets faultTriggers in ECU state.
Warning Lamp Illuminates
MIL / Check Engine indicator lights in amber
ECU detects out-of-range sensor voltage and triggers telltale indicator on the instrument cluster dashboard.
Tester Reads Active DTCs
Send SID 0x19 0x02 0x09 (ReadDTCByStatusMask)
Diagnostic tool transmits request on 0x7E0 to poll all confirmed and test-failed diagnostic trouble codes.
ECU Returns DTC Payload
Positive Response 0x59 0x02 ... DTC P0101
ECU replies with DTC 0x010100 (P0101: Mass Air Flow Sensor) along with active status byte 0x09.
Tester Clears Fault Memory
Send SID 0x14 0xFF 0xFF 0xFF (ClearDiagnosticInfo)
Tester commands the ECU to erase non-volatile fault logs across all vehicle system groups.
Lamps Extinguish & Bus Normal
ECU replies 0x54 (Positive Clear Confirmation)
Warning lamps turn off, freeze frames are wiped, and subsequent 0x19 reads return zero active faults.
Diagnostic Frame Sequences
Step 1: Read Active DTCs (SID 0x19)
Read Active DTCs (Tester -> ECU)
> ReadDTCByStatusMask — mask 0x09 requests confirmed and test-failed faults.
DTC List Response (ECU -> Tester)
> Positive response 0x59 (0x19 + 0x40), status availability 0xFF, DTC 0x010100 (P0101) with status 0x09.
Step 2: Clear Stored DTCs (SID 0x14)
Clear All DTCs (Tester -> ECU)
> ClearDiagnosticInformation — group 0xFFFFFF commands clearing of all DTC categories.
Clear Confirmation (ECU -> Tester)
> Positive response 0x54 (0x14 + 0x40). All telltale lamps extinguish.
Related Documentation
- Getting Started Guide — First diagnostic commands and platform navigation.
- 0x22 Read Data By Identifier — Deep dive into vehicle speed and RPM DID formats.
- 0x19 Read DTC Information — Querying DTC status masks and freeze frames.
- 0x14 Clear Diagnostic Information — Purging fault memories and resetting telltales.
- ECU Flashing & Reprogramming — End-to-end bootloader flashing guide.