# Xterra Overland Power & Monitoring Dashboard

A custom monitoring and control system for a Nissan Xterra using:

- Raspberry Pi Pico 2 W dashboard interface
- ESP32 cargo-area controller
- Touchscreen dashboard
- Lithium battery monitoring
- Fridge monitoring
- Relay control
- Future vehicle telemetry integration

## Project Phases

1. Desktop simulator
2. Pico touchscreen UI
3. ESP32 communications
4. Temperature sensors
5. JBD/Xiaoxiang BMS integration
6. Future integrations / optional logging

## Documentation

### Project Status

* `docs/project-state.md`
* `docs/hardware-status.md`

### System Design

* `docs/architecture.md`
* `docs/protocol.md`
* `docs/pico-architecture.md`

### Hardware

* `docs/uart.md`
* `docs/wiring.md`
* `hardware/bom.md`
* `hardware/esp32-pinout.md`

### User Interface

* `docs/ui-wireframes.md`

### Development

These documents should be considered the source of truth for ongoing development.

Priority order:

1. `docs/project-state.md`
2. `docs/hardware-status.md`
3. `docs/protocol.md`
4. `docs/pico-architecture.md`
5. `docs/ui-wireframes.md`

Implementation should follow documented architecture unless explicitly updated in the documentation first.