Dingz Home Assistant Integration

Integration to integrate with Dingz devices.

Installation

1. Add this repository as a custom repository to HACS:
2. Use HACS to install the integration.
3. Restart Home Assistant.
4. Set up the integration using the UI:
5. (optional but recommended) Set up the MQTT connection from dingz to Home Assistant. Read the Guide

Supported Features

When you make changes to the dingz configuration (for instance when setting up the MQTT connection, or changing the output configuration), reload the integration (or restart Home Assistant) to update the entities.

The following features are fully supported and, since I'm actively using them, should always work:

• Light outputs (including dimmers)
• Front panel LED with RGB support
• PIR Motion detection (incl. live updates when used in combination with MQTT¹)
• Button press events (only when used in combination with MQTT¹)
• Power and Energy sensors for outputs
• Various other sensors like brightness, temperature etc.
• Physical dingz inputs (incl. live updates when used in combination with MQTT¹)

The following features have been implemented, but since I'm not actively using these configurations, I don't know how well they work.

• Blinds / Motors (incl. live updates when used in combination with MQTT¹)
• Thermostats (exposed as climate entites in Home Assistant)
• Fan outputs

Note

If you're using one of these, be sure to contact me (open an issue or a new discussion). With a bit of help, I can easily improve the integration. This also applies to unimplemented features, of course.

And now for the list of things that won't be implemented:

• Dingz firmware updates through Home Assistant. As far as I can tell the dingz doesn't know itself, whether an update is available. They are performed by the mobile app by downloading the firmware blob from somewhere. I'm not planning on reverse engineering this at the moment. Don't hesitate to let me know if you have more information about this though.

Contributions are welcome

If you want to contribute to this please read the Contribution guidelines

Providing translations for other languages

If you would like to use the integration in another language, you can help out by providing the necessary translations.

Head over to GitLocalize to start translating.

If your desired language isn't available there, just open an issue to request it.

You can also just do the translations manually in custom_components/dingz/translations/ and open a pull request with the changes.

Footnotes

1. See the MQTT Guide. ↩ ↩² ↩³ ↩⁴