Brother-Blue / hass-peaq

Home Assistant custom component to help ev-chargers stay below peak hourly energy levels.

Peaqev ev-charging

First time here? Check the getting-started

Interested in sponsoring or prioritizing a certain feature, look here

Peaqev aims at lowering the household's peak energy charges, targeted at charging an electronic vehicle (EV) below a dynamic threshold. Peaqev covers 26 different energy companies in Sweden, Norway and Belgium and two types of ev chargers (2021-11-08) You will get the best experience with a supported charger that can update amps while charging, as well as using a connected power meter that update your total power draw frequently. Examples of such meters are:

• Shelly 3EM
• Tibber Watty
• Tibber Pulse

The integration does not communicate with any proprietary API's. However, the chargers selected will use the integrations set for them, and may include cloud polling of data.

For usage-examples and more in-depth explanations, see the Wiki:

• List of available Locales
• Price awareness
• Scheduler
• Usage

Installation

Required to install is Home Assistant version 2022.10.5 or higher.

Preferred if you have HACS installed is to search for Peaqev there.

Otherwise you may:

• Copy custom_components/peaqev folder to <config_dir>/custom_components/peaqev/
• Restart Home assistant
• Go to Configuration > Devices & Services > Add integration

Config setup:

Peaqev has two types of installations: Regular and Lite. Regular is much more precise, but requires an installed power sensor while Lite does not.

Installation type:

• Installation type - Pick Lite if you do not have a power meter installed. Peaqev will then charge the allowed hourly amount set further down in "Months". Otherwise pick Regular

Sensor:

• Power sensor - The wattage reading sensor for your connected powermeter. Must be in Watts (W)
• Power sensor includes car - Check this option if the above sensor includes your car's power draw

Charger and Locale:

• City, or Grid owner company - The characteristics differ in how peak hours are stored and measured
• Charger type - Pick the installed ev charger you have. Check table below for required custom component and features per charger type
• Charger id - Your local identifier to tell Peaqev which charger unit we mean to manipulate. If your charger type does not provide this, leave blank
• If you have selected Smart outlet as charger type, you will need to provide the switch to turn on/off, and the sensor to read power from the outlet instead of charger id.

Charger	Required integration	Can update amps	Supported models	Notes
Chargeamps	hass-chargeamps	Yes	Halo
Easee	easee-hass	Yes	Robot	Turn off all smart charging before using peaqev
Zaptec	zaptec	No*	Go	*Anticipate update amps to be fixed soon
Smart outlet	-	No		Stability depends on the outlet used

Price-aware:

• Price-aware charging - Check this to calculate the cheapest hours from Nordpool (requires Nordpool). Non- and Caution hours below here will be ignored
• Absolute top price - The limit (if any) where your charger should be stopped, regardless of the hour algorithm
• Min price - The lower limit (if any) where charging will always be permitted (must be lower than top price if set)
• Caution hour type - Choose to what extent you would like Peaqev to hold back during caution hours. Suave > Aggressive

Hours:

• Non hours - Click to select the hours (if any) where you do not wish to charge
• Caution hours - Click to select the hours (if any) where you want the charger to be extra cautious to not break the peak

Months:

• Monthly allowed peak - Needs to be set in order to determine a minimum allowed peak. In the beginning of each month this is necessary to be able to charge at all. Format is in kW. See examples below

Examples for hourly peak-shaving. A tip is to look at your current peaks and set it to about 50-70% of those.

Month	1-phase charge	3-phase charge
Jan	2.0	4.0
Feb	1.8	3.6
Mar	1.8	3.6
Apr	1.5	3.0
May	1.5	3.0
Jun	1.5	3.0
Jul	1.5	3.0
Aug	1.5	3.0
Sep	1.5	3.0
Oct	1.5	3.0
Nov	1.8	3.6
Dec	2.0	4.0

While this integration will try to not break your monthly energy peaks, there is off course no guarantee. Various factors beyond control of this logic do occur, so for those aiming at staying below their threshold, I do suggest you think about the non-hours, caution-hours etc in the setup. These hours should be set when you commonly utilize a lot of extra energy in your home, such as cooking, doing laundry etc.