github thomluther/anker-solix-api v2.0.0

latest releases: v3.8.0, v3.7.0, v3.6.3...
2 years ago

Enhancements:

  • Support for Solarbank 2 devices #101 #104 #105 #114 #115
    • Add all new fields available via cloud api to the device cache
    • Query and add new schedule format for Solarbank 2 #108 #109
    • Query and add new energy statistic types to systems cache
  • Support new Solarbank 2 schedules #108 #109
    • New helper method added to modify the usage mode within the schedule structure
    • Other changes in the SB2 schedule structure are not supported yet. They will be added in a future release
  • Support for Smart Meter devices #101 #106 #112
    • Add all new fields available via cloud api to the device cache
  • Support for flagging invalid data responses from cloud api #114
    • The cloud may report 0 W values for Solarbank 2 power systems since the send the data to the cloud only every 5 minutes
    • When the cloud marks the data as obsolete (after 60 seconds), the response has a field that returned data should not be displayed
    • This field is considered whether it is an invalid data response
    • Note: Around 25.07.2024 there was a change on the cloud to no longer provide invalid data responses. The response will contain the last known data from the device. This however does not change the data update frequency, it only prevents returning invalid data to request
  • Support for energy statistics export and import from files #111
    • Daily energy data can now use energy export files for debugging purposes
  • Enhanced export_system.py: #102 #111 #115
  • Support additional queries required for Solarbank 2 systems
  • Support additional queries to export energy statistics into files
  • Added examples with Solarbank 2 system exports
  • Enhanced solarbank_monitor.py: #111 #115
    • Support for Smart Meter and Solarbank 2 devices
    • Support for optional energy statistic display
    • More capabilities to report from system export files for debugging purposes
  • Enhanced energy_csv.py: #101 #111 #115
    • Support for additional energy statistic types introduced for Solarbank 2 and Smart Meter
  • Updated README

Fixes:

  • Optimized the schedule update sequence to limit the number of required requests to 2 per update
    • A schedule update will now also update other fields in the sites and devices cache which indicate effective settings
    • This was done to allow a change in the schedule to update other fields that are typically just updated during a site refresh to avoid delays until the new effective values are reflected properly in the cache
  • Removed the OTA update query since it does not work for all devices and for Solarbank 1 is does not reflect available updates reliably #116

Breaking changes:

  • Converted sync file I/O methods to async methods #103
    • Required to avoid warnings in HA integration
    • Requires to install aiofiles library, which was added to the pipenv setup
  • Moved all energy statistics from api devices cache to the sites cache #101 #111
    • This became necessary after discovering that all energy statistics tracked on the cloud are only available as totals per device type in a power system.
    • That means for dual Solarbank 1 power systems, you get only the total charge, discharge and solar energy values, but no break down per device. As logical consequence, the whole energy Api methods had to be restructured to query also additional smart meter and Solarbank 2 statistics and it became necessary to track all energy details with the sites cache instead.
  • Disabled the OTA update query since this query does not work for all devices and for Solarbank 1 is does not reflect available updates reliably #116

Don't miss a new anker-solix-api release

NewReleases is sending notifications on new releases.