site

Describes the location with the existing and required devices of the home installation and is responsible for regulating the available power.

To regulate charging with PV surplus, a readable meter directly behind the grid connection point is necessary. In addition, devices for PV power and house battery(ies) can also be specified. Several devices are automatically added in terms of power or, in the case of battery storage, the average state of charge is calculated.

For example:

site:
  title: Home # display name for UI
  meters:
    grid: mygridmeter # grid meter reference
    pv:
      - mypv1 # first pv meter reference
      - mypv9 # second pv meter reference
    battery:
      - mybat5 # battery meter reference
    aux:
      - myaux1 # self-regulating consumer
    consumer:
      - myconsumer1 # regular consumer, recorded for consumption statistics
    ext:
      - myext1 # for data logging, load management, etc.
  residualPower: 100

---

Required Parameters

title

The description of the charging point is also displayed in the UI.

For example:

title: Home

---

meters

Defines which configured meter (current measurement devices) are to be used as what type of measurement point. This logically links the device definition with its intended use. A initially universal meter is thus assigned a purpose based on its location within the home installation.

Note

At least the configuration of one grid or at least one pv element is necessary!

evcc cannot be used without at least one of these entries!

For example:

site:
  meters:
    grid: mygridmeter # grid meter reference
    pv: mypv1 # pv meter reference
    battery: mybat2 # battery meter reference
    aux: myaux1

---

Optional Parameters

meters.grid

Defines the meter (current measurement device) that provides the measurements of the grid connection point.

Possible values: Value of a name parameter in the meters configuration.

For example:

grid: mygridmeter # grid meter reference

---

meters.pv

Defines meter (current measurement devices), from which evcc fetches PV generation measurements. Multiple devices can be specified. Power data is automatically added.

Possible values: A single value or a list of values of a name parameter in the meters configuration. The list version can also be used with single values.

For example:

pv: myonlypv # single pv meter reference

or

pv: # (pvs = deprecated)
  - myoldpv # first pv meter reference
  - mynewestpv # second pv meter reference

---

meters.battery

Defines the meter (current measurement devices) that provide measurement data from the battery(ies). Multiple devices can be specified. Power data is automatically added, and an average is calculated from the battery state of charge.

Possible values: A single value or a list of values of a name parameter in the meters configuration. The list version can also be used with single values.

For example:

battery: myonlybat # single battery meter reference

or

battery: # (batteries = deprecated)
  - mysmallbat # first battery meter reference
  - myhugebat # second battery meter reference

meters.aux

Meters for external devices that run their own surplus control but aren’t directly controlled by evcc, e.g. a self-regulating immersion heater. Their power counts toward the available surplus for vehicle charging, on the assumption that the device reduces its consumption when evcc allocates that power to charging. Multiple meters are added up.

Possible values: A single value or a list of values of a name parameter in the meters configuration. The list version can also be used with single values.

Example:

aux: myaux # single aux meter reference

or

aux:
  - myaux1 # first aux meter reference
  - myaux2 # second aux meter reference

meters.consumer

Meters for regular consumers such as a washing machine or dishwasher, recorded for consumption statistics only. Unlike aux, this power isn’t factored into the available surplus for vehicle charging.

Possible values: A single value or a list of values of a name parameter in the meters configuration. The list version can also be used with single values.

Example:

consumer: myconsumer # single consumer meter reference

or

consumer:
  - myconsumer1 # first consumer meter reference
  - myconsumer2 # second consumer meter reference

meters.ext

Meters that aren’t used for regulation or shown in the UI, e.g. sub-distributions or alternative grid or solar meters. Their data is only logged and exported, not factored into surplus or consumption statistics.

Possible values: A single value or a list of values of a name parameter in the meters configuration. The list version can also be used with single values.

Example:

ext: myext # single ext meter reference

or

ext:
  - myext1 # first ext meter reference
  - myext2 # second ext meter reference

residualPower

Sets the target operating point of the surplus regulation at the grid connection (grid meter). The default value is 0 W. Positive values shift the target value towards grid feed-in, while negative values shift it towards grid consumption. Ultimately, this value sets the “idle state” of the control loop that needs to be adjusted by the controller.

Especially in combination with other independent surplus regulation systems like a battery storage, this value must be adjusted to achieve a defined system behaviour with clear priorities.

If a certain proportion of grid consumption should remain or be allowed in PV mode, a negative value corresponding to the maximum proportion of grid consumption can be configured.

grid meter present

• Positive value: Remaining grid feed-in power
• Negative value: Remaining grid consumption power

Only pv meter present

• Positive value: Typical household consumption, used to estimate PV surplus.
• Negative value: The specified power is added to PV power and increases available charging power (Attention: grid consumption)

Note

When a battery storage is present, it is strongly recommended to enter a small value, e.g. between 100 to 300 W here, allowing battery charging according to configured priorities (see prioritySoc). Otherwise, the independent regulation of the storage will not see usable surplus. Likewise, this prevents temporary grid consumption even without a battery during rapid generation and load changes.

Example “Battery Storage”:

residualPower: 100

For example “Grid Consumption Proportion”:

Charging should start in PV mode with at least 6A (single-phase) even with only 50% PV surplus (rest from grid). Minimum charging power: 1 phase _ 6A _ 230V = 1380 W, 50% of it: 690 W

See also the alternative using enable/disable to allow proportional PV and grid consumption.

residualPower: -690