Skip to content

Latest commit

 

History

History
179 lines (115 loc) · 5.57 KB

README.md

File metadata and controls

179 lines (115 loc) · 5.57 KB
Raw

Logo

NPM version [Known vulnerabilities]

This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers. For more details and for information how to disable the error reporting see Sentry-Plugin Documentation!

soliscloud adapter for IOBroker

This integration is based on this home-assistant integration: https://github.com/hultenvp/solis-sensor

The steps to get the needed data to use the integration are as following:

Create a ticket with ginlong to request enabling API access on your account and wait untill they confirm the change You can find the contact information for your region here: https://www.solisinverters.com/global/contactus.html

  • Go to https://www.soliscloud.com/#/apiManage.
  • Activate API management and agree with the usage conditions.
  • After activation, click on view key tot get a pop-up window asking for the verification code.
  • First click on "Verification code" after which you get an image with 2 puzzle pieces, which you need to overlap each other using the slider below.
  • After that, you will receive an email with the verification code you need to enter (within 60 seconds).
  • Once confirmed, you get the API ID, secret and API URL
  • The plant ID you need to enter in the settings is the ID found in the url once you are logged in. For example: soliscloud.com/#/station/stationdetail_1?id=123486816843454864

This adapter will read multiple values available from the soliscloud API and store them for use in ioBroker. To request additional values, you can either:

The API returns other values that can be added, but at the moment these are sufficient for my needs.

Current state

This adapter is still very new, but tested and seemingly stable. I'm not a professional developer. Use at your own risk.

Buy Me a Coffee

Changelog

1.4.2 (2024-01-24)

  • Adjustment in logging.

1.4.1 (2024-01-21)

  • Removed test code that logged (lots of) errors.

1.4.0 (2024-01-11)

  • Switched to ioBrokers sentry plugin instead of own implementation.
  • Removed setting for own implementation of Sentry.
  • All informational logging can now be turned off in settings.

1.3.5 (2023-12-28)

  • Added option to send stacktraces
  • improved errorhandling

1.3.4 (2023-12-27)

  • Allow for EPM debug logging to be turned off.

1.3.3 (2023-12-27)

  • Added settings to test EPM API Call. Result is logged, not processed at the moment.

1.3.1 (2023-11-10)

  • Plant_state wasn't processed correctly

1.3.0 (2023-11-02)

  • Added more values

1.2.5 (2023-11-01)

  • attempt 2 to fix values

1.2.4 (2023-11-01)

  • 2 values weren't updated correctly

1.2.3 (2023-11-01)

  • Typo in main which caused application crashes

1.2.2 (2023-11-01)

  • Typo in main which caused application crashes

1.2.1 (2023-11-01)

  • added ack to value updates.

1.2.0 (2023-11-01)

  • Adjusted processing of inverter API call.
  • Fixed logging for API calls
  • improved error handling
  • write attribute set to false for all objects.

1.1.6 (2023-31-10)

  • Added new values: from the Power Station List: batteryTodayDischargeEnergy batteryTodayChargeEnergy homeLoadTodayEnergy state oneSelf

    from the Inverter List: eToday etodayStr state

1.1.5 (2023-30-10)

  • Updated minimum node version.
  • Limited input to numerical values only for the plantID.
  • removed some unneeded settings.
  • updated translations.

1.1.4 (2023-24-10)

  • Fixed issues with translations.

1.1.3 (2023-15-10)

1.0.3 (2023-15-10)

  • Removed console logging
  • Removed unused onStateChange handler
  • Adjusted state-id naming
  • Added units to values
  • Added plant ID as root folder for objects

1.0.2 (2023-11-10)

  • Translations
  • Removed some unneeded files.

1.0.1 (2023-10-09)

  • Fixed issue where pollinterval wasn't checked/used

1.0.0 (2023-10-09)

  • Split api logic in separate files
  • various updates to comply with publishing rules
  • Initial release!

License

MIT License

"Copyright (c) 2024 Trixx [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.