Remootio

Gives Homey flow cards to interact with your garage doors and gates Prerequisites for Websocket API - Your Remootio device is set up - Make sure your Remootio and Homey is on the same network / VLAN - The status sensor is installed and enabled in the Remootio app (Homey needs to know the current state of your gate/garage door) - A static/fixed IP address for your Remootio is recommended - "Output configuration" for your Remootio device MUST be set to one of these: 1: Output 1: disabled Output 2: gate impulse control 2: Output 1: gate impulse control Output 2: free relay output 3: Output 1: free relay output Output 2: gate impulse control 4: Output 1 & Output 2: gate impulse control 5: Output 1: gate impulse control Output 2: disabled Websocket API The API in the Remootio must be enabled before adding Remootio device(s) to Homey. Instructions on Remootio homepage Take a note of the 'API Secret Key' and 'API Auth Key' shown when enabling the API Which driver to use For output configurations 1, 4 and 5 - choose "Remootio (gate impulse control)" For output configuration 2 - choose "Remootio (Output 1: gate impulse control, Output 2: free relay output)" For output configuration 3 - choose "Remootio (Output 1: free relay output, Output 2: gate impulse control)" Pairing When adding a Remootio device to your Homey, you can choose to find it automatically on your network with mDNS, or you can add it manually NOTE: Remootio3 with Software version >= 2.40 MUST be added manually because mDNS support is currently not available because Remootio has rewritten the Software to support HomeKit and in the process borked mDNS support - When asked, input your 'API Secret Key' and 'API Auth Key' -> Found in Websocket API configuration in your Remootio app on your phone - Choose 'Find devices (mDNS)' to find your device(s) automatically on your network with mDNS - Choose 'Manually add device' to manually set 'Name', 'Serial Number' and 'IP address' of your device Logic flipped If you have flipped the logic (in the Remootio app) used on the sensor connected to your Remootio device, you must set 'Is sensor logic flipped' to 'yes' in the Remootio device settings in Homey. For additional documentation or troubleshooting, check out the GitHub page Prerequisites for Device API - Your Remootio device is already set up - For the Device API your Homey and Remootio can be on different LAN's or WAN's - The status sensor is installed and enabled in the Remootio app (Homey needs to know the current state of your gate/garage door) - "Output configuration" for your Remootio device MUST be set to one of these: 1: Output 1: disabled Output 2: gate impulse control 2: Output 1: gate impulse control Output 2: free relay output 3: Output 1: free relay output Output 2: gate impulse control 4: Output 1 & Output 2: gate impulse control 5: Output 1: gate impulse control Output 2: disabled Device API The Device API is hosted on Remootio's servers, so your Remootio device must have internet access and be reachable by the Device API IMPORTANT: The Device API is limited to 300 requests per 20 days (this is Remootio's limits!). This means you should be able to open and close your gate/garage door around 6 times a day. If you exceed this limit you will not be able to send requests to the Device API for a while (not sure about the time frame)! IMPORTANT: There is an automatic query status (disabled by default), which can be configured to automatically query the gate/garage door status every x hours. You should keep this disabled or use with a very high value, for instance every 7 hours or higher, to not overuse number of queries which will cause you to not being able to call the Device API! IMPORTANT: If the gate/garage door is operated outside the Remootio app, the status in the Homey Remootio app will NOT reflect this until it's been toggled in the Remootio app in Homey, or when the automatic query status is run (if enabled) To allow the Device API to control your Remootio device you must set up an App-Free key through the Remootio app on your phone: - Go to shared keys - Click 'Share a new key' and choose 'Share unique key (recommended)' - Give the key a meaningful name - On the next screen click on 'App-free key' and click on 'Share link' - Copy only the 'token' value from the URL. You must add this value to the Remootio app on Homey under "pairing" Which driver to use Remootio Device API This driver is the only driver that supports the Device API of Remootio. Pairing When adding the Remootio device to your Homey, copy in the 'token' value found in the previous steps. The pairing process will query the Device API using the 'token' value and find info about the device. Settings Seconds for status change Number of seconds before the gate/garage door has changed status after being operated. A query is sent to the device api after this amount of seconds to set the correct device status. This is done to make sure the device status has the same status as the Remootio device. Hours between status queries Number of hours between each query for gate/garage door status. Set to 0 to disable automatic status queries As Remootio's Device API has a very low request limit, use this setting with caution! For additional documentation or troubleshooting, check out the GitHub page