Enphase IQ Envoy

Usage areas

Grid meter
Solar production
Battery

Parameters

Name	Description	Level
`host`	IP address or hostname Example: `192.0.2.2`	optional
`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	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
`schema`	Schema Default: `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. Default: `ac`	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
`cache`	Cache Time interval for data refresh Default: `1s` Example: `5m`	advanced
`timeout`	Timeout Default: `10s` Example: `10s`	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

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)
      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)
      cache: 1s # Cache, Time interval for data refresh (optional)
      timeout: 10s # Timeout, optional

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)
      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)
      cache: 1s # Cache, Time interval for data refresh (optional)
      timeout: 10s # Timeout, optional

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: 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)
      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