https://github.com/magico13/ha-emporia-vue

Home Assistant Integration for Emporia Vue Energy Monitor
https://github.com/magico13/ha-emporia-vue

custom-integration home-assistant home-assistant-integration homeassistant homeassistant-integration python

Last synced: 3 days ago
JSON representation

Home Assistant Integration for Emporia Vue Energy Monitor

• Host: GitHub
• URL: https://github.com/magico13/ha-emporia-vue
• Owner: magico13
• License: mit
• Created: 2020-03-14T22:21:29.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-09-20T00:40:11.000Z (7 days ago)
• Last Synced: 2024-09-20T12:57:34.483Z (7 days ago)
• Topics: custom-integration, home-assistant, home-assistant-integration, homeassistant, homeassistant-integration, python
• Language: Python
• Homepage:
• Size: 174 KB
• Stars: 475
• Watchers: 40
• Forks: 64
• Open Issues: 148
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# emporia_vue Home Assistant Integration

Reads data from the Emporia Vue energy monitor. Creates a sensor for each device channel showing average usage over each minute.

Note: This project is not associated with or endorsed by Emporia Energy.

Data is pulled from the Emporia API using the [PyEmVue python module](https://github.com/magico13/PyEmVue), also written by me.

![ha_example](images/ha_example.png)

## Installation with HACS

[![hacs_badge](https://img.shields.io/badge/HACS-Custom-orange.svg?style=for-the-badge)](https://github.com/custom-components/hacs)

The simplest way to install this integration is with the Home Assistant Community Store (HACS). This is not (yet) part of the default store and will need to be added as a custom repository.

Setting up a custom repository is done by:

1. Go into HACS from the side bar.

2. Click into Integrations.

3. Click the 3-dot menu in the top right and select `Custom repositories`

4. In the UI that opens, copy and paste the [url for this github repo](https://github.com/magico13/ha-emporia-vue) into the `Add custom repository URL` field.

5. Set the category to `Integration`.

6. Click the `Add` button. Further configuration is done within the Integrations configuration in Home Assistant. You may need to restart home assistant and clear your browser cache before it appears, try ctrl+shift+r if you don't see it in the configuration list.

![hacs1](images/hacs1.PNG)

![hacs2](images/hacs2.PNG)

![hacs3](images/hacs3.PNG)

![hacs4](images/hacs4.PNG)

## Manual Installation

If you don't want to use HACS or just prefer manual installs, you can install this like any other custom component. Just merge the `custom_components` folder with the one in your Home Assistant config folder and you may need to manually install the PyEmVue library.

## Configuration

Configuration is done directly in the Home Assistant UI, no manual config file editing is required.

1. Go into the Home Assistant `Configuration`

2. Select `Integrations`

3. Click the `+` button at the bottom

4. Search for "Emporia Vue" and add it. If you do not see it in the list, ensure that you have installed the integration.

5. In the UI that opens, enter the email and password used for the Emporia App.

6. Done! You should now have a sensor for each "channel".

### Sensor Naming

Sensors are automatically named based on the information gotten from the Emporia API. They should be in the form `Power {Device_Name} {Channel_Id}` where the `Device_Name` is the name set in the Emporia app for the device and `Channel_Id` is the id of each sensor attached to the main Vue device. The Vue device itself has the channel id `1,2,3` indicating the three phase support built into the device. The sensor name can be changed in Home Assistant. Example: `Power Home 1,2,3`

The Entity ID for each sensor is similar to the name but cannot be changed. The Entity ID uses the internal id of the device rather than the name since the id cannot change but the name can, ie `sensor.power_{Device_Id}_{Channel_Id}`. Example: `sensor.power_7576_123`