modbusproxy

De instelling modbusproxy is een lijst van apparaten die via Modbus TCP in het netwerk beschikbaar worden gesteld voor systemen van derden.

Sommige apparaten staan slechts een zeer beperkt aantal Modbus-TCP-clients toe. In het slechtste geval is maar één verbinding toegestaan, zoals bij componenten van SolarEdge. Daarnaast is in seriële RS485-bussystemen met Modbus RTU maar één master toegestaan. Met modbusproxy werkt uw evcc-installatie als Modbus-proxy die bestaande Modbus-verbindingen met andere systemen deelt. Alleen uw evcc-installatie communiceert dan direct met het apparaat. Andere systemen verbinden met de proxy, die hun verzoeken bundelt en naar het doelapparaat doorstuurt.

De configuratie modbusproxy is een lijst van verschillende proxyconfiguraties.

Voorbeeld:

modbusproxy:
  - port: 5021
    uri: 192.0.2.2:502
  - port: 5022
    device: /dev/ttyUSB0
    baudrate: 9600
    comset: "8N1"
  - port: 5023
    uri: 192.0.2.3:502
    rtu: true

Verplichte parameters

`port`

De lokale TCP/IP-poort waarop de proxyserver luistert en inkomende Modbus-TCP-verbindingen van systemen van derden accepteert.

Voorbeeld:

port: 5021

Optionele parameters

`uri`

Het IP-adres en de poort van het doelapparaat in de gangbare URI-notatie.

Elke opgegeven poort moet uniek zijn en mag niet al door een andere toepassing op de evcc-host worden gebruikt, maar hoeft niet te verschillen van de poort van het doelapparaat. U kunt dus ook een configuratie voor poort 502 definiëren die naar poort 502 op het doelapparaat verwijst.

Voorbeeld:

- port: 502
  uri: 192.0.2.2:502

`rtu`

Modbus TCP wordt doorgaans gebruikt voor communicatie met doelapparaten in het netwerk. Indien nodig kunt u met rtu: true overschakelen op Modbus RTU over TCP. Een typische toepassing zijn eenvoudige transparante RS485-naar-TCP-converters (zonder protocolvertaling). De instelling moet overeenkomen met de configuratie van het apparaat. Bij seriële doelapparaten wordt ze genegeerd.

Voorbeeld:

rtu: true

`readonly`

Met deze parameter kunt u schrijftoegang via Modbus door systemen van derden verhinderen.

Mogelijke waarden:

true: schrijftoegang wordt zonder antwoord geblokkeerd
deny: schrijftoegang wordt geblokkeerd met een Modbus-foutmelding als antwoord
false: schrijftoegang wordt doorgestuurd

Functiecodes die de proxy niet zelf afhandelt, zoals de fabrikantspecifieke functiecode 0x41 van Huawei, kunnen schrijfbewerkingen bevatten. Beide alleen-lezenmodi blokkeren ze daarom met een Modbus-foutmelding. Met readonly: false stuurt de proxy ze ongewijzigd door, maar alleen naar apparaten die via Modbus TCP zijn verbonden. De Home Assistant-integratie voor Huawei-omvormers heeft bijvoorbeeld readonly: false nodig.

Voorbeeld:

readonly: true