Skip to content

SebastianHanz/ioBroker.fronius-wattpilot

 
 

Repository files navigation

Logo

ioBroker.fronius-wattpilot

NPM version Downloads Number of Installations Current version in stable repository Dependency Status

NPM

Tests: Test and Release

Barebones implementation of the unofficial Fronius Watt pilot (https://www.fronius.com/de-ch/switzerland/solarenergie/installateure-partner/technische-daten/alle-produkte/l%C3%B6sungen/fronius-wattpilot) API. Based on https://github.com/joscha82/wattpilot.

How to install:

I don't take the responsibility for your device. With this API you can access the device directly, be careful.

Requirements

  • Finish your normal installation of the Fronius Watt pilot app. Remember the Password!
  • Go to the Internet tab and connect your Pilot to your Wi-Fi.
  • Find out the IP-Adress of your WattPilot.
    • Option 1: Via your Router's Web-GUI.
    • Option 2: Via Wattpilot App: After the connection established click on the Wi-Fi name.
      You will see a page with more information about your Wi-Fi connection. Note the IP address down.

iobroker.fronuis-wattpilot Adapter

  • Option 1: Install via expert menu directly in ioBroker:

  • Option 2: Install via NPM:

    • cd into your ioBroker-directory (e.g /opt/iobroker)
    • install with command: npm i iobroker.fronius-wattpilot

    Now you can regularly install an instance of iobroker.fronius-wattpilot via the "Adapters"-page.

After you created the instance, you will be prompted to insert IP-Address and password of your WattPilot. Fill in the values you noticed before and save the config. If you have done everything correctly the adapter will turn green after a while and you can see the incoming data in the objects tab.

It is highly recommended to assign a static-IP to your WattPilot.

How can I use the adapter...

You can use the datapoints of this adapter like every other datapoint in your broker.

To get some ideas see "examples".

There is a Blockly-example how you can measure your Solar Grid output and automatically adjusts the Pilot to the right current value (Amp) to improve your internal energy consumption.
You can simply import it by copying the content of the example and insert it via the "Import blocks"-icon in the upper right corner of your Blockly-script.

What does the adapter?

The adapter connects to the WattPilots WebSocket and separates incoming data into ioBroker-datapoints you can use quite comfortable.

Get states

By default, the adapter only writes the key points of the Wattpilot. If you want all the possible values the API can deliver, uncheck the checkbox in the instance-settings.
A documentation of the Datapoints is available here: https://github.com/joscha82/wattpilot/blob/main/API.md (Thanks to joscha82)

Set states?

Yes, just write the state name followed by a semicolon and then the value in the set_state state.
For example:

amp;6

You can control the "amp" and the "lmo" state directly via the set_power and the set_mode states.

What does this mess mean?

Thanks to joscha82 we know: https://github.com/joscha82/wattpilot/blob/main/API.md

Developers

Changelog

3.0.0 (2022-09-04)

  • Updated README.md
  • Created "examples"-directory for sample applications
  • Added some translations
  • Renamed checkbox "Parser" to something more intuitive
  • Fixxed #4: Datapoint "map" now gets created correctly
  • Fixxed #5: Password-characters are no longer visible
  • Fixxed type conflict of cableType

2.2.4 (2022-09-01)

  • SebastianHanz fixed infinite RAM-usage
  • added some description

2.2.3 (2022-08-30)

  • SebastianHanz fixed type-conflicts. Thank you!

2.2.2 (2022-08-25)

  • Bug fixes

2.2.1 (2022-08-22)

  • Bug fixes

2.2.0 (2022-08-21)

  • Fixed Bugs

2.1.0 (2022-08-19)

  • Min Node Version 16

2.0.3 (2022-07-20)

  • Updated Readme

2.0.2 (2022-07-12)

  • Bug fixed

2.0.1 (2022-07-10)

  • Added a how to install. Not to detail because currently not in stable repo.

2.0.0 (2022-07-10)

  • Fixed NPM Versions hopefully

1.1.0 (2022-07-10)

  • Added UselessPV and TimeStamp Parser, did some testing.

1.0.1 (2022-06-02)

  • Tests

1.0.0 (2022-06-02)

  • Did some changes
  • Did some more changes

v0.0.5 (2020-01-01)

  • Better Code

v0.0.4 (2020-01-01)

  • Parser option added

v0.0.3 (2020-01-01)

  • Parser added

v0.0.2 (2020-01-01)

  • Bug fixed

v0.0.1 (2020-01-01)

  • Initial release

License

MIT License

Copyright (c) 2022 tim2zg [email protected]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

About

A ioBroker Fronius Wattpilot adapter

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 90.6%
  • HTML 7.7%
  • CSS 1.7%