ha-checkwatt

KO | EN

gitlite — search

#hacktoberfest #ai #llm #golang #go #android #rust #deep-learning #linux #docker #macos #java #cli #ios

(★ 16)

Home Assistant CheckWatt Integration

ha-checkwatt 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Home Assistant CheckWatt Custom Integration
This integration uses cloud polling from the CheckWatt EnergyInbalance portal using a reverse engineered private API.

The strategy for this integration is to reduce the amount of sensors published while at the same time maximize the information available and provide them as attributes.

The integration also aims to balance the user needs for information with loads on CheckWatts servers why some data may not always be up-to date.

Out-of-the box, this integration provides two sensors:
- CheckWatt Daily Net Income : Your estimated net income today
- CheckWatt Annual Net Income : Your estimated annual net income
- Battery State of Charge: Your batterys state of charge

The Daily Net Income sensor also have an attribute that provides information about tomorrows estimated Net Income.

![checkwatt main](https://raw.githubusercontent.com/faanskit/ha-checkwatt/master/images/ha_main.png)

# Known Issues and Limitations
1. The integration uses undocumented API's used by the EnergyInBalance portal. These can change at any time and render this integration useless without any prior notice.
2. The monetary information from EnergyInBalance is always provisional and can change before you receive your invoice from CheckWatt.
3. The annual yeild sensor includes today's and tomorrow's estimated net income.
4. CheckWatt EnergyInBalance does not (always) provide Grid In/Out information. Why it is recommended to use other data sources for your Energy Panel.
5. The FCR-D state and status is pulled from a logbook parameter within the API and is a very fragile piece of information. Use with care.
6. The integration will update the Energy sensors once per minute, the Daily Net Income sensor once every fifteenth minute and the Annual Net Income around 2 am every morning. This to not put too much stress on the CheckWatt servers (the net income operation is slow resource heavy)

# Installation
### HACS installation
[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=faanskit&repository=ha-checkwatt&category=integration)

### Git installation
1. Make sure you have git installed on your machine.
2. Navigate to you home assistant configuration folder.
3. Create a `custom_components` folder of it does not exist, navigate down into it after creation.
4. Execute the following command: `git clone https://github.com/faanskit/ha-checkwatt.git checkwatt`
5. Restart Home-Assistant.

## Enable the integration
Go to Settings / Devices & Services / Integrations. Click **+ ADD INTEGRATION**

Find CheckWatt from the list of available brands:

![checkwatt config step 1](https://raw.githubusercontent.com/faanskit/ha-checkwatt/master/images/configure_step_1.png)

Enter your EnergyInBalance credentials and press **SUBMIT**:

Take note that Home Assistant will store your credentials and if this is a security concern for you, abort at this stage.

![checkwatt config step 2](https://raw.githubusercontent.com/faanskit/ha-checkwatt/master/images/configure_step_2.png)

The integration will now install and assuming it all went well you will get a success message and the possibility to add its sensors to an area of your choice.

![checkwatt config step 3](https://raw.githubusercontent.com/faanskit/ha-checkwatt/master/images/configure_step_3.png)

On your Overview you will now have two new sensors in a new group:

![checkwatt config done](https://raw.githubusercontent.com/faanskit/ha-checkwatt/master/images/configure_done.png)

These sensors will show you your estimated daily and annual net income alongside with some basic attributes like Street Address, Zip Code and City.

The Daily Net Income sensor will also show tomorrows estimated net income as an attribute.

![checkwatt basic daily](https://raw.githubusercontent.com/faanskit/ha-checkwatt/master/images/basic_sensor_daily.png)
![checkwatt basic annual](https://raw.githubusercontent.com/faanskit/ha-checkwatt/master/images/basic_sensor_annual.png)

## Configuration
The integration provides basic sensors for most peoples needs. The integration can also be a one-stop-shop for the Home Assistant Energy panel and can therefore be configured to also fetch all required data for that from EnergyInBalance.

For those who need additional information, detailed attributes can be provided by configuring the integration accordingly. Through the detailed sensors you can get gross revenue, fees, fee rates, FCR-D status and much more.

If you need more sensor and more detailed attributes in the sensors,  configure the integration as follows.

Go to Settings / Devices & Services / CheckWatt. Click **CONFIGURE**:

![checkwatt options step 1](https://raw.githubusercontent.com/faanskit/ha-checkwatt/master/images/options_step_1.png)

Select if you want the integration to provide energy sensors and if detailed attributes shall be provided.

Press **SUBMIT** and the configurations will be stored:

![checkwatt options step 2](https://raw.githubusercontent.com/faanskit/ha-checkwatt/master/images/options_step_2.png)

After the configuration is done you need to restart the integration. Click **...** and select **Reload**
![checkwatt options step 3](https://raw.githubusercontent.com/faanskit/ha-checkwatt/master/images/options_step_3.png)

After the system as reload you will have 1 device and 9 sensors available.
![checkwatt options done](https://raw.githubusercontent.com/faanskit/ha-checkwatt/master/images/options_done.png)

Your sensors will now also contain a lot of detailed attributes.
![checkwatt detailed daily](https://raw.githubusercontent.com/faanskit/ha-checkwatt/master/images/detailed_sensor_daily.png)
![checkwatt detailed annual](https://raw.githubusercontent.com/faanskit/ha-checkwatt/master/images/detailed_sensor_annual.png)

## Setting up Energy Panel
With the energy sensors provided by the integration, it is possible to configure the Home Assistant Energy Panel. The Energy panel is available on the left-hand menu of Home Assistant by default.

When you enter the energy panel the first time you will be guided by a Wizard:

![checkwatt energy step 1](https://raw.githubusercontent.com/faanskit/ha-checkwatt/master/images/energy_step_1.png)

For the Grid Consumption, select the Import Energy sensor from the integration and complement it with the cost tracker using the *Spot Price VAT* sensors.

**Take note** that you should use the sensor that includes VAT for Electricity that you purchase. Please **also note** that this sensor does not include markups from your electricity provider.

![checkwatt energy step 2](https://raw.githubusercontent.com/faanskit/ha-checkwatt/master/images/energy_step_2.png)

For Grid Consumption, select the Export Energy sensor from the integration and complement it with the cost tracker using the *Spot Price* sensors.

**Take note** that you should use the sensor that excludes VAT for Electricity that you sell.

![checkwatt energy step 3](https://raw.githubusercontent.com/faanskit/ha-checkwatt/master/images/energy_step_3.png)

When configured, it looks like this. Press **SAVE + NEXT** to continue the Wizard.

![checkwatt energy step 4](https://raw.githubusercontent.com/faanskit/ha-checkwatt/master/images/energy_step_4.png)

Add the Solar Energy sensor from the integration and press **SAVE + NEXT**

![checkwatt energy step 5](https://raw.githubusercontent.com/faanskit/ha-checkwatt/master/images/energy_step_5.png)

Add the Battery Energy sensors from the integration.
*Energy going in to the battery* = Battery Charging Energy Sensor
*Energy going out of the battery* = Battery Discharging Energy Sensor

Press **SAVE + NEXT**

![checkwatt energy step 6](https://raw.githubusercontent.com/faanskit/ha-checkwatt/master/images/energy_step_6.png)

Finish off the Wizard and the result will look like this.
Please be advised that it will take a few hours before the Energy Panels start showing data.

Also, currently EnergyInBalance does not always provide proper Grid Input and Output why this data cannot be relied upon.

For now, you need to pull that data from another integration.

![checkwatt energy done](https://raw.githubusercontent.com/faanskit/ha-checkwatt/master/images/energy_done.png)

## Final result
When the system is fully set-up it you have sensors that provides you with your daily and annual net income and if you have configured it accordingly, you also have sensors available for the Home Assistant Energy Dashboard.

The final result can look like this:

![checkwatt main](https://raw.githubusercontent.com/faanskit/ha-checkwatt/master/images/ha_main.png)

## Events
The integration publish [events](https://www.home-assistant.io/integrations/event/) which can be be used to drive automations.

Below is a sample of an automation that acts when CheckWatt fails to engage your battery and deactivates it.

```yaml
alias: Deactivated
description: ""
trigger:
  - platform: state
    entity_id:
      - event.skarfva_fcr_d_state
    attribute: event_type
    from: fcrd_activated
    to: fcrd_deactivated
condition: []
action:
  - service: notify.faanskit
    data:
      message: "CheckWatt failed, please investigate."
mode: single
```

# Expert Section
If you think that some of the attributes provided should be sensors, please consider to use [Templates](https://www.home-assistant.io/docs/configuration/templating/) before you register it as an [issue](https://github.com/faanskit/ha-checkwatt/issues). If it can be done via a Template Sensor, it will most likely be rejected.

## Use templates
This is an example of a Template based Sensor that pulls tomorrows estimated daily net income from the attribute of the CheckWatt Daily Net Income sensor.

It goes without saying, but this should be put in your `configuration.yaml`:
```yaml
template:
  - sensor:
      - name: "CheckWatt Tomorrow Net Income"
        unique_id: checkwatt_tomorrow_yield
        state: "{{ state_attr('sensor.skarfva_checkwatt_daily_yield', 'tomorrow_gross_income')}}"
        unit_of_measurement: "SEK"
        device_class: "monetary"
        state_class: total
```
The result will look something like this:

![template based sensor](https://raw.githubusercontent.com/faanskit/ha-checkwatt/master/images/expert_sensor.png)

## Use developer tools
The names of the attributes can be found in the Home Assistant Developer Tools section in your Home Assistant environment under the **STATES** sheet:

![home assistant developer tools](https://raw.githubusercontent.com/faanskit/ha-checkwatt/master/images/dev_tools_states.png)

# Acknowledgements
This integration was loosely based on the [ha-esolar](https://github.com/faanskit/ha-esolar) integration.
It was developed by [@faanskit](https://github.com/faanskit) with support from:

- [@flopp999](https://github.com/flopp999)
- [@angoyd](https://github.com/angoyd)

This integration could not have been made without the excellent work done by the Home Assistant team.

If you like what have been done here and want to help I would recommend that you firstly look into supporting Home Assistant.

You can do this by purchasing some swag from their [store](https://home-assistant-store.creator-spring.com/) or paying for a Nabu Casa subscription. None of this could happen without them.

# Licenses
The integration is provided as-is without any warranties and published under [The MIT License](https://opensource.org/license/mit/).

ha-checkwatt

ha-checkwatt 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

ha-checkwatt

ha-checkwatt 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README