{"id":48794335,"url":"https://github.com/emmeoerre/ave_dominaplus","last_synced_at":"2026-04-13T22:05:27.931Z","repository":{"id":292309131,"uuid":"980460752","full_name":"emmeoerre/ave_dominaplus","owner":"emmeoerre","description":"Home assistant integration to control AVE Dominaplus systems. Completely local, completely push","archived":false,"fork":false,"pushed_at":"2026-04-13T13:15:57.000Z","size":122,"stargazers_count":5,"open_issues_count":3,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-13T13:28:24.553Z","etag":null,"topics":["domotics","hacs","hacs-integration","home-assistant","home-assistant-integration","websocket"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/emmeoerre.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-09T06:59:47.000Z","updated_at":"2026-04-13T09:16:02.000Z","dependencies_parsed_at":"2025-05-09T17:32:28.676Z","dependency_job_id":null,"html_url":"https://github.com/emmeoerre/ave_dominaplus","commit_stats":null,"previous_names":["emmeoerre/ave_dominaplus"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/emmeoerre/ave_dominaplus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emmeoerre%2Fave_dominaplus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emmeoerre%2Fave_dominaplus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emmeoerre%2Fave_dominaplus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emmeoerre%2Fave_dominaplus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/emmeoerre","download_url":"https://codeload.github.com/emmeoerre/ave_dominaplus/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emmeoerre%2Fave_dominaplus/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31772654,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T20:17:16.280Z","status":"ssl_error","status_checked_at":"2026-04-13T20:17:08.216Z","response_time":93,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["domotics","hacs","hacs-integration","home-assistant","home-assistant-integration","websocket"],"created_at":"2026-04-13T22:05:27.263Z","updated_at":"2026-04-13T22:05:27.925Z","avatar_url":"https://github.com/emmeoerre.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌟 AVE Dominaplus Integration for Home Assistant\n\nControl your AVE Dominaplus home automation system directly from Home Assistant! This integration uses WebSocket communication with the AVE webserver for a **completely asynchronous** and **100% local** setup.\n\n---\n\n## 📋 Requirements\n\n- An **AVE webserver device** installed and accessible from your Home Assistant instance.\n- Only tested with the **\"autologin\" setting** enabled in the webserver.\n- **AVE Cloud configuration is NOT required**.\n- **Alarm units** connected to the webserver (required for motion sensors and alarm zones).\n---\n\n## 🚀 Installation\n\n1. Install the integration via HACS (recommended) or manually copy the files to your `custom_components` directory.\n2. At this point Home Assistant may autodiscover the AVE webserver and show a configuration prompt. If you see it, open that prompt and continue from there.\n3. If no autodiscovery prompt appears go to **Settings → Devices \u0026 Services → Add Integration**. Search for **\"AVE Dominaplus\"** and select it manually.\n4. In the configuration prompt provide the webserver IP address and configure additional settings as needed.\n\n---\n\n## 🛠️ Supported Devices\n\n### ✅ Switches\n- **Fully supported**: Discovered at startup, with names.\n- Synced with the **\"Get lights\"** flag.\n- Supports turning on, off, and toggling.\n\n### ✅ Alarm Areas\n- **Supported**: Discovered at startup, with names.\n- Synced with the **\"Get antitheft sensor areas\"** flag.\n- Provides motion sensor functionality.\n- Includes **\"Last cleared\"** and **\"Last revealed\"** timestamps as attributes.\n- *Note: \"Armed\" and \"Triggered\" states are not yet exposed as entities.*\n\n### ✅ Individual Alarm Sensors\n- **Supported**: Discovered when the first event is triggered.\n- Synced with the **\"Get individual antitheft sensors\"** flag.\n- The system does not provide names, so sensors are auto-named. It is recommended to set custom\n   names after discovery.\n- These sensors are sensitive and may trigger quickly; configure accordingly.\n\n### ✅ Thermostats\n- **Supported** when **\"Get thermostats\"** is enabled in the config flow.\n- For each thermostat the integration creates two entities:\n  * a **climate** entity representing the controller\n  * a **number** entity showing the current temperature offset of the device (–5 °C..+5 °C)\n\n#### Climate entity behaviour\n- `Mode` controls the combination of season and on/off state:\n  * `Cool` for summer mode\n  * `Heat` for winter mode\n  * `Off` if the thermostat is powered off (support depends on the device)\n- `Preset` is either `Schedule` (follow the schedule on the webserver)\n  or `Manual` (immediate changes from Home Assistant). Changing the\n  target temperature from HA will automatically switch the preset to\n  `Manual`, mimicking the vendor app behaviour.\n- `Fan mode` reflects the fancoil speed reported by the zone; it is **read‑only**.\n\n#### Offset sensor\n- A read‑only number sensor is created for each thermostat exposing the\n  device’s current offset.\n- The offset **cannot be modified from Home Assistant**; it must be set on the\n  physical thermostat itself.  The sensor simply mirrors the value reported\n  by the device.\n\n---\n\n## 🔜 Not yet supported (contributors welcome!)\n\nOther devices are not yet supported either for lack of time or lack of devices at hand\n\n- **Dimmers**: Work in progress\n- **Scenarios**: Backend discovery is ready; no entity is exposed\n- **Areas**: Feel free to come with a plan to add AVE areas and device area assignments without clashing with the HA areas\n- **Economizers**: Not yet supported\n- **Shutters**: Not yet supported\n\n---\n\n## 🏷️ About Device Names\n\nThe integration supports two naming strategies:\n\n1. **Names from Webserver** (Recommended):\n   - Entity IDs like: `switch.normalized_ave_name`.\n   - Names are fetched from the Dominaplus configuration.\n   - Changes are fetched at every restart.\n\n2. **Generated Names**:\n   - Entity IDs like: `switch.\u003cave_family_id\u003e_\u003cave_device_id\u003e`.\n   - Names are automatically generated.\n\n**Tip**: If you plan to customize entity names:\nThe integration tries its best to not override your custom names even if they are changed in the AVE apps. But for better measure:\n- First, enable **\"Get entities names from webserver\"** to discover all entities.\n- Then, disable this option before setting custom names to prevent overwriting.\n\n---\n\n## ❓ Frequently asked questions\n\n### I don’t see certain device types after installation\nFirst verify the device type is listed under “Supported Devices” above. If\nit is supported and still not visible, reconfigure the integration in Home\nAssistant (Settings → Devices \u0026 Services → your AVE entry → ⋮ menu →\nReconfigure).  Items added in a newer version may not appear until the entry\nhas been re‑configured.\n\n\n## ⚠️ Known Issues\n\n### Multiple Webservers for Different Plants\n- Currently, multiple webservers for different plants are **not supported**. Multiple controllers for the same plant are supported, but separate plant setups may cause device ID clashes. Support for multi-plant setups is being explored.\n\n### Individual sensor alarm states after power outage\n- After a webserver or alarm unit reboot, a brief arm/disarm cycle may be needed for sensors to start reporting state updates. This behavior is due to the alarm system firmware, not the integration.\n\n\n## 🆘 How to ask for help\n\nBefore opening an issue:\n\n* Make sure the integration is up to date.\n* Check the **FAQ** and **Known Issues** sections above; your question may already be answered.\n\nWhen creating a GitHub issue:\n\n* Search for an existing issue describing the same problem and add additional information there instead\n  of opening a duplicate.\n* Do **not** post on unrelated issues; off-topic comments may be removed.\n* Provide as much relevant information as you can:\n  - integration version,\n  - Home Assistant version,\n  - webserver firmware version,\n  - model of the affected device(s),\n  - log output with the `ave_dominaplus` domain set to `debug` (capture the messages\n    emitted when the integration starts).\n\n\n---\n\n## 🤝 Contributing \u0026 developing\n\nContributions are welcome! If you encounter issues or have feature requests, feel free to open an issue or submit a pull request on GitHub.\nYou can join our [discord server](https://discord.gg/PQ52jwV6BX)\n\nDevelopment setup and debugging guide (VS Code on Windows + WSL): [docs/development/vscode-windows.md](docs/development/vscode-windows.md)\n\n---\n\n## 📜 License\n\nThis project is licensed under the **MIT License**. See the `LICENSE` file for more details.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femmeoerre%2Fave_dominaplus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Femmeoerre%2Fave_dominaplus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femmeoerre%2Fave_dominaplus/lists"}