# Implementation Roadmap

## Purpose

This document defines the planned implementation order for the Xterra Overland Power & Monitoring Dashboard.

The goal is to build the system incrementally, validating hardware and software at each stage before adding additional complexity.

---

# Current Status

## Complete

* Project architecture defined
* Hardware architecture defined
* UART protocol defined
* Pico architecture defined
* UI wireframes defined
* ESP32 firmware compiles
* Simulator exists and functions

## In Progress

* ESP32 controller firmware
* Communication protocol implementation

## Not Started

* Pico firmware
* Display integration
* Touch integration
* Buzzer integration
* End-to-end communications

---

# Milestone 1: ESP32 Hardware Bring-Up

## Goal

Verify cargo-controller hardware.

## Tasks

* Flash ESP32 firmware
* Verify boot process
* Verify AP mode
* Verify HTTP API
* Verify relay outputs
* Verify DS18B20 framework
* Verify UART initialization

## Success Criteria

* ESP32 boots reliably
* Relay outputs function correctly
* Status API responds correctly
* No crashes or watchdog resets

---

# Milestone 2: Pico Hardware Bring-Up

## Goal

Verify dashboard hardware.

## Tasks

* Verify Pico 2 W operation
* Verify ST7796S display
* Verify FT6336U touch controller
* Verify buzzer operation

## Success Criteria

* Display initializes reliably
* Touch events are detected
* Buzzer can be activated

---

# Milestone 3: UART Communications

## Goal

Establish communications between Pico and ESP32.

## Tasks

* Wire UART over CAT5
* Implement status requests
* Implement status responses
* Implement relay commands
* Implement error handling
* Implement communication timeout detection

## Success Criteria

* Pico receives live status
* Pico can control relays
* Communication loss is detected

---

# Milestone 4: Dashboard UI Foundation

## Goal

Render live data on the touchscreen.

## Tasks

* Create screen manager
* Create app state
* Create dashboard screen
* Create navigation bar
* Create communication status indicators

## Success Criteria

* Live battery data displayed
* Live temperature data displayed
* Navigation functional

---

# Milestone 5: Detailed Screens

## Goal

Implement all planned screens.

## Tasks

### Battery Screen

* SOC
* Voltage
* Current
* Runtime
* Temperature

### Temperature Screen

* Fridge Zone 1
* Fridge Zone 2
* Rear Seat
* Outside Air

### Power Screen

* Starlink control
* Fridge control

### System Screen

* Communication status
* Sensor status
* Firmware information

## Success Criteria

* All screens functional
* Navigation stable
* Live updates working

---

# Milestone 6: Alarm System

## Goal

Implement alerting and warning system.

## Tasks

* Alarm manager
* Alarm overlay
* Communication alarms
* Battery alarms
* Temperature alarms
* Sensor fault alarms
* Buzzer manager

## Success Criteria

* Alarms trigger correctly
* Alarm overlay displays correctly
* Buzzer alerts function correctly

---

# Milestone 7: DS18B20 Integration

## Goal

Implement all production sensors.

## Sensors

### Fridge Zone 1

Monitor refrigerator compartment.

### Fridge Zone 2

Monitor freezer compartment.

### Rear Seat Area

Monitor passenger compartment.

### Outside Air

Monitor ambient exterior temperature.

## Success Criteria

* All sensors report correctly
* Sensor failures are detected

---

# Milestone 8: JBD/Xiaoxiang BMS Integration

## Goal

Replace simulated battery data with live battery data.

## Tasks

* BLE communication
* Battery status retrieval
* Runtime calculations
* Health monitoring

## Success Criteria

* Live battery data displayed
* No simulated battery values required

---

# Milestone 9: Vehicle Integration

## Goal

Add vehicle-specific information.

## Potential Features

* Ignition state
* OBD-II integration
* CAN bus integration
* Engine information
* Fuel information

## Status

Future planning only.

---

# Milestone 10: Future Expansion

## Potential Features

* Additional relays
* Inverter control
* Lighting control
* Starlink diagnostics
* GPS integration
* Home Assistant integration

## Status

Future planning only.

---

# Explicitly Not Planned

The following items are currently out of scope:

* Cloud connectivity
* Internet dependency
* User accounts
* Persistent logging
* Historical graphing
* Subscription services

The system should remain fully functional offline.