Anslut digitalSTROM till Home Assistant: lokal integration och automationer

I digitalSTROM-installationer är lampor, persienner och andra förbrukare anslutna till klämmor i elcentralen och styrs via tryckknappar och en digitalSTROM-server (dSS20). När ytterligare system som Philips Hue, Sonos och en FRITZ!Box tillkommer är det naturligt att samla allt lokalt i Home Assistant, utan molnkonto och utan att lagra dSS-lösenordet i Home Assistant. För detta har jag skrivit en liten integration och publicerat den tillsammans med passande automationer som pfstr/ha-digitalstrom-local under MIT-licens.

Kort sammanfattat: dSS erbjuder ett användbart JSON-API med händelser. Den som använder det varsamt får tryckknappar, scener samt aktiviteterna Gå och Komma till Home Assistant utan fördröjning och kan därmed utlösa automationer som digitalSTROM inte känner till på egen hand.

Så fungerar integrationen

dSS tillhandahåller sitt API på port 8080 via HTTPS, med ett självsignerat certifikat. För program erbjuder digitalSTROM app-token: Programmet begär en token, användaren godkänner den i Configurator under System > Åtkomstbehörighet och programmet loggar sedan in med den. dSS-lösenordet stannar hos användaren.

DSS=https://dss.local:8080/json
curl -sk "$DSS/system/requestApplicationToken?applicationName=Home%20Assistant"
curl -sk "$DSS/system/loginApplication?loginToken=<APP-TOKEN>"
curl -sk "$DSS/event/subscribe?name=callScene&subscriptionID=42&token=<SESSION>"
curl -sk "$DSS/event/get?subscriptionID=42&timeout=30000&token=<SESSION>"

Integrationen håller en sådan long poll-anslutning öppen permanent. Varje scen som utlöses av en tryckknapp, appen eller Configurator kommer in som en händelse. Tillstånd som ”ljus på i rummet” eller närvaro finns i dSS:s cache under /usr/states och kan hämtas utan att belasta klämmorna.

Direkta frågor om utgångsvärden (device/getOutputValue) går däremot via dS485-bussen hela vägen till klämman och tar en halv till en sekund per värde. Många sådana frågor med korta intervall kan överbelasta mätarna. Integrationen läser därför endast persiennpositioner och Joker-utgångar direkt, var 15:e minut och ungefär en minut efter en körning.

Dessutom rapporterar integrationen varje rumsscen samt Gå och Komma som händelsen digitalstrom_local_event till Home Assistant. Därmed kan 2× eller 4× tryckningar på en vanlig ljusknapp tilldelas fritt.

Automationer som Blueprints

Följande automationer ingår som Blueprints i repositoriet och kan läggas till i Home Assistant via importknappen i README.

Rörelsebelysning som inte släcker manuellt tänd belysning

Vid rörelse tänds ljuset och släcks igen efter en inställbar tid utan rörelse. Valfritt gäller detta endast under en ljusstyrketröskel, endast inom ett tidsfönster eller dämpat på natten. Om någon tänder ljuset med tryckknappen förblir det tänt. En hjälpbrytare (input_boolean) minns om automationen tände ljuset; endast då släcker den det också igen.

En detalj märks först under drift: Utlösaren ”detektorn har varit lugn i 2 minuter” är en räknare som Home Assistant förkastar vid varje omstart. Om detektorn senast registrerade rörelse före omstarten sker ingen ny övergång till ”lugn”, och ljuset förblir tänt. Blueprinten kontrollerar därför dessutom varje minut om ett ljus som den har tänt fortfarande lyser trots att detektorn har varit lugn tillräckligt länge.

Släck ljuset när rummet lämnas

Avstängningstiden för rörelsebelysningen är en kompromiss: Är den för kort släcks ljuset medan någon står stilla i rummet; är den för lång fortsätter det lysa i flera minuter efter att rummet lämnats. En annan Blueprint använder därför en andra detektor utanför rummet, vanligtvis i hallen. Om denna registrerar rörelse, detektorn i rummet nyligen (inom 30 sekunder) också har registrerat rörelse och det sedan förblir lugnt där, släcks ljuset i rummet omedelbart. Med Hue-detektorer, som rapporterar ”lugn” ungefär 10 sekunder efter den senaste rörelsen, blir det cirka 10 till 15 sekunder efter att man gått ut.

För att ingen ska sitta i mörkret gäller regeln endast under vissa villkor: Ljuset måste ha tänts av rörelseautomation, ett duschläge får inte vara aktivt och högst en person får vara hemma. Antalet personer avgörs av mobilerna som Home Assistant känner till som personer. 30-sekundersvillkoret skyddar dessutom mot fallet att någon står stilla i rummet under längre tid medan en annan person går genom hallen.

Duschläge med 2× tryckningar

I duschen registrerar en rörelsedetektor oftast ingen, och efter den inställda tiden blir det mörkt. 2× tryckningar på badrumsknappen utlöser stämning 2 (scen 17) i digitalSTROM. Automation känner igen denna scen i rummet och aktiverar ett duschläge som blockerar avstängning. Rörelser under de första 2 minuterna ignoreras (avklädning, att stiga in). Den första rörelsen därefter avslutar duschläget, och från då gäller åter den normala avstängningstiden. Efter en inställbar maximal tid (standard 20 minuter) avslutas det automatiskt.

4× tryckningar startar Sonos

När man trycker snabbt flera gånger på en knapp växlar digitalSTROM genom stämningarna i tur och ordning: scen 5, 17, 18 och 19 vid den fjärde tryckningen. Om scen 19 i Configurator ställs in på ”Ändra inte utgång” för alla lampor är den ledig för andra ändamål. En Blueprint reagerar på denna scen, släcker rummets ljus och startar Sonos-högtalaren i rummet eller, i rum utan högtalare, flera högtalare tillsammans.

Skriptet tar hänsyn till tre saker: Om en högtalare redan spelar läggs det nya rummet till i dess grupp så att uppspelningen förblir synkroniserad. Om inget kan återupptas spelas en radiostation från Radio Browser-katalogen. Och före varje start ställs samma startvolym in, annars spelar det ena rummet tyst och det andra lika högt som någon senast lyssnade på musik.

Gå och Komma via FRITZ!Box

Integrationen FRITZ!Box Tools rapporterar om en mobil är ansluten till WLAN; den utvärderar boxens enhetslista och täcker därmed 2,4 GHz-nät, 5 GHz-nät och LAN samtidigt. Om ingen längre är hemma och Gå inte har aktiverats utlöser en Blueprint Gå. När någon kommer hem följer Komma och, om det är mörkt, en välkomstbelysning.

Som komplement kan en automation släcka lampor i andra system (till exempel Hue) och pausa Sonos vid Gå. digitalSTROM-lamporna släcks av dSS självt.

Planritning som dashboard

En tydlig visning i Home Assistant är en planritning med det inbyggda kortet picture-elements. I varje rum ligger en transparent SVG över planen, som ersätts av en svagt gul när ljuset är tänt; ett tryck på rummet växlar ljuset. Lampor, högtalare, persienner och detektorer placeras som symboler på sina respektive platser. Instruktionerna med exempelkonfiguration finns i repositoriet under docs/floor-plan-dashboard.md.

Problem från praktiken

En enhetssökning på Hue-bryggan lägger till alla enheter som just då är i parkopplingsläge. Kontrollera därefter i enhetslistan att endast dina egna lampor har lagts till.

Klämmornas scentabeller kan läsas ut och ändras via API:t, till exempel med device/getSceneMode och device/saveScene. Vart och ett av dessa anrop går via bussen. Säkerhetskopiera de gamla värdena före ändringar, exempelvis i en CSV-fil, så att de kan återställas vid behov.