thomluther/anker-solix-api v3.8.1

3.8.1

on GitHub

Enhancements:

• MQTT Enhancements for a couple of devices

  • Added C1000X Gen 2 A1765 including full control #342 (Thanks to @rickt123 for confirmation)
    • Mapped status message and MQTT controls supported by the devices
  • Added C2000X Gen 2 A1785 including full control #329 (Thanks to ajw1980 and others who helped decoding the MQTT data and enhanced schedule structures)
    • Mapped status message and MQTT controls supported by the devices
    • Added working status as known so far, some codes may be missing. Note: Device may show AC bypass although working status is discharging, not sure how that is differentiated in the App
  • Added more controls for various PPS, mainly S2000 and C2000(X) (Thanks to all people involved into this and sharing device access to a S2000 for testing and debugging)
    • Switch of usage modes as supported by device
    • Full control of backup plan and Storm Guard switch as supported by device.
    • Note: Storm Guard is a cloud service, that is currently mainly supported in US. The feature support is verified through the Api and not controllable if not supported by the device
    • Conversions of TOU schedule, Custom Schedule and AC output schedule if supported by the device
    • Note: MQTT controls to modify custom, TOU or AC output schedules may be added in a future release
  • Added MQTT control for AX170 power dock to modify the circuit priority
    • Added full decoding and conversion for circuit setup structure, which is different for control and state and must completely recreated if only one circuit priority is changed.
  • Improved management of Power Panel and its attached PPS F3800s
    • The power panel Api class can now handle standalone devices as well
    • This allows to manage the cache data for the attached PPS which are reported as stand alone devices by the Api
    • MQTT data from power panels may contain embedded realtime messages from one of the 2 PPS, but also a few PPS data for both PPS, like SOC, output power and attached device SNs
    • This allows to merge the PPSes to the same system as the power panel and link them to the power panel device as sub devices to show the correct system topology via the merged cache data
    • It also improves the system battery capacity calculation, since all PPS and their extension batteries are now being considered for proper calculation of capacity and remaining energy if MQTT data is available

• Enhanced MQTT data framework

  • Added support for binary field structures decoding and encoding to support additional field types with complex structures like:
    • AC output schedules
    • Power dock circuit setup structures, which even vary between control and state structure
  • Enhanced interactive MQTT control parameter input for mqtt_monitor and monitor tools to support individual prompting methods for complex structures with few parameters like circuit priority
    • Note: Control parameters that require complex structures with many parameters like schedules will not be supported interactively through the monitor tools, since their structure may vary and it will be difficult to pre-define and enter them in one line console prompts

• Added Api support for Powerpanel system and PPS device disaster protection feature discovery and regular status queries

  • The Storm Guard (auto disaster) feature is a cloud service, that is only supported for few regions/countries (e.g. US)
  • The Api queries are the same as used for Power Panel systems, and currently only supported on the COM cloud server, not the EU server
  • The location setting for the feature must be done in the mobile App.
  • Once the Storm Guard is configured, it can be activated and deactivated through the Api
  • Once activated in the cloud, the cloud will drive regular MQTT commands to the device to provide a disaster status, and eventually set an automatic backup charge window whenever there is an elevated disaster risk for your region
  • The backup status of the Power Panel system or PPS device should now report whether a planned or automatic backup charge is in progress
  • The actual disaster status will be queried with every site refresh poll, if the auto disaster feature is supported

• Updated export module

  • Added queries to support the disaster endpoints also for stand alone PPS

• Updated monitor tool

  • Added all MQTT mapping description changes and new PPS field display
  • Added AC output schedule display for PPS devices that are providing and extracting those data
  • Added Api disaster support and status
  • Added PPS backup plan and backup status for devices that are providing and extracting those data

• Updated README.md for supported devices

Fixes and other changes:

• A major change in this release is to ensure all datetime instances will be initialized with a timezone as required by new Ruff rules
• Other significant code refactoring to satisfy new Ruff rules as implemented for HA integrations

Breaking changes:

• The timezone initialization for all datetime based instances should not break the existing methods or data reporting, but it cannot be fully validated either by the developer for all circumstances.
  • Offsets between client time and system/device local time and cloud times may result in wrong day switch comparison, which is required to query to proper days in the cloud recording for daily energies or Solar forecasts or Dynamic price forecasts.
  • Pls open a new issue with the particular time offset issue for wrong day switches in data query or reporting.
• Continuous renaming of MQTT data fields may be required as values are understood, validated and merged across the various devices

Full Changelog: v3.8.0...v3.8.1