# Enphase IQ Gateway

Source: https://docs.evcc.io/en/meters/enphase-iq-gateway

## Parameters

| Name | Description | Default / example | |
| --- | --- | --- | --- |
| host | IP address or hostname | 192.0.2.2 |  |
| token | Token Required if Envoy Firmware D7.x.xxx. Token is valid for one year. Instructions for obtaining a token via web UI: [enphase.com](https://enphase.com/download/accessing-iq-gateway-local-apis-or-local-ui-token-based-authentication) |  |  |
| capacity | Battery capacity | 50 kWh |  |
| minsoc | Minimum charge Lower limit as configured on the battery system. Used by optimizer. | 0 % |  |
| maxsoc | Maximum charge Upper limit as configured on the battery system. Used by optimizer and for grid charging. | 100 % |  |
| schema | Schema (https, http) | https | advanced |
| battery_type | Enphase Battery Type (AC or IQ) Select 'iq' for new Enphase IQ Batteries. Leave at default 'ac' for older generation AC Batteries. (ac, iq) | ac | advanced |
| maxchargepower | Maximum charge power For forced charging of the battery. |  W | advanced |
| maxdischargepower | Maximum discharge power Maximum discharge power of the storage. |  W | advanced |
| cache | Cache Time interval for data refresh | 1s | advanced |
| timeout | Timeout | 10s | advanced |

## Configuration example for evcc.yaml

```yaml
meters:
    - name: my_grid
      type: template
      template: enphase
      usage: grid
      host: 192.0.2.2 # IP address or hostname
      token: # Token, Required if Envoy Firmware D7.x.xxx. Token is valid for one year. Instructions for obtaining a token via web UI: [enphase.com](https://enphase.com/download/accessing-iq-gateway-local-apis-or-local-ui-token-based-authentication) (optional)
      schema: https # Schema, [https, http] (optional)
      cache: 1s # Cache, Time interval for data refresh (optional)
      timeout: 10s # Timeout, optional
```

```yaml
meters:
    - name: my_pv
      type: template
      template: enphase
      usage: pv
      host: 192.0.2.2 # IP address or hostname
      token: # Token, Required if Envoy Firmware D7.x.xxx. Token is valid for one year. Instructions for obtaining a token via web UI: [enphase.com](https://enphase.com/download/accessing-iq-gateway-local-apis-or-local-ui-token-based-authentication) (optional)
      schema: https # Schema, [https, http] (optional)
      cache: 1s # Cache, Time interval for data refresh (optional)
      timeout: 10s # Timeout, optional
```

```yaml
meters:
    - name: my_battery
      type: template
      template: enphase
      usage: battery
      host: 192.0.2.2 # IP address or hostname
      token: # Token, Required if Envoy Firmware D7.x.xxx. Token is valid for one year. Instructions for obtaining a token via web UI: [enphase.com](https://enphase.com/download/accessing-iq-gateway-local-apis-or-local-ui-token-based-authentication) (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)
      schema: https # Schema, [https, http] (optional)
      battery_type: ac # Enphase Battery Type (AC or IQ), Select 'iq' for new Enphase IQ Batteries. Leave at default 'ac' for older generation AC Batteries. [ac, iq] (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)
      cache: 1s # Cache, Time interval for data refresh (optional)
      timeout: 10s # Timeout, optional
```