Română

Comunitate Beta · neverificat Energie și contorizare

SpotLogic – battery optimisation over the spot market (HTTP API)

SpotLogic este un serviciu cloud care planifică, după prețurile spot, când bateria fotovoltaică se încarcă, alimentează casa sau vinde în rețea. Șablonul citește prin HTTPS comanda intervalului curent (0–7), starea de încărcare țintă, comanda următoare și vârsta planului și încarcă telemetria bateriei la 2 minute. Seriile de producție solară, consum și prețuri le furnizează instalatorul; invertorul este comandat prin smart rules proprii.

SpotLogicPacket Parser → HTTP6 dispozitiveRevizia 1.1 Ultima actualizare: 10 noiembrie 2026

Trimis de Adam Pelikán

Import în aplicația TapHomeHardware › Packet Parser › Adăugați din șablon

Descărcați șablon

Pe această pagină

Ghid de integrare

SpotLogic este un serviciu cloud care calculează un plan de încărcare și descărcare pentru bateria unui sistem fotovoltaic pe baza pieței spot de energie electrică. Este un serviciu de calcul, nu o sursă de date: unitatea de control trimite telemetria bateriei împreună cu predicția producției solare, predicția consumului casei și prețurile de import și de export, iar SpotLogic răspunde cu comanda pentru intervalul de timp curent. Acest șablon conectează TapHome la API-ul SpotLogic prin HTTPS (spotlogic.cz, portul 443) cu un modul Packet Parser HTTP. Șablonul citește comanda și încarcă telemetria; nu controlează invertorul solar — comanda se leagă de invertor prin smart rules proprii ale instalatorului.

Nu este nimic de cablat. Punerea în funcțiune a serviciului înseamnă activarea SpotLogic pentru amplasament, colectarea parametrilor bateriei și ai rețelei, asigurarea accesului la internet de ieșire pentru unitatea de control și pregătirea seriilor de predicție și de prețuri.

SpotLogic are nevoie de seriile de predicție și de prețuri la fiecare încărcare a telemetriei (producția solară și consumul casei pentru azi și mâine, prețurile de import și de export). Acest șablon nu le poate completa singur — consultați Serii de predicție și de prețuri. Până când nu sunt completate, SpotLogic respinge telemetria cu HTTP 422, nu calculează niciun plan, iar comanda rămâne la No plan.

Configurare

1. Activarea SpotLogic și păstrarea datelor de acces

SpotLogic trimite prin e-mail PLC ID și tokenul de acces (access token) la activarea dispozitivului. Tokenul este secret, legat de exact un PLC ID și valabil pe durata abonamentului. Ambele se transmit numai în șirul de interogare (query string) al fiecărei cereri (?plc_id=…&token=…), așa cum cere contractul SpotLogic — niciodată în corpul cererii.

Nu puneți tokenul în documente partajate și în depozite publice de cod. O pereche greșită de PLC ID și token, un token invalid sau un abonament expirat se termină toate cu HTTP 401, iar SpotLogic nu spune intenționat care dintre cele trei a fost cauza.

2. Colectarea parametrilor bateriei și ai rețelei

SpotLogic planifică numai cu valorile pe care le primește în telemetrie. Înainte de import, căutați-le în documentația invertorului solar și a bateriei și în contractul de racordare la rețea:

Valoare	Sursa	Unitate
Capacitatea bateriei	fișa tehnică a bateriei; trebuie să fie mai mare decât 0	kWh
Puterea maximă a bateriei	o singură valoare pentru încărcare și descărcare	kW
Puterea maximă de import din rețea	dimensiunea întrerupătorului general; `0` înseamnă că amplasamentul nu importă niciodată	kW
Puterea maximă de export în rețea	limita de export a racordului la rețea; `0` înseamnă că amplasamentul nu exportă niciodată	kW
Limita minimă absolută a bateriei	cea mai mică stare de încărcare permisă de producătorul invertorului, implicit 10	%
Rezerva bateriei	rezerva din care planul nu vinde niciodată în rețea (de exemplu pentru consum imprevizibil), implicit 10	%

Starea de încărcare curentă a bateriei trebuie să fie de asemenea disponibilă în TapHome, de obicei din integrarea proprie a invertorului, astfel încât un smart rule să o poată scrie în acest șablon (consultați mai jos Încărcarea telemetriei).

3. Rețeaua și ceasul unității de control

Unitatea de control are nevoie de acces la internet de ieșire prin HTTPS către spotlogic.cz pe portul 443. SpotLogic nu se conectează înapoi la unitatea de control — seriile de predicție și de prețuri se transmit în corpul încărcării telemetriei, deci nu trebuie deschis niciun port de intrare.
Telemetria conține momentul trimiterii după ceasul unității de control, iar SpotLogic construiește din el fereastra planului. Câteva minute de abatere nu contează; ore de abatere mută întregul plan pe intervale greșite. Mențineți ceasul unității de control corect.
Fusul orar (nume IANA, de exemplu Europe/Prague) decide unde se termină „azi” și unde începe „mâine”. Introduceți fusul orar al amplasamentului.

4. Parametrii de import

Șablonul se importă în interfața Packet Parser din aplicația TapHome, iar la import se completează următorii parametri:

Parametru	Semnificație	Unitate
PLC ID, access token	din e-mailul de activare	—
Time zone	nume IANA, implicit `Europe/Prague`; din el rezultă limitele zilelor planului	—
Battery capacity	trebuie să fie mai mare decât 0	kWh
Battery max power	o singură valoare pentru încărcare și descărcare	kW
Max grid import / export power	`0` înseamnă că amplasamentul nu importă / nu exportă niciodată	kW
Max state of charge	doar înregistrată de SpotLogic, planificatorul actual nu o aplică	%
Hard battery floor	limita minimă de la producătorul invertorului, implicit 10	%

Numerele se scriu cu punct zecimal (virgula se convertește). PLC ID și tokenul se stochează în variabilele modulului PlcId și Token. Toate valorile rămân ulterior editabile ca variabile ale modulului.

5. Verificarea datelor de acces

Documentația interactivă a API-ului SpotLogic (pe spotlogic.cz, la /docs) are un dialog Authorize pentru PLC ID și token, iar exemplul de telemetrie TapHome din ea este complet: cu date de acces valide, SpotLogic îl acceptă cu HTTP 202. Actualizați mai întâi momentul trimiterii (TimeStampUnix) la ora curentă. Datele de exemplu acceptate sunt reținute pentru plan la fel ca telemetria reală, de aceea această verificare se face înainte ca comanda să fie legată de invertor.

Un răspuns HTTP 422 despre un orizont de predicție incomplet dovedește și el că PLC ID și tokenul sunt corecte — un token greșit dă HTTP 401.

Funcțiile dispozitivului

Citirea comenzii (la fiecare 20 s)

Modulul interoghează GET /api/v1/dispatch la fiecare 20 de secunde, iar dispozitivele procesează răspunsul:

SpotLogic command — comanda pentru intervalul în curs (action_id):

Valoare	Valoare TapHome	Nume SpotLogic	Semnificație
0	No plan	`no_plan`	Niciun plan utilizabil — mențineți invertorul în propriul mod sigur
1	Self-use	`self_use`	Autoconsum: încărcare din surplusul fotovoltaic, descărcare pentru alimentarea casei
2	Force charge	`force_charge`	Încărcarea bateriei la putere maximă
3	Force discharge to grid	`force_discharge`	Descărcarea bateriei în rețea la putere maximă
4	Self-use, no discharging	`self_use_ChargeOnly`	Autoconsum, încărcarea permisă, descărcarea interzisă
5	Self-use, no charging	`self_use_DischargeOnly`	Autoconsum, descărcarea permisă, încărcarea interzisă
6	Stop PV (reserved)	`stopPV`	Rezervat — nu este emis de planificatorul actual
7	Grid charge without PV (reserved)	`ChargeMaxNoPV`	Rezervat — nu este emis de planificatorul actual

Atributele de service afișează numele comenzii și momentul în care se termină comanda (ora locală).

SpotLogic target state of charge — starea de încărcare (%) pe care planul o așteaptă la sfârșitul intervalului. Opriți încărcarea sau descărcarea forțată când bateria o atinge; la autoconsum nu încărcați peste ea. SpotLogic adaugă că la self_use_DischargeOnly bateria nu trebuie descărcată sub ea. Valoarea este un rezultat al planului, nu o valoare de referință care trebuie impusă, și poate fi temporar mai mică decât rezerva bateriei după ce casa a consumat rezerva.
SpotLogic next command — comanda intervalului următor, cu momentul de început ca atribut de service.
SpotLogic plan age — vârsta planului servit, în secunde. Poate comanda un smart rule de rezervă: când crește mult peste intervalul de recalculare, planul nu se mai recalculează.

Răspunsul HTTP 404 no_plan nu este o eroare: comanda este 0, iar dispozitivul afișează un mesaj informativ. În această stare, SpotLogic cere trecerea invertorului în propriul mod sigur și niciodată repetarea din memorie a ultimei comenzi cunoscute. HTTP 401 (PLC ID sau token greșit, abonament expirat) setează o eroare pe dispozitive și pe modul; SpotLogic cere ca astfel de apeluri să nu fie repetate, deci corectați datele de acces.

Încărcarea telemetriei (aproximativ la fiecare 2 minute)

Modulul trimite POST /api/v1/optimize cu PLCtype: "taphome" cel mult o dată la 2 minute. Trimite momentul trimiterii, fusul orar, parametrii bateriei și ai rețelei și două valori de la dispozitive:

Battery state of charge (input) — scrieți cu un smart rule starea de încărcare curentă 0–100 % din invertor (când șablonul invertorului dă 0–1, înmulțiți cu 100). Valoarea se rotunjește la procent întreg, deoarece SpotLogic respinge valorile fracționare. Până când nu are o valoare, nu se trimite nimic, iar modulul afișează un avertisment.
Battery reserve for SpotLogic — rezerva SOCmin, implicit 10 %: nivelul din care planul nu vinde niciodată în rețea.

Atributele de service ale modulului afișează rezultatul ultimei încărcări, intervalul de recalculare raportat de SpotLogic (implicit 900 s), momentul calculării planului, rularea planului și versiunea API. O încărcare respinsă (HTTP 422) este o eroare a modulului, cu mesajul returnat de SpotLogic. Răspunsul la încărcare nu conține niciodată planul — SpotLogic îl calculează în fundal, iar modulul îl preia la următoarea citire a comenzii.

Serii de predicție și de prețuri

SpotLogic așteaptă în corpul cererii șase serii, fiecare ca perechi [unix_ts, value]:

Variabila modulului	Conținut	Contract
`PvForecastTod`, `PvForecastTom`	producția solară azi / mâine, kWh pe oră	orar, fără goluri, de la ora curentă până la sfârșitul zilei de mâine
`LoadForecastTod`, `LoadForecastTom`	consumul casei azi / mâine, kWh pe oră	la fel
`PriceImp`, `PriceExp`	prețul de import / export, CZK/kWh	pas constant (orar sau 15 minute), ziua de azi este suficientă, prețurile negative sunt permise

Variabilele păstrează seriile ca text JSON, de exemplu [[1788645600,0.0],[1788649200,0.42]], și sunt inserate nemodificate în corpul cererii; valoarea implicită [] este o serie goală. Integrarea în sine funcționează; ceea ce îi trebuie sunt datele. TapHome nu poate încă partaja un text JSON între scripturi, iar un script de smart rule nu poate trimite cereri HTTP. De aceea cele șase serii — în total aproximativ 500 de valori — trebuie colectate din alte scripturi (de exemplu dintr-un șablon de predicție sau de prețuri spot) și transmise acestui modul prin sute de dispozitive auxiliare sau construite chiar în scriptul de citire al modulului. Integrarea devine cu adevărat practică atunci când TapHome va adăuga o variabilă text partajată între scripturi — consultați ideea Variabilă text și HTTP din scripturile smart rules. Până atunci, completați cele șase variabile, iar șablonul funcționează așa cum este. Scriptul explică acest lucru într-un comentariu în partea de sus și în locul în care se inserează seriile.

Proveniența datelor este la latitudinea instalatorului; SpotLogic numește aceste surse tipice:

Producția solară — un serviciu de predicție a producției solare, alimentat cu locația, orientarea și înclinarea panourilor și puterea instalată, sau cloudul producătorului invertorului.
Consumul casei — istoricul propriu al amplasamentului: pentru început este suficient consumul orar mediat pe ora din zi și pe tipul zilei (zi lucrătoare, weekend, sărbătoare).
Prețurile — prețul spot recalculat conform contractului de furnizare (import, de exemplu spot plus o marjă) și conform contractului de vânzare a surplusului de energie (export).

O zi cu trecere la ora de vară sau de iarnă are 23 sau 25 de ore, deci o serie completă de producție solară sau de consum are 47, 48 sau 49 de valori. Eșantioanele mai vechi de o oră înainte de ora curentă sunt eliminate, la fel ca eșantioanele de după sfârșitul zilei de mâine; o serie care se termină înainte de sfârșitul zilei de mâine este respinsă.

Rezolvarea problemelor

Simptom	Cauză și soluție
Comanda rămâne la No plan	Încă nu s-a calculat niciun plan sau telemetria este respinsă. Verificați eroarea modulului și atributul de service Last telemetry upload. Nici planul mai vechi de 60 de minute nu este servit. După prima încărcare acceptată, planul poate dura o vreme — cel puțin un interval de recalculare.
Eroare a modulului HTTP 422	Telemetria încalcă contractul de date SpotLogic; mesajul spune care parte. Cel mai des lipsesc seriile de predicție sau de prețuri ori nu acoperă perioada până la sfârșitul zilei de mâine.
Eroare HTTP 401	PLC ID și tokenul nu se potrivesc sau abonamentul a expirat. Corectați variabilele modulului `PlcId` și `Token`.
Avertismentul „Telemetry not sent”	Starea de încărcare nu a fost încă scrisă sau un parametru al bateriei ori al rețelei este gol.
Vârsta planului crește continuu	Telemetria nouă nu ajunge la SpotLogic sau sursele sale de date au căderi; ultimul plan valid rămâne în vigoare până la vârsta de 60 de minute.
Eroare HTTP 500 sau 502	Eroare de server sau sursă de date defectă pe partea SpotLogic; ultimul plan valid rămâne în vigoare. SpotLogic recomandă repetarea ambelor cereri cu întârzieri crescătoare; modulul repetă pur și simplu ambele cereri la următoarea interogare.
Planul comandă orele greșite	Ceasul unității de control sau fusul orar este greșit — fereastra planului se construiește din momentul trimiterii și din fusul orar declarat.

Dispozitive disponibile 6

Aceste dispozitive apar în TapHome după import.

SpotLogic Modul

Atribute de service

Last telemetry upload

Plan recompute interval

Plan computed at

Plan run

API version

Variabile personalizate

PlcId (string)

Token (string)

TimeZone (string)

BatCapacity (string)

BatPmax (string)

GridImportPmax (string)

GridExportPmax (string)

SocMax (string)

SocHardMin (string)

SocNow (numeric) = -1

SocMin (numeric) = 10

PvForecastTod (string) = []

PvForecastTom (string) = []

LoadForecastTod (string) = []

LoadForecastTom (string) = []

PriceImp (string) = []

PriceExp (string) = []

DispatchJson (string)

DispatchCode (numeric)

OptimizeJson (string)

OptimizeCode (numeric)

OptimizeAt (string)

LastOptimizeUnix (numeric)

SpotLogic

Citire (modul)

# =============================================================================
#  STATUS: WORKING, BUT THE DATA MUST BE BROUGHT IN BY HAND
# =============================================================================
#  The integration itself works - dispatch reading, action_id -> inverter mode
#  mapping, next command, plan diagnostics and error reporting are finished.
#  What it needs is the data: six series (PV forecast, load forecast, import and
#  export spot price; ~500 values, hourly or 15-minute, horizon now -> end of
#  tomorrow) as JSON text [[unix_ts, value], ...] in the module variables
#  PvForecastTod ... PriceExp (see below).
#  Until TapHome ships a shared variable between scripts, those series must be
#  collected from other scripts and handed over through hundreds of helper
#  devices - that is why the integration is only really practical once that
#  feature lands.
#  Tracking: https://taphome.com/cs/ideas/script-data-http/  (TapHome idea FR-003)
#  In the meantime: fill the six variables below and the template works as is.
# =============================================================================

# 1) GET /api/v1/dispatch - the command for the slot in progress (module poll ~20 s).
#    plc_id and token travel ONLY in the query string (SpotLogic contract).
VAR r := SENDHTTPREQUEST("/api/v1/dispatch?plc_id=" + PlcId + "&token=" + Token);
DispatchCode := r.StatusCode;
DispatchJson := r.Content;
IF r.StatusCode = 401
    ADDERROR(1, "SpotLogic rejected the PLC ID or the token (HTTP 401) - check the module variables PlcId and Token; the subscription may have expired. Not retried by SpotLogic rules, fix the credentials.");
ELSEIF r.StatusCode != 200 AND r.StatusCode != 404
    VAR dmsg := PARSEJSON(r.Content, "$.message", true);
    ADDERROR(2, "SpotLogic dispatch failed: HTTP " + r.StatusCode + IF(ISNULL(dmsg), "", " " + dmsg));
END

# 2) POST /api/v1/optimize - telemetry, at most every ~2 min (SpotLogic asks for no more often).
datetime now := NOW();
VAR nowUnix := now.UNIXTIME;
IF nowUnix - LastOptimizeUnix >= 115
    LastOptimizeUnix := nowUnix;
    VAR cap := TODOUBLE(REPLACE(BatCapacity, ",", "."));
    VAR bp := TODOUBLE(REPLACE(BatPmax, ",", "."));
    VAR gi := TODOUBLE(REPLACE(GridImportPmax, ",", "."));
    VAR ge := TODOUBLE(REPLACE(GridExportPmax, ",", "."));
    VAR smax := TODOUBLE(SocMax);
    VAR shard := TODOUBLE(SocHardMin);
    IF SocNow < 0 OR SocNow > 100
        OptimizeCode := -1;
    ELSEIF ISNAN(cap) OR ISNAN(bp) OR ISNAN(gi) OR ISNAN(ge) OR ISNAN(smax) OR ISNAN(shard) OR LENGTH(PlcId) = 0 OR LENGTH(Token) = 0
        OptimizeCode := -2;
    ELSE
        # Forecast and price series: module variables PvForecastTod, PvForecastTom,
        # LoadForecastTod, LoadForecastTom, PriceImp, PriceExp hold JSON text
        # [[unix_ts, value], ...]. The template does NOT fill them - see the banner
        # at the top of this script. Until they are filled, SpotLogic answers 422.
        VAR body := "{\"PLCtype\":\"taphome\"";
        body := body + ",\"TimeZone\":\"" + TimeZone + "\"";
        body := body + ",\"TimeStampUnix\":" + TOSTRING(nowUnix, "F0");
        body := body + ",\"BatCapacity\":" + TOSTRING(cap, "F2");
        body := body + ",\"BatPmax\":" + TOSTRING(bp, "F2");
        body := body + ",\"GridImportPmax\":" + TOSTRING(gi, "F2");
        body := body + ",\"GridExportPmax\":" + TOSTRING(ge, "F2");
        body := body + ",\"SOCnow\":" + TOSTRING(SocNow, "F0");
        body := body + ",\"SOCmin\":" + TOSTRING(SocMin, "F0");
        body := body + ",\"SOCmax\":" + TOSTRING(smax, "F0");
        body := body + ",\"SOChardmin\":" + TOSTRING(shard, "F0");
        body := body + ",\"PvForecastTod\":" + PvForecastTod;
        body := body + ",\"PvForecastTom\":" + PvForecastTom;
        body := body + ",\"LoadForecastTod\":" + LoadForecastTod;
        body := body + ",\"LoadForecastTom\":" + LoadForecastTom;
        body := body + ",\"PriceImp\":" + PriceImp;
        body := body + ",\"PriceExp\":" + PriceExp + "}";
        VAR o := SENDHTTPREQUEST("/api/v1/optimize?plc_id=" + PlcId + "&token=" + Token, "POST", body, "Content-Type: application/json");
        OptimizeCode := o.StatusCode;
        OptimizeJson := o.Content;
        OptimizeAt := TOSTRING(now, "yyyy-MM-dd HH:mm:ss");
    END
END

# The outcome of the last telemetry upload is reported on every run, not only on the upload run.
VAR omsg := "";
IF LENGTH(OptimizeJson) > 0
    omsg := PARSEJSON(OptimizeJson, "$.message", true);
    IF ISNULL(omsg)
        omsg := "";
    END
END
IF OptimizeCode = -1
    ADDWARNING(3, "Telemetry not sent: the device Battery state of charge (input) has no value 0-100 yet - write it from the inverter with a smart rule.");
ELSEIF OptimizeCode = -2
    ADDWARNING(7, "Telemetry not sent: fill the module variables PlcId, Token, BatCapacity, BatPmax, GridImportPmax, GridExportPmax, SocMax and SocHardMin (numbers with a decimal point).");
ELSEIF OptimizeCode = 401
    ADDERROR(4, "SpotLogic rejected the telemetry: PLC ID or token invalid (HTTP 401).");
ELSEIF OptimizeCode = 422
    ADDERROR(5, "SpotLogic rejected the telemetry (HTTP 422): " + omsg + " - the forecast and price series (module variables PvForecastTod ... PriceExp) must be filled, see the template description.");
ELSEIF OptimizeCode != 0 AND OptimizeCode != 202
    ADDERROR(6, "SpotLogic telemetry upload failed: HTTP " + OptimizeCode + " " + omsg);
END

Atribute de service

Last telemetry upload

IF(OptimizeCode = 0, "not sent yet", IF(OptimizeCode < 0, "waiting for inputs", "HTTP " + OptimizeCode + " at " + OptimizeAt))

Plan recompute interval

VAR v := PARSEJSON(OptimizeJson, "$.data.recompute_interval_sec", true);
IF ISNULL(v)
    RETURN("-");
END
RETURN(TOSTRING(v, "F0") + " s");

Plan computed at

VAR s := PARSEJSON(DispatchJson, "$.meta.plan_created_at", true);
IF ISNULL(s)
    RETURN("-");
END
datetime t := DATETIME(s);
VAR l := t.LOCALDATETIME;
RETURN(TOSTRING(l, "yyyy-MM-dd HH:mm"));

Plan run

VAR v := PARSEJSON(DispatchJson, "$.meta.run_id", true);
RETURN(IF(ISNULL(v), "-", v));

API version

VAR v := PARSEJSON(DispatchJson, "$.meta.version.api", true);
RETURN(IF(ISNULL(v), "-", v));

SpotLogic command Comutator cu mai multe valori

Valori / Stări: No plan · Self-use · Force charge · Force discharge to grid · Self-use, no discharging · Self-use, no charging · Stop PV (reserved) · Grid charge without PV (reserved)

SpotLogic command

Citirea stării comutatorului

IF DispatchCode = 0
    RETURN(NaN);
END
IF DispatchCode = 401
    ADDERROR(1, "SpotLogic rejected the PLC ID or the token (HTTP 401) - check the module variables PlcId and Token.");
    RETURN(NaN);
END
IF DispatchCode = 404
    ADDINFO(2, "No usable plan yet (no_plan) - keep the inverter in its own safe mode.");
    RETURN(0);
END
IF DispatchCode != 200
    ADDERROR(3, "Command not available: HTTP " + DispatchCode);
    RETURN(NaN);
END
VAR id := PARSEJSON(DispatchJson, "$.data.command.action_id", true);
IF ISNULL(id)
    ADDERROR(4, "Unexpected SpotLogic answer: data.command.action_id is missing.");
    RETURN(NaN);
END
RETURN(id);

Atribute de service

Command name

VAR v := PARSEJSON(DispatchJson, "$.data.command.action_name", true);
IF ISNULL(v)
    v := PARSEJSON(DispatchJson, "$.data.action_name", true);
END
RETURN(IF(ISNULL(v), "-", v));

Command valid until

VAR s := PARSEJSON(DispatchJson, "$.data.command.valid_until", true);
IF ISNULL(s)
    RETURN("-");
END
datetime t := DATETIME(s);
VAR l := t.LOCALDATETIME;
RETURN(TOSTRING(l, "yyyy-MM-dd HH:mm"));

SpotLogic target state of charge Variabilă

SpotLogic target state of charge

Citire

IF DispatchCode = 0
    RETURN(NaN);
END
IF DispatchCode = 401
    ADDERROR(1, "SpotLogic rejected the PLC ID or the token (HTTP 401) - check the module variables PlcId and Token.");
    RETURN(NaN);
END
IF DispatchCode != 200
    RETURN(NaN);
END
VAR v := PARSEJSON(DispatchJson, "$.data.command.target_soc_percent", true);
IF ISNULL(v)
    RETURN(NaN);
END
RETURN(v);

SpotLogic next command Comutator cu mai multe valori

Valori / Stări: No plan · Self-use · Force charge · Force discharge to grid · Self-use, no discharging · Self-use, no charging · Stop PV (reserved) · Grid charge without PV (reserved)

SpotLogic next command

Citirea stării comutatorului

IF DispatchCode = 0
    RETURN(NaN);
END
IF DispatchCode = 401
    ADDERROR(1, "SpotLogic rejected the PLC ID or the token (HTTP 401) - check the module variables PlcId and Token.");
    RETURN(NaN);
END
IF DispatchCode = 404
    RETURN(0);
END
IF DispatchCode != 200
    ADDERROR(3, "Next command not available: HTTP " + DispatchCode);
    RETURN(NaN);
END
VAR id := PARSEJSON(DispatchJson, "$.data.context.next_action_id", true);
IF ISNULL(id)
    RETURN(NaN);
END
RETURN(id);

Atribute de service

Next command name

VAR v := PARSEJSON(DispatchJson, "$.data.context.next_action_name", true);
RETURN(IF(ISNULL(v), "-", v));

Next command starts

VAR s := PARSEJSON(DispatchJson, "$.data.context.next_action_time", true);
IF ISNULL(s)
    RETURN("-");
END
datetime t := DATETIME(s);
VAR l := t.LOCALDATETIME;
RETURN(TOSTRING(l, "yyyy-MM-dd HH:mm"));

SpotLogic plan age Variabilă

SpotLogic plan age

Citire

IF DispatchCode = 0
    RETURN(NaN);
END
IF DispatchCode = 401
    ADDERROR(1, "SpotLogic rejected the PLC ID or the token (HTTP 401) - check the module variables PlcId and Token.");
    RETURN(NaN);
END
IF DispatchCode != 200
    RETURN(NaN);
END
VAR v := PARSEJSON(DispatchJson, "$.meta.plan_age_sec", true);
IF ISNULL(v)
    RETURN(NaN);
END
RETURN(v);

Battery state of charge (input) Variabilă

Battery reserve for SpotLogic Variabilă

Conexiune: Packet Parser → HTTP

Parametri de import

Introduceți aceste valori când importați XML-ul.

Solicitat în aplicație	Implicit
SpotLogic PLC ID (from the activation e-mail)	Se introduce la import
SpotLogic access token (from the activation e-mail, secret)	Se introduce la import
Time zone (IANA name)	`Europe/Prague`
Battery capacity [kWh]	Se introduce la import
Battery max charge and discharge power [kW]	Se introduce la import
Max grid import power [kW] (0 = never import)	Se introduce la import
Max grid export power [kW] (0 = never export)	Se introduce la import
Max state of charge [%] (recorded only)	`100`
Hard battery floor from the inverter manufacturer [%]	`10`

Ați găsit o problemă la acest șablon de dispozitiv?

Spuneți-ne ce nu funcționează, ce lipsește sau cum ar trebui să se comporte șablonul. Feedbackul dvs. ne ajută să păstrăm catalogul corect.

Șablon · portalul TapHome SpotLogic – battery optimisation over the spot market (HTTP API) Deschideți acest șablon în Customer Portal pentru a-l aplica într-una dintre locuințele dvs. sau pentru a propune o îmbunătățire și a o trimite înapoi în catalog. Packet Parser → HTTP Vezi în portalul TapHome

SpotLogic – battery optimisation over the spot market (HTTP API)

Ghid de integrare

Configurare

1. Activarea SpotLogic și păstrarea datelor de acces

2. Colectarea parametrilor bateriei și ai rețelei

3. Rețeaua și ceasul unității de control

4. Parametrii de import

5. Verificarea datelor de acces

Funcțiile dispozitivului

Citirea comenzii (la fiecare 20 s)

Încărcarea telemetriei (aproximativ la fiecare 2 minute)

Serii de predicție și de prețuri

Rezolvarea problemelor

Dispozitive disponibile 6

Parametri de import

Ați găsit o problemă la acest șablon de dispozitiv?

Raportați o problemă la acest dispozitiv

Lăsați-ne datele de contact și vă trimitem răspunsul

Continuați pe WhatsApp

Mesajul a sosit

Codul a expirat

Solicitarea este la suport

Căutăm testeri pentru noua versiune

Vă mulțumim, vă vom contacta în curând

Ghid de integrare

Configurare#

1. Activarea SpotLogic și păstrarea datelor de acces

2. Colectarea parametrilor bateriei și ai rețelei

3. Rețeaua și ceasul unității de control

4. Parametrii de import

5. Verificarea datelor de acces

Funcțiile dispozitivului#

Citirea comenzii (la fiecare 20 s)

Încărcarea telemetriei (aproximativ la fiecare 2 minute)

Serii de predicție și de prețuri

Rezolvarea problemelor#

Dispozitive disponibile 6

SpotLogic

SpotLogic command

SpotLogic target state of charge

SpotLogic next command

SpotLogic plan age

Battery state of charge (input)

Battery reserve for SpotLogic

Parametri de import

Documentație asociată

Ați găsit o problemă la acest șablon de dispozitiv?

Raportați o problemă la acest dispozitiv

Configurare

Funcțiile dispozitivului

Rezolvarea problemelor