mirror of
https://github.com/Legolas-2025/EPrices.git
synced 2026-08-18 12:44:51 +02:00
Amir
a2ad24c017
Added version 1.2 release notes including fixes for HTTP fetch reliability, tomorrow auto-retry count, and status message improvements.
108 lines
4.6 KiB
Markdown
108 lines
4.6 KiB
Markdown
# EPrices – Version History
|
||
|
||
## v1.2 — 2026-04-06
|
||
|
||
### HTTP fetch stuck-flag watchdog
|
||
|
||
Fixed a production-observed reliability issue where a TCP-level stall during
|
||
an HTTP fetch could lock `is_updating_today` or `is_updating_tomorrow` at
|
||
`true` for several minutes, silently blocking all auto-retry triggers and
|
||
manual button presses for the duration.
|
||
|
||
A 120-second watchdog was added to both worker loops. If either `is_updating_*`
|
||
flag has been held for more than 120 seconds, the worker force-clears it and
|
||
sets the status message to `"Fetch timeout – will retry"`, allowing the next
|
||
scheduled retry or manual press to proceed immediately.
|
||
|
||
New globals: `is_updating_today_since`, `is_updating_tomorrow_since`.
|
||
|
||
### Tomorrow auto-retry attempt counter fix
|
||
|
||
`tomorrow_retry_count` was not being incremented in the 13:55 and 14:55–19:55
|
||
hourly retry triggers, causing the `Tomorrow API Fetch Attempts` diagnostic
|
||
sensor to undercount after the first scheduled attempt at 13:25.
|
||
|
||
### Status message improvements
|
||
|
||
- `tomorrow_update_status_message` initial value changed from
|
||
`"Waiting for 13:20"` to `"No data yet"` — removes misleading time
|
||
reference shown after afternoon reboots
|
||
- `clear_tomorrow_prices` end message changed from
|
||
`"Cleared – awaiting next 13:20 window"` to
|
||
`"Cleared – awaiting fetch window"`
|
||
|
||
See `CHANGELOG.md` for full implementation details.
|
||
|
||
---
|
||
|
||
## v1.1 — 2026-04-06
|
||
|
||
### Negative price provider fee
|
||
|
||
Added separate provider fee support for negative spot prices via a new
|
||
`eprices_neg_prov_fee` secret key. Positive and negative market prices
|
||
now use independent fee multipliers, correctly modelling contracts where
|
||
the provider's fee structure differs between the two cases.
|
||
|
||
Price calculation:
|
||
- Positive: `(raw / 1000) × (1 + prov_fee) × (1 + vat_rate)`
|
||
- Negative: `(raw / 1000) × (1 - neg_prov_fee) × (1 + vat_rate)`
|
||
|
||
VAT is applied to both, consistent with net billing where VAT is calculated
|
||
on the monthly net sum (linear equivalence applies).
|
||
|
||
See `CHANGELOG.md` for full implementation details.
|
||
|
||
---
|
||
|
||
## v1.0 — 2026-04-05
|
||
|
||
First public release.
|
||
|
||
### What EPrices is
|
||
|
||
EPrices is an ESPHome firmware for ESP32 that fetches day-ahead electricity
|
||
spot prices from the public Energy-Charts API and exposes them as Home Assistant
|
||
sensors. No API token, no cloud subscription, no external automations required
|
||
for core functionality — just an ESP32, ESPHome, and your WiFi network.
|
||
|
||
Prices are fetched for today and tomorrow in 15-minute resolution, converted
|
||
from raw €/MWh to €/kWh with your provider fee and VAT applied, and stored
|
||
persistently in ESP32 NVS flash so they survive reboots without re-fetching.
|
||
|
||
### Core features
|
||
|
||
- 15-minute and hourly resolution price arrays exposed as JSON text sensors
|
||
- Current, next, average, highest and lowest price sensors for both today and tomorrow
|
||
- Tomorrow live sensors evaluate at `now + 86400s` — showing tomorrow at the same local time
|
||
- NVS persistence — prices survive reboots without re-fetching
|
||
- Midnight bridge — tomorrow's data automatically promoted to today at 00:00
|
||
- Auto-retry logic — up to 8 HTTP fetch attempts for both today and tomorrow
|
||
- DST-safe — UNIX timestamps and binary search throughout, no hour-slot arithmetic
|
||
- Staleness detection — `Today Current Price Status` shows `Stale` if stored date mismatches today
|
||
- Full diagnostic sensor suite — NVS status, fetch attempts, API fetch times, data loaded
|
||
times, WiFi signal, human-readable uptime
|
||
- Supports any Energy-Charts bidding zone (SI, DE-LU, AT, FR, HR, HU and more)
|
||
- Provider fee and VAT rate configurable via `secrets.yaml` — no code changes needed
|
||
|
||
### Sensor highlights
|
||
|
||
- **Today/Tomorrow JSON Hourly Prices EUR⁄kWh** — 24-value JSON arrays
|
||
- **Today/Tomorrow JSON 15-Min Prices EUR⁄kWh (P1/P2/P3)** — three 32-value JSON arrays
|
||
covering 00:00-07:45, 08:00-15:45 and 16:00-23:45
|
||
- **Today/Tomorrow Data Loaded Time** — stamped on both NVS load and HTTP fetch
|
||
- **Today/Tomorrow Last API Fetch Time** — stamped on HTTP fetch only; `Never` if NVS only
|
||
- **Today/Tomorrow API Fetch Attempts** — HTTP-only counter, resets at midnight
|
||
- **Uptime** — human-readable: `45 s` → `5 min` → `3 h 22 min` → `12 d 4 h` → `4 months 12 d`
|
||
|
||
### Files
|
||
|
||
| File | Purpose |
|
||
|---|---|
|
||
| `eprices.yaml` | Main ESPHome configuration |
|
||
| `eprices_nvs.h` | NVS helper — save/load price arrays to ESP32 flash |
|
||
| `secrets.yaml` | Local secrets — not committed to git |
|
||
| `CHANGELOG.md` | Full sensor and entity ID reference for v1.0 |
|
||
| `README.md` | Installation guide and full sensor reference |
|
||
| `ENTSO-E-PRICES-MIGRATION.md` | Optional — migration guide from the predecessor project |
|