# ESP32-S3 Dashboard Firmware

This is the placeholder for the current dashboard firmware direction.

## Target hardware

Current dashboard target:

- Waveshare ESP32-S3 touchscreen display
- WiFi connection to the Cargo ESP32 access point
- HTTP/REST communication with the Cargo ESP32 API
- Future LVGL-based dashboard UI

## Responsibilities

The ESP32-S3 dashboard is responsible for:

- Touchscreen UI
- Vehicle gauges
- Dashboard rendering
- Future CAN/OBD-II vehicle visualization
- Future tilt/roll/off-road screen visualization

## Not responsible for

The ESP32-S3 dashboard does not own:

- Relay authority
- BMS authority
- Alarm authority
- Cargo ESP configuration storage
- Load-switching hardware control as the source of truth

The Cargo ESP32 remains the power-system controller and source of truth.

## v1 communication path

    Dashboard ESP32-S3
            <-> WiFi / HTTP REST
    Cargo ESP32 AP

Not v1 dashboard communication:

- Pico UART
- ESP-NOW
- MQTT
- CAN between controllers

## Selected Hardware

The selected dashboard hardware target is:

    Waveshare ESP32-S3 Touch LCD 5B

Display details:

- 5-inch touchscreen
- 1024x600 resolution
- Capacitive touch
- ESP32-S3 platform
- Native WiFi
- Integrated CAN transceiver available for future vehicle integration

This is the current active dashboard target. The archived Pico dashboard is not active firmware.