696GrocuttT / ha-myenergi

Home Assistant integration for MyEnergi devices

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

myenergi for Home Assistant

GitHub Release GitHub Activity License

pre-commit Black

hacs Project Maintenance BuyMeCoffee

Discord Community Forum

myenergi custom component for Home Assistant. This component will make all myenergi devices connected to your 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)
    • Genertion power sensor (W)
    • Charging/heating power sensor (W)
    • Home power today sensor (W), 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 that let you switch between Stopped, Fast, Eco and Eco+ charge modes
    • 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
    • Charger status sensor
    • Minumum green level number input
    • Service to start boost (provide boost amount in kWh as paramter)
    • Service to start smart boost (provide boost amount in kWh and desired finished time as paramters)
  • Eddi

    • Power sensors for internal and external CT clamps (W)
    • Temperature sensors if fitted
  • Harvi

    • Power sensors for internal and external CT clamps (W)

Talking 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

example

HACS Installation

This is the recommended way to install.

  1. Search for myenergi in HACS.
  2. Install.
  3. Restart Home Assistant.
  4. In the HA UI go to "Configuration" -> "Integrations" click "+" and thensearch for "myenergi".

Manual Installation

  1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
  2. If you do not have a custom_components directory (folder) there, you need to create it.
  3. In the custom_components directory (folder) create a new folder called myenergi.
  4. Download all the files from the custom_components/myenergi/ directory (folder) in this repository.
  5. Place the files you downloaded in the new directory (folder) you created.
  6. Restart Home Assistant.
  7. In the HA UI go to "Configuration" -> "Integrations" click "+" 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

Configuration is done in the UI

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.

Contributions are welcome!

If you want to contribute to this please read the Contribution guidelines.

Credits

This project was generated from @oncleben31's Home Assistant Custom Component Cookiecutter template.

Code template was mainly taken from @Ludeeus's integration_blueprint template.


About

Home Assistant integration for MyEnergi devices

License:MIT License


Languages

Language:Python 100.0%