drc38 / Fronius_solarweb

Home Assistant integration for cloud-based Fronius Solar.web api
MIT License
5 stars 5 forks source link
fronius fronius-solar-api hacs-integration home-assistant

Fronius Solar.Web Home Assistant integration

coverage badge GitHub Release License

hacs Project Maintenance hacs_downloads

Discord Community Forum

Standalone Home Assistant integration using the Fronius Solar.web API. It is intended for use when your Fronius is on a different network to HA, otherwise you are best to use the built-in integration which will have more sensors and a faster refresh rate.

Installation

HACS

HACS is recommended as it provides automated install and will notify you when updates are available.

This assumes you have HACS installed and know how to use it. If you need help with this, go to the HACS project documentation.

Add custom repository in HACS

  1. Click on HACS in your menu to open the HACS panel, then click on integrations (https://your.domain/hacs/integrations).
  2. Click on the 3 dots in the top right corner.
  3. Select "Custom repositories"
  4. Add the URL to the repository: https://github.com/drc38/Fronius_solarweb
  5. Select the integration category.
  6. Click the "ADD" button.

Once done, you should see the new repository, appearing in a list like this. Click the Download button

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 solarweb.
  4. Download all the files from the custom_components/solarweb/ 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 "Integrations" click "+" and search for "solarweb"

Configuration

Configuration of the integration is done within the Integrations Panel in Home Assistant.

  1. Navigate to Integrations
  2. Click Add Integration
  3. Search for Fronius Solar.Web
  4. Enter your PV System ID and API details from your Solar.Web account *note that you need to contact Fronius support to obtain these details and they may not provide them as it's intended for commercial installers only.

If you have an issue ensure the api is working at official test site

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