This is a Home Assistant Custom Component for the Bayrol Cloud. It currently allows you to monitor your pool's pH, Redox (ORP), and temperature values directly in Home Assistant.
It currently only supports the German Bayrol Cloud services (https://www.bayrol-poolaccess.de), because I do not have access to others yet. If you can help with other Bayrol Cloud instances, open an issue. PRs are always welcome.
Currently tested with:
- BAYROL PoolRelax 3
- BAYROL Automatic Cl-pH
Have a different Bayrol device? Please open an issue to help expand device support! When opening an issue, please include:
- Your device model
- HTML response of https://www.bayrol-poolaccess.de/webview/getdata.php?cid=
- Any specific features or parameters your device supports
- Monitors pool water parameters:
- pH Level
- Redox/ORP (mV)
- Temperature
- Debug mode for troubleshooting:
- Captures raw HTML responses
- Accessible through Home Assistant developer tools
- Automatic data updates every 5 minutes
- Easy configuration through the Home Assistant UI
- Automatic discovery of all your pool controllers
- Support for multiple pool controllers
- Make sure you have HACS installed
- Add this repository as a custom repository in HACS:
- Click on HACS in the sidebar
- Click on "Integrations"
- Click the three dots in the top right corner
- Select "Custom repositories"
- Add
https://github.com/razem-io/ha-bayrol-cloudas the repository URL - Select "Integration" as the category
- Click "Install"
- Restart Home Assistant
- Copy the
custom_components/bayrol_clouddirectory to your Home Assistant'scustom_componentsdirectory - Restart Home Assistant
- Go to Settings -> Devices & Services
- Click "Add Integration"
- Search for "Bayrol Cloud"
- Enter your credentials:
- Username (Email address used for Bayrol Pool Access)
- Password
The integration will automatically discover and add all pool controllers configured in your Bayrol Cloud account.
For each controller (where CID is your Controller ID), the integration provides:
sensor.bayrol_cloud_CID_ph: Current pH levelsensor.bayrol_cloud_CID_redox: Current Redox/ORP value in mVsensor.bayrol_cloud_CID_temperature: Current water temperature in °C
Each controller will appear as a separate device in Home Assistant with its own set of sensors.
Each device comes with a debug switch that can be used to capture raw HTML responses from the Bayrol Cloud API. This is particularly useful when:
- Troubleshooting issues
- Adding support for new device types
- Understanding the data structure
-
Find your device's debug switch in Home Assistant:
- Go to Settings -> Devices & Services
- Click on your Bayrol Cloud device
- Look for the switch named "[Device Name] Debug Mode"
- Or find it directly as
switch.bayrol_cloud_CID_debug
-
Enable debug mode:
- Toggle the debug switch to ON
- The integration will start capturing raw HTML responses
-
Access the debug information:
- Go to Developer Tools -> States
- Search for your debug switch entity (e.g.,
switch.bayrol_cloud_CID_debug) - Look in the attributes section
- You'll find the raw HTML response under
debug_raw_html
Example of accessing debug data:
switch.bayrol_cloud_12345_debug:
state: 'on'
attributes:
debug_raw_html: '<html>... raw HTML response from Bayrol Cloud API ...</html>'
friendly_name: 'Pool Controller Debug Mode'
icon: 'mdi:bug'- When finished:
- Toggle the debug switch to OFF
- Debug data will be cleared
- Python 3.9 or higher
- Home Assistant development environment
- SSH access to your Home Assistant instance
rsyncinstalled on your development machine
A development installation script (dev-install.sh) is provided to easily update the integration on your Home Assistant instance during development.
The script can be run in several ways:
-
Using default settings ([email protected]):
./dev-install.sh
-
Specifying custom user and host:
./dev-install.sh -u admin -h 192.168.1.100
-
View help and available options:
./dev-install.sh --help
The script will:
- Sync the integration files to your Home Assistant instance
- Restart Home Assistant to apply changes
- Wait for Home Assistant to come back online
A test script (test_api.py) is provided to verify the API connection before deploying to Home Assistant:
python test_api.py --username [email protected] --password yourpassword --cid yourcidThis will test:
- Authentication with Bayrol Cloud Access
- Data fetching for your pool controller
- Parsing of sensor values
If you encounter any issues:
- Check that your credentials are correct
- Ensure your Bayrol Cloud Access account is active and working
- Check the Home Assistant logs for any error messages
- Try running the test script to verify API connectivity
- Enable debug mode to capture raw API responses
To enable debug logs for the Bayrol Cloud integration:
- Add the following to your
configuration.yaml:logger: default: info logs: custom_components.bayrol_cloud: debug
- Restart Home Assistant
- Access the logs through:
- Home Assistant UI: Settings -> System -> Logs
- Command line:
tail -f /config/home-assistant.log | grep bayrol_cloud
The debug logs will show:
- API requests and responses
- Data updates from your pool controller
- Authentication status
- Any errors or issues that occur
For bugs, feature requests, or to add support for new devices, please open an issue on GitHub.
This project is licensed under the MIT License - see the LICENSE file for details.