BETA WARNING: this Beta release contains a significant amount of changes to support Outputs, Lights, Scenes and Shutters for the OpenMotics Gateway. It equally uses v0.0.1 of the pyHAopenmotics API, which also contains a significant amount of changes. It has been tested but may contain some bugs in existing or new functionality. Use in your live environment at your own risk.
This repository contains a Home Assistant component + platforms, for the awesome OpenMotics solution.
For the latest version of the OpenMotics Home Assistant Platform please use the master branch or better still install via HACS. if you want bleeding edge then checkout the dev branch, or look out for beta releases via HACS. Depending on what you choose you may need to use the Manual Code Installation described below.
This custom component is developed for controlling an OpenMotics platform by using the pyHAopenmotics sdk.
Requires a minimum of HA 2022.03. This is needed to support the new functionality and changes to config flow. Requires the new pyHAopenmotics v0.0.1 (or newer) sdk.
Login to cloud.openmotics.com
Remember to use your e-mail address as login.
Make sure your installation is at a recent firmware. Update if needed.
Create an additional user
Note: Since the last update of the webui, the link to the integrations is missing. You can access it directly via: https://portal.openmotics.com/#cloud/oauth
Make sure the Client type is Confidential and the Grant type is Client credentials.
The Redirect URI is not used right now and can have any value.
Copy the Client ID and Client secret as you'll need it to configure the integration in Home Assistant.
See Home Assistant Official Installation Guide to install Home Assistant Core.
We highly recommend using HACS Home Assistant Community Store, for more information on how to install HACS please see their documentation website at https://hacs.xyz/
Option 1: HACS installation
- See HACS Official Installation Guide and install HACS.
- See Initial Configuration Guide and complete initial configuration.
- Open Home Assistant. Click HACS > Integrations > ⋮ > Custom repositories.
- Enter
https://github.com/openmotics/home-assistantin the address bar at the bottom left of the window. Select Integration from the Category list and click ADD.
- Click the new repositry. In the dialog box that appears, click DOWNLOAD THIS REPOSITORY WITH HACS.
Option 2: Manual Code Installation
This method is best used when you want to play with the "latest and greatest" from the repository. Moving forward, the github repository will contain two primary branches, master and dev. Master is the latest released, and hopefully most stable branch, whereas dev is the branch that we're currently working on.
- Download the openmotics-home-assistant repo.
- Unzip it and copy the
custom_components/openmoticsfolder to the Home Assistant configuration directory, for example~/.homeassistant.
The disadvantage of a manual installation is that you won't be notified about updates.
Make sure you restart Home Assistant after the installation (in HACS). After the restart, go to Configuration in the side menu in Home Assistant and select Integrations. Click on Add Integrations in the bottom right corner and search for Openmotics to install. This will open the configuration menu with the default settings.
Fill in the client_id and client_secret you have created in the first step.
Depending on your installation, the modules should be added to your Home Assistant automatically within a few seconds till 10 minutes.
Run, Play and let us know if there are any bugs, enhancements etc via the github issues system
This plugin is a community effort and OpenMotics cannot give any warranties even though you can report any issues and we'll help as much as possible. Pull requests are always welcome.
This project is licensed under the AGPLv3 License - see the LICENSE.md file for details
- Special thanks to @woutercoppens for making this plugin and donating it to OpenMotics.