<<<<<<< HEAD

GitHub Release GitHub Activity License

hacs Project Maintenance BuyMeCoffee

Discord Community Forum

Integration to integrate with [Fluidra Pool][fluidra_pool].

This integration will set up the following platforms.

1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
2. If you do not have a custom_components directory (folder) there, you need to create it.
3. In the custom_components directory (folder) create a new folder called fluidra_pool.
4. Download all the files from the custom_components/fluidra_pool/ directory (folder) in this repository.
5. Place the files you downloaded in the new directory (folder) you created.
6. Restart Home Assistant
7. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "Fluidra Pool"

If you want to contribute to this please read the Contribution guidelines

This project was generated from @oncleben31's Home Assistant Custom Component Cookiecutter template.

Code template was mainly taken from @Ludeeus's integration_blueprint template

=======

hacs_badge maintainer Community Forum

A comprehensive Home Assistant integration for Fluidra Pool heat pumps, providing complete monitoring and control capabilities.

• 7 Specific Modes: Smart Heating/Cooling, Boost Heating, Silence Heating, Boost Cooling, Smart Cooling, Silence Cooling, Off
• Temperature Control: 10-40°C range with 0.5°C precision
• Quick Updates: 5-second refresh after control commands
• Numeric API Integration: Proper 0-6 mapping for Fluidra API

• 105 Total Sensors: Covering all aspects of pool heat pump operation
• 16 Binary Sensors: Device status, pool conditions, user account information
• 6 Control Switches: Pool equipment control (filtration pump, heater, chlorinator, etc.)
• Real-time Data: Live temperature, water quality, device status monitoring

• Entity Organization: Logical grouping with diagnostic, monitoring, and config categories
• API Management: Configurable update intervals and rate limiting
• Error Monitoring: Comprehensive error code mapping and alarm detection
• Multi-device Support: Handle multiple pool devices
• Professional Branding: Custom icons and translations

• Device name, model, firmware, serial number
• Connection status and session management
• Component information and capabilities
• Pool specifications and water quality data

1. Install HACS if you haven't already
2. Add this repository to HACS
3. Search for "Fluidra Pool" in the integrations
4. Click "Download"
5. Restart Home Assistant

1. Download the fluidra_pool folder
2. Copy it to your config/custom_components/ directory
3. Restart Home Assistant

1. Go to Settings → Devices & Services
2. Click Add Integration
3. Search for Fluidra Pool
4. Enter your Fluidra credentials:
   • Username: Your Fluidra account email
   • Password: Your Fluidra account password

1. Find Fluidra Pool in your integrations
2. Click Configure
3. Adjust settings:
   • Update Interval: 5-120 minutes (default: 30)
   • API Rate Limit: 10-120 requests/minute (default: 60)

1. Open Climate Entity: Go to your Fluidra Pool climate entity
2. Select Preset: Choose from 7 available modes:
   • Smart Heating / Cooling (0): Automatic temperature control
   • Boost Heating (1): Maximum heating power
   • Silence Heating (2): Quiet heating operation
   • Boost Cooling (3): Maximum cooling power
   • Smart Cooling (4): Automatic cooling control
   • Silence Cooling (5): Quiet cooling operation
   • Off (6): Heat pump disabled
3. Mode Applied: Heat pump switches to selected mode
4. Quick Update: Status updates within 5 seconds

• Range: 10-40°C with 0.5°C precision
• Units: Celsius (configurable for Fahrenheit)
• Quick Updates: Immediate feedback after changes

• Diagnostic: Technical information and troubleshooting data
• Monitoring: Real-time status and measurements
• Config: Control settings and configuration options

• Serial Number, Owner, Last Update
• Current Temperature, Target Temperature, Heat Pump Mode

• Device Name, Type, Status, Model, Version, Firmware
• SKU, Thing Type, First Connection, Connection Status
• Session ID, Connectivity Timestamp

• Error Code, Error Message, Alarm Status, Alarm Count

• Pool ID, Water Flow Status, Filtration Pump Status

• User ID, Email, Name, Phone, Address, Timezone
• Language, Account Type, Subscription Status
• Account Created, Last Login, Notifications Enabled

• Water Temperature, Air Temperature, Humidity
• pH Level, Chlorine Level, Alkalinity, Water Hardness
• Cyanuric Acid, Water Flow Rate, Pump Status
• Filter Status, Heater Status, Chlorinator Status
• Pool Light Status, Cleaning Status, Maintenance Status

• Component ID, Type, Name, Status, Version, Firmware
• Serial Number, Manufacturer, Model, Capabilities
• Settings, Last Update, Errors

• UI Config Version, Features, Controls, Display Options
• Language, Theme, Notifications, Automation Rules
• Schedule Settings, Maintenance Reminders, Energy Settings

• Device Status (5): Online, Error, Alarm, Maintenance Required, Updating
• Pool/Water System (9): Water Flow, Pump Running, Heater Active, Chlorinator Active, Light On, Cleaning, Cover Closed, Low/High Water Level
• User/Account (2): Notifications Enabled, Subscription Active

• Pool Control: Filtration Pump, Heater, Chlorinator, Pool Light, Cleaning, Cover

• Verify your Fluidra credentials
• Check if your account is active
• Ensure you have access to the Fluidra Pool app

• Check your internet connection
• Verify the integration is properly configured
• Check the logs for API errors

• Ensure the heat pump is online
• Check for any error codes
• Verify the component ID is correct

• E03: Faulty water flowmeter or no flow
• E01: General system error
• E02: Communication error
• E04: Temperature sensor error
• E05: Pressure sensor error
• E06: Compressor error
• E07: Fan error
• E08: Defrost error
• E09: Water flow error
• E10: Power error

Check the Home Assistant logs for detailed error information:

logger:
 default: info
 logs:
 custom_components.fluidra_pool: debug

• Python 3.9+
• Home Assistant 2023.8+
• aiohttp >= 3.8.0
• boto3 >= 1.26.0
• pycognito >= 202350

1. Clone this repository
2. Copy to config/custom_components/fluidra_pool/
3. Restart Home Assistant
4. Check logs for any issues

Run the test scripts to verify functionality:

python test_heatpump_modes.py
python test_integration_simple.py

• Initial release
• Complete heat pump control with 7 modes
• 105 sensors for comprehensive monitoring
• Entity organization with categories
• Professional branding and translations

1. Fork this repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

This project is licensed under the MIT License - see the LICENSE file for details.

• Fluidra for their pool equipment
• Home Assistant community
• All contributors and testers

• GitHub Issues: Report bugs or request features
• Community Forum: Home Assistant Community
• Documentation: Integration Documentation

Note: This integration is not officially affiliated with Fluidra. Use at your own risk and ensure compliance with Fluidra's terms of service.

b8a5c8247c85817c154edfa741acb07424ef5a8d