Skip to content

Latest commit

 

History

History
272 lines (178 loc) · 11.8 KB

README.md

File metadata and controls

272 lines (178 loc) · 11.8 KB

Logo

ioBroker.solax

NPM version Downloads Number of Installations (latest) Number of Installations (stable) Known Vulnerabilities Test and Release

License Donate


If you like it, please consider a donation:

paypal


Solax Adapter for ioBroker


Deutsche Dokumentation

Solax Cloud-Verbindung

Solax Wechselrichter API-Cloud-Verbindung

Dieser Adapter ruft die Daten deines Wechselrichters vom Hersteller Solax für iobroker ab.

Was dazu benötigt wird, ist ein Konto bei Solax, eine Token-ID und die Seriennummer des Pocket Wifi oder LAN Sticks.

API-Token

Seriennummer

Experteneinstellungen

Die lokale Verbindung wird aktuell nur von dem Pocket Wifi Sticks unterstützt. LAN-Sticks können nur im Cloud-Modus betrieben werden.

Achtung, wer in den Experteneinstellungen den lokalen Modus aktiviert sollte im Vorfeld zwingend die aktuelle Firmwareversion seines Pocket Wifi Sticks prüfen. Eine Firmware Version größer 2.30.20 (Wifi-Pocket V1/V2) und kleiner als 3.001 (Wifi-Pocket V3) darf der Stick nicht installiert haben, da Solax in höheren Versionen den lokalen Zugriff blockiert und es zu einem Absturz des Wifi Sticks führt.

Wie man die Firmware Version prüfen kann und ein Downgrade auf die korrekte Version hinbekommt, wird hier erklärt.

Um die Firmware auf dem Stick zu prüfen, müsst ihr euch mit dem Hotspot des Sticks verbinden. Der Name des Hotspots sollte bei euch wie folgt aussehen: Solax_SWXXXXXXXX oder Wifi_SWXXXXXXXX. XXXXXXXX wird durch eure Seriennummer ersetzt.

Wenn ihr mit dem Hotspot verbunden seit, dann geht ihr mit folgender IP-Adresse in euren Browser auf das Webinterface des Wifi-Sticks: 5.8.8.8
Solltet ihr euer Passwort bei der Ersteinrichtung nicht geändert haben, sind die Standard Login-Daten admin:admin

Im Webinterface geht ihr auf den Tab "System" und findet dort die aktuell installierte Firmware-Version.
Sollte die Version größer 2.033.20 (Wifi-Pocket V1/V2) und kleiner 3.001 (Wifi-Pocket V3) sein, könnt ihr im gleichen Tab über den Menüpunkt "Update Firmware (.usb)" die korrekte Version flashen.

Die Version 2.033.20 könnt ihr euch unter folgenden Link herunterladen:

Download Pocket Wifi Firmware

Die Zip-Datei muss entpackt werden und es muss die Datei mit der Endung ".usb" ausgewählt werden.
Nun könnt Ihr den Downgrade starten und werdet nach ca. 20-30 Sekunden eine Meldung bekommen, dass das Update erfolgreich war und der Stick neu gestartet wird.

Nach erfolgreichen Neustart könnt ihr nun über den Hotspot mit der IP-Adresse 5.8.8.8 oder auch über eure lokale IP in eurem Netzwerk auf den Wifi-Stick zugreifen.

Prüft bitte vor einer Verbindung zu dem Adapter noch einmal, ob der Downgrade erfolgreich war und die korrekte Firmware installiert ist. Der Stick aktualisiert die Firmware nicht automatisch und ist mit der Version 2.033.20 voll funktionsfähig.

Im Adapter müssen die lokale IP-Adresse (nicht die Hotspot IP) und das Passwort des Webinterfaces eingetragen werden, und ihr habt nun eine sekundengenaue lokale Analyse eures Wechselrichters


English documentation

Solax Cloud Connection

Solax Inverter API Cloud Connection

This adapter calls the data of your inverter from the manufacturer Solax into the iobroker.

What you need for this is an account with Solax, your token ID and the serial number of your WiFi module.

API-Token

serial number

Expert settings

The local connection is currently only supported by the Pocket Wifi Sticks. LAN sticks can only be operated in cloud mode.

Attention, if you activate the local mode in the expert settings, you should check the current firmware version of your Pocket Wifi Stick in advance.
The stick must not have a firmware version greater than 2.30.20 (Wifi-Pocket V1/V2) and smaler than 3.001 (Wifi-Pocket V3) installed, since Solax blocks local access in higher versions and causes the Wifi stick to crash.

How to check the firmware version and how to downgrade to the correct version is explained here.

To check the firmware on the stick, you have to connect to the stick's hotspot. Your hotspot name should look like this: Solax_SWXXXXXXXX or Wifi_SWXXXXXXXX. XXXXXXXX will be replaced with your serial number.

If you are connected to the hotspot, go to the web interface of the Wifi stick in your browser with the following IP address: 5.8.8.8
If you did not change your password during the initial setup, the default login data is admin:admin

In the web interface you go to the "System" tab and you will find the currently installed firmware version there.
If the version is greater than 2.033.20 (Wifi-Pocket V1/V2) and smaler than 3.001 (Wifi-Pocket V3), you can flash the correct version in the same tab via the "Update Firmware (.usb)" menu item.

You can download version 2.033.20 from the following link:

Download Pocket Wifi Firmware

The zip file must be unpacked and the file with the ".usb" extension must be selected.
Now you can start the downgrade and after about 20-30 seconds you will get a message that the update was successful and the stick will be restarted.

After a successful restart, you can now access the WiFi stick via the hotspot with the IP address 5.8.8.8 or via your local IP in your network.

Before connecting to the adapter, please check again whether the downgrade was successful and the correct firmware is installed. Fortunately the stick does not perform an automatic firmware upgrade and is fully functional with version 2.033.20.

The local IP address (not the hotspot IP) and the password of the web interface must be entered in the adapter and you now have a local analysis of your inverter that is accurate to the second


What is Sentry.io and what is reported to the servers of that company?

Sentry.io is a service for developers to get an overview about errors from their applications. And exactly this is implemented in this adapter.

When the adapter crashes or an other Code error happens, this error message that also appears in the ioBroker log is submitted to Sentry. When you allowed iobroker GmbH to collect diagnostic data then also your installation ID (this is just a unique ID without any additional infos about you, email, name or such) is included. This allows Sentry to group errors and show how many unique users are affected by such an error. All of this helps me to provide error free adapters that basically never crashs.


Changelog

0.5.7 (2022-11-01)

  • (simatec) Dependencies updated

0.5.6 (2022-09-21)

  • (simatec) local mode for X1 boost added

0.5.5 (2022-09-21)

  • (simatec) small Bugfixes

0.5.4 (2022-09-20)

  • (simatec) small Bugfixes

0.5.3 (2022-09-20)

  • (simatec) Hybrid-G4 added
  • (simatec) small Bugfixes
  • (simatec) appveyor test removed
  • (simatec) travis test removed

0.5.1 (2022-09-13)

  • (simatec) feedin added

0.5.0 (2022-09-12)

  • (simatec) Dependencies updated
  • (simatec) small Bugfixes
  • (clausmuus) Add support for firmware version 3.001

0.4.6 (2022-04-11)

  • (simatec) Fix states

0.4.5 (2022-04-04)

  • (simatec) Dependencies updated
  • (simatec) small Bugfixes

0.4.4 (2022-03-14)

  • (simatec) Dependencies updated
  • (simatec) battery data for local request added
  • (simatec) night mode turn on/off added

0.4.3 (2022-02-03)

  • (simatec) refactoring Sourcecode
  • (simatec) Dependencies updated
  • (simatec) Fix API Request

0.4.2 (2022-01-27)

  • (simatec) Fix json state

0.4.1 (2022-01-26)

  • (simatec) Fix react Translatation

0.4.0 (2022-01-25)

  • (simatec) local request for Wifi Pocket Stick added
  • (simatec) Dependencies updated
  • (simatec) test and release updated
  • (simatec) Number of days of history data added
  • (simatec) Expert-Mode added
  • (simatec) Docu updated
  • (simatec) Bugfixes

0.3.7 (2021-11-17)

  • (simatec) Dependencies updated
  • (simatec) test and release updated

0.3.6 (2021-08-04)

  • (simatec) deps fixed

0.3.5 (31.07.2021)

  • (simatec) await/async functions fixed

0.3.4 (30.07.2021)

  • (simatec) code cleanig
  • (simatec) await functions fixed

0.3.3 (29.07.2021)

  • (simatec) Formatted objects
  • (simatec) await functions fixed
  • (simatec) query interval changed
  • (simatec) Dependencies updated

0.3.2 (28.07.2021)

  • (simatec) fix for latest repo

0.3.1 (11.06.2021)

  • (simatec) fix for latest repo
  • (simatec) API-Token encrypted

0.3.0 (09.06.2021)

  • (simatec) state settings changed
  • (simatec) sentry plugin added
  • (simatec) readme added
  • (simatec) sunposition added
  • (simatec) nightmode added

0.2.0 (07.06.2021)

  • (simatec) powerdc 1-4 added
  • (simatec) battPower added
  • (simatec) many small bugfixes

0.1.1 (02.06.2021)

  • (simatec) small Bugfixes

0.1.0 (02.06.2021)

  • (simatec) first beta

License

MIT License

Copyright (c) 2021 - 2022 simatec

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.