Xerolux / violet-hass

Violet Pool Controller
MIT License
1 stars 0 forks source link
addon hacs pool pool-controller pool-digital violet

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

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