Files
nixie-clock/firmware/uniclock/README.md
T

30 lines
1.7 KiB
Markdown
Raw Normal View History

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.