Skip to content

2.0.0 multi region support

Choose a tag to compare

View all tags
@DTekNOdev DTekNOdev released this 03 Dec 07:59
v2.0.0
8b35b99

v2.0.0

This major release introduces multi-region support and comprehensive energy monitoring capabilities for your MSpa hot tub.

🌍 Multi-Region Support (Experimental)

  • Auto-detection: Automatically selects the correct regional API endpoint based on your Home Assistant country setting
  • Regional endpoints: Support for ROW (Rest of World/Europe), US (United States/Canada), and CH (China/Hong Kong/Macau)
  • Manual override: Ability to manually select your region during setup if auto-detection is incorrect
  • Fallback protection: Defaults to ROW (Europe) region for maximum compatibility
  • Region endpoints identified from the openHAB MSpa binding

Note: Multi-region support is experimental. While the ROW region is well-tested, US and CH regions have had limited testing. User feedback is welcomed!

⚡ Power and Energy Monitoring

  • Individual power sensors: Separate sensors for pump, bubble blower, and heater power consumption
  • Total power sensor: Automatically calculates combined power usage with component breakdown in attributes
  • Energy dashboard integration: Built-in total energy sensor (kWh) compatible with Home Assistant's Energy dashboard
  • Configurable power values: Customize power consumption values for each component to match your specific hot tub model
  • Persistent tracking: Energy consumption persists across Home Assistant restarts
  • Accurate calculation: Uses trapezoidal integration for precise energy measurements
  • Default values based on MSpa Comfort C-BE061 specifications (60W pump, 900W bubbles, 1500W/2000W heater)

🚀 Adaptive Polling

  • Smart polling: Automatically increases polling frequency to 1 second when changes are pending or during preheat
  • Timeout protection: Returns to normal 60-second polling after 15 seconds
  • Improved responsiveness: Faster state updates when you make changes through Home Assistant
  • Reduced API load: Normal polling during idle periods to minimize unnecessary API calls

🔧 Improvements

  • Better offline detection: Entities now correctly show as unavailable when the hot tub is offline
  • HVAC action states: Added preheating state to climate entity for better heating status visibility
  • Robust input handling: Improved username/password handling to strip leading/trailing whitespace from copy/paste operations

📝 Documentation

  • Comprehensive documentation for power/energy monitoring with calibration guide
  • Multi-region setup instructions with visual guides
  • Updated screenshots with meaningful filenames
  • Configuration instructions with emoji indicators

Breaking Changes: None - this release is fully backward compatible with v1.x configurations.

Upgrade Notes:

  • After upgrading, visit the integration configuration (⚙️ cog wheel) to set custom power consumption values if desired
  • Add the Total Energy sensor to your Energy dashboard for consumption tracking
  • If outside Europe, verify the correct region is selected in the integration configuration
Assets 3
Loading