3.4.0

Enhancements:

• MQTT cloud support enhancements

  • Improved and simplified methods for connecting to MQTT cloud, subscribing to device topics etc
  • Improved MQTT data monitor tool
    • Added subscription for MQTT commands to decode and describe all controls that can be sent by the mobile App
  • Enhanced MQTT descriptions for existing and new devices, merged field names to consistent naming for extraction in the Api library
    • C1000 (X) 221
    • F2000 (P)
    • F3800 (P) #117, #241
    • C300 AC/DC #188
    • Solarbank Multisystem
  • Added generic MQTT device classes and device factory as foundation for future MQTT command framework
  • Added file based message simulator to mqtt module #236
  • Added separate module for MQTT command and parameter/value descriptions
    • It also contains common command declarations to be used in the desciptions
    • The central command descriptions can be re-used in the device mapping descriptions for assignment to the correct message number
    • Non-default command fields can be updated/overwritten in the device descriptions

• Export module enhancements

  • Added support for export of MQTT messages for 310 second period #232
  • Real Time messages will be triggered for 60 seconds within the period
  • Messages are saved into JSON files, grouped by device and message number
  • Note: Command topic is not subscribed for the export, so no command messages will be exported

• Updated monitor tool for new system and device data fields with additional settings#230

  • Added support for hybrid MQTT data display in device data
  • File mode allows to replay exported MQTT messages with variable speed for debugging purposes
  • Added display for described fields of PPS and Charger devices
  • Added capability to filter display for certain device
  • Added command line parameters to automated launch and usage of the monitor (Thanks @ohadlevy)

• Other enhancements

  • Support more decimals for site price values #233
  • Enhancements to support SB2/3 multisystems with an active power dock
  • Added dot-env to save Account credentials locally in a file which are loaded by the tools as environment variables at runtime. The .env * file is ignored for github repo synchronization (Thanks @stockmopar)
  • Updated README for MQTT client and monitor and supported devices.

Fixes:

• Fixed some value calculations if solarbank multisystem is in use
• Various other fixes in the codebase

Important

Multisystems still have significant consumption data reporting issues to the cloud if they are not used with the owner account and triggered for real time data updates, see Add support for multi-system Solarbanks.

Breaking changes:

• Continuous renaming of MQTT data fields may be required as values are understood, validated and merged across the various devices
• The device agnostic MQTT device modules are no longer maintained (C1000 and F3800)
  • They will be removed once a common, scalable and module command framework was implemented.
  • There will be MQTT device classes per device type, which will specify supported command features and values per PN.
  • Any example modules utilizing those classes will then also break and have to be updated to the new generic MQTT device classes

Full Changelog: v3.3.0...v3.4.0