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:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

Host

The IP Address of your Homee.

User

The username you chose in the Prerequisites.

Password

The password for that user.

Available devices will automatically show up in your Home Assistant installation. New devices added to Homee will be automatically discovered after a restart of Home Assistant. This restart is only required when adding new devices, not for state updates of existing devices.

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.