mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-02 09:17:35 +00:00
1aca7b08cf
* e.g. to e.g., and proper case for Home Assistant * Instructions how to -> Instructions on how to
110 lines
3.0 KiB
Markdown
110 lines
3.0 KiB
Markdown
---
|
|
layout: page
|
|
title: "OpenGarage Cover"
|
|
description: "Instructions on how to integrate OpenGarage.io covers within Home Assistant."
|
|
date: 2017-04-07 14:25
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
logo: opengarage.png
|
|
ha_category: Cover
|
|
ha_release: 0.44
|
|
---
|
|
|
|
|
|
The `opengarage` cover platform lets you control the open-source [OpenGarage.io](https://opengarage.io/) device through Home Assistant.
|
|
|
|
To enable OpenGarage Covers in your installation, add the following to your `configuration.yaml` file:
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
cover:
|
|
platform: opengarage
|
|
covers:
|
|
garage:
|
|
host: 192.168.1.12
|
|
device_key: opendoor
|
|
name: Left Garage Door
|
|
garage2:
|
|
host: 192.168.1.13
|
|
device_key: opendoor
|
|
name: Right Garage Door
|
|
```
|
|
|
|
Configuration variables:
|
|
|
|
- **covers** array (*Required*): List of your doors.
|
|
- **identifier** (*Required*): Name of the cover as slug. Multiple entries are possible.
|
|
- **host** (*Required*): IP address of device.
|
|
- **port** (*Optional*): HTTP Port. Default is `80`.
|
|
- **device_key** (*Required*): Access key to control device. Default is `opendoor`.
|
|
- **name** (*Optional*): Name to use in the Frontend. If not provided, it will use name configured in device.
|
|
|
|
|
|
|
|
**Example with more detail:**
|
|
<p class='img'>
|
|
<img src='{{site_root}}/images/components/opengarage/cover_opengarage_details.jpg' />
|
|
</p>
|
|
|
|
```yaml
|
|
# Related configuration.yaml entry
|
|
cover:
|
|
platform: opengarage
|
|
covers:
|
|
garage:
|
|
host: 192.168.1.12
|
|
device_key: opendoor
|
|
name: honda
|
|
|
|
sensor:
|
|
platform: template
|
|
sensors:
|
|
garage_status:
|
|
friendly_name: 'Honda Door Status'
|
|
value_template: {% raw %}'{% if states.cover.honda %}
|
|
{% if states.cover.honda.attributes["door_state"] == "open" %}
|
|
Open
|
|
{% elif states.cover.honda.attributes["door_state"] == "closed" %}
|
|
Closed
|
|
{% elif states.cover.honda.attributes["door_state"] == "opening" %}
|
|
Opening
|
|
{% elif states.cover.honda.attributes["door_state"] == "closing" %}
|
|
Closing
|
|
{% else %}
|
|
Unknown
|
|
{% endif %}
|
|
{% else %}
|
|
n/a
|
|
{% endif %}'{% endraw %}
|
|
garage_car_present:
|
|
friendly_name: 'Honda in Garage'
|
|
value_template: {% raw %}'{% if states.cover.honda %}
|
|
{% if states.cover.honda.state == "open" %}
|
|
n/a
|
|
{% elif ((states.cover.honda.attributes["distance_sensor"] > 40) and (states.cover.honda.attributes["distance_sensor"] < 100)) %}
|
|
Yes
|
|
{% else %}
|
|
No
|
|
{% endif %}
|
|
{% else %}
|
|
n/a
|
|
{% endif %}'{% endraw %}
|
|
|
|
group:
|
|
garage:
|
|
name: Garage
|
|
entities:
|
|
- cover.honda
|
|
- sensor.garage_status
|
|
- sensor.garage_car_present
|
|
|
|
customize:
|
|
cover.honda:
|
|
friendly_name: Honda
|
|
entity_picture: /local/honda.gif
|
|
sensor.garage_car_present:
|
|
icon: mdi:car
|
|
```
|