6. oktober 2026 Oppdatert: 25. oktober 2026 13 min lesetid

Koble digitalSTROM til Home Assistant: lokal integrasjon og automasjoner

En lokal Home Assistant-integrasjon for digitalSTROM-serveren, samt bevegelseslys, dusjmodus, musikk med 4× trykk og automatisk bortemodus via FRITZ!Box. Med problemene som oppstod i praksis.

I digitalSTROM-installasjoner er lys, persienner og andre forbrukere koblet til klemmer i sikringsskapet, styrt via trykknapper og en digitalSTROM-server (dSS20). Når flere systemer som Philips Hue, Sonos og en FRITZ!Box kommer til, er det naturlig å samle alt lokalt i Home Assistant, uten skykonto og uten å lagre passordet til dSS i Home Assistant. Til dette har jeg skrevet en liten integrasjon og publisert den sammen med passende automasjoner som pfstr/ha-digitalstrom-local under MIT-lisens.

Kort oppsummert: dSS tilbyr et brukbart JSON-API med hendelser. De som bruker det skånsomt, får trykknapper, scener og aktivitetene Gå og Komme til Home Assistant uten forsinkelse og kan dermed utløse automasjoner som digitalSTROM alene ikke kjenner til.

Slik fungerer integrasjonen

DSS tilbyr API-et sitt på port 8080 via HTTPS, med et selvsignert sertifikat. For programmer har digitalSTROM app-tokener: Programmet ber om et token, brukeren godkjenner det i Configurator under System > Tilgangstillatelse, og deretter logger programmet inn med det. Passordet til dSS forblir hos brukeren.

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>"
Forklaring av alternativer
AlternativVirkning
-singen fremdriftsvisning
-kgodtar selvsignert sertifikat fra dSS
requestApplicationTokenoppretter et app-token som må godkjennes i Configurator
loginApplicationbytter det godkjente app-tokenet mot et økt-token
event/subscribeabonnerer på en hendelse (callScene, stateChange, buttonClick …) under en fritt valgt ID
event/get med timeoutventer opptil 30 sekunder på nye hendelser (long poll)

Integrasjonen holder en slik long-poll-forbindelse åpen kontinuerlig. Hver scene som en trykknapp, appen eller Configurator utløser, kommer inn som en hendelse. Tilstander som «lys på i rommet» eller tilstedeværelse ligger i hurtigbufferen til dSS under /usr/states og kan hentes uten å belaste klemmene.

Direkte spørringer av utgangsverdier (device/getOutputValue) går derimot over dS485-bussen helt til klemmen og tar et halvt til ett sekund per verdi. Mange slike spørringer med korte mellomrom kan overbelaste målerne. Integrasjonen leser derfor bare persienneposisjoner og Joker-utganger direkte, hvert 15. minutt og omtrent ett minutt etter en bevegelse.

PlattformInnhold
lightett lys per rom, styrt via romscener som trykknappene; lysstyrke for dimmede klemmer, bare av/på for bryterstyrte
coverpersienner med opp, ned, stopp og posisjon
scenestemninger med navn i Configurator
buttonGå (scene 72) og Komme (scene 71)
binary_sensortilstedeværelse, vindalarm, bevegelsessensorer, Joker-utganger
sensortotalt forbruk

I tillegg rapporterer integrasjonen hver romscene samt Gå og Komme som hendelsen digitalstrom_local_event til Home Assistant. Dermed kan 2× eller 4× trykk på en vanlig lysbryter tildeles fritt.

Automatiseringer som Blueprints

Følgende automasjoner følger med i repositoryet som Blueprints og kan importeres til Home Assistant via importknappen i README-filen.

Bevegelseslys som ikke slår av lys som er slått på manuelt

Ved bevegelse slås lyset på, og etter en justerbar tid uten bevegelse slås det av igjen. Valgfritt gjelder dette bare under en lysstyrketerskel, bare innenfor et tidsvindu eller med dempet lys om natten. Hvis noen slår på lyset med trykknappen, forblir det på. En hjelpekontakt (input_boolean) husker om automasjonen slo på lyset; bare da slår den det også av igjen.

En detalj blir først synlig i drift: Utløseren «sensoren har vært rolig i 2 minutter» er en teller som Home Assistant forkaster ved hver omstart. Hvis sensoren sist registrerte bevegelse før omstarten, kommer det ingen ny overgang til «rolig», og lyset blir værende på. Blueprintet kontrollerer derfor i tillegg hvert minutt om et lys det har slått på, fortsatt er på selv om sensoren har vært rolig lenge nok.

Slå av lyset når rommet forlates

Utkoblingstiden for bevegelseslyset er et kompromiss: Er den for kort, slår lyset seg av mens noen står stille i rommet; er den for lang, fortsetter det å lyse i flere minutter etter at rommet er forlatt. Et annet Blueprint bruker derfor en andre sensor utenfor rommet, vanligvis i gangen. Hvis denne registrerer bevegelse, sensoren i rommet like før (innen 30 sekunder) fortsatt har registrert bevegelse, og det deretter forblir rolig der, slås lyset i rommet av umiddelbart. Med Hue-sensorer, som melder «rolig» omtrent 10 sekunder etter siste bevegelse, er dette rundt 10 til 15 sekunder etter at man går ut.

For at ingen skal sitte i mørket, gjelder regelen bare under bestemte vilkår: Lyset må ha blitt slått på av bevegelsesautomatiseringen, dusjmodus må ikke være aktiv, og det kan være høyst én person hjemme. Antall personer beregnes ut fra mobiltelefonene som Home Assistant kjenner som personer. 30-sekundersvilkåret beskytter dessuten mot tilfeller der noen har stått stille lenge i rommet, mens en annen person går gjennom gangen.

Dusjmodus med 2× trykk

I dusjen registrerer en bevegelsessensor vanligvis ingen, og etter den angitte tiden blir det mørkt. 2× trykk på baderomsknappen utløser stemning 2 (scene 17) i digitalSTROM. Automatiseringen registrerer denne scenen i rommet og slår på en dusjmodus som blokkerer utkobling. Bevegelser de første 2 minuttene ignoreres (avkledning, innstigning). Den første bevegelsen etterpå avslutter dusjmodusen, og deretter gjelder den vanlige utkoblingstiden igjen. Etter en justerbar maksimal varighet (standard 20 minutter) avsluttes den av seg selv.

4× trykk starter Sonos

Når man trykker raskt flere ganger på en knapp, går digitalSTROM gjennom stemningene i rekkefølge: scene 5, 17, 18 og 19 ved fjerde trykk. Hvis scene 19 settes til «Ikke endre utgang» for alle lamper i Configurator, er den ledig for andre formål. Et Blueprint reagerer på denne scenen, slår av romlyset og starter Sonos-høyttaleren i rommet eller, i rom uten høyttaler, flere høyttalere samtidig.

Skriptet til dette tar hensyn til tre ting: Hvis en høyttaler allerede spiller, legges det nye rommet til gruppen, slik at avspillingen forblir synkron. Hvis ingenting kan fortsettes, spilles en radiostasjon fra Radio Browser-katalogen. Og før hver start settes samme startvolum, ellers spiller det ene rommet lavt og det andre like høyt som noen sist hørte på musikk.

Gå og Komme via FRITZ!Box

Integrasjonen FRITZ!Box Tools rapporterer om en mobiltelefon er på WLAN; den evaluerer enhetslisten fra boksen og dekker dermed 2,4 GHz-nett, 5 GHz-nett og LAN samtidig. Hvis ingen lenger er hjemme og Gå ikke ble trykket, utløser et Blueprint Gå. Når noen kommer hjem, følger Komme og, hvis det er mørkt, et velkomstlys.

I tillegg kan en automatisering slå av lampene i andre systemer (for eksempel Hue) og sette Sonos på pause ved Gå. digitalSTROM-lampene slås av av dSS selv.

Plantegning som dashboard

En oversiktlig visning i Home Assistant er en plantegning med det innebygde kortet picture-elements. For hvert rom ligger det en gjennomsiktig SVG over planen, som erstattes med en svakt gul når lyset er på; et trykk på rommet slår på lyset. Lamper, høyttalere, persienner og sensorer vises som symboler på sine plasseringer. Veiledningen med eksempelkonfigurasjon ligger i repositoryet under docs/floor-plan-dashboard.md.

Problemer fra praksis

ProblemÅrsakLøsning
Gå-knappen har ingen virkningdSS er ikke på nettverket, aktiviteter over flere strømkretser går via serverennettverkstilkoblingen til dSS ble gjenopprettet
Persiennene reagerer ikkevindalarm stod på «aktiv», selv om ingen vindsensor finnesscene 87 («ingen vind») ble utløst for alle rom
Persiennene kjører ikke opp ved Gåscene 72 står på «Ikke endre utgang» (dontCare)device/setSceneMode med dontCare=0; verdien false ble godtatt, men ignorert
Lyset kan ikke dimmeslysrør på en bryterstyrt klemme (utgangsmodus 35)integrasjonen oppdager bryterstyrte klemmer og tilbyr der bare av/på
Lyset forblir på etter omstarttelleren for «rolig i X minutter» går tapt ved omstartekstra kontroll hvert minutt
Mobiltelefonen regnes som borteiPhone bruker en skiftende privat WLAN-adresse og kobler kort fra WLAN i hvilemodusPrivat WLAN-adresse satt til «Fast», ventetid 10 minutter
DECT sender hele tiden«DECT Eco» er ikke tilgjengelig så snart en FRITZ!-smarthjemenhet er registrertunngå DECT-stikkontakter dersom DECT Eco er ønsket

Et enhetssøk på Hue Bridge legger til alle enheter som akkurat nå er i paringsmodus. Kontroller deretter i enhetslisten at bare dine egne lamper er blitt lagt til.

Scenetabellene for klemmene kan leses ut og endres via API-et, for eksempel med device/getSceneMode og device/saveScene. Hvert av disse kallene går over bussen. Ta sikkerhetskopi av de gamle verdiene før endringer, for eksempel i en CSV-fil, slik at de kan gjenopprettes ved behov.

Endringslogg

  • 25. oktober 2026: Kildelenken ble oppdatert til den nye adressen til FRITZ!-kunnskapsdatabasen.

Kilder

  1. pfstr/ha-digitalstrom-local

    Integrasjon og Blueprints fra denne artikkelen, MIT-lisens.

    https://github.com/pfstr/ha-digitalstrom-local
  2. digitalSTROM: Håndbok for betjening og innstillinger

    Aktiviteten Gå (hold inne i 3 sekunder), innstillingen «Ikke endre utgang» i kapittel 3.5.2.

    https://www.digitalstrom.com/wp-content/uploads/2021/08/AHB_DE_A1121D001V013_neu.pdf
  3. digitalSTROM: Dokumentasjon for klemmenes knapper
  4. digitalSTROM: Bruksanvisninger

    Oversikt over håndbøker, planleggings- og installasjonsdokumenter.

    https://www.digitalstrom.com/bedienungsanleitungen/
  5. Home Assistant: FRITZ!Box Tools

    Tilstedeværelsesregistrering, WLAN-brytere, alternativer for integrasjonen.

    https://www.home-assistant.io/integrations/fritz/
  6. Home Assistant: Picture Elements card
  7. Home Assistant: Blueprints
  8. FRITZ! Kunnskapsdatabase: FRITZ!-stikkontakt mister forbindelsen
  9. Radio Browser

    Gratis katalog over radiostrømmer, integrert i Home Assistant som mediekilde.

    https://www.radio-browser.info/

Kommentarer

Kommentarene lastes inn fra GitHub / Giscus.