Homee

homee is a smart home system, able to integrate various protocols such as Z-Wave, Zigbee, EnOcean, and more. The homee integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] will let you use the devicesA device is a model representing a physical or logical unit that contains entities. from your homee in Home Assistant.

Prerequisites

You need to create a new user in your homee app. Create a user that is only used by Home Assistant. For security reasons, it’s recommended to:

• Use a strong, unique password.
• Restrict the user’s permissions for what you want to do from Home Assistant.
• Do not use this account for any other purpose.

1. In your homee app, in the top-left corner, tap the menu button.
2. On the top right of the opening menu, tap the gear icon.
3. Choose Manage users.
4. Choose Add user and configure the desired values.

Configuration

To add the Homee hub to your Home Assistant instance, use this My button:

Homee can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Available devices will automatically show up in your Home Assistant installation. Devices you add in homee appear automatically in Home Assistant. If you remove a device from homee, it is also removed from Home Assistant.

Supported devices

The integration basically supports all devices that are working in homee. Since development relies on an unofficial and outdated description of the interface and reverse engineering, not all functions of a device may work as expected.

A list of known devices and their status can be found in the old custom integration’s wiki. If you think a device is not correctly supported, see below.

Unsupported devices

Commands of the “Warema WMS Handsender” remote controls are not passed to the external API by the homee cube. Therefore these devices show up in Home Assistant, but have no function.

Homeegrams (automations)

Homeegrams are automationsAutomations in Home Assistant allow you to automatically respond to things that happen in and around your home. [Learn more] in homee. The integration implements them as switchesSwitches are things that have two states you can select between, such as turning on or off a socket. [Learn more] that the user can trigger and that momentarily turn on if the Homeegram is played in homee, so they can also be used as a triggerA trigger is a set of values or conditions of a platform that are defined to cause an automation to run. [Learn more] in Home Assistant. Although turning off a Homeegram in HA can be triggered by the user, it is not supported and will raise an error. Only Homeegrams that perform at least two actions are enabled by default to avoid creating a large number of low-value entities in your Home Assistant installation.

Limitations

Changed values are reported from homee in defined time intervals and not always in realtime. For example, while a cover moves, the position is updated only every few seconds and intermediate states may be missed by Home Assistant.

Troubleshooting

First, see the general Home Assistant troubleshooting guide.

The homee integration supports debug logs and diagnostics.

homee device not working as expected

Make sure, the deviceA device is a model representing a physical or logical unit that contains entities. works as expected in homee. If a homee device shows up in Home Assistant, but does not work as expected or is missing entitiesAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more], open a report and attach error logs and the device’s diagnosticsThe diagnostics integration provides a way to download diagnostic data from a device or integration for sharing in issue reports. Sharing diagnostics data when reporting an issue allows developers to diagnose and fix your reported problem quicker. [Learn more] data.

Integration not loading or homee device not showing up in HA

Check that the homee-user, used for Home Assistant, is allowed to see the device. If that is the case, open a report and attach error logs and the diagnostic data of the integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more].

Reconfiguration

This integration supports reconfiguration, allowing you to change the IP address, even after a device has already been set up.

To start the reconfiguration

1. Go to Settings > Devices & services and select the homee integration card.
2. From the list of hubs, select the one you want to reconfigure.
3. Next to the entry, select the three dots menu. Then, select Reconfigure.

Removing the integration

This integration follows standard integration removal, and once the integration is removed, you can also remove the dedicated user from your homee.

To remove an integration instance from Home Assistant

1. Go to Settings > Devices & services and select the integration card.
2. From the list of devices, select the integration instance you want to remove.
3. Next to the entry, select the three dots menu. Then, select Delete.