overland-controller/docs/CHANGELOG.md

CHANGELOG.md

Changelog

All notable changes to Overland Controller will be documented in this file.

The format loosely follows Keep a Changelog principles.

---

[0.3.0] - 2026-06-04

Major Changes

Project Renaming

• Renamed project from Xterra Controller to Overland Controller
• Updated firmware naming
• Updated repository naming
• Updated documentation naming
• Began removal of vehicle-specific assumptions

Generic Configuration Architecture

Removed hardcoded installation-specific values from firmware.

Firmware now uses generic identifiers:

Relays:

text id="4xvc8l" relay_1 relay_2

Temperature sensors:

text id="xq2e8v" temp_1 temp_2 temp_3 temp_4 temp_5 temp_6 temp_7 temp_8

Installation-specific names now belong in saved configuration.

JSON Status API Improvements

Reworked status response format.

Changed from:

json id="k8l5yx" { "temps": { "outside": 72.0 } }

To:

json id="k3g0ey" { "temps": [ { "id": "temp_1", "name": "Outside", "temperature_f": 72.0 } ] }

Benefits:

• Dynamic sensor support
• Generic architecture
• Easier dashboard integration
• Better future scalability

Relay Status Improvements

Relay reporting converted to structured arrays.

Example:

json id="wh1f5k" { "id": "relay_1", "name": "Aux Power", "state": false }

BMS Integration

Implemented:

• JBD BLE communication
• Xiaoxiang compatibility
• Cell voltage reporting
• SOC reporting
• Current reporting
• Capacity reporting
• Temperature reporting
• Cycle count reporting

BLE Setup Workflow

Added:

• Setup mode
• BLE device scanning
• BMS selection
• Persistent BMS storage

Known limitation:

• Some BMS devices advertise infrequently and may require multiple scans before appearing.

Documentation

Added:

• README.md
• API.md
• SERIAL_COMMANDS.md
• HARDWARE.md
• ARCHITECTURE.md
• CHANGELOG.md

---

[0.2.x]

Initial Controller Development

Implemented:

• ESP32 firmware framework
• Relay control
• Configuration storage
• Access Point mode
• Web server
• UART communications
• JSON status reporting

---

[0.1.x]

Project Foundation

Initial proof-of-concept work.

Implemented:

• Repository structure
• ESP32 firmware skeleton
• Basic relay testing
• Initial dashboard communications concept

---

Upcoming

Planned for 0.4.x

Dashboard Development

• Pico 2 W integration
• Dashboard communications
• Touchscreen support
• Relay control interface

Temperature System

• Sensor assignment workflow
• Sensor discovery workflow
• Improved diagnostics

Configuration System

• Expanded configuration API
• Additional runtime configuration
• Improved validation

Documentation

• Installation guide
• Wiring guide
• Development guide

---

Planned for 0.5.x

Vehicle Integration

Potential support for:

• OBD-II
• ELM327
• CAN Bus

Data Logging

Potential support for:

• Historical battery data
• Historical temperature data
• Event logging

Integrations

Potential support for:

• MQTT
• Home Assistant
• Grafana
• InfluxDB

---

Long-Term Roadmap

Potential future capabilities:

• GPS support
• Route logging
• Multi-controller support
• OTA updates
• Alerting system
• Mobile-friendly dashboard
• Remote monitoring

The roadmap is intentionally flexible and may change as the project evolves.