Git Product home page Git Product logo

tailwind-home-assistant's Introduction

tailwind-home-assistant

Tailwind iQ3 integration for Home Assistant

v0.2 of this component requires V9.95 of the Tailwind iQ3 firmware. This version has been officially released; please update via the Tailwind app.

v0.1 of this component requires a beta firmware which has been superseded by the V9.95 release. If you were previously using this version, you may need to delete the Tailwind integration and re-add it, as you will need to specify the Local Control Key (see below) during setup for correct operation.

The integration will create one or more Cover entities for your garage door(s). The state (open/closed) is updated every 10 seconds via local polling - no cloud connection is required.

Installation

For the best experience, install via HACS. At this stage, you'll need to add it to HACS as a custom repository using the following details:

  • Repository URL: https://github.com/pauln/tailwind-home-assistant
  • Category: Integration

This will result in the "Tailwind iQ3" integration appearing on your HACS integrations dashboard; from there, click the "Install" button and confirm. Once installed, HACS will list the integration as "pending restart" until you restart Home Assistant.

After restarting Home Assistant, you should get a notification within Home Assistant that a new device has been discovered. Following the prompt to "check it out" (or manually navigating to the Integrations page), a "Tailwind iQ3" card should appear; click the "Configure" button, select how many doors you have set up, give it a name (if desired) and enter your Local Control Key (see below) and click "submit".

If your Tailwind iQ3 isn't automatically discovered (or you've "ignored" it), you can manually add the Tailwind iQ3 integration using the "Add Integration" button on the Integrations page in Home Assistant. You'll need to enter the IP address of your iQ3 in addition to the number of doors and Local Control Key (and optional name) as part of the manual setup process.

Local Control Key

In order to use the local control API which this integration relies on, it's necessary to obtain your Local Control Key (a 6-digit code) and enter it as part of the integration configuration. To obtain your Local Control Key, ensure that you've updated your Tailwind iQ3 to the v9.95 firmware and then:

  1. Visit Tailwind Web
  2. Log in with your Tailwind account
  3. Click "Local Control Key" in the top menu (red box in screenshot)
  4. If no key is displayed, click the "Create new local command key" button
  5. Enter the 6-digit code (green box in screenshot) into the integration configuration

Screenshot showing where to find the Local Control Key

tailwind-home-assistant's People

Contributors

amcfague avatar pauln avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

tailwind-home-assistant's Issues

Fail to call service error

Hi,
After firmware update, Tailwind integration does not communicate with Home assistant. I have deleted integration and re added also restarted the Tailwind controller. Now this error appears once I attempt to open the garage door from HA.
Failed to call service cover/open_cover. int' object has no attribute name'

Thank you

Enable stop_cover action?

Hello, is there anyway to enable stop_cover action? The reason I ask is because I think we can create a automation that mimics the partial open functionality. The automation would send the open command weights 500 milliseconds and then send a stop command. Basically we need a way to mimic a button press for this to work and currently there is no such functionality in the integration.

Deprecated Constants will be removed from HA Core 2025.1

Logger: homeassistant.components.cover
Source: helpers/deprecation.py:205
Integration: Cover (documentation, issues)
First occurred: 3:23:33 PM (6 occurrences)
Last logged: 3:23:33 PM

DEVICE_CLASS_GARAGE was used from tailwind_iq3, this is a deprecated constant which will be removed in HA Core 2025.1. Use CoverDeviceClass.GARAGE instead, please create a bug report at https://github.com/pauln/tailwind-home-assistant/issues

SUPPORT_CLOSE was used from tailwind_iq3, this is a deprecated constant which will be removed in HA Core 2025.1. Use CoverEntityFeature.CLOSE instead, please create a bug report at https://github.com/pauln/tailwind-home-assistant/issues

SUPPORT_OPEN was used from tailwind_iq3, this is a deprecated constant which will be removed in HA Core 2025.1. Use CoverEntityFeature.OPEN instead, please create a bug report at https://github.com/pauln/tailwind-home-assistant/issues

IP Address reassignment

Please modify so that the assigned IP address of the device can be changed in the Integration. As it is now, if the device gets a different IP address the integration has to be deleted and then reinstalled.

Update to 2023.2 breaks tailwind iq3 startup

I get this message once I updated HA to 2023.2.

**Logger: homeassistant.setup
Source: setup.py:205
First occurred: 4:42:50 PM (1 occurrences)
Last logged: 4:42:50 PM

Setup failed for custom integration tailwind_iq3: Requirements for tailwind_iq3 not found: ['scapy==2.4.5'].**

Was working fine just before the update.

0.6 update does not recognize my 3rd door

Did the update to 0.6 and now my third garage door is unavailable in home assistant, stating "This entity is no longer being provided by the tailwind_iq3 integration"

Replace async_setup_platforms with async_forward_entry_setups

2023-02-01 21:49:19.845 WARNING (MainThread) [homeassistant.helpers.frame] Detected integration that called async_setup_platforms instead of awaiting async_forward_entry_setups; this will fail in version 2023.3. Please report issue to the custom integration author for tailwind_iq3 using this method at custom_components/tailwind_iq3/init.py, line 74: hass.config_entries.async_setup_platforms(entry, PLATFORMS)

Multiple Tailwind devices

It seems you can only add one device at a time. I have two garages far enough apart that it requires two physical tailwind hubs. When trying to add a second Ip address you get the message "This Tailwind iQ3 is already configured."

discovery_info['host'] vs. discovery_info.host

Just wanted to let you know about a message in the logs about deprecated functionality to be removed in the near-ish future.

Detected integration that accessed discovery_info['host'] instead of discovery_info.host; this will fail in version 2022.6. Please report issue to the custom component author for tailwind_iq3 using this method at custom_components/tailwind_iq3/config_flow.py, line 97: self._ip_address = discovery_info[CONF_HOST]

Probably low priority. I am very new to HA (haven't actually gotten this integration running yet), but came across that log message when trying to get things setup.

Integration Setup Issues

Hello. I went through all of the installation steps and got the integration successfully installed message, but when I go back to the main integrations page, there's a red exclamation point and a "Retrying setup" message. There are no devices or entities showing up in the Tailwind integrations box. I've tried deleting, rebooting HA, and reinstalling the integration, but I'm still getting the same error. Here's what the log is showing:

2022-05-25 11:07:52 WARNING (SyncWorker_1) [homeassistant.loader] We found a custom integration tailwind_iq3 which has not been tested by Home Assistant. This component might cause stability problems, be sure to disable it if you experience issues with Home Assistant
2022-05-25 15:28:35 WARNING (MainThread) [homeassistant.util.async_] Detected blocking call to sleep inside the event loop. This is causing stability issues. Please report issue to the custom component author for tailwind_iq3 doing blocking calls at custom_components/tailwind_iq3/config_flow.py, line 53: mac = getmacbyip(user_input[CONF_IP_ADDRESS])
2022-05-25 15:28:48 WARNING (MainThread) [homeassistant.config_entries] Config entry 'Tailwind iQ3' for tailwind_iq3 integration not ready yet; Retrying in background

Any ideas on how I can fix this? Thanks

HA 2023.2.5 Update: Setup failed for custom integration tailwind_iq3: Requirements for tailwind_iq3 not found

Logger: homeassistant.setup
Source: setup.py:205
First occurred: 11:55:30 (1 occurrences)
Last logged: 11:55:30

Setup failed for custom integration tailwind_iq3: Requirements for tailwind_iq3 not found: ['scapy==2.4.5'].


Logger: homeassistant.util.package
Source: util/package.py:100
First occurred: 11:55:21 (3 occurrences)
Last logged: 11:55:30

Unable to install package scapy==2.4.5: ERROR: Cannot install scapy==2.4.5 because these package versions have conflicting dependencies. ERROR: ResolutionImpossible: for help visit https://pip.pypa.io/en/latest/topics/dependency-resolution/#dealing-with-dependency-conflicts [notice] A new release of pip available: 22.3 -> 23.0.1 [notice] To update, run: pip install --upgrade pip

Feature request: add support for partial open

The Tailwind app allows me to configure an amount of time for a partial door open. I can then long press the garage door to partially open it by this amount. See here for example: https://youtu.be/sOODpMTewW0?t=87

It would be nice if there was a way for me to trigger a partial open via this home assistant integration.

Use case I have in mind is that I'd like to set up an automation to partially open my garage doors when the weather outside is nice so I can automatically air out my garage.

Add Binary Sensor

Feature Request

Alarmo is the alarm system I am using and it only looks at binary sensors. It would be nice if your integration included a binary sensor so it could be used by Alarmo. Home Assistant also provides a binary sensor device class for garage doors.

async_setup_platforms -- deprecated

Home Assistant 2023.5.2
Supervisor 2023.04.1
Operating System 10.1
Frontend 20230503.3 - latest

Hello and thanks to the devs for creating this great HACS plugin. I noticed with the 2023.5.2 Home Assistant release that my Tailwind integration was failing at startup. After some research, I found that the async_setup_platform function has been marked as deprecated and set to fail in 2023.3. It seems that it is now indeed failing. To correct the issue, I have modified "init.py" file in HACS - Custom Components - tailwind_iq3, line 74

From: hass.config_entries.async_setup_platforms(entry, PLATFORMS)
To: await hass.config_entries.async_forward_entry_setups(entry, PLATFORMS)

I restarted Home Assistant and the Tailwind integration seems to be working as expected. Hopefully this is the permanent fix and can be updated in the HACS package for all.

Thanks

Retrying setup: Cannot connect to host

Retrying setup: Cannot connect to host 192.168.1.165:80 ssl:default [Connect call failed ('192.168.1.165', 80)]
H/w Revision No. V1.3
Model/Fw Ver. IQ3/9.05

Who opened the garage door?

Tailwind app indicates who opened the door (i.e. the user of the app or 'someone' if the door was opened via the physical button). Is it possible to expose this in HA? I want to use it for security purposes, such that when the garage door automatically opens when a vehicle approaches, it turns off the security system (so it doesn't need to be turned off manually). Tx!

Garage Door Opening is not working as a trigger

Tailwind IQ3 Firmware version: 9.97
HACS integration version: 1.33.0

"Garage Door Opening" is not working as a trigger. Automation is failing silently and log book shows no reference.

"Garage Door Opened" and "Garage Door Closed" are working fine as triggers on the same automation (turn on light switch X).

Is this a recent regression given no one else seems to have reported this?

in debug mode, no errors are reported when I open one of the garage doors:
2023-10-01 13:04:00.222 DEBUG (MainThread) [custom_components.tailwind_iq3] tailwind reported state: 4
2023-10-01 13:04:00.223 DEBUG (MainThread) [custom_components.tailwind_iq3] Finished fetching tailwind devices data in 0.014 seconds (success: True)
2023-10-01 13:04:03.524 INFO (MainThread) [custom_components.tailwind_iq3.cover] Open door: 0
2023-10-01 13:04:10.218 DEBUG (MainThread) [custom_components.tailwind_iq3] tailwind reported state: 5
2023-10-01 13:04:10.218 DEBUG (MainThread) [custom_components.tailwind_iq3] Finished fetching tailwind devices data in 0.011 seconds (success: True)

Unable to add new integration due to getmacbyip failure

I just set up a new Tailwind iQ3 device and successfully connected it to my network. I am able to access it via the web.gotailwind.com website. When I try to add it to my HA server, I get an error stating "IP address is invalid (MAC address could not be determined). Please correct it and try again." When I check my HA logs, I note the following additional error message:

Logger: scapy.runtime
Source: custom_components/tailwind_iq3/config_flow.py:53
Integration: Tailwind iQ3
First occurred: 2:05:11 PM (1 occurrences)
Last logged: 2:05:11 PM

getmacbyip failed on [Errno 1] Operation not permitted

Any ideas? I am currently running HA version 2023.12.1 on python 3.11.

Official integration

I noticed that there is now an official integration for Tailwind in Home Assistant core, which was added as of 2024.1: https://www.home-assistant.io/integrations/tailwind

With this new integration, I'm curious what the status of this project is. Would you recommend continuing to use this integration, or should folks migrate to the one in core?

Fresh Install - Integration not ready yet

Tailwind Hardware Rev: 1.2
Model/FW Ver: IQ3/9.97

Logger: homeassistant.config_entries
Source: config_entries.py:441
First occurred: 2:38:02 PM (1 occurrences)
Last logged: 2:38:02 PM

Config entry 'Tailwind iQ3' for tailwind_iq3 integration not ready yet; Retrying in background

Getting this error. Any ideas?

One Garage Door Stating Incorrect State and Cover Control doesn't work

I've got 2 garage door openers working correctly in HomeKit with proper state. In Home Assistant, was able to successfully add and configure both doors, but one of them is showing an incorrect state and doesn't seem to update with garage opening or closing; can't seem to trick it into working or responding to cover control.

Integration Broken Following HA 2023.02 Upgrade

Hello,

After upgrading to the 2023.02 version of HA, the integration no longer seems to be working. I am seeing these two errors on startup and the integration no longer functions.

Logger: homeassistant.util.package
Source: util/package.py:100
First occurred: 12:16:27 AM (3 occurrences)
Last logged: 12:16:40 AM

Unable to install package scapy==2.4.5: ERROR: Cannot install scapy==2.4.5 because these package versions have conflicting dependencies. ERROR: ResolutionImpossible: for help visit https://pip.pypa.io/en/latest/topics/dependency-resolution/#dealing-with-dependency-conflicts [notice] A new release of pip available: 22.3 -> 23.0 [notice] To update, run: pip install --upgrade pip

Logger: homeassistant.setup
Source: setup.py:205
First occurred: 12:16:40 AM (1 occurrences)
Last logged: 12:16:40 AM

Setup failed for custom integration tailwind_iq3: Requirements for tailwind_iq3 not found: ['scapy==2.4.5'].

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.