GithubHelp home page GithubHelp logo

olibos / home-assistant-fusionsolar-kiosk Goto Github PK

View Code? Open in Web Editor NEW

This project forked from tijsverkoyen/home-assistant-fusionsolar-kiosk

0.0 0.0 0.0 29 KB

Integrate FusionSolar into your Home Assistant.

License: MIT License

Python 100.00%

home-assistant-fusionsolar-kiosk's Introduction

Home Assistant FusionSolar Integration

hacs_badge

Integrate FusionSolar into you Home Assistant.

FusionSolar has a kiosk mode. When this kiosk mode is enabled we can access data about our plants through a JSON REST api.

{% if installed %} {% if version_installed.replace("v", "").replace(".","") | int < 300 %}

Breaking Changes

Use the full kiosk url (since v3.0.0)

Your current configuration should be updated. Before v3.0.0 we used the kiosk id. Starting with v3.0.0 the full kiosk url should be used:

sensor:
  - platform: fusion_solar_kiosk
    kiosks:
      - url: "REPLACE THIS WITH THE KIOSK URL"
        name: "A readable name for the plant"

See the "Configuration" section for more details {% endif %} {% endif %}

Remark

In kiosk mode the "realtime" data is not really realtime, it is cached at FusionSolars end for 30 minutes.

If you need more accurate information you can use Home Assistant FusionSolar OpenAPI Integration by @olibos. This integration requires an OpenAPI account.

Installation

At this point the integration is not part of the default HACS repositories, so you will need to add this repository as a custom repository in HACS.

When this is done, just install the repository.

Configuration

The configuration of this integration happens in a few steps:

Enable kiosk mode

  1. Sign in on the Huawei FusionSolar portal: https://eu5.fusionsolar.huawei.com/.
  2. Select your plant if needed.
  3. At the top there is a button: "Kiosk", click it.
  4. An overlay will open, and you need to enable the kiosk view by enabling the toggle.
  5. Note down the url that is shown.

Add into configuration

Open your configuration.yaml, add the code below:

sensor:
  - platform: fusion_solar_kiosk
    kiosks:
      - url: "REPLACE THIS WITH THE KIOSK URL"
        name: "A readable name for the plant"

Use secrets

I strongly advise to store the unique urls as a secret. The kiosk url is public, so anybody with the link can access your data. Be careful when sharing this.

More information on secrets: Storing secrets.

Multiple plants

You can configure multiple plants:

sensor:
  - platform: fusion_solar_kiosk
    kiosks:
        - url: "KIOSK URL XXXXX"
          name: "A readable name for plant XXXXX"
        - url: "KIOSK URL YYYYY"
          name: "A readable name for plant YYYYY"

home-assistant-fusionsolar-kiosk's People

Contributors

olibos avatar tijsverkoyen avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.