ioBroker

← PV, Battery, Grid, Meter

The rest-api adapter (not simple-api) must be installed on the ioBroker instance being used. Authentication can only be performed using basic authentication. If no password is provided, no authentication will be performed. When specifying the entities for the individual measured values, ensure that they are correctly URL-encoded. For example, shelly.0.SHEM-3#8CAAB561991E#1.Total.ConsumedPower becomes shelly.0.SHEM-3%238CAAB561991E%231.Total.ConsumedPower

Usage areas

Grid meter
Solar production
Battery
Charger meter

Parameters

Name	Description	Level
`uri`	The full uri of the host to query HTTP(S) address Example: `https://iobroker.homelab.lan:8082`	optional
`user`	Username e.g. email address, user id, etc.	optional
`password`	Password Service account password	optional
`power` [W]	Power	optional
`soc` [%]	State of Charge	optional
`capacity` [kWh]	Battery capacity Example: `50`	optional
`minsoc` [%]	Minimum charge Lower limit when discharging the battery in normal operation Example: `25`	optional
`maxsoc` [%]	Maximum charge Upper limit when charging the battery from the grid Example: `95`	optional
`cache`	Cache Time interval for data refresh Example: `5m`	advanced
`energy` [kWh]	Meter reading	advanced
`currentL1` [A]	L1 current	advanced
`currentL2` [A]	L2 current	advanced
`currentL3` [A]	L3 current	advanced
`maxchargepower` [W]	Maximum charge power For forced charging of the battery.	advanced
`maxdischargepower` [W]	Maximum discharge power Maximum discharge power of the storage.	advanced
`maxacpower` [W]	Maximum AC power of the hybrid inverter Default: `0` Example: `5000`	advanced

Configuration example for evcc.yaml

If you don't want to configure via the UI, you can alternatively use this YAML block.

Grid meter Solar production Battery Charger meter

meters:
    - name: my_grid
      type: template
      template: iobroker
      usage: grid
      uri: https://iobroker.homelab.lan:8082 # The full uri of the host to query, HTTP(S) address
      user: # Username, e.g. email address, user id, etc. (optional)
      password: # Password, Service account password (optional)
      power: # Power (W), optional
      soc: # State of Charge (%), optional
      cache: 5m # Cache, Time interval for data refresh (optional)
      energy: # Meter reading (kWh), optional
      currentL1: # L1 current (A), optional
      currentL2: # L2 current (A), optional
      currentL3: # L3 current (A), optional

meters:
    - name: my_pv
      type: template
      template: iobroker
      usage: pv
      uri: https://iobroker.homelab.lan:8082 # The full uri of the host to query, HTTP(S) address
      user: # Username, e.g. email address, user id, etc. (optional)
      password: # Password, Service account password (optional)
      power: # Power (W), optional
      soc: # State of Charge (%), optional
      cache: 5m # Cache, Time interval for data refresh (optional)
      energy: # Meter reading (kWh), optional
      currentL1: # L1 current (A), optional
      currentL2: # L2 current (A), optional
      currentL3: # L3 current (A), optional
      maxacpower: 0 # Maximum AC power of the hybrid inverter (W), optional

meters:
    - name: my_battery
      type: template
      template: iobroker
      usage: battery
      uri: https://iobroker.homelab.lan:8082 # The full uri of the host to query, HTTP(S) address
      user: # Username, e.g. email address, user id, etc. (optional)
      password: # Password, Service account password (optional)
      power: # Power (W), optional
      soc: # State of Charge (%), optional
      capacity: 50 # Battery capacity (kWh), optional
      minsoc: 25 # Minimum charge (%), Lower limit when discharging the battery in normal operation (optional)
      maxsoc: 95 # Maximum charge (%), Upper limit when charging the battery from the grid (optional)
      cache: 5m # Cache, Time interval for data refresh (optional)
      energy: # Meter reading (kWh), optional
      currentL1: # L1 current (A), optional
      currentL2: # L2 current (A), optional
      currentL3: # L3 current (A), 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)

meters:
    - name: my_charger
      type: template
      template: iobroker
      usage: charge
      uri: https://iobroker.homelab.lan:8082 # The full uri of the host to query, HTTP(S) address
      user: # Username, e.g. email address, user id, etc. (optional)
      password: # Password, Service account password (optional)
      power: # Power (W), optional
      soc: # State of Charge (%), optional
      cache: 5m # Cache, Time interval for data refresh (optional)
      energy: # Meter reading (kWh), optional
      currentL1: # L1 current (A), optional
      currentL2: # L2 current (A), optional
      currentL3: # L3 current (A), optional