Napojení na OCPP backend
Napojení stanice MyBox na vlastní nebo cizí OCPP backend — přepnutí režimu autorizace na OCPP, odemčení záložky Servis v aplikaci MyBox a parametry Backend URL, EVSE ID tag a Freevend ID tag.
Úvod
Stanice MyBox komunikují protokolem OCPP 1.6 JSON. Ve výchozím stavu je stanice napojená na MyBox Cloud. Pokud ji provozuje CPO na vlastním nebo cizím backendu, přesměruje se na jeho OCPP endpoint — backend pak řídí autorizaci, tarify i reporting.
Nastavení se dělá v mobilní aplikaci MyBox, stejně jako Modbus TCP — režim autorizace je v Nastavení stanice dostupný přímo, adresa backendu a identifikátor stanice jsou na záložce Servis, kterou je potřeba nejdřív odemknout servisním heslem.
Platí pro zařízení
- MyBox Home
- MyBox Plus
- MyBox Profi
- MyBox Post
Předpoklady
- Stanice je spárovaná v MyBox Cloudu a Online.
- Stanice má funkční datové připojení (LTE, LAN nebo WiFi).
- Máte adresu OCPP endpointu (Backend URL) a identifikátor stanice (EVSE ID tag) — obojí dodá provozovatel backendu (CPO).
- Stanice je na straně backendu založená pod stejným identifikátorem.
Parametry připojení
| Parametr | Hodnota |
|---|---|
| Protokol | OCPP 1.6 JSON (WebSocket) |
| Transport | wss:// (doporučeno) nebo ws:// |
| Kde se nastavuje | mobilní aplikace MyBox, Nastavení stanice › Servis › OCPP (režim autorizace na Stanice › Nastavení) |
| Po změně konfigurace | restart stanice |
Na veřejné síti použijte wss://
ws:// je nešifrovaný WebSocket — patří jen do laboratoře nebo do uzavřené
sítě. Přes internet posílá stanice po OCPP i autorizační tokeny (idTag), takže
na produkci vždy wss://.
Konfigurace přes mobilní aplikaci
Krok za krokem
-
Otevřete aplikaci MyBox a ve spodní navigaci zvolte Domů. Otevřete detail své stanice — ťukněte na její widget nebo kartu (stanice musí být ve stavu Online).
-
Otevřete Nastavení stanice — vpravo nahoře ťukněte na ozubené kolo (popisek „Nastavení“); stejně funguje ťuknutí na název stanice.
-
Přepněte režim autorizace na OCPP — na hlavní záložce Stanice, podzáložce Nastavení, v sekci Autorizace ťukněte na Režim autorizace a ve spodním listu Vyberte hodnotu zvolte jednu z OCPP možností. Servisní heslo k tomu není potřeba.
Režim Kdy ho zvolit OCPP O tom, kdo smí dobíjet, rozhoduje backend (zprávou Authorize) — zákazník se autorizuje kartou nebo v aplikaciOCPP Freevendor Dobíjení se spustí bez autorizace zákazníka; stanice použije Freevend ID tag, aby měl backend transakci k čemu přiřadit
Volby OCPP a OCPP Freevendor zapínají OCPP na stanici, ostatní režimy ho vypínají. Stejné nastavení najdete také na Servis › Možnosti. Ostatní režimy (Lokální seznam RFID, Cloud MQTT, Zamknutí / odemknutí) popisuje Nastavení čtečky (RFID autorizace).
-
Odemkněte záložku Servis — na hlavní záložce Stanice otevřete podzáložku Systém, sjeďte úplně dolů k poli Servisní heslo, zadejte heslo
myboxa potvrďte (tlačítkem ✓ nebo „Hotovo“ na klávesnici). Při překlepu se pod polem zobrazí „Nesprávné heslo“.
Po odemčení se místo pole objeví řádek Servisní režim aktivní a mezi hlavními záložkami přibude Servis. Odemčení platí jen pro tuto stanici, dokud obrazovku Nastavení stanice nezavřete.
-
Přejděte na Servis › OCPP — hlavní záložka Servis, podzáložka OCPP.
-
Nastavte parametry — ťuknutím na řádek vyplňte Backend URL a EVSE ID tag, podle potřeby také Freevend ID tag (hodnotu vždy potvrďte tlačítkem Uložit), viz tabulka níže.
-
Restartujte stanici — na Stanice › Systém ťukněte na červený řádek Restartovat a v dialogu „Opravdu pokračovat?“ zvolte Potvrdit.
Restart po změně konfigurace
Po změně Backend URL, EVSE ID tag nebo Režimu autorizace je nutný restart stanice. Aplikace po uložení restart sama nenabízí ani nehlásí, že na něj stanice čeká. Bez restartu se spojení nenaváže.
Parametry na záložce Servis › OCPP
| Položka | Co znamená |
|---|---|
| OCPP povoleno | Zda je OCPP komunikace na stanici povolená — Povoleno / Nepovoleno. Jen zobrazení, hodnotu určuje Režim autorizace. |
| Stav OCPP | Stav spojení s backendem — Připojeno / Odpojeno. Jen zobrazení. |
| EVSE ID tag | Identifikátor, pod kterým stanici zná backend (v OCPP identita nabíjecí stanice, ChargeBox ID). Ve výchozím stavu prázdné. |
| Backend URL | Adresa OCPP endpointu, na který se stanice připojuje. Ve výchozím stavu prázdná. |
| Freevend ID tag | idTag, kterým stanice spustí dobíjení bez autorizace uživatelem |
„OCPP povoleno“ ještě neznamená, že je stanice s backendem spojená — to ukazuje až Stav OCPP.
Backend URL
Adresa má tvar wss://<host>/<cesta> — zadejte ji bez identifikátoru
stanice, například wss://backend.example.com/ocpp. Identifikátor stanice se
zadává zvlášť do pole EVSE ID tag a stanice jej při připojení doplní za
adresu (jako poslední segment cesty). Dodá-li provozovatel backendu celou adresu
včetně identifikátoru, oddělte poslední segment do pole EVSE ID tag.
EVSE ID tag
Identifikátor stanice na backendu musí přesně odpovídat tomu, pod kterým je stanice na backendu založená. Když se liší, backend stanici odmítne nebo ji nespáruje s žádnou lokalitou. Nezaměňujte ho s polem Freevend ID tag, které patří k režimu OCPP Freevendor.
Freevend ID tag
Uplatní se, když je Režim autorizace nastavený na OCPP Freevendor —
tedy dobíjení bez autorizace zákazníka. Stanice pak transakci zahájí sama
a backendu pošle tenhle idTag, aby měl relaci k čemu přiřadit. Výchozí hodnota
je 00FFFFFFFF.
V režimu OCPP (autorizace kartou nebo aplikací) se Freevend nepoužije a hodnota zůstává beze změny.
Ověření
Po restartu zkontrolujte na Servis › OCPP:
- OCPP povoleno →
Povoleno - Stav OCPP →
Připojeno
Na straně backendu se stanice ohlásí zprávou BootNotification a dál posílá
Heartbeat. Pokud backend obojí vidí, spojení je v pořádku.
Nejčastější problémy
Stav OCPP zůstává Odpojeno
- Restartovali jste stanici po změně konfigurace? Bez restartu se spojení nenaváže.
- Ověřte Backend URL — překlep v hostu nebo v cestě, chybějící
/na konci,ws://místowss://— a EVSE ID tag, který musí přesně odpovídat identifikátoru na backendu. - Ověřte, že je Režim autorizace nastavený na OCPP nebo OCPP
Freevendor (řádek OCPP povoleno musí ukazovat
Povoleno). - Ověřte, že má stanice datové připojení — na záložce Servis řádky Stav Wi-Fi (záložka Wi-Fi) nebo Stav LAN (záložka LAN), případně Signál Wi-Fi na Stanice › Systém, případně stav LTE modemu.
- Ověřte, že backend pouští spojení z IP adresy stanice (firewall, whitelist na straně CPO).
Stanice se připojí, ale backend ji nezná
Identifikátor v poli EVSE ID tag se neshoduje s tím, pod kterým je stanice na backendu založená. Zkontrolujte hodnotu v tomto poli a že není zároveň zapsaná v Backend URL.
Dobíjení nejde spustit kartou
Autorizaci po přepnutí na OCPP řeší backend. Karta musí být v jeho whitelistu — tagy z MyBox Cloudu se na cizí backend nepřenášejí.
Stanice po přepnutí zmizela z MyBox Cloudu
Po přepnutí na cizí OCPP backend stanice reportuje transakce tam, ne do MyBox Cloudu. To není závada — je to důsledek přesměrování.
Související
- Nastavení QR kódů na displeji stanice
— konfigurační klíče
AO Afir code 1a2, nastavitelné z OCPP backendu přesChangeConfiguration - Integrace Modbus TCP — lokální rozhraní stanice pro nadřazené systémy
- Párování zařízení do cloudu