v2.2.0

Chemistry Monitoring Features & Multi-Pool Support

New Features

• Binary Sensors for Out-of-Range Detection

  • binary_sensor.poolmath_{pool}_fc_problem, ph_problem, ta_problem, etc.
  • Device class: Problem (on = chemistry out of range)
  • Attributes: current_value, target_min, target_max, deviation

• Enhanced Sensor Attributes

  • target_min, target_max, target (ideal value)
  • in_range (boolean indicating if value is within target range)
  • last_logged (ISO datetime string of when measurement was taken)

• Chemistry Change Events

  • poolmath_chemistry_out_of_range - fired when a value goes out of range
  • poolmath_chemistry_in_range - fired when a value returns to range
  • Event data includes: measurement, value, target_min, target_max, pool_id, pool_name

• Expanded Target Ranges

  • Added TFP target ranges for all chemistry sensors (FC, CC, pH, TA, CH, CYA, Salt, Borate, CSI)

• Multi-Pool Support

  • Updated unique ID scheme to include user_id, preventing entity collisions
  • Backwards compatible migration for existing installations

• Options Flow: Force Data Refresh

  • Menu option to manually refresh Pool Math data

Improvements

• Block pool identity changes in options flow to prevent orphaned entities
• Better handling of pool-specific targets from API data

Compatibility

• Existing installations will automatically migrate entity unique IDs
• No manual reconfiguration required

2.0.1

Major Release – Breaking Changes

This update introduces significant changes that require a full reconfiguration for existing users.

Changes

• Simplified UI setup flow for easier onboarding (@aallen90)
• Updated to support PoolMath API changes and request throttling (@aallen90)
• Migrated to the new PoolMath API (@Redth)
• Partial adoption of Home Assistant’s Coordinator pattern for improved architecture
• Performance improvements: sensors now update via the coordinator instead of polling individually

v2.1.1 - Config Flow UX Improvements

What's New

Improved config flow user experience:

• Clearer field labels (Display name, Chemistry guidelines, Update frequency)
• Added URL format example in share URL description
• More actionable error messages with guidance
• Better abort message with next steps

No breaking changes - existing configurations will continue to work.

Compatibility

• Home Assistant: 2025.2.0+
• Python: 3.13+

v2.1.0 - Home Assistant 2025.2+ Modernization

What's New

• Modernize to Home Assistant 2025.2+ standards
• Update Python 3.13+ type hints and async patterns
• Add comprehensive test suite
• Add diagnostics support
• Fix ruff lint errors

Compatibility

• Home Assistant: 2025.2.0+
• Python: 3.13+

0.2.7

• bump to 0.2.7 version due to manifest.json issue in 0.2.6

0.2.6

• fixed the UnitOfMeasurement.FAHRENHEIT warning (see https://github.com/rsnodgrass/hass-poolmath/issues/24)
• changed default interval from 15 minutes to 2 minutes

0.2.5

• added water temp, pressure, flow rate, and SWG cell percentage

0.2.4

• fix log_type failure when INFO logs were enabled

0.2.3

• check for None (null) vs 0 for sensor values to update the value if numeric

0.2.2

• Fixed bugs for cases where hyphen was in URL
• Much clearer error messages for users when things go wrong
• Default timeout raised from 5 seconds to 15 to deal with users who have slow RPi or devices (like older Synology) where the HA startup time is really long