• Bugfixes.
• max from 10 to 20 svotc_requested_offset_c:, svotc_applied_offset_c:

SVOTC är ett stabilt och förutseende styrsystem för värmepumpar i Home Assistant. Det optimerar värmeproduktion genom att kombinera komfortskydd och prislogik, med mjuka övergångar och tydliga förklaringar (reason codes).

Systemet är byggt för att vara:

• ✅ Stabilt — inga oscillationer eller instabila tillstånd
• ✅ Förutsägbart — tydlig logik med full observability
• ✅ Självkorrigerande — via stabiliserande lager (dwell, hysteresis, ramp-limit)
• ✅ Enkelt att felsöka — omfattande diagnostik och reason codes
• ✅ Autonomt — kräver minimal inblandning efter setup

• Håller inomhustemperaturen nära ett mål
• Komfortskydd aktiveras när temperaturen sjunker för lågt
• MCP (Maximum Comfort Priority) blockerar prisstyrning när komforten hotas
• Hysteresis förhindrar studsning mellan on/off

• Använder P30/P80-percentiler från raw_today för att avgöra billiga/dyra perioder (Ngenic-liknande dagsfokus)
• Pre-brake-logik (forward-look) som bygger upp bromsning gradvis innan dyra timmar
• Brake-fasmaskin (ramping up → holding → ramping down) för mjuka övergångar
• Dwell-timers förhindrar prisfluktuationer från att orsaka instabilitet
• Bridge-hold (NEAR) kan titta in i raw_tomorrow om det finns, men påverkar inte P30/P80-gränserna

Alla delar är separerade för enkel förståelse och underhåll:

• Sensors — validerade temperaturer och priser
• Price dwell — stabiliserar råa pristillstånd
• Brake phase — fasmaskin för mjuka bromscykler
• Engine — core control loop
• Learning — självjustering (endast i learning-variant)
• Notify — diagnostik och varningar
• Startup init — säker initialisering (om din variant har den)

• Freeze-logik när prisdata saknas (komfortskydd fortsätter)
• Rate-limiter för applied offset (förhindrar plötsliga hopp)
• Hälsokontroller för alla inputs
• Anti-storm throttling (max en körning per 30 sekunder, om aktiverat i din variant)
• Sanity checks på alla sensorvärden

Lägg filen i:

/config/packages/svotc.yaml

Eller valfri plats om du använder packages: i configuration.yaml.

I din configuration.yaml, lägg till:

homeassistant:
  packages: !include_dir_named packages

Där hittar du alla SVOTC-kontroller.

För kompatibilitet är input_boolean.svotc_initialized satt till on från början. Gör så här för säker first-run-init:

1. Sätt input_boolean.svotc_initialized till off
2. Vänta 30–60 sekunder så init-automation hinner skriva standardvärden
3. Verifiera att helpers fått rimliga defaultvärden
4. Låt svotc_initialized gå tillbaka till on (automatiskt eller manuellt)

Tips: Lägg gärna detta som punkt i din installationschecklista så det inte missas.

Följ dessa steg för att komma igång snabbt:

1. Installera filen enligt ovan
2. Starta om Home Assistant
3. Konfigurera entiteter:
   • Gå till Developer Tools → States
   • Hitta dina temperatur- och pris-entiteter
   • Ange dem i:
     • input_text.svotc_entity_indoor → din inomhussensor
     • input_text.svotc_entity_outdoor → din utomhussensor
     • input_text.svotc_entity_price → din Nordpool-sensor
4. Sätt mode till Smart:
   • input_select.svotc_mode → Smart
5. Vänta 2-3 minuter för första körningen
6. Verifiera att det fungerar:
   • Kolla input_text.svotc_reason_code
   • Om NEUTRAL eller PRICE_BRAKE → allt är OK
   • Om MISSING_INPUTS_FREEZE → kontrollera entitetsmappning

Troubleshooting: Om inget händer efter 5 minuter, kolla:

• binary_sensor.svotc_inputs_healthy (ska vara ON)
• binary_sensor.svotc_price_available (ska vara ON)
• input_text.svotc_reason_code för diagnos

Du måste ange dessa tre entiteter:

OBS: Nordpool-entiteten måste vara från Nordpool-integrationen eller kompatibel.

• P30/P80 beräknas endast från raw_today (dagens priser).
• raw_tomorrow används bara för forward-look/bridge-hold när morgondagens block finns tillgängliga.

Lätt hus (snabb värme/kyla, dålig isolering):

• Thermal mass factor: 0.6–0.8
• Prebrake lead time: 15–30 min
• Brake hold offset: 4–6°C

Normal villa:

• Thermal mass factor: 1.0
• Prebrake lead time: 30 min
• Brake hold offset: 6°C

Tung villa (bra isolering, långsam värme/kyla):

• Thermal mass factor: 1.3–1.8
• Prebrake lead time: 40–60 min
• Brake hold offset: 6–8°C

SVOTC styr inte direkt din värmepump. Istället skapar den en virtuell utomhustemperatur som du måste skicka till pumpen.

sensor.svotc_virtual_outdoor_temperature

Detta är den temperatur din värmepump ska använda istället för verklig utomhustemperatur.

SVOTC kan kopplas till din värmepump på flera sätt:

Ohmigo Ohm-on WiFi Plus är en WiFi-adapter som gör det enkelt att integrera SVOTC med din värmepump.

Fördelar:

• ✅ Plug & Play — enkel installation
• ✅ WiFi-baserad — kommunicerar direkt med Home Assistant
• ✅ Kompatibel med många värmepumpar
• ✅ Ingen molntjänst krävs — fungerar lokalt

Installation:

1. Montera Ohm-on WiFi Plus enligt tillverkarens instruktioner
2. Anslut enheten till ditt WiFi-nätverk
3. Integrera med Home Assistant (via MQTT)
4. Skapa en automation som läser sensor.svotc_virtual_outdoor_temperature
5. Skicka värdet till värmepumpen via Ohmigo-enheten

SVOTC levereras med färdiga kort som du kan kopiera in i din dashboard.

Detta är det rekommenderade sättet - lägg till SVOTC-kort i din befintliga dashboard.

1. Gå till din Hemskärm (eller valfri dashboard)
2. Klicka på pennikonen (Edit Dashboard) uppe till höger

1. Klicka på "+ ADD CARD" där du vill ha kortet
2. Scrolla ner i kortlistan
3. Klicka på "MANUAL" längst ner (eller välj ett befintligt kort först)
4. Du ser nu en kod-editor med YAML

1. Radera det som står i editorn
2. Öppna filen SVOTC_Cards.yaml från repot
3. Kopiera det kort du vill ha (t.ex. "Kontrollpanel")
4. Klistra in i editorn
5. Klicka "SAVE"

Lägg till fler kort genom att upprepa steg 2-3 för varje kort du vill ha.

Klart! Dina SVOTC-kort är nu tillagda. 🎉

Om du vill ha en egen dashboard för SVOTC med Sections-layout:

1. Gå till Settings → Dashboards
2. Klicka på "+ ADD DASHBOARD" (nere till höger)
3. Välj "New dashboard"
4. Namn: "SVOTC Control"
5. Typ: Välj "Sections (experimental)" om tillgänglig, annars standard
6. Klicka "CREATE"

1. På den nya dashboarden, klicka "EDIT DASHBOARD"
2. Klicka "+ ADD SECTION"
3. Välj "Grid"

1. I den nya grid-sectionen, klicka "+ ADD CARD"
2. Scrolla ner och välj "MANUAL" (eller sök efter korttyp)
3. I YAML-editorn som öppnas:
   • Radera befintligt innehåll
   • Klistra in ett kort från SVOTC_Cards.yaml
   • Klicka "SAVE"
4. Upprepa för varje kort du vill ha

1. I edit-läge, klicka på "MANAGE BADGES" (om tillgängligt)
2. Lägg till relevanta entiteter som badges:
   • sensor.svotc_virtual_outdoor_temperature
   • input_text.svotc_reason_code
   • binary_sensor.svotc_inputs_healthy

Klart! Du har nu en dedikerad SVOTC-dashboard. 🎉

Innehåll:

• Driftsläge (Smart/Simple/ComfortOnly/etc.)
• Komfortinställningar (mål, guard-trösklar)
• Prisoptimering (brake/heat aggressiveness)
• Thermal mass factor
• Comfort guard on/off

Användning: Primära kontroller för daglig användning.

Innehåll:

• Requested offset (orange)
• Applied offset (röd)
• 24h historik

Användning: Se hur systemet justerar offset över tid.

Innehåll:

• Outdoor verklig (blå)
• Virtual outdoor → VP (lila)
• 24h historik

Användning: Se skillnaden mellan verklig och virtuell utetemperatur.

Innehåll:

• Nordpool-pris
• 24h historik

Användning: Övervaka elpriset och förstå när systemet bromsar.

Innehåll:

• Systemhälsa (sensors OK, price available)
• Timing (minuter till nästa brake, prebrake window)
• Prisstatus (raw → pending → stable)
• Brake phase

Användning: Felsökning och förståelse av systemets interna tillstånd.

Innehåll:

• Live systemöversikt med dynamiska beräkningar
• Temperaturstatus med offset-detaljer
• Prisstyrning med prebrake-indikator
• Komfortskydd med trösklar
• Bromsfas med progress
• Expanderbara diagnostikdetaljer
• Strategi-förklaring

Användning: En enda överblick över ALLT systemet gör.

OBS: Detta kort kräver mycket utrymme - rekommenderas i egen sektion.

Innehåll:

• SVOTC Mode + System OK (rad 1)
• Comfort Guard + Reason Code (rad 2)

Användning: Kompakt statusöversikt.

Graferna använder mini-graph-card från HACS:

1. Öppna HACS → Frontend
2. Sök efter "mini-graph-card"
3. Klicka "Download"
4. Starta om Home Assistant

Alternativ utan custom cards:

• Skippa grafkorten
• Eller ersätt med standard history-graph:

  type: history-graph
  entities:
    - entity: input_number.svotc_applied_offset_c
  hours_to_show: 24

För bästa översikt, använd denna ordning:

Sektion 1 (Grid):

1. 🎯 Snabbstatus (överst för snabb överblick)
2. 🎛️ Kontrollpanel (primära inställningar)
3. 📊 Offset-graf (viktigaste grafen)
4. 🌡️ Temperaturgraf
5. 💵 Prisgraf

Sektion 2 (Grid, valfri):

1. 📋 System Status (markdown) - hel bredd
2. 🔬 Diagnostik (för nördarna)

1. Håll nere på kortet (mobil) eller klicka tre prickar (desktop)
2. Välj "Edit"
3. Klicka "SHOW CODE EDITOR" (nere till höger)
4. Gör dina ändringar
5. Spara

Öppna kortet i YAML-läge och ta bort rader. Exempel:

entities:
  - entity: input_number.svotc_comfort_temperature
  # - entity: input_number.svotc_prebrake_lead_time_min  ← Ta bort denna rad om du inte vill ändra den

SVOTC kan (i learning-varianten) använda en enkel självjustering som anpassar bromsningen över tid baserat på hur ofta komfortskyddet behöver ingripa.

1. Varje gång komfortskyddet aktiveras räknas en “komfortavvikelse”.

2. Vid midnatt varje natt analyseras senaste 24 timmarna med en finstegad kurva:

   • >5 avvikelser → systemet har varit för aggressivt → minska brake-efficiency med 0.05
   • 3–5 avvikelser → något för aggressivt → minska brake-efficiency med 0.02
   • 0 avvikelser → systemet kan bromsa mer → öka brake-efficiency med 0.03
   • 1 avvikelse → nära balans men kan bromsa lite mer → öka brake-efficiency med 0.01
   • 2 avvikelser → balans → behåll nuvarande värde

3. Räknaren nollställs.

4. Nästa dag används den uppdaterade effektiviteten i prisbromsningen.

Värdet klampas alltid till intervallet 0.5–1.5.

Systemet brukar stabilisera sig efter några dygn till någon vecka, men tiden varierar beroende på husets tröghet, väder, värmepumpens kurva och elprisernas mönster.

Du kan alltid manuellt justera:

input_number.svotc_learned_brake_efficiency

Normalintervall: 0.5–1.5

• 0.5 = mycket försiktig (liten offset)
• 1.0 = normal (rekommenderad start)
• 1.5 = aggressiv (stor offset)

Systemet skickar automatiska notiser vid:

Ange vilken notify-service som ska användas:

input_text.svotc_notify_service

Exempel:

• notify.mobile_app_johan (HA Companion App)
• notify.telegram (Telegram)
• notify.pushover (Pushover)
• notify.notify (default, alla notifieringstjänster)

Vid problem:

SVOTC: Missing data

Inputs eller prisdata saknas sedan minst 3 minuter.

Missing mappings: price mapping
Sources:
  indoor=21.3
  outdoor=5.2
  price=unknown

Vid återhämtning:

SVOTC: OK again

Inputs + price data är stabila igen.

Q: Varför rör sig inte offset?
A: Kolla input_text.svotc_reason_code. Troligen:

• MISSING_INPUTS_FREEZE → saknar sensorer, kontrollera entitetsmappning
• PRICE_DATA_WARMUP_FREEZE → väntar på tillräcklig prisdata (främst raw_today) innan prislogik släpps
• OFF → systemet är avstängt, sätt mode till Smart

Q: Hur vet jag att det fungerar?
A: Efter 2-3 minuter bör du se:

1. binary_sensor.svotc_inputs_healthy = ON
2. binary_sensor.svotc_price_available = ON
3. input_text.svotc_reason_code = NEUTRAL (eller annan aktiv kod)
4. input_number.svotc_applied_offset_c ändras gradvis

Q: Vilken Nordpool-integration behöver jag?
A: Den officiella Nordpool-integrationen från HACS eller core. Sensorn måste ha attributen:

• current_price
• raw_today (lista med prisblock för idag)
• raw_tomorrow (valfritt men rekommenderat för bättre forward-look/bridge-hold)

Tips: Om du använder den officiella Nordpool-integrationen, kan du använda paketfilen från Nordpool-official för enklare konfiguration.

Q: Vilken hårdvara behöver jag för att koppla SVOTC till min värmepump?
A: Det beror på din värmepump:

• Rekommenderat: Ohmigo Ohm-on WiFi Plus — fungerar med de flesta värmepumpar och ger fullständig lokal kontroll
• Annat: Kontrollera om din pumpintegration stöder temperaturoffset eller värmekurva

Q: Systemet är för aggressivt / för försiktigt
A: Justera i denna ordning:

1. input_number.svotc_prebrake_lead_time_min → hur tidigt prebrake ska börja
2. input_number.svotc_thermal_mass_factor (0.5-2.0) → anpassa till husets tröghet
3. input_number.svotc_brake_hold_offset_c (0-20) → max offset under dyra perioder
4. input_number.svotc_bridge_hold_window_min → minska/öka brohållning mellan toppar
5. Vänta 3-5 dagar om learning/autotune är aktiv innan ny större justering

Q: Kan jag inaktivera learning?
A: Ja, ta bort automationen SVOTC Learning: reset daily counter. Då behåller systemet alltid det manuella värdet i svotc_learned_brake_efficiency.

Q: Hur fungerar freeze-logiken?
A: När prisdata saknas:

1. Comfort guard fortsätter fungera (säkerhet först)
2. Price logic frysas på senast kända värde
3. Offset ändras inte (rate-limiter håller nuvarande värde)
4. Notifikation skickas efter 3 minuter
5. När data återkommer → systemet fortsätter normalt

Q: Vad händer om Nordpool går ner?
A:

1. Systemet detekterar saknad prisdata inom 1 minut
2. Övergår till freeze-mode (behåller senaste offset)
3. Comfort guard fortsätter fungera
4. Du får en notis efter 3 minuter
5. När Nordpool är uppe igen återgår allt till normalt

Q: Kan jag bidra?
A: Absolut! Pull requests välkomnas för:

• Buggfixar
• Dokumentationsförbättringar
• Översättningar

MIT License — fritt att använda, ändra och dela.

Copyright (c) 2026 Johan Ä

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

• Ohmigo Ohm-on WiFi Plus — WiFi-adapter för värmepumpar

• Coming soon: Installation guide
• Coming soon: Advanced tuning
• Coming soon: Integration examples

Version: (2026-02-25)
Senast uppdaterad: 2026-02-25 Licens: MIT