VCD Tool v2.0 (Public Release)

v2.0: New Diagnostic menu with AI-ready logs

v1 showed live telemetry. v2 adds a Diagnostic menu that records a timed
session and exports it as a JSON log built for analysis, including by an AI
assistant.

Five diagnostic segments

• Vehicle & Button Activity: switches, modes and how often they changed
• Battery Health & BMS: cell balance, temperatures, derating, voltage sag
• Motor & Controller: drivetrain load, throttle agreement, thermals
• Charger Performance: charge behaviour against the charge SoC limit
• RideCheck: speed, braking, motion and energy use

How it works

1. Choose a segment and a profile: Quick Check (5 min), Snapshot (15 min) or
   Drive Cycle (30 min).
2. Optionally fill in the vehicle details: model, pack capacity, build date and
   reason for the test.
3. Start, pause or stop the recording, then download the JSON log.

What is in a log

• Per-sample metrics, summaries, events and screening flags
• Data-quality information
• Vehicle details, with the build date decoded from the VIN
• AI guidance that explains how to read the log. For example, a charge that
  ends at 92% BMS SoC while the dashboard shows 100% is normal.
• VIN and Scooter ID masking, on by default

Also new

• VIN and Scooter ID are saved to flash and tied to the battery BIN.
• The blue LED blinks while CAN data is arriving and stays off otherwise.
• CAN is listen-only.
• Speed comes from the odometer, with forward, reverse and stopped direction.
• SoC values are labelled by kind, with an estimated dashboard value.

Notes

• Keep the page open on your phone during a recording; it runs in the browser.
• Speed is smoothed (about 0.7 km/h resolution, 2-3 s lag).
• Drive-mode speed limits and the dashboard SoC estimate are unverified.
• Saved VIN and Scooter ID persist across normal uploads, but "Erase All Flash"
  clears them.

Flashing the ESP

1. Connect your ESP module to your PC/Laptop via USB.
2. Open the ESP Flasher application.
3. Select the correct COM / Serial port your ESP32 is connected to.
4. Select the proper VCD_Tool_C3.bin file and click Flash.
5. Wait a minute for the process to complete, then disconnect and reconnect the ESP32 to restart it.
6. Check the Wi-Fi networks on your phone or laptop. If you see a network named VCD-Tool, the flashing was successful! (If it doesn't appear, try flashing again).

v1.5.0: VCD-Tool v1.5 (Public Release)

This update came with an automatic system theme, That follows the device or browser's appearance:

• Light mode: when the user's system is set to Light.
• Dark mode: when the user's system is set to Dark.
• Live switching: if the system theme changes while the dashboard is open, the UI changes automatically without refreshing.
• Consistent styling: the home screen, telemetry cards, cell tables, detail pages, navigation menus, and status panels all adapt automatically not just the page background.
• Fixed the min max soc bug on Cell details

✨ Highlights

• 📶 Built-in Wi-Fi hotspot: join VCD-Tool, open http://192.168.4.1. No app, router or internet needed.
• 📱 Mobile-friendly dashboard with eight categories: Vehicle, Cell Details, BMS, Motor & Controller, Charger, Firmware & Software, Thermals, About.
• 🔋 Per-cell data for all 14 cells: voltage, SoC and SoH.
• 🌡️ Detailed thermals: cell probes, BMS chip, FET, ambient, humidity, motor, controller and MCU.
• ⚡ Charger insights: input/output voltage, current, calculated power, fan speeds, charge SoC limit and grid-support level.
• 💾 Firmware versions for BMS, BCM, gateway and motor, plus CAN health counters.
• 🟢🟡🔴 Live status bar based on CAN frame freshness (online / intermittent / offline).
• 🧵 Dual-task firmware: CAN decoding runs separately from the web server so frames aren't dropped.
• 🏷️ Confidence tags on uncertain values: Estimated, Hypothesis, Rarely seen.
• 🚫 No cloud, telemetry or tracking.

Flashing the ESP

1. Connect your ESP module to your PC/Laptop via USB.
2. Open the ESP Flasher application.
3. Select the correct COM / Serial port your ESP32 is connected to.
4. Select the proper .bin file provided in this folder for you selected hardware and click Flash.
5. Wait a minute for the process to complete, then disconnect and reconnect the ESP32 to restart it.
6. Check the Wi-Fi networks on your phone or laptop. If you see a network named VCD-Tool, the flashing was successful! (If it doesn't appear, try flashing again).

v1.0.0: Initial Public Release

First public release of VCD Tool, an ESP32-C3-based Ather vehicle CAN diagnostic dashboard. It presents available vehicle, battery, motor/controller, charger, firmware, and thermal telemetry from the connected vehicle. Displayed values depend on the signals decoded by the firmware.

✨ Highlights

• 📶 Built-in Wi-Fi hotspot: join VCD-Tool, open http://192.168.4.1. No app, router or internet needed.
• 📱 Mobile-friendly dashboard with eight categories: Vehicle, Cell Details, BMS, Motor & Controller, Charger, Firmware & Software, Thermals, About.
• 🔋 Per-cell data for all 14 cells: voltage, SoC and SoH.
• 🌡️ Detailed thermals: cell probes, BMS chip, FET, ambient, humidity, motor, controller and MCU.
• ⚡ Charger insights: input/output voltage, current, calculated power, fan speeds, charge SoC limit and grid-support level.
• 💾 Firmware versions for BMS, BCM, gateway and motor, plus CAN health counters.
• 🟢🟡🔴 Live status bar based on CAN frame freshness (online / intermittent / offline).
• 🧵 Dual-task firmware: CAN decoding runs separately from the web server so frames aren't dropped.
• 🏷️ Confidence tags on uncertain values: Estimated, Hypothesis, Rarely seen.
• 🚫 No cloud, telemetry or tracking.

Flashing the ESP

1. Connect your ESP module to your PC/Laptop via USB.
2. Open the ESP Flasher application.
3. Select the correct COM / Serial port your ESP32 is connected to.
4. Select the proper .bin file provided in this folder for you selected hardware and click Flash.
5. Wait a minute for the process to complete, then disconnect and reconnect the ESP32 to restart it.
6. Check the Wi-Fi networks on your phone or laptop. If you see a network named VCD-Tool, the flashing was successful! (If it doesn't appear, try flashing again).

v0.5.0: Initial Pre-Public Release

First pre-public release of VCD Tool, an ESP32-C3-based Ather vehicle CAN diagnostic dashboard. It presents available vehicle, battery, motor/controller, charger, firmware, and thermal telemetry from the connected vehicle. Displayed values depend on the signals decoded by the firmware.

Flashing the ESP

1. Connect your ESP module to your PC/Laptop via USB.
2. Open the ESP Flasher application.
3. Select the correct COM / Serial port your ESP32 is connected to.
4. Select the proper .bin file provided in this folder for you selected hardware and click Flash.
5. Wait a minute for the process to complete, then disconnect and reconnect the ESP32 to restart it.
6. Check the Wi-Fi networks on your phone or laptop. If you see a network named VCD-Tool, the flashing was successful! (If it doesn't appear, try flashing again).