#!/usr/bin/env python3
"""Dashboard read-only do boiler Tuya com histórico SQLite e consumo estimado."""
from __future__ import annotations
import asyncio
import csv
import hashlib
import hmac
import io
import json
import os
import sqlite3
import time
import urllib.parse
import urllib.request
from datetime import date, datetime, time as dt_time, timedelta, timezone
from pathlib import Path
from zoneinfo import ZoneInfo
from aiohttp import web
DEVICE_ID = os.environ["TUYA_DEVICE_ID"]
ACCESS_ID = os.environ["TUYA_ACCESS_ID"]
ACCESS_KEY = os.environ["TUYA_ACCESS_KEY"]
ENDPOINT = os.getenv("TUYA_API_ENDPOINT", "https://openapi.tuyaeu.com")
DB_PATH = Path(os.getenv("BOILER_DB_PATH", "/home/admin/boiler-energy/data/boiler.db"))
PORT = int(os.getenv("BOILER_PORT", "8788"))
POWER_KW = float(os.getenv("BOILER_POWER_KW", "2.3"))
UNIT_RATE = float(os.getenv("BOILER_RATE_EUR_KWH", "0.3652"))
POLL_SECONDS = int(os.getenv("BOILER_POLL_SECONDS", "300"))
TZ = ZoneInfo(os.getenv("BOILER_TIMEZONE", "Europe/Dublin"))
class TuyaOpenAPI:
"""Minimal Tuya REST client; avoids the unused Pulsar/Crypto dependency."""
def __init__(self, endpoint: str, access_id: str, access_key: str) -> None:
self.endpoint = endpoint.rstrip("/")
self.access_id = access_id
self.access_key = access_key
self.token = ""
self.token_expires_ms = 0
def _request(self, method: str, path: str, params: dict | None = None) -> dict:
params = params or {}
canonical_query = "&".join(f"{key}={params[key]}" for key in sorted(params))
canonical_path = path + (f"?{canonical_query}" if canonical_query else "")
body_hash = hashlib.sha256(b"").hexdigest()
string_to_sign = f"{method}\n{body_hash}\n\n{canonical_path}"
now_ms = int(time.time() * 1000)
message = f"{self.access_id}{self.token}{now_ms}{string_to_sign}"
signature = hmac.new(
self.access_key.encode(), message.encode(), hashlib.sha256
).hexdigest().upper()
query = urllib.parse.urlencode(sorted(params.items()))
url = self.endpoint + path + (f"?{query}" if query else "")
request = urllib.request.Request(
url,
method=method,
headers={
"client_id": self.access_id,
"sign": signature,
"sign_method": "HMAC-SHA256",
"access_token": self.token,
"t": str(now_ms),
"lang": "en",
},
)
with urllib.request.urlopen(request, timeout=20) as response:
return json.loads(response.read())
def connect(self) -> dict:
self.token = ""
result = self._request("GET", "/v1.0/token", {"grant_type": 1})
if result.get("success"):
payload = result.get("result", {})
self.token = payload.get("access_token", "")
self.token_expires_ms = int(time.time() * 1000) + int(
payload.get("expire_time", 7200)
) * 1000
return result
def get(self, path: str, params: dict | None = None) -> dict:
if not self.token or self.token_expires_ms - 60000 < int(time.time() * 1000):
connected = self.connect()
if not connected.get("success"):
return connected
return self._request("GET", path, params)
def iso_local(ms: int) -> str:
return datetime.fromtimestamp(ms / 1000, timezone.utc).astimezone(TZ).isoformat()
class Store:
def __init__(self) -> None:
DB_PATH.parent.mkdir(parents=True, exist_ok=True)
self.db = sqlite3.connect(DB_PATH)
self.db.row_factory = sqlite3.Row
self.db.execute("PRAGMA journal_mode=WAL")
self.db.executescript(
"""
CREATE TABLE IF NOT EXISTS switch_events (
event_time_ms INTEGER NOT NULL,
value INTEGER NOT NULL CHECK(value IN (0,1)),
event_from TEXT NOT NULL DEFAULT '',
received_at TEXT NOT NULL,
PRIMARY KEY(event_time_ms, value, event_from)
);
CREATE INDEX IF NOT EXISTS idx_switch_events_time
ON switch_events(event_time_ms);
CREATE TABLE IF NOT EXISTS sync_runs (
id INTEGER PRIMARY KEY AUTOINCREMENT,
started_at TEXT NOT NULL,
finished_at TEXT,
ok INTEGER NOT NULL DEFAULT 0,
fetched INTEGER NOT NULL DEFAULT 0,
inserted INTEGER NOT NULL DEFAULT 0,
error TEXT
);
CREATE TABLE IF NOT EXISTS settings (
key TEXT PRIMARY KEY,
value TEXT NOT NULL
);
"""
)
self.db.commit()
def add_events(self, logs: list[dict]) -> int:
before = self.db.total_changes
now = datetime.now(timezone.utc).isoformat()
for item in logs:
if item.get("code") != "switch_1":
continue
raw = str(item.get("value", "")).lower()
if raw not in {"true", "false", "1", "0", "on", "off"}:
continue
value = 1 if raw in {"true", "1", "on"} else 0
self.db.execute(
"INSERT OR IGNORE INTO switch_events VALUES (?,?,?,?)",
(int(item["event_time"]), value, str(item.get("event_from", "")), now),
)
self.db.commit()
return self.db.total_changes - before
def normalized_events(self, start_ms: int | None = None, end_ms: int | None = None):
# Include the last event before the range to establish initial state.
rows: list[sqlite3.Row] = []
if start_ms is not None:
previous = self.db.execute(
"SELECT * FROM switch_events WHERE event_time_ms < ? "
"ORDER BY event_time_ms DESC LIMIT 1",
(start_ms,),
).fetchone()
if previous:
rows.append(previous)
query = "SELECT * FROM switch_events WHERE 1=1"
args: list[int] = []
if start_ms is not None:
query += " AND event_time_ms >= ?"
args.append(start_ms)
if end_ms is not None:
query += " AND event_time_ms < ?"
args.append(end_ms)
query += " ORDER BY event_time_ms, event_from"
rows.extend(self.db.execute(query, args).fetchall())
result: list[dict] = []
for row in rows:
event = {"ms": row["event_time_ms"], "on": bool(row["value"])}
# Tuya often emits the same transition twice from cloud/device.
if result and event["on"] == result[-1]["on"]:
continue
result.append(event)
return result
def report(self, start_day: date, end_day: date) -> dict:
start = datetime.combine(start_day, dt_time.min, TZ)
end = datetime.combine(end_day + timedelta(days=1), dt_time.min, TZ)
start_ms = int(start.timestamp() * 1000)
end_ms = int(end.timestamp() * 1000)
events = self.normalized_events(start_ms, end_ms)
intervals: list[tuple[datetime, datetime]] = []
on_at: int | None = None
for event in events:
if event["on"] and on_at is None:
on_at = max(event["ms"], start_ms)
elif not event["on"] and on_at is not None:
stop = min(event["ms"], end_ms)
if stop > on_at:
intervals.append(
(
datetime.fromtimestamp(on_at / 1000, timezone.utc).astimezone(TZ),
datetime.fromtimestamp(stop / 1000, timezone.utc).astimezone(TZ),
)
)
on_at = None
if on_at is not None:
stop_ms = min(int(time.time() * 1000), end_ms)
if stop_ms > on_at:
intervals.append(
(
datetime.fromtimestamp(on_at / 1000, timezone.utc).astimezone(TZ),
datetime.fromtimestamp(stop_ms / 1000, timezone.utc).astimezone(TZ),
)
)
daily: dict[date, dict] = {}
cursor = start_day
while cursor <= end_day:
daily[cursor] = {"date": cursor.isoformat(), "seconds": 0.0, "starts": 0}
cursor += timedelta(days=1)
for begin, finish in intervals:
daily[begin.date()]["starts"] += 1
point = begin
while point < finish:
midnight = datetime.combine(point.date() + timedelta(days=1), dt_time.min, TZ)
segment_end = min(finish, midnight)
if point.date() in daily:
daily[point.date()]["seconds"] += (segment_end - point).total_seconds()
point = segment_end
rows = []
for item in daily.values():
hours = item.pop("seconds") / 3600
kwh = hours * POWER_KW
rows.append(
{
**item,
"runtime_min": round(hours * 60, 1),
"kwh": round(kwh, 3),
"cost_eur": round(kwh * UNIT_RATE, 2),
}
)
total_min = sum(row["runtime_min"] for row in rows)
total_kwh = sum(row["kwh"] for row in rows)
return {
"ok": True,
"from": start_day.isoformat(),
"to": end_day.isoformat(),
"power_kw": POWER_KW,
"rate_eur_kwh": UNIT_RATE,
"measurement": "estimated_from_on_time",
"days": rows,
"totals": {
"starts": sum(row["starts"] for row in rows),
"runtime_min": round(total_min, 1),
"kwh": round(total_kwh, 3),
"cost_eur": round(total_kwh * UNIT_RATE, 2),
},
}
class TuyaMonitor:
def __init__(self, store: Store) -> None:
self.store = store
self.api = TuyaOpenAPI(ENDPOINT, ACCESS_ID, ACCESS_KEY)
self.connected = False
self.latest = {"ok": False, "error": "a iniciar"}
self.lock = asyncio.Lock()
def _connect(self) -> None:
result = self.api.connect()
if not result.get("success"):
raise RuntimeError(result.get("msg", "falha de autenticação Tuya"))
self.connected = True
def _fetch_status(self) -> dict:
if not self.connected:
self._connect()
response = self.api.get(f"/v1.0/iot-03/devices/{DEVICE_ID}/status")
if not response.get("success"):
self.connected = False
raise RuntimeError(response.get("msg", "falha ao consultar status"))
values = {x["code"]: x["value"] for x in response.get("result", [])}
return values
def _fetch_logs(self, days: int) -> list[dict]:
if not self.connected:
self._connect()
now_ms = int(time.time() * 1000)
params = {
"type": "1,2,7",
"start_time": now_ms - days * 86400 * 1000,
"end_time": now_ms,
"size": 100,
}
response = self.api.get(f"/v1.0/devices/{DEVICE_ID}/logs", params)
if not response.get("success"):
self.connected = False
raise RuntimeError(response.get("msg", "falha ao consultar logs"))
return response.get("result", {}).get("logs", [])
async def sync(self, days: int = 14) -> dict:
async with self.lock:
try:
# tuya-connector keeps the access token on the client; serialize its calls.
status = await asyncio.to_thread(self._fetch_status)
logs = await asyncio.to_thread(self._fetch_logs, days)
inserted = self.store.add_events(logs)
now = datetime.now(TZ)
today = self.store.report(now.date(), now.date())
self.latest = {
"ok": True,
"ts": now.isoformat(timespec="seconds"),
"device_id": DEVICE_ID,
"name": "Boiler Shower",
"is_on": bool(status.get("switch_1")),
"online": True,
"power_kw_assumed": POWER_KW,
"watts_estimated": POWER_KW * 1000 if status.get("switch_1") else 0,
"today": today["totals"],
"events_fetched": len(logs),
"events_inserted": inserted,
"measurement": "ESTIMATIVA por tempo ON; este Tuya não mede watts/kWh",
}
return self.latest
except Exception as exc:
self.latest = {
"ok": False,
"online": False,
"error": f"{type(exc).__name__}: {exc}",
}
return self.latest
async def loop(self) -> None:
await self.sync(days=90)
while True:
await asyncio.sleep(POLL_SECONDS)
await self.sync(days=7)
INDEX_HTML = r"""
Boiler · Tuya
Interruptor do boilera iniciar…
—
Potência configurada: 2,3 kW · apenas leitura
Ligações hoje
—
ciclos detectados
Estimativa: este modelo Tuya não possui medidor elétrico. kWh = 2,3 kW × tempo em que o relé ficou ON. Um termóstato interno pode reduzir o consumo real.
"""
store = Store()
monitor = TuyaMonitor(store)
def parse_range(request: web.Request) -> tuple[date, date]:
today = datetime.now(TZ).date()
start = date.fromisoformat(request.query.get("from", (today - timedelta(days=29)).isoformat()))
end = date.fromisoformat(request.query.get("to", today.isoformat()))
if end < start:
raise ValueError("data final anterior à inicial")
if (end - start).days > 730:
raise ValueError("intervalo máximo: 730 dias")
return start, end
async def index(_request: web.Request) -> web.Response:
return web.Response(text=INDEX_HTML, content_type="text/html")
async def boiler_redirect(_request: web.Request) -> web.Response:
raise web.HTTPPermanentRedirect("/boiler/")
async def api_status(_request: web.Request) -> web.Response:
if not monitor.latest.get("ok"):
await monitor.sync(days=14)
return web.json_response(monitor.latest)
async def api_sync(_request: web.Request) -> web.Response:
return web.json_response(await monitor.sync(days=90))
async def api_report(request: web.Request) -> web.Response:
try:
start, end = parse_range(request)
return web.json_response(store.report(start, end))
except Exception as exc:
return web.json_response({"ok": False, "error": str(exc)}, status=400)
async def api_report_csv(request: web.Request) -> web.Response:
try:
start, end = parse_range(request)
report = store.report(start, end)
output = io.StringIO()
writer = csv.writer(output)
writer.writerow(["data", "ligacoes", "minutos_on", "kwh_estimados", "custo_eur"])
for row in report["days"]:
writer.writerow(
[row["date"], row["starts"], row["runtime_min"], row["kwh"], row["cost_eur"]]
)
return web.Response(
text=output.getvalue(),
content_type="text/csv",
headers={
"Content-Disposition": f'attachment; filename="boiler_{start}_{end}.csv"'
},
)
except Exception as exc:
return web.json_response({"ok": False, "error": str(exc)}, status=400)
async def on_start(app: web.Application) -> None:
app["collector"] = asyncio.create_task(monitor.loop())
async def on_stop(app: web.Application) -> None:
app["collector"].cancel()
def main() -> None:
app = web.Application()
app.router.add_get("/", index)
app.router.add_get("/api/status", api_status)
app.router.add_post("/api/sync", api_sync)
app.router.add_get("/api/report", api_report)
app.router.add_get("/api/report.csv", api_report_csv)
app.router.add_get("/boiler", boiler_redirect)
app.router.add_get("/boiler/", index)
app.router.add_get("/boiler/api/status", api_status)
app.router.add_get("/boiler/api/report", api_report)
app.router.add_get("/boiler/api/report.csv", api_report_csv)
app.on_startup.append(on_start)
app.on_cleanup.append(on_stop)
web.run_app(app, host="0.0.0.0", port=PORT, print=None)
if __name__ == "__main__":
main()