TailWind Smart Garage Controller Binding [5.0.0.0;6.0.0.0)

Add-on Marketplace Bundles
,
1

logo
logo262×100 19.9 KB

This binding was developed for the TailWind Smart Garage Controllers. Supported models include:

  • iQ3 Smart Automatic Garage Controller

The binding has been tested with the TailWind iQ3 controller using multiple number of door configurations on v5.0.x of OpenHab.

README

Refer to the README for additional details regarding the configuration of this binding.

This is the initial release being made available in the OpenHab Marketplace.

Changelog

Version 1.0.0

  • initial release

Version 5.2.0

  • Builds against openHAB 5.2.0 (Java 21).
  • License headers and static code analysis rules updated for openHAB 5.2.
  • UDP status messages are decoded as UTF-8, and names are upper-cased with Locale.ROOT.
  • New Server Connection Monitoring channel (controller#serverMonitor), from section 3.8 of the
    Local Control API (firmware 10.61 or later). UNDEF on older firmware.
  • The Firmware Version channel (controller#firmwareVersion) now appears on the Thing.
  • Both channels are added to existing iQ3 Things automatically.

Version 5.2.1

  • Builds against openHAB 5.2.0 (Java 21). For openHAB 5.x.
  • Things defined in .things files now connect. The httpServerUrl property is set from webServerAddress when it is missing, instead of leaving the controller URL host null.
  • webServerAddress accepts an http:// or https:// prefix (and a trailing /json).
  • MAC address, firmware version and model properties are filled in for Things defined in files.
  • Door and controller channels are set from the controller’s status at startup, so items no longer show an old door state until the next UDP event.
  • A rejected authorization token is reported as a token problem, not as an unreachable controller.
  • The Thing stays OFFLINE when its configuration check fails, instead of going ONLINE anyway.
  • Fixed a null-result error that logged an ERROR for every linked item when the controller rejected a request.
  • The Thing comes back ONLINE by itself after a temporary communication error.
  • Door Partial Open items no longer briefly change to 0 each time the Thing starts.
  • The Thing connects to the controller in the background, so openHAB no longer warns that initializing the handler takes more than 5000ms.
  • If the controller can’t be reached when the Thing starts (for example after a power cut), the binding keeps trying: after 30s, 60s, 120s, 240s, then every 5 minutes, and goes ONLINE when it answers.

Resources

org.openhab.binding.tailwind-5.2.1.jar

To install: download the jar for your openHAB version from the release page and copy it into your addons folder, replacing the older org.openhab.binding.tailwind jar.

If you used the Openhab Store:Binding in the UI, then you need to remove the binding and install it.

Authoring and Support

This binding is developed by @dschoepel . If you encounter any issues, please use this thread.

Sources

Sources for v5.2.1

2

I’ve created separate versions of this binding for both OH v4.x and v5.x which are now published in the Marketplace. Should be visible once they are reviewed.

v5.x: org.openhab.binding.tailwind-5.2.0.jar

v4.x: org.openhab.binding.tailwind-4.2.3.jar

Added a couple of new channels:

  • New Server Connection Monitoring channel (controller#serverMonitor), from section 3.8 of the
    Local Control API (firmware 10.61 or later). UNDEF on older firmware.
  • The Firmware Version channel (controller#firmwareVersion) now appears on the Thing.
  • Both channels are added to existing iQ3 Things automatically.
3

I have updated the versions with several fixes and improvements. Refer to the change log for the details and the link to the updated binding jar file.

Latest versions: