Skip to content

Releases: witekin/winterdash

Release list

v0.2

v0.2 Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 13 Sep 20:47
v0.2
404a2b6

Watch your Victron Blue Smart charger all winter — on a little screen, a web page you open from your phone, and in Home Assistant.

✨ New

  • New board — the CYD ("Cheap Yellow Display", ESP32-2432S028R). A cheap 2.8″ touch screen, an RGB status light (🟢 charged · 🟠 charging · 🔵 idle · 🔴 fault) and auto-brightness, all on one board. Flash it straight from the browser installer.
  • RGB "breathe" on the CYD — once the screen dims, the light gently pulses in the status colour.

🔧 Improved

  • More accurate charge status. A full or nearly-full battery on Float/Storage no longer flips to a false "Idle", and the on-screen detail line now shows the charger's own phase (Bulk / Absorption / Float / Recondition).
  • Steadier web dashboard on tight-memory boards, and a cleaner offline state — no stale readings held after a Bluetooth dropout.
  • Browser installer & site — pick the CYD in the flasher, per-board deep-links, a board carousel, clickable board cards, and clearer "the firmware is free" messaging.
  • New YouTube channel.

📦 Install

Easiest way: flash it in your browser — desktop Chrome or Edge + a USB cable, no app to install. Already have a device? It updates itself (the dashboard tells you when a new version is out).

The files below are for advanced / manual flashing:

Board Files
TTGO T-Display 16 MB esp32-tdisplay-16mb-0.2.*
TTGO T-Display 4 MB esp32-tdisplay-4mb-0.2.*
Screenless ESP32 (WROOM-32) esp32-wroom32-0.2.*
CYD (ESP32-2432S028R) esp32-cyd-0.2.*

*.factory.bin = full flash for a fresh board over USB · *.ota.bin = app-only update.

Docs: Boards · Reading your WinterDash · Install & update

Independent open-source project — not affiliated with, endorsed by, or sponsored by Victron Energy. "Victron" and "Blue Smart" are used only to describe compatibility. Free software under GPL-3.0.

Assets 10
Loading

v0.1

v0.1

Choose a tag to compare

View all tags
@github-actions github-actions released this 01 Sep 22:01
v0.1
93c7f7f

WinterDash is open-source ESPHome firmware for a cheap ESP32 board that reads a Victron Blue Smart charger over Bluetooth ("Instant Readout") and shows its status — voltage, current, and charge stage — on a little on-device screen, a web page you open from your phone, and (optionally) in Home Assistant. Made for keeping an eye on a car / motorcycle / boat battery over winter.

Independent open-source project — not affiliated with, endorsed by, or sponsored by Victron Energy. "Victron" and "Blue Smart" are trademarks of Victron Energy B.V., used only to describe compatibility.

Install — easiest, in your browser

No downloads, no tools: Flash a board in your browser → (desktop Chrome or Edge + one USB data cable). It picks the right firmware for your board and flashes it.

Prefer to do it yourself? Download your board's .factory.bin below and flash it at address 0x0 with Espressif's esptool-js. Full guide: Install & update.

Which file do I need?

Your board Fresh install (USB) Update over-the-air
LilyGO TTGO T-Display — 16 MB esp32-tdisplay-16mb-0.1.factory.bin esp32-tdisplay-16mb-0.1.ota.bin
LilyGO TTGO T-Display — 4 MB esp32-tdisplay-4mb-0.1.factory.bin esp32-tdisplay-4mb-0.1.ota.bin
Screenless ESP32-WROOM-32 esp32-wroom32-0.1.factory.bin esp32-wroom32-0.1.ota.bin
  • .factory.bin — full image for a fresh USB flash (installer / esptool, at 0x0).
  • .ota.bin — app-only image for an over-the-air update; it can't be used for a first USB flash. Default OTA password: winterdash-ota. See Updating later. (The browser .ota.bin upload is newly enabled — verify it on your hardware; re-flashing with the installer is the always-works fallback.)

After flashing

The board creates its own WinterDashAP Wi-Fi network — join it from your phone to enter your home Wi-Fi, then pair your charger. Walkthrough: First-time setup.

Status & known limits

  • Live-verified on a Blue Smart IP65s 12/5 (fw 3.65) through a full charge cycle (Bulk → Absorption → Float). Other single-output Blue Smart 12 / 24 V are expected to work (same broadcast). Needs charger firmware 3.61+ with Instant Readout enabled.
  • TTGO 16 MB is the main, fully-tested board; 4 MB is build-validated (not yet flash-tested on 4 MB hardware); screenless WROOM-32 is proven. The CYD touch board isn't ready yet.
  • Many IP65 models don't broadcast temperature, so that reading stays blank — that's normal.

Docs: Wiki · Troubleshooting · GPL-3.0. You can't break the device — unplugging is always safe.

Loading