Integration for devices that can connect to HomeWhiz mobile app (Beko, Grundig, Arcelik)
- Search for
HomeWhizon the HACS integration page (this integration is part of the HACS default repository meaning it is not necessary to add this integration manually via custom repositories) - Install the integration and Restart Home Assistant
- Using the tool of choice, open the directory (folder) for your HA configuration (where you find
configuration.yaml). - If you do not have a
custom_componentsdirectory there, you need to create it. - In the
custom_componentsdirectory create a new folder calledhomewhiz. - Download all files from the
custom_components/homewhiz/directory in this repository. - Place the files you downloaded in the new directory you created.
- Restart Home Assistant
- Connect the device to the HomeWhiz app on your smartphone
- Close the app
- In the HA UI go to "Configuration" -> "Integrations". The device should be automatically discovered. If it's not click "+" and search for "HomeWhiz"
- Select the "Bluetooth" connection type
- Provide the HomeWhiz username and password. These will be used to fetch your device mapping from the HomeWhiz API during configuration. No internet connection is required after the initial configuration.
- Connect the device to the HomeWhiz app on your smartphone
- In the HA UI go to "Configuration" -> "Integrations". Click "+" and search for "HomeWhiz"
- Select the "Cloud" connection type
- Provide the HomeWhiz username and password.
Please note that the constant internet connection is required. Support for local connection is coming soon (#52)
| Device | Supported | Comments |
|---|---|---|
| Washing machines | ✔️ | Also includes washing machine / dryer combinations |
| Dryer | ✔️ | Also includes washing machine / dryer combinations |
| Dishwasher | ✔️ | |
| Air conditioner | ✔️ | |
| Oven | ❓ ❌ | Not tested |
If you have other device types not listed yet, please let us know.
If your device is missing some information, translations or not working at all, please create an issue. Don't forget to include your device digital ID that can be found either in the HomeWhiz app or the integration logs.
Integration should work with all devices connected via Bluetooth. Remember that the range of Bluetooth can be limited. If your device is out of range, you could try using an ESPHome Bluetooth Proxy.
If you are using custom Home Assistant installation method like Virtual Machine, please make sure your system is configured properly and Bluetooth is available for the Home Assistant
The devices can support only single Bluetooth connection at a time. To connect the device to the original app, you have to disable the Home Assistant integration. Restart Home Assistant and wait a few minutes - this should be indicated on the device: E.g. the Bluetooth icon on a washing machine starts flashing.
To help us help you, please include integration logs when you submit issues. The integration supports multiple logging levels of which not all are shown in the Home Assistant log by default. To enable debug logging for this integration, please add the following configuration to your Home Assistant configuration.yaml file:
logger:
logs:
custom_components.homewhiz: debugTo retrieve logs, navigate in Home Assistant to: settings -> system -> logs and retrieve logs by e.g. pressing the download button below the logs.
⚠️ Please review your logs and delete personal and private information before posting⚠️
Contributions are welcome.
- Report problems by creating an issue here
- Get started developing
- Submit your code