Myenergi custom component for Home Assistant. This component will make all supported myenergi devices (libbi is not currently supported) connected to your myenergi hub accessible in Home Assistant. The energy sensors are fully compatible with the energy dashboard in Home Assistant.
It will create HA devices depending on what you have installed:
-
Hub
- Grid power sensor (W)
- Grid voltage sensor (V)
- Grid frequency sensor (Hz)
- Generation power sensor (W)
- Charging/heating power sensor (W)
- Home power sensor (W); consumed power that is not charging, heating, generation and export
- Energy generated today sensor (kWh)
- Energy exported today sensor (kWh)
- Energy imported today sensor (kWh)
- Green energy today sensor (kWh); this is the amount of generated energy that was used for charging or heating instead of being exported
-
Zappi
- Charge mode selector (Stopped, Fast, Eco and Eco+)
- Phase setting (Automatic, 1 phase, 3 phase); Used in Eco+ charge mode
- Charge added this session sensor (kWh)
- Energy consumed today sensor (kWh)
- Energy diverted today sensor (kWh)
- Power sensors for internal and external CT clamps (W)
- Plug status sensor (EV Connected, Waiting for EV, Charging, EV Disconnected)
- Charger status sensor (Paused, Charging, Boosting, Completed)
- Minumum green level number input (%); how much power must be sourced from green sources (local generation) to do diversion charging
- Service to start boost (provide boost amount in kWh as parameter)
- Service to start smart boost (provide boost amount in kWh and desired finished time as paramters)
- Service to stop boost
- Service to unlock the Zappi
- Sensor for PIN Lock Status (This is not very useful in the real world)
- Sensor for Charge when Locked Status (This is the sensor that relates to the "unlock" service call and is the one you will want to use)
- Sensor for lock when plugged in status
- Sensor for lock when unplugged status
-
Eddi
- Operating mode selector that let you switch between Stopped (no heating will take place) and Normal modes
- Power sensors for internal and external CT clamps (W)
- Temperature sensors if fitted
- Service to start boost (provide boost amount in minutes as parameter)
- Heater priority; whether the first or second heater should be used first
-
Harvi
- Power sensors for internal and external CT clamps (W)
Common sensor entities may also include:
- Serial number
- Firmware version
- Device priority; used for deciding which gets power first
This Home Assistant integration talks to the myenergi API using the pymyenergi python library.
This component will set up the following platforms.
| Platform | Description |
|---|---|
sensor |
Provides various readings for your myenergi devices |
select |
Configure devices |
number |
Configure devices |
This is the recommended way to install.
- Search for myenergi in HACS.
- Install.
- Restart Home Assistant.
- In the HA UI, click Settings in the left nav bar, then click "Devices & Services". By default you should be viewing the Integrations tab. Click "+ Add Integration" button at bottom right and then search for "myenergi".
- Using the tool of choice open the directory (folder) for your HA configuration (where you find
configuration.yaml). - If you do not have a
custom_componentsdirectory (folder) there, you need to create it. - In the
custom_componentsdirectory (folder) create a new folder calledmyenergi. - Download all the files from the
custom_components/myenergi/directory (folder) in this repository. - Place the files you downloaded in the new directory (folder) you created.
- Restart Home Assistant.
- In the HA UI, click Settings in the left nav bar, then click "Devices & Services". By default you should be viewing the Integrations tab. Click "+ Add Integration" button at bottom right and then search for "myenergi".
Using your HA configuration directory (folder) as a starting point you should now also have this:
custom_components/myenergi/translations/en.json
custom_components/myenergi/translations/fr.json
custom_components/myenergi/translations/sv.json
custom_components/myenergi/translations/nb.json
custom_components/myenergi/__init__.py
custom_components/myenergi/config_flow.py
custom_components/myenergi/const.py
custom_components/myenergi/entity.py
custom_components/myenergi/manifest.json
custom_components/myenergi/number.py
custom_components/myenergi/select.py
custom_components/myenergi/sensor.py
custom_components/myenergi/services.yaml
If you have trouble logging in you might need to request an API key from myenergi. You can generate one at your myenergi account page. See the myenergi support article for more information.
in case of issues, check the MyEnergi app first to ensure everything works in the MyEnergi eco system.
If you need to change your API key for any reason, you will need to remove the device from "Integration entries", and re-add it again with the new API key.
If the master device is changed or replaced, a new API key is needed.
If an additional device is added, it can take a few hours before it shows up.
If you want to contribute to this please read the Contribution guidelines.
This project was generated from @oncleben31's Home Assistant Custom Component Cookiecutter template.
Code template was mainly taken from @Ludeeus's integration_blueprint template.