Skip to Content
Docs

Integrace Modbus TCP

VeřejnéMyBox HomeMyBox PlusMyBox ProfiMyBox PostTyp obsahu: Reference

Zapnutí Modbus TCP v aplikaci MyBox (Nastavení stanice › Servis › Modbus), port 502, byte order LBF_LWF a mapy registrů pro Home, Plus, Profi i Post včetně řízení nabíjecího proudu.

Úvod

MyBox stanice podporují komunikaci přes Modbus TCP v režimu Slave. To umožňuje externím systémům (Loxone, Siemens, PLC, BMS apod.) číst stav stanice a řídit nabíjecí výkon.

Tato dokumentace je rozdělena dle typu jednotky:

SekceJednotkaProdukty
MSSaM / MSMyBox Plus, MyBox PlusLAN
MSSMSSMyBox Profi, MyBox Post
SaMSaMMyBox Home

Obecné nastavení

Požadavky

  • Stanice musí být napárována v cloudu a online
  • Modbus TCP se nastavuje přes mobilní aplikaci MyBox
  • Po aktivaci / jakékoliv změně Modbus konfigurace je nutný restart stanice

Parametry připojení

ParametrHodnota
Port502
ProtokolModbus TCP
RežimSlave
Výchozí slave address10 (konfigurovatelné)
Byte orderLBF_LWF (Little Byte First, Little Word First)

Konfigurace přes mobilní aplikaci

Nastavení Modbusu se provádí v mobilní aplikaci MyBox, v Nastavení stanice na záložce Servis. Ta je skrytá a je nutné ji nejdřív odemknout servisním heslem.

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. 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
  4. Přejděte na Servis › Modbus — hlavní záložka Servis, podzáložka Modbus.

  5. Nastavte parametry Modbus:

    • Modbus povoleno → zapněte (ve výchozím stavu je vypnuto)
    • Typ protokolu → TCP (výchozí hodnota; druhá možnost je RTU)
    • Pořadí bytů → ponechte výchozí LBF_LWF, pokud integrátor nevyžaduje jinak (možnosti: LBF_LWF, LBF_HWF, HBF_LWF, HBF_HWF)
    • Adresa slave, Baudrate, Parita → týkají se jen Modbus RTU (sériová linka RS-485); u TCP se nepoužijí a stanice adresu (Unit ID) v dotazu nekontroluje
    Servis › Modbus — přepínač „Modbus povoleno“ zapnutý a sekce Modbus: Typ protokolu TCP, Adresa slave 10, Baudrate 9600, Parita NONE, Pořadí bytů LBF_LWF
  6. 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 jakékoliv změně Modbus nastavení (aktivace, typ protokolu, adresa slave, pořadí bytů) je nutný restart stanice. Aplikace po uložení restart sama nenabízí ani nehlásí, že na něj stanice čeká. Bez restartu komunikace nefunguje.

Modbus TCP nemá přihlašování

Kdokoli v síti stanice může registry číst a ty zapisovatelné i měnit. Zapínejte Modbus jen v důvěryhodné síti.

Když se „Modbus povoleno“ samo vypne

Pokud stanice linku RS-485 už sama používá jako Modbus master (například ke čtení elektroměru), slave v režimu RTU se nespustí a stanice Modbus povoleno sama vypne.

Doporučení pro síť

  • IP adresu stanice doporučujeme zafixovat na DHCP serveru (statická rezervace), aby se po restartu nezměnila
  • Stanice získává IP přes DHCP — aktuální IP zjistíte například v seznamu připojených zařízení na routeru/DHCP serveru

Byte order (Endianness)

Všechny 32-bitové hodnoty (integer i float) používají kódování LBF_LWF (Low Byte First, Low Word First = little-endian).

Příklad — hodnota 0x00000003 (integer 3):

Low WordHigh Word
Low ByteHigh ByteLow ByteHigh Byte
Pořadí přenosu1234
Hodnota (hex)03000000

Doporučené Function Codes

FCNázevPoužití
02Read Discrete InputsČtení bool registrů (CABLE_LOCK, PWM_ON)
03Read Holding RegistersČtení R/W registrů (MAX_CHARGE_CURRENT)
04Read Input RegistersČtení stavových registrů (CAR_STATE, proudy, energie)
05Write Single CoilZápis bool (STOP_CHARGING, UNLOCK_CONNECTOR)
06Write Single Holding RegisterZápis 16-bit hodnoty
16Write Multiple Holding RegistersZápis 32-bit hodnoty (2 registry)

:::warning 32-bitový zápis — použijte FC 16 Hodnoty jako MAX_CHARGE_CURRENT jsou 32-bitové a zabírají 2 registry. Pro zápis je nutné použít FC 16 (Write Multiple Holding Registers). Při použití FC 06 (Write Single Register) se zapíše jen polovina hodnoty a stanice na změnu nereaguje — to je nejčastější příčina problémů s Modbus zápisem. :::


MS — MyBox Plus

Platí pro: MyBox Plus, MyBox PlusLAN

Stanice s jedním nabíjecím bodem (1 konektor).

Discrete registry (read-only, bool)

AdresaRegistrPopis
0CABLE_LOCK_STATE_KEYStav zámku kabelu (0 = odemčeno / zámek není nainstalován)
1PWM_ON_KEYPWM signál aktivní

Coil registry (R/W, bool)

AdresaRegistrPopis
0STOP_CHARGINGUkončení nabíjecí relace (zápis nenulové hodnoty)
1UNLOCK_CONNECTOROdemknutí konektoru (od FW 1.6.0)

Input registry (read-only, 32-bit = 2 registry)

AdresaRegistrTypJednotka / Enum
0CAR_STATE_KEYinteger (enum)STATE_A(0), STATE_B(1), STATE_C(2), FAIL(3), UNKNOWN(4)
2EVSE_STATE_KEYinteger (enum)Unplugged(0), Plugged(1), Ready(2), Charging(3), Paused(4), Error(5), Locked(6)
4NLB_NODE_CURRENTfloatA
6EV_METER_CURRENT_L1floatA
8EV_METER_CURRENT_L2floatA
10EV_METER_CURRENT_L3floatA
12EV_METER_TOTAL_ENERGYfloatkWh
14EV_METER_TOTAL_ACTIVE_POWERfloatkW

Holding registry (R/W, 32-bit = 2 registry)

AdresaRegistrTypJednotka
0MAX_CHARGE_CURRENTintegerA

Řízení výkonu

Registr MAX_CHARGE_CURRENT slouží k omezení maximálního nabíjecího proudu:

  • Minimum: 0 A (nabíjení se pozastaví)
  • Pod 6 A: nabíjení se automaticky pozastaví (pauza)
  • 6–32 A: aktivní nabíjení s daným limitem
  • Maximum: závisí na konfiguraci stanice (typicky 16 A nebo 32 A na nabíjecí bod)

MSS — MyBox Profi, MyBox Post

Platí pro: MyBox Profi, MyBox Post

Stanice se dvěma nabíjecími body (2 konektory). Registry jsou zdvojené — konektor 1 začíná na nižších adresách, konektor 2 na adresách + 10 (discrete/coil) resp. + 20 (input/holding).

Discrete registry (read-only, bool)

AdresaKonektorRegistr
01CABLE_LOCK_STATE_KEY
11PWM_ON_KEY
102CABLE_LOCK_STATE_KEY
112PWM_ON_KEY

Coil registry (R/W, bool)

AdresaKonektorRegistr
01STOP_CHARGING
11UNLOCK_CONNECTOR (od FW 1.6.0)
102STOP_CHARGING
112UNLOCK_CONNECTOR (od FW 1.6.0)

Input registry (read-only, 32-bit = 2 registry)

AdresaKonektorRegistrTypJednotka / Enum
01CAR_STATE_KEYinteger (enum)STATE_A(0), STATE_B(1), STATE_C(2), FAIL(3), UNKNOWN(4)
21EVSE_STATE_KEYinteger (enum)Unplugged(0), Plugged(1), Ready(2), Charging(3), Paused(4), Error(5), Locked(6)
41NLB_NODE_CURRENTfloatA
61EV_METER_CURRENT_L1floatA
81EV_METER_CURRENT_L2floatA
101EV_METER_CURRENT_L3floatA
121EV_METER_TOTAL_ENERGYfloatkWh
141EV_METER_TOTAL_ACTIVE_POWERfloatkW
202CAR_STATE_KEYinteger (enum)STATE_A(0), STATE_B(1), STATE_C(2), FAIL(3), UNKNOWN(4)
222EVSE_STATE_KEYinteger (enum)Unplugged(0), Plugged(1), Ready(2), Charging(3), Paused(4), Error(5), Locked(6)
242NLB_NODE_CURRENTfloatA
262EV_METER_CURRENT_L1floatA
282EV_METER_CURRENT_L2floatA
302EV_METER_CURRENT_L3floatA
322EV_METER_TOTAL_ENERGYfloatkWh
342EV_METER_TOTAL_ACTIVE_POWERfloatkW

Holding registry (R/W, 32-bit = 2 registry)

AdresaKonektorRegistrTypJednotka
01MAX_CHARGE_CURRENTintegerA
202MAX_CHARGE_CURRENTintegerA

Řízení výkonu

Každý konektor se řídí nezávisle přes vlastní MAX_CHARGE_CURRENT registr. Pravidla jsou stejná jako u MS sekce (0 A = pauza, pod 6 A = pauza, max. dle konfigurace).


SaM — MyBox Home

Platí pro: MyBox Home

Stanice s jedním nabíjecím bodem. Mapa registrů je shodná s MyBox Plus (MS).

Discrete registry (read-only, bool)

AdresaRegistrPopis
0CABLE_LOCK_STATE_KEYStav zámku kabelu
1PWM_ON_KEYPWM signál aktivní

Coil registry (R/W, bool)

AdresaRegistrPopis
0STOP_CHARGINGUkončení nabíjecí relace
1UNLOCK_CONNECTOROdemknutí konektoru (od FW 1.6.0)

Input registry (read-only, 32-bit = 2 registry)

AdresaRegistrTypJednotka / Enum
0CAR_STATE_KEYinteger (enum)STATE_A(0), STATE_B(1), STATE_C(2), FAIL(3), UNKNOWN(4)
2EVSE_STATE_KEYinteger (enum)Unplugged(0), Plugged(1), Ready(2), Charging(3), Paused(4), Error(5), Locked(6)
4NLB_NODE_CURRENTfloatA
6EV_METER_CURRENT_L1floatA
8EV_METER_CURRENT_L2floatA
10EV_METER_CURRENT_L3floatA
12EV_METER_TOTAL_ENERGYfloatkWh
14EV_METER_TOTAL_ACTIVE_POWERfloatkW

Holding registry (R/W, 32-bit = 2 registry)

AdresaRegistrTypJednotka
0MAX_CHARGE_CURRENTintegerA

Příklady komunikace (Modbus TCP)

Všechny příklady používají výchozí byte order LBF_LWF.

Čtení stavu stanice (EVSE_STATE_KEY)

Čtení Input registru na adrese 2, délka 2 registry (FC 04):

TX: 00 34 00 00 00 06 01 04  00 02 00 02
RX: 00 34 00 00 00 07 01 04  04 01 00 00 00

Výsledek: 0x00000001 = Plugged (1)

Čtení všech Input registrů konektoru 1

Čtení 16 registrů od adresy 0 (FC 04):

TX: 00 3D 00 00 00 06 01 04  00 00 00 10
RX: 00 3D 00 00 00 23 01 04  20 02 00 00 00 03 00 00 00
    00 00 50 41 52 B8 DE 3F  00 00 00 00 00 00 00 00
    B8 1E A5 3F 3D 0A D7 3E

Dekódování:

AdresaHexTypHodnota
0–10x00000002enumSTATE_C (2)
2–30x00000003enumCharging (3)
4–50x41500000float13.0 A
6–70x3FDEB852float1.74 A
12–130x3FA51EB8float1.29 kWh
14–150x3ED70A3Dfloat0.42 kW

Čtení MAX_CHARGE_CURRENT

Čtení Holding registru na adrese 0, délka 2 (FC 03):

TX: 00 44 00 00 00 06 01 03  00 00 00 02
RX: 00 44 00 00 00 07 01 03  04 11 00 00 00

Výsledek: 0x00000011 = 17 A

Zápis MAX_CHARGE_CURRENT (FC 16 — doporučeno)

Zápis hodnoty 9 A do 2 registrů od adresy 0 (FC 16):

TX: 00 4A 00 00 00 0B 01 10  00 00 00 02 04 09 00 00 00
RX: 00 4A 00 00 00 06 01 10  00 00 00 02

Zápis MAX_CHARGE_CURRENT (FC 06 — alternativa pro 16-bit)

Zápis hodnoty 18 A na adresu 0 (FC 06):

TX: 00 4E 00 00 00 06 01 06  00 00 12 00
RX: 00 4E 00 00 00 06 01 06  00 00 12 00

:::info Poznámka k FC 06 FC 06 zapíše pouze 16-bit (1 registr). Pro spolehlivý zápis 32-bitových hodnot vždy preferujte FC 16. :::

Čtení PWM_ON_KEY

Čtení Discrete registru na adrese 1 (FC 02):

TX: 00 6A 00 00 00 06 01 02  00 01 00 01
RX: 00 6A 00 00 00 04 01 02  01 01

Výsledek: PWM je ON (1)

STOP_CHARGING

Zápis Coil na adrese 0, nenulová hodnota (FC 05):

TX: 00 72 00 00 00 06 01 05  00 00 FF 00
RX: 00 72 00 00 00 06 01 05  00 00 FF 00

Nejčastější problémy

Nemohu navázat spojení

  1. Ověřte, že je v mobilní aplikaci na Servis › Modbus zapnuto Modbus povoleno a Typ protokolu je TCP (pokud se přepínač sám vypnul, viz upozornění výše o RS-485)
  2. Ověřte IP adresu stanice — zjistíte ji například v seznamu připojených zařízení na routeru/DHCP serveru
  3. Port musí být 502
  4. Restartovali jste stanici po změně konfigurace? Bez restartu komunikace nefunguje

Zápis MAX_CHARGE_CURRENT nereaguje

Nejčastější příčina: použití FC 06 místo FC 16. Registr je 32-bitový (2× 16-bit). Modbus vrátí ACK, ale stanice hodnotu ignoruje. Řešení: použijte FC 16 (Write Multiple Holding Registers) se zápisem do 2 registrů v kódování LBF_LWF.

CABLE_LOCK_STATE_KEY je stále 0

Pokud stanice nemá fyzicky nainstalovaný zámek kabelu (cable-lock = Disable), registr vrací vždy 0. To není chyba.

Po restartu se změnila IP adresa

IP adresu stanice doporučujeme zafixovat statickou DHCP rezervací na routeru/DHCP serveru.

Nabíjení se pozastaví při snížení proudu

Při nastavení MAX_CHARGE_CURRENT pod 6 A se nabíjení automaticky pozastaví (pauza). Pro obnovení zvyšte hodnotu nad 6 A.

On this page

Stáhnout