Tailwind

The Tailwind integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] lets you control your Tailwind garage door controller fully locally, without relying on cloud services.

Use cases for this integration include:

• Opening and closing your garage door from the Home Assistant UI or automations.
• Monitoring whether the garage door is currently open or closed.
• Automating your garage door based on presence detection, for example, opening it when you arrive home.
• Adjusting the brightness of the status LED on the Tailwind device.

Supported devices

The following Tailwind devices are supported:

• Tailwind iQ3

Prerequisites

Before setting up this integration, make sure your Tailwind device is set up, connected to your network, and configured in the Tailwind app.

You will need the following information during setup:

• The IP address of your Tailwind device. In the Tailwind app, select the cog icon on your device. The IP address is shown in the Device Info section.
• The local control key token. Go to the Tailwind web portal, sign in with your Tailwind account, and select the Local Control Key tab. The 6-digit number shown is your local control key token.

Configuration

To add the Tailwind device to your Home Assistant instance, use this My button:

Tailwind can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

To change the host or local control key token after setup, go to Settings > Devices & services, select the Tailwind integration, and select Reconfigure.

Supported functionality

Covers

The integration creates a cover entity for each garage door connected to your Tailwind controller. You can open and close the door and see its current state (open or closed).

Binary sensors

• Operational problem
  • Description: Indicates whether the door has an operational problem (locked out).
  • Entity category: Diagnostic

Buttons

• Identify
  • Description: Flashes the status LED on the Tailwind device so you can identify it.
  • Entity category: Configuration

Numbers

• Status LED brightness
  • Description: Controls the brightness of the status LED on the Tailwind device (0 to 100%).
  • Entity category: Configuration

Examples

Notify when the garage door is left open

Send a mobile notification when the garage door has been open for more than 10 minutes:

alias: "Notify when garage door left open"
triggers:
  - trigger: state
    entity_id: cover.garage_door
    to: "open"
    for:
      minutes: 10
actions:
  - action: notify.mobile_app_my_phone
    data:
      title: "Garage door"
      message: "The garage door has been open for 10 minutes."

Close the garage door at bedtime if left open

Automatically close the garage door when you activate your bedtime scene, but only if it is currently open:

alias: "Close garage door at bedtime"
triggers:
  - trigger: state
    entity_id: scene.bedtime
conditions:
  - condition: state
    entity_id: cover.garage_door
    state: "open"
actions:
  - action: cover.close_cover
    target:
      entity_id: cover.garage_door

Close the garage door when everyone leaves home

Close the garage door automatically when nobody is home:

alias: "Close garage door when leaving home"
triggers:
  - trigger: state
    entity_id: zone.home
    to: "0"
conditions:
  - condition: state
    entity_id: cover.garage_door
    state: "open"
actions:
  - action: cover.close_cover
    target:
      entity_id: cover.garage_door

Data updates

The integration polls the Tailwind device every 5 seconds over the local network for updated door and device status.

Known limitations

• The integration communicates with the Tailwind device over the local network. If the device is not reachable, the entities become unavailable.
• The Tailwind device requires a minimum firmware version. If your firmware is too old, the integration will not set up. Update your device to the latest firmware using the Tailwind app.

Troubleshooting

Cannot connect during setup

If you see a “Cannot connect” error during setup, verify that:

1. The Tailwind device is powered on and connected to your network.
2. The IP address you entered is correct. You can find it in the Tailwind app under the device’s cog icon in the Device Info section.
3. Home Assistant can reach the device on the local network.

Invalid authentication

If you see an “Invalid authentication” error, your local control key token may have changed. Go to the Tailwind web portal and verify the current token. You can update it in Home Assistant by selecting Reconfigure on the integration card.

Unsupported firmware

If you see an “Unsupported firmware” message, update your Tailwind device to the latest firmware version using the Tailwind app, then try setting up the integration again.

Removing the integration

This integration follows standard integration removal, no extra steps are required.

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.