Skip to content

This custom integration allows you to monitor and control your pool equipment using the Violet Pool Controller in Home Assistant. It includes sensors, binary sensors, and switches to track various pool metrics and perform essential operations.

License

Notifications You must be signed in to change notification settings

Xerolux/violet-hass

Repository files navigation

GitHub Release releases GitHub Activity License

hacs Project Maintenance BuyMeCoffee

Discord Community Forum

Violet Pool Controller HACS Home Assistant Addon

This custom integration allows you to monitor and control your pool equipment using the Violet Pool Controller in Home Assistant. It includes sensors, binary sensors, and switches to track various pool metrics and perform essential operations.

Violet Home Assistant Integration

Features

Sensors: Monitor various parameters such as water flow, temperature, pump power, and pH levels.
Binary Sensors: Track the status of critical systems like pumps and system connectivity.
Switches: Control your pool equipment, such as the pump, lights, eco mode, and dosing systems. -> not aviable now

Table of Contents

Install

To install the Violet Pool Controller via HACS, follow these steps:

  1. Open HACS in your Home Assistant interface.
  2. Click on the three dots in the top-right corner.
  3. Select "Custom repositories" from the dropdown menu.
  4. Add the following URL as a custom Git repository:
    https://github.com/Xerolux/violet-hass.git
  5. Choose "Integration" as the category for the repository.
  6. Once the repository is added, go to "Integrations" in HACS.
  7. Search for "Violet Pool Controller" and download the integration.
  8. Restart Home Assistant to apply the changes.
  9. After restarting, navigate to Settings > Integrations and add the "Violet Pool Controller" integration.

Configuration is Done in the UI

  1. API URL: The base URL of your Violet Pool Controller (e.g., 192.168.1.100).
  2. Username: Your API username for authentication.
  3. Password: Your API password for authentication.
  4. Polling Interval: How often to poll the device (in seconds).
  5. Use SSL: Whether to use HTTPS for secure communication.
  6. Device ID: A number to uniquely identify this Violet device when using multiple devices.

Common Problems/Errors and Solutions

  • Too Many Arguments Passed: Ensure that your config_entry and other variables are correctly passed when initializing entities like sensors, switches, or binary sensors.
  • Missing Device Information: Verify that the API URL and authentication details are correct.

Getting Support for this Integration

If you encounter any issues or need help, please raise an issue on GitHub. This ensures that others can benefit from the solution too.

Supporting this Integration

If you'd like to support this integration or show your appreciation, you can:

Buy Me A Coffee

Contributing

Contributions are always welcome! If you'd like to contribute, please read the Contribution Guidelines.

A Brief Description of the Violet Pool Controller

Violet Home Assistant Integration

VIOLET is designed as a smart all-in-one solution for pool control, capable of managing small to fully equipped pool installations. It controls filtration, heating/solar heating, lighting (ON/OFF or DMX-enabled), backwashing, overflow tank control, water level regulation, pool cover, additional water features, and dosing.

In case of errors (e.g., sensor failure, pump running dry, faulty refill valve, etc.), notifications can be sent via email, push, or HTTP request. The configuration and operation of VIOLET are entirely browser-based, accessible via any device. Integrated statistics, log files, remote access, and a simple JSON API enable easy integration with smart home systems.

Credits

This project was generated using the integration blueprint from @Ludeeus.

Screenshots

Violet Home Assistant Integration
Violet Home Assistant Integration


About

This custom integration allows you to monitor and control your pool equipment using the Violet Pool Controller in Home Assistant. It includes sensors, binary sensors, and switches to track various pool metrics and perform essential operations.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages