OpenEMS Modbus-API

← Solare, batteria domestica, rete, contatori

License notice:

For active battery control on FENECON FEMS systems, a commercial license (FEMS App Modbus/TCP Write Access) is required.

FEMS documentation:

FEMS App Modbus/TCP Read Access: docs.fenecon.de
FEMS App Modbus/TCP Write Access: docs.fenecon.de

OpenEMS documentation:

OpenEMS Edge Api Modbus Controller: openems.github.io

Funzionalità supportate

Controllo batteria: Controllo esterno della carica e della scarica della batteria domestica tramite evcc.

Ambiti di utilizzo

Contatore di rete
Produzione solare
Batteria

Parametri

Nome	Descrizione	Valore	Livello
`id`	ID Modbus Predefinito: `1`	int	obbligatorio
`host`	Indirizzo IP o hostname Esempio: `192.0.2.2`		obbligatorio
`port`	Porta Predefinito: `502`	int	obbligatorio
`battery`	controls battery component active battery control (Modbus/TCP Write Access) Predefinito: `false`		facoltativo
`capacity` [kWh]	Battery capacity Esempio: `50`		facoltativo
`minsoc` [%]	Minimum charge Lower limit as configured on the battery system. Used by optimizer. Predefinito: `0` Esempio: `25`		facoltativo
`maxsoc` [%]	Maximum charge Upper limit as configured on the battery system. Used by optimizer and for grid charging. Predefinito: `100` Esempio: `95`		facoltativo
`grid_power_register`	Modbus register for grid power GridActivePower (W) Predefinito: `315`		avanzato
`grid_energy_register`	Modbus register for grid import energy GridBuyActiveEnergy (Wh) Predefinito: `359`		avanzato
`pv_power_register`	Modbus register for PV power ProductionActivePower (W) Predefinito: `327`		avanzato
`pv_energy_register`	Modbus register for PV energy ProductionActiveEnergy (Wh) Predefinito: `367`		avanzato
`maxacpower` [W]	Maximum AC power of the hybrid inverter Predefinito: `0` Esempio: `5000`		avanzato
`battery_power_register`	Modbus register for battery power EssDischargePower (W) Predefinito: `415`		avanzato
`battery_soc_register`	Modbus register for state of charge SoC (%) Predefinito: `302`		avanzato
`battery_set_register`	Modbus register for charge power SetActivePowerLessOrEquals (W) Predefinito: `710`		avanzato
`watchdog`	battery control API timeout Predefinito: `60s`		avanzato
`maxchargepower` [W]	Maximum charge power For forced charging of the battery.		avanzato
`maxdischargepower` [W]	Maximum discharge power Maximum discharge power of the storage.		avanzato

Esempio di configurazione per evcc.yaml

Se preferisci non configurare il dispositivo dall’interfaccia, puoi usare questo blocco YAML.

Contatore di reteProduzione solareBatteria

meters:
    - name: my_grid
      type: template
      template: openems-modbus
      usage: grid

      # Modbus TCP
      modbus: tcpip
      id: 1
      host:  # Hostname
      port: 502 # Port
      grid_power_register: 315 # Modbus register for grid power, GridActivePower (W) (optional)
      grid_energy_register: 359 # Modbus register for grid import energy, GridBuyActiveEnergy (Wh) (optional)

meters:
    - name: my_pv
      type: template
      template: openems-modbus
      usage: pv

      # Modbus TCP
      modbus: tcpip
      id: 1
      host:  # Hostname
      port: 502 # Port
      pv_power_register: 327 # Modbus register for PV power, ProductionActivePower (W) (optional)
      pv_energy_register: 367 # Modbus register for PV energy, ProductionActiveEnergy (Wh) (optional)
      maxacpower: 0 # Maximum AC power of the hybrid inverter (W), optional

meters:
    - name: my_battery
      type: template
      template: openems-modbus
      usage: battery

      # Modbus TCP
      modbus: tcpip
      id: 1
      host:  # Hostname
      port: 502 # Port
      battery: false # controls battery component, active battery control (Modbus/TCP Write Access) (optional)
      capacity: 50 # Battery capacity (kWh), optional
      minsoc: 0 # Minimum charge (%), Lower limit as configured on the battery system. Used by optimizer. (optional)
      maxsoc: 100 # Maximum charge (%), Upper limit as configured on the battery system. Used by optimizer and for grid charging. (optional)
      battery_power_register: 415 # Modbus register for battery power, EssDischargePower (W) (optional)
      battery_soc_register: 302 # Modbus register for state of charge, SoC (%) (optional)
      battery_set_register: 710 # Modbus register for charge power, SetActivePowerLessOrEquals (W) (optional)
      watchdog: 60s # battery control API timeout, optional
      maxchargepower: # Maximum charge power (W), For forced charging of the battery. (optional)
      maxdischargepower: # Maximum discharge power (W), Maximum discharge power of the storage. (optional)

Vedi la versione nightly