Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
marthoc authored Sep 11, 2017
1 parent 00d636b commit 8edcefc
Showing 1 changed file with 25 additions and 1 deletion.
26 changes: 25 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,7 @@ Best of all, if you select the proper parts, building and installing a GarHAge r
* [Installing GarHAge](#installing-garhage)
* [Configuring Home Assistant](#configuring-home-assistant)
* [HASS's Birth Message](#hasss-birth-message)
* [HASS Automation as a Better Workaround than birth_message](#hass-automation-as-a-better-workaround-than-birth_message)
* [MQTT Cover: Basic configuration](#mqtt-cover-basic-configuration)
* [MQTT Cover: Complete configuration](#mqtt-cover-complete-configuration)
* [MQTT Binary Sensor](#mqtt-binary-sensor)
Expand Down Expand Up @@ -331,7 +332,7 @@ GarHAGE supports both Home Assistant's "MQTT Cover" and "MQTT Binary Sensor" pla

To be used in conjunction with the "Home Assistant Workaround Parameters" in config.h. These must be set to take advantage of the GarHAge functionality described along with those parameters that addresses a current bug in HASS.

Add the `birth_message` parameters to the `mqtt` stanza in configuration.yaml:
Add the `birth_message` parameters to the `mqtt` stanza in `configuration.yaml`:

```
mqtt:
Expand All @@ -341,6 +342,29 @@ mqtt:
payload: "online"
```

### HASS Automation as a Better Workaround than birth_message

_Testing has shown that the "birth_message" workaround often still leaves the MQTT cover in an "unknown" state. A more reliable solution is to use an automation to send the "STATE" payload to one or both doors' action topics on Home Assistant start. Consider GarHAge's "birth_message" code and parameters deprecated and to be removed in the next feature release._

Place the following in your `automations.yaml` (adjusting if you have only one door controlled by GarHAge); be sure to change `id: ABC` to suit your setup.

```
- id: ABC
alias: Update garage door state on startup
trigger:
- platform: homeassistant
event: start
action:
- service: mqtt.publish
data:
topic: "garage/door/1/action"
payload: "STATE"
- service: mqtt.publish
data:
topic: "garage/door/2/action"
payload: "STATE"
```

### MQTT Cover: Basic configuration

```
Expand Down

0 comments on commit 8edcefc

Please sign in to comment.