KatapultNRG Docs
Översikt · Uppdaterad juli 2026
Välkommen till KatapultNRG-dokumentationen
KatapultNRG är en energihanteringsplattform som är byggd och underhålls av JLStyr AB. Den har en inbyggd AI assistent som överstyr värmekällor i fastigheten för att använda så mycket egenproducerad energi som möjligt samt att hålla nere energikostnader genom att tillåta drift endast när elpriset är lågt. Den passar såväl små villaägare som större fastigheter. Den deterministiska kärnan sköter säkerheten — AI-lagret optimerar trösklar baserat på din fastighets förutsättningar. Här får du en översikt över systemet; för fullständig teknisk manual, kontakta JL Styr AB.
Hårdvaruinstallation
Katapult fungerar smidigast med Shelly-enheter men fungerar också med andra fabrikat. Nya enheter dyker upp automatiskt i systemet som “nyupptäckta” efter att AI:n skannat av nätverket — operatören/användaren godkänner och väljer/skapar zon. Om man vill styra sin värmepump med hjälp av SG Ready krävs en Shelly UNI Plus (ca 300 kr) eller Modbus-koppling. Du behöver även en elmätare med HAN-port (alla nya mätare har detta) samt en dongle för ca 600 kr som kan leverera mätvärden till Katapult — se HanLink. Man kan även lägga till andra Shelly-enheter på t.ex. luft/luftvärmepump och koppla dem till SG Ready-styrning. Även LoRaWAN-sensorer kan användas (främst för större fastighetsägare) — fästs med dubbelhäftande tejp och kommunicerar trådlöst via gateway till Katapult. Du kan t.ex. lägga till rumsgivare i flerbostadshus och sedan läsa av Katapult via Modbus TCP till ditt befintliga styrsystem.
LoRaWAN Gateway
En LoRaWAN-gateway kan placeras centralt i fastigheten, oftast i teknikrummet. Gatewayen ansluts till internet via Ethernet eller 4G och kommunicerar över krypterat MQTT. Räckvidd: 100–300 meter i byggnad. ChirpStack används som LoRaWAN-nätserver — fullt kompatibel med industristandard.
SG Ready – tre lägen
SG Ready är standarden för att kommunicera med värmepumpar. Katapult använder tre lägen: BLOCK (VP av under dyra timmar — det är här besparingen sker), BOOST (ladda på när elen är billig), NORMAL (standardläge). BLOCK-timmarna ger den ekonomiska effekten; BOOST är sekundärt eftersom värmepumpen reglerar sin egen effekt autonomt. Säkerhetslager som frost, inomhustemp och legionella trumpfar alltid prisbeslutet.
Styrning mot Nord Pool — deterministiskt + AI
Varje timme hämtas aktuellt elpris från Nord Pool (SE4). Systemet beräknar var timmen hamnar i prisfördelningen (percentil) och väljer BLOCK/NORMAL/BOOST baserat på konfigurerade trösklar (block_above, boost_below). Standardintervall: 60 minuter. AI-agenten "Lill-Bert" kör djupoptimering två gånger per dygn och justerar trösklarna baserat på din fastighets mönster — men fattar aldrig styrkommandot direkt. Den deterministiska kärnan — som körs på Opta-PLC:er — behåller alltid kontrollen över säkerheten.
Soloptimering med tvånivå-hysteres
Har du solceller? Katapult läser effektmätaren och schemalägger lasten till solens toppproduktion. Logiken använder tvånivå-hysteres: nivå 1 (NORMAL) vid export >1000 W, nivå 2 (BOOST) efter 15 min i nivå 1 om exporten >1500 W. Dessa trösklar kan justeras fritt.SMHI:s molnprognos används för att förutsäga nästa dags solproduktion. Systemet maximerar egenanvändning — varje egenanvänd kWh sparar spotpris + nätavgift, ofta 1–2 kr/kWh totalt.
Termisk modell — huset lär sig själv
Under de första 2 veckorna bygger Katapult en termisk modell av din fastighet: sink_rate (hur snabbt temperaturen sjunker utan uppvärmning) och thermal_mass (hur trög byggnaden är att värma). Modellen kalibreras automatiskt och används för att avgöra hur långa BLOCK-perioder fastigheten tål utan komfortförlust. Lill-Bert granskar temperaturkurvor och filtrerar bort störningar (soluppvärmning, duschspik, buffertlag).
Larmhantering på naturligt språk
Säg till AI-assistenten "Maila mig om framledningstempen sjunker under 40°" så programmeras larmet i Opta-PLC:n direkt. Röstlarm via högtalare stöds. Larmregler kan läggas till, ändras och tas bort via chatt — ingen programmering krävs.
Modbus TCP, Home Assistant och MQTT
Katapult exponerar automatiskt alla datapunkter som Modbus-register. Inga manuella mappningar — listan uppdateras när nya enheter läggs till. Home Assistant stöds via custom_components med REST/JWT-polling, publicerar SG Ready-läge, pristier och Lill-Bert-status. Generiska MQTT-enheter (Zigbee, Tasmota, ESPHome, elmätare) läggs till genom MQTT-skanning där LLM analyserar payloaden automatiskt.
Dashboard och transparens
Dashboarden visar realtidsdata för alla sensorer, aktuellt Nord Pool-pris, aktivt SG-läge och ackumulerad besparing. Klicka på "Varför BLOCK?" för att se prispercentil, aktiva trösklar och vilka säkerhetslager som triggar. Lill-Berts optimering visar senaste körning med reasoning i klartext — inga svarta lådor. Live-demo: demo.katapultnrg.se.
Driftkort — realtidssynoptik i webbläsaren
Driftkorten är Katapults SCADA-lager: levande synoptikbilder med rör, pumpar, ventiler, givare och larm som renderas direkt i webbläsaren, drivna av plattformens live-data över WebSocket och REST. När scada-tjänsten är igång dyker fliken "Driftkort" upp automatiskt i plattformen. Ett driftkort är ren data — en JSON-scen plus en bakgrunds-SVG — så ett nytt projekt betyder en ny scen, inte ny kod. Byggläget öppnas direkt i webbläsaren: teknikern drar symboler på plats, binder dem mot tag-katalogen (alla enheter och mätvärden i anläggningen) och sparar utan omstart eller ombyggnad. AI:n kan dessutom generera scengrunden maskinellt, till exempel från ett fotograferat pappersdriftkort. Kvalitetsprincipen är strikt: en givare med osäker eller gammal data visas grå med "--" och flödesanimeringen stoppas — driftkortet gissar aldrig. Varje kund är tenant-isolerad med JWT. Driftkorten är ren realtidsmimik; trender och historik ligger i historikvyn.
Historik och datalagring
Mätdata lagras i tre lager automatiskt: rådata (10 s upplösning, 60 dagar), timmedel (1 år), dygnsmitt (10 år). Chunks äldre än 7 dagar komprimeras automatiskt (~90 % storleksminskning utan dataförlust). Historikgrafen väljer rätt lager baserat på tidsfönstret — ingen konfiguration krävs.
Vanliga frågor
Varför är vi på BLOCK just nu? — Elpriset är högt jämfört med resten av dagen. Öppna "Senaste agent-körning" för exakt motivering. Varför är vi på BOOST trots att det inte verkar billigt? — Kan bero på legionellaskydd (var 72:a timme), frostskydd eller att inomhustemperaturen ligger för lågt. Kräver systemet internet? — Ja, för prisdata — men fungerar i degraderat läge vid tillfälliga avbrott.