Skip to Content
Docs

Napojení na OCPP backend

VeřejnéMyBox HomeMyBox PlusMyBox ProfiMyBox PostTyp obsahu: Návod

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í

ParametrHodnota
ProtokolOCPP 1.6 JSON (WebSocket)
Transportwss:// (doporučeno) nebo ws://
Kde se nastavujemobilní aplikace MyBox, Nastavení stanice › Servis › OCPP (režim autorizace na Stanice › Nastavení)
Po změně konfiguracerestart 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

  1. 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).

  2. Otevřete Nastavení stanice — vpravo nahoře ťukněte na ozubené kolo (popisek „Nastavení“); stejně funguje ťuknutí na název stanice.

    Detail stanice „Garáž“ — v záhlaví vpravo nahoře tlačítka „⋯“ (Další možnosti) a ozubené kolo (Nastavení)
  3. 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žimKdy ho zvolit
    OCPPO tom, kdo smí dobíjet, rozhoduje backend (zprávou Authorize) — zákazník se autorizuje kartou nebo v aplikaci
    OCPP FreevendorDobíjení se spustí bez autorizace zákazníka; stanice použije Freevend ID tag, aby měl backend transakci k čemu přiřadit
    Spodní list „Vyberte hodnotu“ u řádku Režim autorizace se šesti možnostmi: Vypnuto, Lokální seznam RFID (aktuální hodnota, zaškrtnuto), OCPP, OCPP Freevendor, Zamknutí / odemknutí, Cloud MQTT

    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).

  4. 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 mybox a potvrďte (tlačítkem ✓ nebo „Hotovo“ na klávesnici). Při překlepu se pod polem zobrazí „Nesprávné heslo“.

    Nastavení stanice › Stanice › Systém — úplně dole pole „Servisní heslo“ s potvrzovacím tlačítkem ✓, zatím prázdné

    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.

    Nastavení stanice › Stanice › Systém po odemčení — dole zelený řádek „Servisní režim aktivní“ s nápisem „Zrušit“ a mezi hlavními záložkami nově záložka Servis
  5. Přejděte na Servis › OCPP — hlavní záložka Servis, podzáložka OCPP.

    Servis › OCPP — „OCPP povoleno“ (Povoleno) a „Stav OCPP“ (Připojeno), v sekci OCPP řádky EVSE ID tag, Backend URL a Freevend ID tag (00FFFFFFFF)
  6. 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.

  7. Restartujte stanici — na Stanice › Systém ťukněte na červený řádek Restartovat a v dialogu „Opravdu pokračovat?“ zvolte Potvrdit.

    Dialog „Opravdu pokračovat?“ po ťuknutí na Restartovat (Stanice › Systém): „Akce „Restartovat“ se provede na stanici.“ s tlačítky Zrušit a 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žkaCo znamená
OCPP povolenoZda je OCPP komunikace na stanici povolená — Povoleno / Nepovoleno. Jen zobrazení, hodnotu určuje Režim autorizace.
Stav OCPPStav spojení s backendem — Připojeno / Odpojeno. Jen zobrazení.
EVSE ID tagIdentifikátor, pod kterým stanici zná backend (v OCPP identita nabíjecí stanice, ChargeBox ID). Ve výchozím stavu prázdné.
Backend URLAdresa OCPP endpointu, na který se stanice připojuje. Ve výchozím stavu prázdná.
Freevend ID tagidTag, 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

  1. Restartovali jste stanici po změně konfigurace? Bez restartu se spojení nenaváže.
  2. Ověřte Backend URL — překlep v hostu nebo v cestě, chybějící / na konci, ws:// místo wss:// — a EVSE ID tag, který musí přesně odpovídat identifikátoru na backendu.
  3. Ověřte, že je Režim autorizace nastavený na OCPP nebo OCPP Freevendor (řádek OCPP povoleno musí ukazovat Povoleno).
  4. 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.
  5. 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í

On this page

Stáhnout