# ioBroker Charger

Source: https://docs.evcc.io/en/chargers/iobroker-charger

The `rest-api` adapter (not `simple-api`) must be installed extension to a web adapter.
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`

## Parameters

| Name | Description | Default / example | |
| --- | --- | --- | --- |
| uri | The full uri of the host to query HTTP(S) address | https://iobroker.homelab.lan:8082 |  |
| status | Charge status (A, B, C) |  |  |
| enabled | Enabled |  |  |
| enable | Set enabled |  |  |
| user | Username e.g. email address, user id, etc. |  |  |
| password | Password Service account password |  |  |
| power | Power |  W |  |
| maxcurrent | Set maximum amperage The maximum current per connected phase that can be used | 16 A |  |
| phaseswitch | Set num phases (1 or 3) |  |  |
| cache | Cache Time interval for data refresh | 5m | advanced |
| maxcurrentmillis | Set maximum amperage |  mA | advanced |

## Configuration example for evcc.yaml

```yaml
chargers:
    - name: my_charger
      type: template
      template: iobroker
      uri: https://iobroker.homelab.lan:8082 # The full uri of the host to query, HTTP(S) address
      status: # Charge status (A, B, C)
      enabled: # Enabled
      enable: # Set enabled
      user: # Username, e.g. email address, user id, etc. (optional)
      password: # Password, Service account password (optional)
      power: # Power (W), optional
      maxcurrent: 16 # Set maximum amperage (A), The maximum current per connected phase that can be used (optional)
      phaseswitch: # Set num phases (1 or 3), optional
      cache: 5m # Cache, Time interval for data refresh (optional)
      maxcurrentmillis: # Set maximum amperage (mA), optional
```