2026-10-25 20:48:04 +01:00
|
|
|
# ESP_UniClock for the NixieIN12v2 clock
|
|
|
|
|
|
|
|
|
|
Firmware for this clock, based on [ESP_UniClock](https://github.com/gpeter62/ESP_UniClock) by
|
|
|
|
|
Peter Gautier (GPL-3.0-or-later), vendored from upstream commit `1189810` (2026-09-07).
|
|
|
|
|
|
2026-10-29 00:06:35 +01:00
|
|
|
- `ESP32_UniClock2/`: the upstream sketch folder (all `.ino`/`.h` files; `data/` is the SPIFFS
|
|
|
|
|
content). It keeps the upstream layout, so it still opens in the Arduino IDE.
|
|
|
|
|
- `web/index.html`: the web UI (replaces the upstream jQuery page), one file with its CSS and JS.
|
|
|
|
|
`web/gzip_web.py` gzips it to `data/index.html.gz`; PlatformIO runs it before every build, in the
|
|
|
|
|
Arduino IDE run `python web/gzip_web.py` before uploading the data folder. Opened straight from
|
|
|
|
|
disk, the page runs on sample data, so layout changes can be checked without the clock.
|
2026-10-25 20:48:04 +01:00
|
|
|
- `lib/`: the library versions bundled upstream (`libraries/*.zip`), only those the ESP8266 build
|
|
|
|
|
needs. The upstream manuals, datasheets, photos and ESP32-only libraries were left out.
|
2026-10-25 21:37:25 +01:00
|
|
|
Exception: `arduino-home-assistant` is v2.1.0 (upstream bundles 1.3.0, which has no light,
|
|
|
|
|
number, select or button entities); `mqtt.ino` was rewritten for it.
|
2026-10-25 20:48:04 +01:00
|
|
|
- `platformio.ini`: PlatformIO build for the ESP-12 (4 MB flash, 2 MB SPIFFS).
|
|
|
|
|
|
|
|
|
|
Local changes are separate commits on top of the import (`git log -- firmware/uniclock`).
|
|
|
|
|
|
|
|
|
|
## Build and flash
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
pio run # build
|
|
|
|
|
pio run -t upload # flash the firmware over COM7
|
2026-10-29 00:06:35 +01:00
|
|
|
pio run -t uploadfs # flash the web UI (data/) to SPIFFS; over WiFi: -e nixie_in12_ota
|
2026-10-25 20:48:04 +01:00
|
|
|
pio device monitor # serial log, 115200 Bd
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
The CH340C adapter has no auto-reset: before each upload, hold GPIO0 to GND, tap RST to GND, then
|
|
|
|
|
release GPIO0. See `CLAUDE.md` in the repo root for the wiring.
|