Component to integrate with homee.
This component will set up the following platforms.
Platform | Description |
---|---|
binary_sensor |
Integrate homee devices that provide binary state information like on /off or open /close . |
sensor |
Integrate homee devices that provide readings - currently power and energy are supported |
cover |
Integrate homee devices that provide motor and position functions such as blinds and shutter actuators |
climate |
Integrate homee devices that provide temperature and can set a target temperature. |
light |
Integrate lights from homee. |
switch |
Integrate homee devices that can be turned on /off and can optionally provide information about the current power consumption. |
⚠️ Backup homee and Home Assistant!
- Make sure the HACS integration is properly installed for your instance of home assistant.
- In the HACS UI go to "Integrations", click on three small dots in the top right and select "Custom repositories".
- Paste
https://github.com/FreshlyBrewedCode/hacs-homee
into the field that says "Add custom repository URL", select "Integration" from "Category" dropdown and click "Add". - You should now see a card with the homee integration in the HACS -> "Integrations" section. Click "Install".
- Select the latest version from the dropdown and click "Install".
- 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_components
directory (folder) there, you need to create it. - In the
custom_components
directory (folder) create a new folder calledhomee
. - Download all the files from the
custom_components/homee/
directory (folder) in this repository. - Place the files you downloaded in the new directory (folder) you created.
- Restart Home Assistant.
ℹ️ Because of a bug (#4) you should only configure one homee in Home Assistant.
The integration will attempt to discover homee cubes in your network. Discovered cubes should show up in the "Configuration" -> "Integrations" section along with the associated homee id and host ip address.
- In the HA UI go to "Configuration" -> "Integrations", click "Configure" on a discovered homee or click "+", search for "homee", and select the "homee" integration from the list.
- In the dialog enter the username and password of a homee account that can access your cube, as well as the host (ip address of the homee cube) if you are not configuring a discovered cube. Click submit.
- If the connection was successful you will see the "Initial Configuration" section. These options can also be changed later from by clicking on the "Options" button on the homee integration. For more details on the available options check the Options section.
- Click submit. Your devices will be automatically added to Home Assistant.
The following table shows the available options that can be configured in the "Initial Configuration" step or using the "Options" button on an existing configuration. Please note that you have to restart Home Assistant after changing the options using the "Options" button.
Option | Default | Description |
---|---|---|
The groups that should be imported |
all groups | The integration will only import devices that are in any of the selected groups. Use this option to limit the devices that you want to import. |
Groups that contain window sensors |
empty | Any binary_sensor that is in any of the selected groups will use the window device class. You should select a homee group that contains all of your window sensors. |
Groups that contain door sensors |
empty | Any binary_sensor that is in any of the selected groups will use the door device class. You should select a homee group that contains all of your door sensors. |
Add (debug) information about the homee node and attributes to each entity |
False |
Enabling this option will add the homee_data attribute to every entity created by this integration. The attribute contains information about the homee node (name, id, profile) and the attributes (id, type). This option can be useful for debugging or advanced automations when used with templates. |
As of now this integration has support for very few devices. If you have devices, that are not discovered or not working correctly, open an issue and do the following to provide a log:
- Add following lines to configuration.yaml to enable info logging for hacs-homee:
logger:
default: warn
logs:
custom_components.homee: info
- Restart Home Assistant.
- Go to "Settings->System->Logs" and show complete logs.
- Look for lines containing "INFO (MainThread) [homee]" and copy them
- Open an issue describing the device and paste the logs in the corresponding section
If you want to contribute to this please read the Contribution guidelines
Home Assistant encourages developers of integrations to use a separate python package that handles the communication between Home Assistant and the different devices (i.e. python api/backend). This integration uses pymee to connect and communicate with the homee websocket api. For some features it may be necessary to make changes to pymee first.