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 28 different energy companies in Sweden, Norway and Belgium. 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 (every 10s or more). Peaqev can also be used without living in an area with peak-shaving implemented, you may utilize it soley for the purpose of charging at the lowest available hours in your area (Requires Nordpool)

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

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

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

• 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

• 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.

• Price-aware charging - Check this to calculate the cheapest hours from Nordpool or EnergiDataService. Non- and Caution hours below here will be ignored
• Dynamic top price - If checked, the absolute top price for charging will be calculated by the monthly average from the spotprice-source (current month)
• 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

• 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

• 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

• Main fuse - (optional) Pick your main fuse setup to allow peaqev to detect and stop charging if consumption is about to breach the limit

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

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.