Skip to content

fabiorenner-hub/hmip-hcu-gardena

Repository files navigation

🇬🇧 English | 🇩🇪 Deutsch

hmip-gardena-plugin icon

hmip-gardena-plugin

📦 Download hmip-gardena-plugin-1.2.0-arm64.tar.gz — install via HCUweb → Developer mode → Plugins → Install from file.

GitHub: https://github.com/fabiorenner-hub/hmip-hcu-gardena

Homematic IP HCU plugin that bridges Gardena smart system devices (mowers, valves, power sockets, sensors) into the HMIP app via the official Husqvarna v2 API.

Support

If this plugin is useful to you, please consider a small donation — it helps me keep the lights on while building more HCU plugins: Donate via PayPal.

Install on your HCU

  1. Download the latest hmip-gardena-plugin-<version>.tar.gz from Releases.
  2. In HCUweb open Developer mode → Plugins → Install from file and upload it.
  3. Open the plugin tile → Configuration and fill in your Husqvarna API API key and API secret (Application Key/Secret from the Husqvarna Developer Portal).
  4. Save. After OAuth your Gardena devices appear in the HMIP inbox.

Dashboard

The plugin serves a local status dashboard (dark-glass UI, DE/EN) at http://<HCU-address>:8093 — live device state, diagnostics, logs with a 360° export and an update check. You can switch it off or change the port in the plugin Configuration; the container always keeps port 8093 reachable for its health check.

Note: the brightness value of Gardena sensors is shown up to 20,000 lx. That is the maximum of the Connect API Illumination feature (spec §6.7.15), not a plugin limitation — the HMIP app cannot display higher values.

Build it yourself

./build.ps1   # Windows
chmod +x build.sh
./build.sh    # macOS / Linux

HCU requirements

  • HCU1 with firmware 1.4.7 or newer
  • Developer mode enabled
  • HCU has internet access

Author

Issued by Fabio Renner.

Third-party components

License

Apache-2.0