🇬🇧 English | 🇩🇪 Deutsch

HMIP HCU Plugin: Fake Switches

📦 Download hmip-plugin-fake-switches-1.1.2.tar.gz — install via HCUweb → Developer mode → Plugins → Install from file.

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

A Homematic IP Home Control Unit (HCU) plugin that exposes virtual switches (and an optional dimmable light) in the HMIP app. Useful for testing automations, scenes and groups without real hardware.

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.

Devices in the HMIP app

• Fake Switch 1..N — SWITCH with switchState, onTime, maintenance
• Fake Light (optional) — LIGHT with switchState, dimming, onTime, maintenance

All switch states are persisted in /data/state.json, surviving restarts and plugin updates.

Install on your HCU

1. Download hmip-plugin-fake-switches-<version>.tar.gz from the Releases.
2. In HCUweb open Developer mode → Plugins → Upload and choose the file.
3. Configure under Plugins → Fake Switches → Configure.

Configuration via the HCU UI

After installing, in Plugins → Fake Switches → Configure:

• Number of switches (1..20), Name prefix, Individual names
• Create fake light (boolean), Light name
• Attach maintenance feature — reports unreach/lowBat/sabotage = false

Build and install on the HCU

./build.ps1   # Windows

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

References

• Homematic IP Connect API

Author

Issued by Fabio Renner.

Third-party components

• Built against the Homematic IP Connect API 1.0.1 by eQ-3.
• No external services or vendor APIs — purely virtual devices.

License

Apache-2.0