mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-22 16:56:50 +00:00
Merge branch 'current' into next
This commit is contained in:
commit
f9e120f975
@ -101,8 +101,8 @@ social:
|
||||
# Home Assistant release details
|
||||
current_major_version: 0
|
||||
current_minor_version: 106
|
||||
current_patch_version: 0
|
||||
date_released: 2020-02-26
|
||||
current_patch_version: 2
|
||||
date_released: 2020-02-28
|
||||
|
||||
# Either # or the anchor link to latest release notes in the blog post.
|
||||
# Must be prefixed with a # and have double quotes around it.
|
||||
|
@ -57,7 +57,7 @@ Extensions allow templates to access all of the Home Assistant specific states a
|
||||
- `states('device_tracker.paulus')` will return the state string (not the object) of the given entity or `unknown` if it doesn't exist.
|
||||
- `is_state('device_tracker.paulus', 'home')` will test if the given entity is the specified state.
|
||||
- `state_attr('device_tracker.paulus', 'battery')` will return the value of the attribute or None if it doesn't exist.
|
||||
- `is_state_attr('device_tracker.paulus', 'battery', 40)` will test if the given entity attribute is the specified state (in this case, a numeric value).
|
||||
- `is_state_attr('device_tracker.paulus', 'battery', 40)` will test if the given entity attribute is the specified state (in this case, a numeric value). Note that the attribute can be `None` and you want to check if it is `None`, you need to use `state_attr('sensor.my_sensor', 'attr') == None`.
|
||||
|
||||
<div class='note warning'>
|
||||
|
||||
|
@ -12,6 +12,7 @@ Supported by MQTT discovery:
|
||||
- [Binary sensors](/integrations/binary_sensor.mqtt/)
|
||||
- [Cameras](/integrations/camera.mqtt/)
|
||||
- [Covers](/integrations/cover.mqtt/)
|
||||
- [Device Triggers](/integrations/device_trigger.mqtt/)
|
||||
- [Fans](/integrations/fan.mqtt/)
|
||||
- [HVACs](/integrations/climate.mqtt/)
|
||||
- [Lights](/integrations/light.mqtt/)
|
||||
|
@ -241,7 +241,7 @@ A better weekday condition could be by using the [Workday Binary Sensor](/integr
|
||||
|
||||
### Zone condition
|
||||
|
||||
Zone conditions test if an entity is in a certain zone. For zone automation to work, you need to have set up a device tracker platform that supports reporting GPS coordinates. Currently this is limited to the [OwnTracks platform](/integrations/owntracks/) and the [iCloud platform](/integrations/icloud/).
|
||||
Zone conditions test if an entity is in a certain zone. For zone automation to work, you need to have set up a device tracker platform that supports reporting GPS coordinates.
|
||||
|
||||
```yaml
|
||||
condition:
|
||||
|
@ -34,57 +34,10 @@ alarm_control_panel:
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
name:
|
||||
description: The name of the alarm.
|
||||
availability_topic:
|
||||
description: The MQTT topic subscribed to receive availability (online/offline) updates.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT Alarm
|
||||
unique_id:
|
||||
description: An ID that uniquely identifies this alarm panel. If two alarm panels have the same unique ID, Home Assistant will raise an exception.
|
||||
required: false
|
||||
type: string
|
||||
state_topic:
|
||||
description: The MQTT topic subscribed to receive state updates.
|
||||
required: true
|
||||
type: string
|
||||
command_topic:
|
||||
description: The MQTT topic to publish commands to change the alarm state.
|
||||
required: true
|
||||
type: string
|
||||
command_template:
|
||||
description: "The [template](/docs/configuration/templating/#processing-incoming-data) used for the command payload. Available variables: `action` and `code`."
|
||||
required: false
|
||||
type: string
|
||||
default: action
|
||||
value_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the value."
|
||||
required: false
|
||||
type: template
|
||||
qos:
|
||||
description: The maximum QoS level of the state topic.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
payload_disarm:
|
||||
description: The payload to disarm your Alarm Panel.
|
||||
required: false
|
||||
type: string
|
||||
default: DISARM
|
||||
payload_arm_home:
|
||||
description: The payload to set armed-home mode on your Alarm Panel.
|
||||
required: false
|
||||
type: string
|
||||
default: ARM_HOME
|
||||
payload_arm_away:
|
||||
description: The payload to set armed-away mode on your Alarm Panel.
|
||||
required: false
|
||||
type: string
|
||||
default: ARM_AWAY
|
||||
payload_arm_night:
|
||||
description: The payload to set armed-night mode on your Alarm Panel.
|
||||
required: false
|
||||
type: string
|
||||
default: ARM_NIGHT
|
||||
code:
|
||||
description: If defined, specifies a code to enable or disable the alarm in the frontend.
|
||||
required: false
|
||||
@ -99,41 +52,28 @@ code_disarm_required:
|
||||
required: false
|
||||
type: boolean
|
||||
default: true
|
||||
availability_topic:
|
||||
description: The MQTT topic subscribed to receive availability (online/offline) updates.
|
||||
command_template:
|
||||
description: "The [template](/docs/configuration/templating/#processing-incoming-data) used for the command payload. Available variables: `action` and `code`."
|
||||
required: false
|
||||
type: string
|
||||
payload_available:
|
||||
description: The payload that represents the available state.
|
||||
required: false
|
||||
default: action
|
||||
command_topic:
|
||||
description: The MQTT topic to publish commands to change the alarm state.
|
||||
required: true
|
||||
type: string
|
||||
default: online
|
||||
payload_not_available:
|
||||
description: The payload that represents the unavailable state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
required: false
|
||||
type: string
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-template-configuration) documentation."
|
||||
required: false
|
||||
type: template
|
||||
device:
|
||||
description: 'Information about the device this alarm panel is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/docs/mqtt/discovery/) and when [`unique_id`](#unique_id) is set.'
|
||||
required: false
|
||||
type: map
|
||||
keys:
|
||||
identifiers:
|
||||
description: 'A list of IDs that uniquely identify the device. For example a serial number.'
|
||||
required: false
|
||||
type: [list, string]
|
||||
connections:
|
||||
description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": [["mac", "02:5b:26:a8:dc:12"]]`.'
|
||||
required: false
|
||||
type: list
|
||||
identifiers:
|
||||
description: 'A list of IDs that uniquely identify the device. For example a serial number.'
|
||||
required: false
|
||||
type: [list, string]
|
||||
manufacturer:
|
||||
description: 'The manufacturer of the device.'
|
||||
required: false
|
||||
@ -150,4 +90,64 @@ device:
|
||||
description: 'The firmware version of the device.'
|
||||
required: false
|
||||
type: string
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-template-configuration) documentation."
|
||||
required: false
|
||||
type: template
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
required: false
|
||||
type: string
|
||||
name:
|
||||
description: The name of the alarm.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT Alarm
|
||||
payload_arm_away:
|
||||
description: The payload to set armed-away mode on your Alarm Panel.
|
||||
required: false
|
||||
type: string
|
||||
default: ARM_AWAY
|
||||
payload_arm_home:
|
||||
description: The payload to set armed-home mode on your Alarm Panel.
|
||||
required: false
|
||||
type: string
|
||||
default: ARM_HOME
|
||||
payload_arm_night:
|
||||
description: The payload to set armed-night mode on your Alarm Panel.
|
||||
required: false
|
||||
type: string
|
||||
default: ARM_NIGHT
|
||||
payload_available:
|
||||
description: The payload that represents the available state.
|
||||
required: false
|
||||
type: string
|
||||
default: online
|
||||
payload_disarm:
|
||||
description: The payload to disarm your Alarm Panel.
|
||||
required: false
|
||||
type: string
|
||||
default: DISARM
|
||||
payload_not_available:
|
||||
description: The payload that represents the unavailable state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
qos:
|
||||
description: The maximum QoS level of the state topic.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
state_topic:
|
||||
description: The MQTT topic subscribed to receive state updates.
|
||||
required: true
|
||||
type: string
|
||||
unique_id:
|
||||
description: An ID that uniquely identifies this alarm panel. If two alarm panels have the same unique ID, Home Assistant will raise an exception.
|
||||
required: false
|
||||
type: string
|
||||
value_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the value."
|
||||
required: false
|
||||
type: template
|
||||
{% endconfiguration %}
|
||||
|
@ -14,6 +14,8 @@ The binary sensor state will be updated only after a new message is published on
|
||||
the binary sensor will receive an instant state update after subscription and Home Assistant will display the correct state on startup.
|
||||
Otherwise, the initial state displayed in Home Assistant will be `unknown`.
|
||||
|
||||
Stateless devices such as buttons, remote controls etc are better represented by [MQTT device triggers](/integrations/device_trigger.mqtt/) than by binary sensors.
|
||||
|
||||
## Configuration
|
||||
|
||||
The `mqtt` binary sensor platform optionally supports an `availability_topic` to receive online and offline messages (birth and LWT messages) from the MQTT device. During normal operation, if the MQTT sensor device goes offline (i.e., publishes `payload_not_available` to `availability_topic`), Home Assistant will display the binary sensor as `unavailable`. If these messages are published with the `retain` flag set, the binary sensor will receive an instant update after subscription and Home Assistant will display the correct availability state of the binary sensor when Home Assistant starts up. If the `retain` flag is not set, Home Assistant will display the binary sensor as `unavailable` when Home Assistant starts up. If no `availability_topic`
|
||||
@ -30,90 +32,23 @@ binary_sensor:
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
state_topic:
|
||||
description: The MQTT topic subscribed to receive sensor values.
|
||||
required: true
|
||||
type: string
|
||||
name:
|
||||
description: The name of the binary sensor.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT Binary Sensor
|
||||
payload_on:
|
||||
description: The payload that represents the on state.
|
||||
required: false
|
||||
type: string
|
||||
default: "ON"
|
||||
payload_off:
|
||||
description: The payload that represents the off state.
|
||||
required: false
|
||||
type: string
|
||||
default: "OFF"
|
||||
availability_topic:
|
||||
description: "The MQTT topic subscribed to receive birth and LWT messages from the MQTT device. If `availability_topic` is not defined, the binary sensor availability state will always be `available`. If `availability_topic` is defined, the binary sensor availability state will be `unavailable` by default."
|
||||
required: false
|
||||
type: string
|
||||
payload_available:
|
||||
description: The payload that represents the online state.
|
||||
required: false
|
||||
type: string
|
||||
default: online
|
||||
payload_not_available:
|
||||
description: The payload that represents the offline state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
required: false
|
||||
type: string
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-template-configuration) documentation."
|
||||
required: false
|
||||
type: template
|
||||
qos:
|
||||
description: The maximum QoS level to be used when receiving messages.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
unique_id:
|
||||
description: An ID that uniquely identifies this sensor. If two sensors have the same unique ID, Home Assistant will raise an exception.
|
||||
required: false
|
||||
type: string
|
||||
device_class:
|
||||
description: Sets the [class of the device](/integrations/binary_sensor/#device-class), changing the device state and icon that is displayed on the frontend.
|
||||
required: false
|
||||
type: string
|
||||
expire_after:
|
||||
description: "Defines the number of seconds after the value expires if it's not updated. After expiry, the value is cleared, and the availability is set to false"
|
||||
required: false
|
||||
type: integer
|
||||
value_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract a value from the payload. Available variables: `entity_id`. Remove this option when 'payload_on' and 'payload_off' are sufficient to match your payloads."
|
||||
required: false
|
||||
type: string
|
||||
force_update:
|
||||
description: Sends update events even if the value hasn't changed. Useful if you want to have meaningful value graphs in history.
|
||||
required: false
|
||||
type: boolean
|
||||
default: false
|
||||
off_delay:
|
||||
description: "For sensors that only sends `On` state updates, this variable sets a delay in seconds after which the sensor state will be updated back to `Off`."
|
||||
required: false
|
||||
type: integer
|
||||
device:
|
||||
description: "Information about the device this binary sensor is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/docs/mqtt/discovery/) and when [`unique_id`](#unique_id) is set."
|
||||
required: false
|
||||
type: map
|
||||
keys:
|
||||
identifiers:
|
||||
description: A list of IDs that uniquely identify the device. For example a serial number.
|
||||
required: false
|
||||
type: [list, string]
|
||||
connections:
|
||||
description: "A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `'connections': ['mac', '02:5b:26:a8:dc:12']`."
|
||||
required: false
|
||||
type: [list, map]
|
||||
identifiers:
|
||||
description: A list of IDs that uniquely identify the device. For example a serial number.
|
||||
required: false
|
||||
type: [list, string]
|
||||
manufacturer:
|
||||
description: The manufacturer of the device.
|
||||
required: false
|
||||
@ -130,6 +65,73 @@ device:
|
||||
description: The firmware version of the device.
|
||||
required: false
|
||||
type: string
|
||||
device_class:
|
||||
description: Sets the [class of the device](/integrations/binary_sensor/#device-class), changing the device state and icon that is displayed on the frontend.
|
||||
required: false
|
||||
type: string
|
||||
expire_after:
|
||||
description: "Defines the number of seconds after the value expires if it's not updated. After expiry, the value is cleared, and the availability is set to false"
|
||||
required: false
|
||||
type: integer
|
||||
force_update:
|
||||
description: Sends update events even if the value hasn't changed. Useful if you want to have meaningful value graphs in history.
|
||||
required: false
|
||||
type: boolean
|
||||
default: false
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-template-configuration) documentation."
|
||||
required: false
|
||||
type: template
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
required: false
|
||||
type: string
|
||||
name:
|
||||
description: The name of the binary sensor.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT Binary Sensor
|
||||
off_delay:
|
||||
description: "For sensors that only sends `On` state updates, this variable sets a delay in seconds after which the sensor state will be updated back to `Off`."
|
||||
required: false
|
||||
type: integer
|
||||
payload_available:
|
||||
description: The payload that represents the online state.
|
||||
required: false
|
||||
type: string
|
||||
default: online
|
||||
payload_not_available:
|
||||
description: The payload that represents the offline state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
payload_off:
|
||||
description: The payload that represents the off state.
|
||||
required: false
|
||||
type: string
|
||||
default: "OFF"
|
||||
payload_on:
|
||||
description: The payload that represents the on state.
|
||||
required: false
|
||||
type: string
|
||||
default: "ON"
|
||||
qos:
|
||||
description: The maximum QoS level to be used when receiving messages.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
state_topic:
|
||||
description: The MQTT topic subscribed to receive sensor values.
|
||||
required: true
|
||||
type: string
|
||||
unique_id:
|
||||
description: An ID that uniquely identifies this sensor. If two sensors have the same unique ID, Home Assistant will raise an exception.
|
||||
required: false
|
||||
type: string
|
||||
value_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract a value from the payload. Available variables: `entity_id`. Remove this option when 'payload_on' and 'payload_off' are sufficient to match your payloads."
|
||||
required: false
|
||||
type: string
|
||||
{% endconfiguration %}
|
||||
|
||||
## Examples
|
||||
|
@ -24,31 +24,19 @@ camera:
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
topic:
|
||||
description: The MQTT topic to subscribe to.
|
||||
required: true
|
||||
type: string
|
||||
name:
|
||||
description: The name of the camera.
|
||||
required: false
|
||||
type: string
|
||||
unique_id:
|
||||
description: An ID that uniquely identifies this camera. If two cameras have the same unique ID Home Assistant will raise an exception.
|
||||
required: false
|
||||
type: string
|
||||
device:
|
||||
description: "Information about the device this camera is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/docs/mqtt/discovery/) and when [`unique_id`](#unique_id) is set."
|
||||
required: false
|
||||
type: map
|
||||
keys:
|
||||
identifiers:
|
||||
description: 'A list of IDs that uniquely identify the device. For example a serial number.'
|
||||
required: false
|
||||
type: [list, string]
|
||||
connections:
|
||||
description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": ["mac", "02:5b:26:a8:dc:12"]`.'
|
||||
required: false
|
||||
type: list
|
||||
identifiers:
|
||||
description: 'A list of IDs that uniquely identify the device. For example a serial number.'
|
||||
required: false
|
||||
type: [list, string]
|
||||
manufacturer:
|
||||
description: The manufacturer of the device.
|
||||
required: false
|
||||
@ -65,4 +53,16 @@ device:
|
||||
description: The firmware version of the device.
|
||||
required: false
|
||||
type: string
|
||||
name:
|
||||
description: The name of the camera.
|
||||
required: false
|
||||
type: string
|
||||
topic:
|
||||
description: The MQTT topic to subscribe to.
|
||||
required: true
|
||||
type: string
|
||||
unique_id:
|
||||
description: An ID that uniquely identifies this camera. If two cameras have the same unique ID Home Assistant will raise an exception.
|
||||
required: false
|
||||
type: string
|
||||
{% endconfiguration %}
|
||||
|
@ -21,259 +21,65 @@ climate:
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
name:
|
||||
description: The name of the HVAC.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT HVAC
|
||||
unique_id:
|
||||
description: An ID that uniquely identifies this HVAC device. If two HVAC devices have the same unique ID, Home Assistant will raise an exception.
|
||||
required: false
|
||||
type: string
|
||||
qos:
|
||||
description: The maximum QoS level to be used when receiving and publishing messages.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
retain:
|
||||
description: Defines if published messages should have the retain flag set.
|
||||
required: false
|
||||
type: boolean
|
||||
default: false
|
||||
send_if_off:
|
||||
description: "Set to `false` to suppress sending of all MQTT messages when the current mode is `Off`."
|
||||
required: false
|
||||
type: boolean
|
||||
default: true
|
||||
initial:
|
||||
description: Set the initial target temperature.
|
||||
required: false
|
||||
type: integer
|
||||
default: 21
|
||||
payload_on:
|
||||
description: The payload that represents enabled state.
|
||||
required: false
|
||||
type: string
|
||||
default: "ON"
|
||||
payload_off:
|
||||
description: The payload that represents disabled state.
|
||||
required: false
|
||||
type: string
|
||||
default: "OFF"
|
||||
availability_topic:
|
||||
description: The MQTT topic subscribed to receive availability (online/offline) updates.
|
||||
required: false
|
||||
type: string
|
||||
payload_available:
|
||||
description: The payload that represents the available state.
|
||||
required: false
|
||||
type: string
|
||||
default: online
|
||||
payload_not_available:
|
||||
description: The payload that represents the unavailable state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
value_template:
|
||||
description: Default template to render the payloads on *all* `*_state_topic`s with.
|
||||
type: template
|
||||
required: false
|
||||
current_temperature_topic:
|
||||
description: The MQTT topic on which to listen for the current temperature.
|
||||
required: false
|
||||
type: string
|
||||
current_temperature_template:
|
||||
description: A template with which the value received on `current_temperature_topic` will be rendered.
|
||||
action_template:
|
||||
description: A template to render the value received on the `action_topic` with.
|
||||
required: false
|
||||
type: template
|
||||
power_command_topic:
|
||||
description: The MQTT topic to publish commands to change the power state. This is useful if your device has a separate power toggle in addition to mode.
|
||||
required: false
|
||||
type: string
|
||||
action_topic:
|
||||
description: >-
|
||||
The MQTT topic to subscribe for changes of the current action. If this is set, the climate graph uses the value received as data source.
|
||||
Valid values: `off`, `heating`, `cooling`, `drying`, `idle`, `fan`.
|
||||
required: false
|
||||
type: string
|
||||
action_template:
|
||||
description: A template to render the value received on the `action_topic` with.
|
||||
required: false
|
||||
type: template
|
||||
mode_command_topic:
|
||||
description: The MQTT topic to publish commands to change the HVAC operation mode.
|
||||
required: false
|
||||
type: string
|
||||
mode_state_topic:
|
||||
description: The MQTT topic to subscribe for changes of the HVAC operation mode. If this is not set, the operation mode works in optimistic mode (see below).
|
||||
required: false
|
||||
type: string
|
||||
mode_state_template:
|
||||
description: A template to render the value received on the `mode_state_topic` with.
|
||||
required: false
|
||||
type: template
|
||||
modes:
|
||||
description: A list of supported modes. Needs to be a subset of the default values.
|
||||
required: false
|
||||
default: ['auto', 'off', 'cool', 'heat', 'dry', 'fan_only']
|
||||
type: list
|
||||
action_topic:
|
||||
description: The MQTT topic on which to listen for the current action state of the HVAC. Expects `idle`, `cooling`, `heating`, `drying`, or `off`.
|
||||
required: false
|
||||
type: string
|
||||
action_template:
|
||||
description: A template to render the value received on the `action_topic` with.
|
||||
required: false
|
||||
type: template
|
||||
temperature_command_topic:
|
||||
description: The MQTT topic to publish commands to change the target temperature.
|
||||
required: false
|
||||
type: string
|
||||
temperature_state_topic:
|
||||
description: The MQTT topic to subscribe for changes in the target temperature. If this is not set, the target temperature works in optimistic mode (see below).
|
||||
required: false
|
||||
type: string
|
||||
temperature_state_template:
|
||||
description: A template to render the value received on the `temperature_state_topic` with.
|
||||
required: false
|
||||
type: template
|
||||
temperature_low_command_topic:
|
||||
description: The MQTT topic to publish commands to change the target low temperature.
|
||||
required: false
|
||||
type: string
|
||||
temperature_low_state_topic:
|
||||
description: The MQTT topic to subscribe for changes in the target low temperature. If this is not set, the target low temperature works in optimistic mode (see below).
|
||||
required: false
|
||||
type: string
|
||||
temperature_low_state_template:
|
||||
description: A template to render the value received on the `temperature_low_state_topic` with.
|
||||
required: false
|
||||
type: template
|
||||
temperature_high_command_topic:
|
||||
description: The MQTT topic to publish commands to change the high target temperature.
|
||||
required: false
|
||||
type: string
|
||||
temperature_high_state_topic:
|
||||
description: The MQTT topic to subscribe for changes in the target high temperature. If this is not set, the target high temperature works in optimistic mode (see below).
|
||||
required: false
|
||||
type: string
|
||||
temperature_high_state_template:
|
||||
description: A template to render the value received on the `temperature_high_state_topic` with.
|
||||
required: false
|
||||
type: template
|
||||
precision:
|
||||
description: The desired precision for this device. Can be used to match your actual thermostat's precision. Supported values are `0.1`, `0.5` and `1.0`.
|
||||
required: false
|
||||
type: float
|
||||
default: 0.1 for Celsius and 1.0 for Fahrenheit.
|
||||
fan_mode_command_topic:
|
||||
description: The MQTT topic to publish commands to change the fan mode.
|
||||
required: false
|
||||
type: string
|
||||
fan_mode_state_topic:
|
||||
description: The MQTT topic to subscribe for changes of the HVAC fan mode. If this is not set, the fan mode works in optimistic mode (see below).
|
||||
required: false
|
||||
type: string
|
||||
fan_mode_state_template:
|
||||
description: A template to render the value received on the `fan_mode_state_topic` with.
|
||||
required: false
|
||||
type: template
|
||||
fan_modes:
|
||||
description: A list of supported fan modes.
|
||||
required: false
|
||||
default: ['auto', 'low', 'medium', 'high']
|
||||
type: list
|
||||
swing_mode_command_topic:
|
||||
description: The MQTT topic to publish commands to change the swing mode.
|
||||
required: false
|
||||
type: string
|
||||
swing_mode_state_topic:
|
||||
description: The MQTT topic to subscribe for changes of the HVAC swing mode. If this is not set, the swing mode works in optimistic mode (see below).
|
||||
required: false
|
||||
type: string
|
||||
swing_mode_state_template:
|
||||
description: A template to render the value received on the `swing_mode_state_topic` with.
|
||||
required: false
|
||||
type: template
|
||||
swing_modes:
|
||||
description: A list of supported swing modes.
|
||||
required: false
|
||||
default: ['on', 'off']
|
||||
type: list
|
||||
away_mode_command_topic:
|
||||
description: The MQTT topic to publish commands to change the away mode.
|
||||
required: false
|
||||
type: string
|
||||
away_mode_state_topic:
|
||||
description: The MQTT topic to subscribe for changes of the HVAC away mode. If this is not set, the away mode works in optimistic mode (see below).
|
||||
required: false
|
||||
type: string
|
||||
away_mode_state_template:
|
||||
description: A template to render the value received on the `away_mode_state_topic` with.
|
||||
required: false
|
||||
type: template
|
||||
hold_command_topic:
|
||||
description: The MQTT topic to publish commands to change the hold mode.
|
||||
required: false
|
||||
type: string
|
||||
hold_state_topic:
|
||||
description: The MQTT topic to subscribe for changes of the HVAC hold mode. If this is not set, the hold mode works in optimistic mode (see below).
|
||||
required: false
|
||||
type: string
|
||||
hold_state_template:
|
||||
description: A template to render the value received on the `hold_state_topic` with.
|
||||
required: false
|
||||
type: template
|
||||
hold_modes:
|
||||
description: A list of available hold modes.
|
||||
required: false
|
||||
type: list
|
||||
aux_command_topic:
|
||||
description: The MQTT topic to publish commands to switch auxiliary heat.
|
||||
required: false
|
||||
type: string
|
||||
aux_state_topic:
|
||||
description: The MQTT topic to subscribe for changes of the auxiliary heat mode. If this is not set, the auxiliary heat mode works in optimistic mode (see below).
|
||||
required: false
|
||||
type: string
|
||||
aux_state_template:
|
||||
description: A template to render the value received on the `aux_state_topic` with.
|
||||
required: false
|
||||
type: template
|
||||
min_temp:
|
||||
description: Minimum set point available.
|
||||
type: float
|
||||
required: false
|
||||
max_temp:
|
||||
description: Maximum set point available.
|
||||
type: float
|
||||
required: false
|
||||
temp_step:
|
||||
description: Step size for temperature set point.
|
||||
type: float
|
||||
required: false
|
||||
default: 1
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
aux_state_topic:
|
||||
description: The MQTT topic to subscribe for changes of the auxiliary heat mode. If this is not set, the auxiliary heat mode works in optimistic mode (see below).
|
||||
required: false
|
||||
type: string
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-template-configuration) documentation."
|
||||
availability_topic:
|
||||
description: The MQTT topic subscribed to receive availability (online/offline) updates.
|
||||
required: false
|
||||
type: string
|
||||
away_mode_command_topic:
|
||||
description: The MQTT topic to publish commands to change the away mode.
|
||||
required: false
|
||||
type: string
|
||||
away_mode_state_template:
|
||||
description: A template to render the value received on the `away_mode_state_topic` with.
|
||||
required: false
|
||||
type: template
|
||||
away_mode_state_topic:
|
||||
description: The MQTT topic to subscribe for changes of the HVAC away mode. If this is not set, the away mode works in optimistic mode (see below).
|
||||
required: false
|
||||
type: string
|
||||
current_temperature_template:
|
||||
description: A template with which the value received on `current_temperature_topic` will be rendered.
|
||||
required: false
|
||||
type: template
|
||||
current_temperature_topic:
|
||||
description: The MQTT topic on which to listen for the current temperature.
|
||||
required: false
|
||||
type: string
|
||||
device:
|
||||
description: 'Information about the device this HVAC device is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/docs/mqtt/discovery/) and when [`unique_id`](#unique_id) is set.'
|
||||
required: false
|
||||
type: map
|
||||
keys:
|
||||
identifiers:
|
||||
description: 'A list of IDs that uniquely identify the device. For example a serial number.'
|
||||
required: false
|
||||
type: [list, string]
|
||||
connections:
|
||||
description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": [["mac", "02:5b:26:a8:dc:12"]]`.'
|
||||
required: false
|
||||
type: list
|
||||
identifiers:
|
||||
description: 'A list of IDs that uniquely identify the device. For example a serial number.'
|
||||
required: false
|
||||
type: [list, string]
|
||||
manufacturer:
|
||||
description: 'The manufacturer of the device.'
|
||||
required: false
|
||||
@ -290,6 +96,192 @@ device:
|
||||
description: 'The firmware version of the device.'
|
||||
required: false
|
||||
type: string
|
||||
fan_mode_command_topic:
|
||||
description: The MQTT topic to publish commands to change the fan mode.
|
||||
required: false
|
||||
type: string
|
||||
fan_mode_state_template:
|
||||
description: A template to render the value received on the `fan_mode_state_topic` with.
|
||||
required: false
|
||||
type: template
|
||||
fan_mode_state_topic:
|
||||
description: The MQTT topic to subscribe for changes of the HVAC fan mode. If this is not set, the fan mode works in optimistic mode (see below).
|
||||
required: false
|
||||
type: string
|
||||
fan_modes:
|
||||
description: A list of supported fan modes.
|
||||
required: false
|
||||
default: ['auto', 'low', 'medium', 'high']
|
||||
type: list
|
||||
hold_command_topic:
|
||||
description: The MQTT topic to publish commands to change the hold mode.
|
||||
required: false
|
||||
type: string
|
||||
hold_state_template:
|
||||
description: A template to render the value received on the `hold_state_topic` with.
|
||||
required: false
|
||||
type: template
|
||||
hold_state_topic:
|
||||
description: The MQTT topic to subscribe for changes of the HVAC hold mode. If this is not set, the hold mode works in optimistic mode (see below).
|
||||
required: false
|
||||
type: string
|
||||
hold_modes:
|
||||
description: A list of available hold modes.
|
||||
required: false
|
||||
type: list
|
||||
initial:
|
||||
description: Set the initial target temperature.
|
||||
required: false
|
||||
type: integer
|
||||
default: 21
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-template-configuration) documentation."
|
||||
required: false
|
||||
type: template
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
required: false
|
||||
type: string
|
||||
max_temp:
|
||||
description: Maximum set point available.
|
||||
type: float
|
||||
required: false
|
||||
min_temp:
|
||||
description: Minimum set point available.
|
||||
type: float
|
||||
required: false
|
||||
mode_command_topic:
|
||||
description: The MQTT topic to publish commands to change the HVAC operation mode.
|
||||
required: false
|
||||
type: string
|
||||
mode_state_template:
|
||||
description: A template to render the value received on the `mode_state_topic` with.
|
||||
required: false
|
||||
type: template
|
||||
mode_state_topic:
|
||||
description: The MQTT topic to subscribe for changes of the HVAC operation mode. If this is not set, the operation mode works in optimistic mode (see below).
|
||||
required: false
|
||||
type: string
|
||||
modes:
|
||||
description: A list of supported modes. Needs to be a subset of the default values.
|
||||
required: false
|
||||
default: ['auto', 'off', 'cool', 'heat', 'dry', 'fan_only']
|
||||
type: list
|
||||
name:
|
||||
description: The name of the HVAC.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT HVAC
|
||||
payload_available:
|
||||
description: The payload that represents the available state.
|
||||
required: false
|
||||
type: string
|
||||
default: online
|
||||
payload_not_available:
|
||||
description: The payload that represents the unavailable state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
payload_off:
|
||||
description: The payload that represents disabled state.
|
||||
required: false
|
||||
type: string
|
||||
default: "OFF"
|
||||
payload_on:
|
||||
description: The payload that represents enabled state.
|
||||
required: false
|
||||
type: string
|
||||
default: "ON"
|
||||
power_command_topic:
|
||||
description: The MQTT topic to publish commands to change the power state. This is useful if your device has a separate power toggle in addition to mode.
|
||||
required: false
|
||||
type: string
|
||||
precision:
|
||||
description: The desired precision for this device. Can be used to match your actual thermostat's precision. Supported values are `0.1`, `0.5` and `1.0`.
|
||||
required: false
|
||||
type: float
|
||||
default: 0.1 for Celsius and 1.0 for Fahrenheit.
|
||||
qos:
|
||||
description: The maximum QoS level to be used when receiving and publishing messages.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
retain:
|
||||
description: Defines if published messages should have the retain flag set.
|
||||
required: false
|
||||
type: boolean
|
||||
default: false
|
||||
send_if_off:
|
||||
description: "Set to `false` to suppress sending of all MQTT messages when the current mode is `Off`."
|
||||
required: false
|
||||
type: boolean
|
||||
default: true
|
||||
swing_mode_command_topic:
|
||||
description: The MQTT topic to publish commands to change the swing mode.
|
||||
required: false
|
||||
type: string
|
||||
swing_mode_state_template:
|
||||
description: A template to render the value received on the `swing_mode_state_topic` with.
|
||||
required: false
|
||||
type: template
|
||||
swing_mode_state_topic:
|
||||
description: The MQTT topic to subscribe for changes of the HVAC swing mode. If this is not set, the swing mode works in optimistic mode (see below).
|
||||
required: false
|
||||
type: string
|
||||
swing_modes:
|
||||
description: A list of supported swing modes.
|
||||
required: false
|
||||
default: ['on', 'off']
|
||||
type: list
|
||||
temperature_command_topic:
|
||||
description: The MQTT topic to publish commands to change the target temperature.
|
||||
required: false
|
||||
type: string
|
||||
temperature_high_command_topic:
|
||||
description: The MQTT topic to publish commands to change the high target temperature.
|
||||
required: false
|
||||
type: string
|
||||
temperature_high_state_template:
|
||||
description: A template to render the value received on the `temperature_high_state_topic` with.
|
||||
required: false
|
||||
type: template
|
||||
temperature_high_state_topic:
|
||||
description: The MQTT topic to subscribe for changes in the target high temperature. If this is not set, the target high temperature works in optimistic mode (see below).
|
||||
required: false
|
||||
type: string
|
||||
temperature_low_command_topic:
|
||||
description: The MQTT topic to publish commands to change the target low temperature.
|
||||
required: false
|
||||
type: string
|
||||
temperature_low_state_template:
|
||||
description: A template to render the value received on the `temperature_low_state_topic` with.
|
||||
required: false
|
||||
type: template
|
||||
temperature_low_state_topic:
|
||||
description: The MQTT topic to subscribe for changes in the target low temperature. If this is not set, the target low temperature works in optimistic mode (see below).
|
||||
required: false
|
||||
type: string
|
||||
temperature_state_template:
|
||||
description: A template to render the value received on the `temperature_state_topic` with.
|
||||
required: false
|
||||
type: template
|
||||
temperature_state_topic:
|
||||
description: The MQTT topic to subscribe for changes in the target temperature. If this is not set, the target temperature works in optimistic mode (see below).
|
||||
required: false
|
||||
type: string
|
||||
temp_step:
|
||||
description: Step size for temperature set point.
|
||||
type: float
|
||||
required: false
|
||||
default: 1
|
||||
unique_id:
|
||||
description: An ID that uniquely identifies this HVAC device. If two HVAC devices have the same unique ID, Home Assistant will raise an exception.
|
||||
required: false
|
||||
type: string
|
||||
value_template:
|
||||
description: Default template to render the payloads on *all* `*_state_topic`s with.
|
||||
type: template
|
||||
required: false
|
||||
{% endconfiguration %}
|
||||
|
||||
#### Optimistic mode
|
||||
|
@ -36,4 +36,4 @@ display_currency_decimals:
|
||||
default: 2
|
||||
{% endconfiguration %}
|
||||
|
||||
All supported currencies can be found [here](https://coinmarketcap.com/api/), a list of currency IDs can be found [here](https://api.coinmarketcap.com/v2/ticker/).
|
||||
All supported currencies can be found [here](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions), a list of currency IDs can be found [here](https://api.coinmarketcap.com/v2/ticker/).
|
||||
|
@ -37,165 +37,12 @@ cover:
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
command_topic:
|
||||
description: The MQTT topic to publish commands to control the cover.
|
||||
required: false
|
||||
type: string
|
||||
name:
|
||||
description: The name of the cover.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT Cover
|
||||
payload_open:
|
||||
description: The command payload that opens the cover.
|
||||
required: false
|
||||
type: string
|
||||
default: OPEN
|
||||
payload_close:
|
||||
description: The command payload that closes the cover.
|
||||
required: false
|
||||
type: string
|
||||
default: CLOSE
|
||||
payload_stop:
|
||||
description: The command payload that stops the cover.
|
||||
required: false
|
||||
type: string
|
||||
default: STOP
|
||||
state_topic:
|
||||
description: The MQTT topic subscribed to receive cover state messages. Use only if not using `position_topic`. State topic can only read open/close state. Cannot read position state. If `position_topic` is set `state_topic` is ignored.
|
||||
required: false
|
||||
type: string
|
||||
state_open:
|
||||
description: The payload that represents the open state.
|
||||
required: false
|
||||
type: string
|
||||
default: open
|
||||
state_opening:
|
||||
description: The payload that represents the opening state.
|
||||
required: false
|
||||
type: string
|
||||
default: opening
|
||||
state_closed:
|
||||
description: The payload that represents the closed state.
|
||||
required: false
|
||||
type: string
|
||||
default: closed
|
||||
state_closing:
|
||||
description: The payload that represents the closing state.
|
||||
required: false
|
||||
type: string
|
||||
default: closing
|
||||
position_topic:
|
||||
description: The MQTT topic subscribed to receive cover position messages. If `position_topic` is set `state_topic` is ignored.
|
||||
required: false
|
||||
type: string
|
||||
position_open:
|
||||
description: Number which represents open position.
|
||||
required: false
|
||||
type: integer
|
||||
default: 100
|
||||
position_closed:
|
||||
description: Number which represents closed position.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
availability_topic:
|
||||
description: "The MQTT topic subscribed to to receive birth and LWT messages from the MQTT cover device. If `availability_topic` is not defined, the cover availability state will always be `available`. If `availability_topic` is defined, the cover availability state will be `unavailable` by default."
|
||||
required: false
|
||||
type: string
|
||||
payload_available:
|
||||
description: The payload that represents the online state.
|
||||
required: false
|
||||
type: string
|
||||
default: online
|
||||
payload_not_available:
|
||||
description: The payload that represents the offline state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
optimistic:
|
||||
description: Flag that defines if switch works in optimistic mode.
|
||||
required: false
|
||||
type: string
|
||||
default: "`true` if no state topic defined, else `false`."
|
||||
qos:
|
||||
description: The maximum QoS level to be used when receiving and publishing messages.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
retain:
|
||||
description: Defines if published messages should have the retain flag set.
|
||||
required: false
|
||||
type: boolean
|
||||
default: false
|
||||
value_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract a value from the payload."
|
||||
required: false
|
||||
type: string
|
||||
set_position_topic:
|
||||
description: "The MQTT topic to publish position commands to. You need to set position_topic as well if you want to use position topic. Use template if position topic wants different values than within range `position_closed` - `position_open`. If template is not defined and `position_closed != 100` and `position_open != 0` then proper position value is calculated from percentage position."
|
||||
required: false
|
||||
type: string
|
||||
set_position_template:
|
||||
description: "Defines a [template](/topics/templating/) to define the position to be sent to the `set_position_topic` topic. Incoming position value is available for use in the template `{{position}}`. If no template is defined, the position (0-100) will be calculated according to `position_open` and `position_closed` values."
|
||||
required: false
|
||||
type: string
|
||||
tilt_command_topic:
|
||||
description: The MQTT topic to publish commands to control the cover tilt.
|
||||
required: false
|
||||
type: string
|
||||
tilt_status_topic:
|
||||
description: The MQTT topic subscribed to receive tilt status update values.
|
||||
required: false
|
||||
type: string
|
||||
tilt_status_template:
|
||||
description: "Defines a [template](/topics/templating/) that can be used to extract the payload for the `tilt_status_topic` topic. "
|
||||
required: false
|
||||
type: string
|
||||
tilt_min:
|
||||
description: The minimum tilt value.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
tilt_max:
|
||||
description: The maximum tilt value
|
||||
required: false
|
||||
type: integer
|
||||
default: 100
|
||||
tilt_closed_value:
|
||||
description: The value that will be sent on a `close_cover_tilt` command.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
tilt_opened_value:
|
||||
description: The value that will be sent on an `open_cover_tilt` command.
|
||||
required: false
|
||||
type: integer
|
||||
default: 100
|
||||
tilt_optimistic:
|
||||
description: Flag that determines if tilt works in optimistic mode.
|
||||
required: false
|
||||
type: boolean
|
||||
default: "`true` if `tilt_status_topic` is not defined, else `false`"
|
||||
tilt_invert_state:
|
||||
description: Flag that determines if open/close are flipped; higher values toward closed and lower values toward open.
|
||||
required: false
|
||||
type: boolean
|
||||
default: false
|
||||
device_class:
|
||||
description: Sets the [class of the device](/integrations/cover/), changing the device state and icon that is displayed on the frontend.
|
||||
required: false
|
||||
type: string
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
required: false
|
||||
type: string
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-template-configuration) documentation."
|
||||
required: false
|
||||
type: template
|
||||
unique_id:
|
||||
description: An ID that uniquely identifies this cover. If two covers have the same unique ID, Home Assistant will raise an exception.
|
||||
command_topic:
|
||||
description: The MQTT topic to publish commands to control the cover.
|
||||
required: false
|
||||
type: string
|
||||
device:
|
||||
@ -203,14 +50,14 @@ device:
|
||||
required: false
|
||||
type: map
|
||||
keys:
|
||||
identifiers:
|
||||
description: 'A list of IDs that uniquely identify the device. For example a serial number.'
|
||||
required: false
|
||||
type: [list, string]
|
||||
connections:
|
||||
description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": ["mac", "02:5b:26:a8:dc:12"]`.'
|
||||
required: false
|
||||
type: list
|
||||
identifiers:
|
||||
description: 'A list of IDs that uniquely identify the device. For example a serial number.'
|
||||
required: false
|
||||
type: [list, string]
|
||||
manufacturer:
|
||||
description: The manufacturer of the device.
|
||||
required: false
|
||||
@ -227,6 +74,159 @@ device:
|
||||
description: The firmware version of the device.
|
||||
required: false
|
||||
type: string
|
||||
device_class:
|
||||
description: Sets the [class of the device](/integrations/cover/), changing the device state and icon that is displayed on the frontend.
|
||||
required: false
|
||||
type: string
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-template-configuration) documentation."
|
||||
required: false
|
||||
type: template
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
required: false
|
||||
type: string
|
||||
name:
|
||||
description: The name of the cover.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT Cover
|
||||
optimistic:
|
||||
description: Flag that defines if switch works in optimistic mode.
|
||||
required: false
|
||||
type: string
|
||||
default: "`true` if no state topic defined, else `false`."
|
||||
payload_available:
|
||||
description: The payload that represents the online state.
|
||||
required: false
|
||||
type: string
|
||||
default: online
|
||||
payload_close:
|
||||
description: The command payload that closes the cover.
|
||||
required: false
|
||||
type: string
|
||||
default: CLOSE
|
||||
payload_not_available:
|
||||
description: The payload that represents the offline state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
payload_open:
|
||||
description: The command payload that opens the cover.
|
||||
required: false
|
||||
type: string
|
||||
default: OPEN
|
||||
payload_stop:
|
||||
description: The command payload that stops the cover.
|
||||
required: false
|
||||
type: string
|
||||
default: STOP
|
||||
position_closed:
|
||||
description: Number which represents closed position.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
position_open:
|
||||
description: Number which represents open position.
|
||||
required: false
|
||||
type: integer
|
||||
default: 100
|
||||
position_topic:
|
||||
description: The MQTT topic subscribed to receive cover position messages. If `position_topic` is set `state_topic` is ignored.
|
||||
required: false
|
||||
type: string
|
||||
qos:
|
||||
description: The maximum QoS level to be used when receiving and publishing messages.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
retain:
|
||||
description: Defines if published messages should have the retain flag set.
|
||||
required: false
|
||||
type: boolean
|
||||
default: false
|
||||
set_position_template:
|
||||
description: "Defines a [template](/topics/templating/) to define the position to be sent to the `set_position_topic` topic. Incoming position value is available for use in the template `{{position}}`. If no template is defined, the position (0-100) will be calculated according to `position_open` and `position_closed` values."
|
||||
required: false
|
||||
type: string
|
||||
set_position_topic:
|
||||
description: "The MQTT topic to publish position commands to. You need to set position_topic as well if you want to use position topic. Use template if position topic wants different values than within range `position_closed` - `position_open`. If template is not defined and `position_closed != 100` and `position_open != 0` then proper position value is calculated from percentage position."
|
||||
required: false
|
||||
type: string
|
||||
state_closed:
|
||||
description: The payload that represents the closed state.
|
||||
required: false
|
||||
type: string
|
||||
default: closed
|
||||
state_closing:
|
||||
description: The payload that represents the closing state.
|
||||
required: false
|
||||
type: string
|
||||
default: closing
|
||||
state_open:
|
||||
description: The payload that represents the open state.
|
||||
required: false
|
||||
type: string
|
||||
default: open
|
||||
state_opening:
|
||||
description: The payload that represents the opening state.
|
||||
required: false
|
||||
type: string
|
||||
default: opening
|
||||
state_topic:
|
||||
description: The MQTT topic subscribed to receive cover state messages. Use only if not using `position_topic`. State topic can only read open/close state. Cannot read position state. If `position_topic` is set `state_topic` is ignored.
|
||||
required: false
|
||||
type: string
|
||||
tilt_closed_value:
|
||||
description: The value that will be sent on a `close_cover_tilt` command.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
tilt_command_topic:
|
||||
description: The MQTT topic to publish commands to control the cover tilt.
|
||||
required: false
|
||||
type: string
|
||||
tilt_invert_state:
|
||||
description: Flag that determines if open/close are flipped; higher values toward closed and lower values toward open.
|
||||
required: false
|
||||
type: boolean
|
||||
default: false
|
||||
tilt_max:
|
||||
description: The maximum tilt value
|
||||
required: false
|
||||
type: integer
|
||||
default: 100
|
||||
tilt_min:
|
||||
description: The minimum tilt value.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
tilt_opened_value:
|
||||
description: The value that will be sent on an `open_cover_tilt` command.
|
||||
required: false
|
||||
type: integer
|
||||
default: 100
|
||||
tilt_optimistic:
|
||||
description: Flag that determines if tilt works in optimistic mode.
|
||||
required: false
|
||||
type: boolean
|
||||
default: "`true` if `tilt_status_topic` is not defined, else `false`"
|
||||
tilt_status_template:
|
||||
description: "Defines a [template](/topics/templating/) that can be used to extract the payload for the `tilt_status_topic` topic. "
|
||||
required: false
|
||||
type: string
|
||||
tilt_status_topic:
|
||||
description: The MQTT topic subscribed to receive tilt status update values.
|
||||
required: false
|
||||
type: string
|
||||
unique_id:
|
||||
description: An ID that uniquely identifies this cover. If two covers have the same unique ID, Home Assistant will raise an exception.
|
||||
required: false
|
||||
type: string
|
||||
value_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract a value from the payload."
|
||||
required: false
|
||||
type: string
|
||||
{% endconfiguration %}
|
||||
|
||||
## Examples
|
||||
|
@ -417,6 +417,8 @@ The `entity_id` name will be `cover.device_name`, where `device_name` is defined
|
||||
|
||||
### Verified supported covers
|
||||
|
||||
- IKEA Fyrtur
|
||||
- IKEA Kadrilj
|
||||
- Keen vents
|
||||
- Xiaomi Aqara Curtain controller
|
||||
|
||||
|
75
source/_integrations/device_trigger.mqtt.markdown
Normal file
75
source/_integrations/device_trigger.mqtt.markdown
Normal file
@ -0,0 +1,75 @@
|
||||
---
|
||||
title: "MQTT Device Trigger"
|
||||
description: "Instructions on how to integrate MQTT device triggers within Home Assistant."
|
||||
logo: mqtt.png
|
||||
ha_category:
|
||||
- Device Automation
|
||||
ha_release: 0.106
|
||||
ha_iot_class: Configurable
|
||||
---
|
||||
|
||||
The `mqtt` device trigger platform uses an MQTT message payload to generate device trigger events.
|
||||
|
||||
An MQTT device trigger is a better option than a [binary sensor](/integrations/binary_sensor.mqtt/) for buttons, remote controls etc.
|
||||
|
||||
## Configuration
|
||||
|
||||
MQTT device triggers are only supported through [MQTT discovery](/docs/mqtt/discovery/), manual setup through `configuration.yaml` is not supported.
|
||||
The discovery topic needs to be: `<discovery_prefix>/device_automation/[<node_id>/]<object_id>/config`.
|
||||
|
||||
{% configuration %}
|
||||
automation_type:
|
||||
description: The type of automation, must be 'trigger'.
|
||||
required: true
|
||||
type: string
|
||||
payload:
|
||||
description: Optional payload to match the payload being sent over the topic.
|
||||
required: false
|
||||
type: string
|
||||
qos:
|
||||
description: The maximum QoS level to be used when receiving messages.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
topic:
|
||||
description: The MQTT topic subscribed to receive trigger events.
|
||||
required: true
|
||||
type: string
|
||||
type:
|
||||
description: "The type of the trigger, e.g. `button_short_press`. Entries supported by the frontend: `button_short_press`, `button_short_release`, `button_long_press`, `button_long_release`, `button_double_press`, `button_triple_press`, `button_quadruple_press`, `button_quintuple_press`. If set to an unsupported value, will render as `subtype type`, e.g. `First button spammed` with `type` set to `spammed` and `subtype` set to `button_1`"
|
||||
required: true
|
||||
type: string
|
||||
subtype:
|
||||
description: "The subtype of the trigger, e.g. `button_1`. Entries supported by the frontend: `turn_on`, `turn_off`, `button_1`, `button_2`, `button_3`, `button_4`, `button_5`, `button_6`. If set to an unsupported value, will render as `subtype type`, e.g. `left_button pressed` with `type` set to `button_short_press` and `subtype` set to `left_button`"
|
||||
required: true
|
||||
type: string
|
||||
device:
|
||||
description: "Information about the device this device trigger is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html)."
|
||||
required: true
|
||||
type: map
|
||||
keys:
|
||||
connections:
|
||||
description: "A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `'connections': ['mac', '02:5b:26:a8:dc:12']`."
|
||||
required: false
|
||||
type: [list, map]
|
||||
identifiers:
|
||||
description: A list of IDs that uniquely identify the device. For example a serial number.
|
||||
required: false
|
||||
type: [list, string]
|
||||
manufacturer:
|
||||
description: The manufacturer of the device.
|
||||
required: false
|
||||
type: string
|
||||
model:
|
||||
description: The model of the device.
|
||||
required: false
|
||||
type: string
|
||||
name:
|
||||
description: The name of the device.
|
||||
required: false
|
||||
type: string
|
||||
sw_version:
|
||||
description: The firmware version of the device.
|
||||
required: false
|
||||
type: string
|
||||
{% endconfiguration %}
|
@ -8,4 +8,102 @@ ha_release: 0.27
|
||||
ha_quality_scale: internal
|
||||
---
|
||||
|
||||
The `fan` integration is built for the controlling of fan devices.
|
||||
The Fan integration allows you to control and monitor Fan devices.
|
||||
|
||||
## Services
|
||||
|
||||
### Fan control services
|
||||
|
||||
Available services:
|
||||
`fan.set_speed`, `fan.set_direction`, `fan.oscillate`, `fan.turn_on`, `fan.turn_off`, `fan.toggle`
|
||||
|
||||
<div class='note'>
|
||||
|
||||
Not all fan services may be available for your platform. Be sure to check the available services Home Assistant has enabled by checking <img src='/images/screenshots/developer-tool-services-icon.png' alt='service developer tool icon' class="no-shadow" height="38" /> **Services**.
|
||||
|
||||
</div>
|
||||
|
||||
### Service `fan.set_speed`
|
||||
|
||||
Sets the speed for fan device
|
||||
|
||||
| Service data attribute | Optional | Description |
|
||||
| ---------------------- | -------- | ----------- |
|
||||
| `entity_id` | yes | String or list of strings that define the entity ID(s) of fan device(s) to control. To target all fan devices, use `all`.
|
||||
| `speed` | no | Speed setting
|
||||
|
||||
#### Automation example
|
||||
|
||||
```yaml
|
||||
automation:
|
||||
trigger:
|
||||
platform: time
|
||||
at: "07:15:00"
|
||||
action:
|
||||
- service: fan.set_speed
|
||||
data:
|
||||
entity_id: fan.kitchen
|
||||
speed: low
|
||||
```
|
||||
|
||||
### Service `fan.set_direction`
|
||||
|
||||
Sets the rotation for fan device
|
||||
|
||||
| Service data attribute | Optional | Description |
|
||||
| ---------------------- | -------- | ----------- |
|
||||
| `entity_id` | yes | String or list of strings that define the entity ID(s) of fan device(s) to control. To target all fan devices, use `all`.
|
||||
| `direction` | no | The direction to rotate. Either `forward` or `reverse`
|
||||
|
||||
#### Automation example
|
||||
|
||||
```yaml
|
||||
automation:
|
||||
trigger:
|
||||
platform: time
|
||||
at: "07:15:00"
|
||||
action:
|
||||
- service: fan.set_direction
|
||||
data:
|
||||
entity_id: fan.kitchen
|
||||
direction: forward
|
||||
```
|
||||
|
||||
### Service `fan.oscillate`
|
||||
|
||||
Sets the oscillation for fan device
|
||||
|
||||
| Service data attribute | Optional | Description |
|
||||
| ---------------------- | -------- | ----------- |
|
||||
| `entity_id` | yes | String or list of strings that define the entity ID(s) of fan device(s) to control. To target all fan devices, use `all`.
|
||||
| `oscillating` | no | Flag to turn on/off oscillation. Either `True` or `False`.
|
||||
|
||||
#### Automation example
|
||||
|
||||
```yaml
|
||||
automation:
|
||||
trigger:
|
||||
platform: time
|
||||
at: "07:15:00"
|
||||
action:
|
||||
- service: fan.oscillate
|
||||
data:
|
||||
entity_id: fan.kitchen
|
||||
oscillating: True
|
||||
```
|
||||
|
||||
### Service `fan.turn_on`
|
||||
|
||||
Turn fan device on. This is only supported if the fan device supports being turned off.
|
||||
|
||||
| Service data attribute | Optional | Description |
|
||||
| ---------------------- | -------- | ----------- |
|
||||
| `entity_id` | yes | String or list of strings that define the entity ID(s) of fan device(s) to control. To target all fan devices, use `all`.
|
||||
|
||||
### Service `fan.turn_off`
|
||||
|
||||
Turn fan device off. This is only supported if the fan device supports being turned on.
|
||||
|
||||
| Service data attribute | Optional | Description |
|
||||
| ---------------------- | -------- | ----------- |
|
||||
| `entity_id` | yes | String or list of strings that define the entity ID(s) of fan device(s) to control. To target all fan devices, use `all`.
|
@ -28,140 +28,27 @@ fan:
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
command_topic:
|
||||
description: The MQTT topic to publish commands to change the fan state.
|
||||
required: true
|
||||
type: string
|
||||
name:
|
||||
description: The name of the fan.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT Fan
|
||||
state_topic:
|
||||
description: The MQTT topic subscribed to receive state updates.
|
||||
required: false
|
||||
type: string
|
||||
payload_on:
|
||||
description: The payload that represents the running state.
|
||||
required: false
|
||||
type: string
|
||||
default: "ON"
|
||||
payload_off:
|
||||
description: The payload that represents the stop state.
|
||||
required: false
|
||||
type: string
|
||||
default: "OFF"
|
||||
state_value_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract a value from the state."
|
||||
required: false
|
||||
type: string
|
||||
qos:
|
||||
description: The maximum QoS level of the state topic.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
optimistic:
|
||||
description: Flag that defines if lock works in optimistic mode
|
||||
required: false
|
||||
type: boolean
|
||||
default: "`true` if no state topic defined, else `false`."
|
||||
retain:
|
||||
description: If the published message should have the retain flag on or not.
|
||||
required: false
|
||||
type: boolean
|
||||
default: true
|
||||
oscillation_state_topic:
|
||||
description: The MQTT topic subscribed to receive oscillation state updates.
|
||||
required: false
|
||||
type: string
|
||||
oscillation_command_topic:
|
||||
description: The MQTT topic to publish commands to change the oscillation state.
|
||||
required: false
|
||||
type: string
|
||||
payload_oscillation_on:
|
||||
description: The payload that represents the oscillation on state.
|
||||
required: false
|
||||
type: string
|
||||
default: oscillate_on
|
||||
payload_oscillation_off:
|
||||
description: The payload that represents the oscillation off state.
|
||||
required: false
|
||||
type: string
|
||||
default: oscillate_off
|
||||
oscillation_value_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract a value from the oscillation."
|
||||
required: false
|
||||
type: string
|
||||
speed_state_topic:
|
||||
description: The MQTT topic subscribed to receive speed state updates.
|
||||
required: false
|
||||
type: string
|
||||
speed_command_topic:
|
||||
description: The MQTT topic to publish commands to change speed state.
|
||||
required: false
|
||||
type: string
|
||||
payload_low_speed:
|
||||
description: The payload that represents the fan's low speed.
|
||||
required: false
|
||||
type: string
|
||||
default: low
|
||||
payload_medium_speed:
|
||||
description: The payload that represents the fan's medium speed.
|
||||
required: false
|
||||
type: string
|
||||
default: medium
|
||||
payload_high_speed:
|
||||
description: The payload that represents the fan's high speed.
|
||||
required: false
|
||||
type: string
|
||||
default: high
|
||||
speed_value_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract a value from the speed payload."
|
||||
required: false
|
||||
type: string
|
||||
speeds:
|
||||
description: "List of speeds this fan is capable of running at. Valid entries are `off`, `low`, `medium` and `high`."
|
||||
required: false
|
||||
type: [string, list]
|
||||
availability_topic:
|
||||
description: The MQTT topic subscribed to receive availability (online/offline) updates.
|
||||
required: false
|
||||
type: string
|
||||
payload_available:
|
||||
description: The payload that represents the available state.
|
||||
required: false
|
||||
type: string
|
||||
default: online
|
||||
payload_not_available:
|
||||
description: The payload that represents the unavailable state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
required: false
|
||||
type: string
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-template-configuration) documentation."
|
||||
required: false
|
||||
type: template
|
||||
unique_id:
|
||||
description: An ID that uniquely identifies this fan. If two fans have the same unique ID, Home Assistant will raise an exception.
|
||||
required: false
|
||||
command_topic:
|
||||
description: The MQTT topic to publish commands to change the fan state.
|
||||
required: true
|
||||
type: string
|
||||
device:
|
||||
description: "Information about the device this fan is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/docs/mqtt/discovery/) and when [`unique_id`](#unique_id) is set."
|
||||
required: false
|
||||
type: map
|
||||
keys:
|
||||
identifiers:
|
||||
description: A list of IDs that uniquely identify the device. For example a serial number.
|
||||
required: false
|
||||
type: [string, list]
|
||||
connections:
|
||||
description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": [["mac", "02:5b:26:a8:dc:12"]]`.'
|
||||
required: false
|
||||
type: [list, map]
|
||||
identifiers:
|
||||
description: A list of IDs that uniquely identify the device. For example a serial number.
|
||||
required: false
|
||||
type: [string, list]
|
||||
manufacturer:
|
||||
description: The manufacturer of the device.
|
||||
required: false
|
||||
@ -178,6 +65,119 @@ device:
|
||||
description: The firmware version of the device.
|
||||
required: false
|
||||
type: string
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-template-configuration) documentation."
|
||||
required: false
|
||||
type: template
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
required: false
|
||||
type: string
|
||||
name:
|
||||
description: The name of the fan.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT Fan
|
||||
optimistic:
|
||||
description: Flag that defines if lock works in optimistic mode
|
||||
required: false
|
||||
type: boolean
|
||||
default: "`true` if no state topic defined, else `false`."
|
||||
oscillation_command_topic:
|
||||
description: The MQTT topic to publish commands to change the oscillation state.
|
||||
required: false
|
||||
type: string
|
||||
oscillation_state_topic:
|
||||
description: The MQTT topic subscribed to receive oscillation state updates.
|
||||
required: false
|
||||
type: string
|
||||
oscillation_value_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract a value from the oscillation."
|
||||
required: false
|
||||
type: string
|
||||
payload_available:
|
||||
description: The payload that represents the available state.
|
||||
required: false
|
||||
type: string
|
||||
default: online
|
||||
payload_high_speed:
|
||||
description: The payload that represents the fan's high speed.
|
||||
required: false
|
||||
type: string
|
||||
default: high
|
||||
payload_low_speed:
|
||||
description: The payload that represents the fan's low speed.
|
||||
required: false
|
||||
type: string
|
||||
default: low
|
||||
payload_medium_speed:
|
||||
description: The payload that represents the fan's medium speed.
|
||||
required: false
|
||||
type: string
|
||||
default: medium
|
||||
payload_not_available:
|
||||
description: The payload that represents the unavailable state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
payload_off:
|
||||
description: The payload that represents the stop state.
|
||||
required: false
|
||||
type: string
|
||||
default: "OFF"
|
||||
payload_on:
|
||||
description: The payload that represents the running state.
|
||||
required: false
|
||||
type: string
|
||||
default: "ON"
|
||||
payload_oscillation_off:
|
||||
description: The payload that represents the oscillation off state.
|
||||
required: false
|
||||
type: string
|
||||
default: oscillate_off
|
||||
payload_oscillation_on:
|
||||
description: The payload that represents the oscillation on state.
|
||||
required: false
|
||||
type: string
|
||||
default: oscillate_on
|
||||
qos:
|
||||
description: The maximum QoS level of the state topic.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
retain:
|
||||
description: If the published message should have the retain flag on or not.
|
||||
required: false
|
||||
type: boolean
|
||||
default: true
|
||||
speed_command_topic:
|
||||
description: The MQTT topic to publish commands to change speed state.
|
||||
required: false
|
||||
type: string
|
||||
speed_state_topic:
|
||||
description: The MQTT topic subscribed to receive speed state updates.
|
||||
required: false
|
||||
type: string
|
||||
speed_value_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract a value from the speed payload."
|
||||
required: false
|
||||
type: string
|
||||
speeds:
|
||||
description: "List of speeds this fan is capable of running at. Valid entries are `off`, `low`, `medium` and `high`."
|
||||
required: false
|
||||
type: [string, list]
|
||||
state_topic:
|
||||
description: The MQTT topic subscribed to receive state updates.
|
||||
required: false
|
||||
type: string
|
||||
state_value_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract a value from the state."
|
||||
required: false
|
||||
type: string
|
||||
unique_id:
|
||||
description: An ID that uniquely identifies this fan. If two fans have the same unique ID, Home Assistant will raise an exception.
|
||||
required: false
|
||||
type: string
|
||||
{% endconfiguration %}
|
||||
|
||||
<div class='note warning'>
|
||||
|
@ -91,7 +91,7 @@ the standard ones:
|
||||
|
||||
```yaml
|
||||
# Example configuration.yaml entry
|
||||
geonetnz_quakes:
|
||||
geonetnz_volcano:
|
||||
radius: 100
|
||||
latitude: -41.2
|
||||
longitude: 174.7
|
||||
|
@ -45,19 +45,10 @@ light:
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
name:
|
||||
description: The name of the light.
|
||||
availability_topic:
|
||||
description: The MQTT topic subscribed to receive availability (online/offline) updates.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT Light
|
||||
unique_id:
|
||||
description: An ID that uniquely identifies this light. If two lights have the same unique ID, Home Assistant will raise an exception.
|
||||
required: false
|
||||
type: string
|
||||
command_topic:
|
||||
description: The MQTT topic to publish commands to change the switch state.
|
||||
required: true
|
||||
type: string
|
||||
brightness_command_topic:
|
||||
description: The MQTT topic to publish commands to change the light’s brightness.
|
||||
required: false
|
||||
@ -91,10 +82,47 @@ color_temp_value_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the color temperature value."
|
||||
required: false
|
||||
type: string
|
||||
command_topic:
|
||||
description: The MQTT topic to publish commands to change the switch state.
|
||||
required: true
|
||||
type: string
|
||||
device:
|
||||
description: 'Information about the device this light is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/docs/mqtt/discovery/) and when [`unique_id`](#unique_id) is set.'
|
||||
required: false
|
||||
type: map
|
||||
keys:
|
||||
connections:
|
||||
description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": [["mac", "02:5b:26:a8:dc:12"]]`.'
|
||||
required: false
|
||||
type: list
|
||||
identifiers:
|
||||
description: 'A list of IDs that uniquely identify the device. For example a serial number.'
|
||||
required: false
|
||||
type: [string, list]
|
||||
manufacturer:
|
||||
description: 'The manufacturer of the device.'
|
||||
required: false
|
||||
type: string
|
||||
model:
|
||||
description: 'The model of the device.'
|
||||
required: false
|
||||
type: string
|
||||
name:
|
||||
description: 'The name of the device.'
|
||||
required: false
|
||||
type: string
|
||||
sw_version:
|
||||
description: 'The firmware version of the device.'
|
||||
required: false
|
||||
type: string
|
||||
effect_command_topic:
|
||||
description: "The MQTT topic to publish commands to change the light's effect state."
|
||||
required: false
|
||||
type: string
|
||||
effect_list:
|
||||
description: The list of effects the light supports.
|
||||
required: false
|
||||
type: [string, list]
|
||||
effect_state_topic:
|
||||
description: The MQTT topic subscribed to receive effect state updates.
|
||||
required: false
|
||||
@ -103,10 +131,6 @@ effect_value_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the effect value."
|
||||
required: false
|
||||
type: string
|
||||
effect_list:
|
||||
description: The list of effects the light supports.
|
||||
required: false
|
||||
type: [string, list]
|
||||
hs_command_topic:
|
||||
description: "The MQTT topic to publish commands to change the light's color state in HS format (Hue Saturation).
|
||||
Range for Hue: 0° .. 360°, Range of Saturation: 0..100.
|
||||
@ -122,6 +146,19 @@ hs_value_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the HS value."
|
||||
required: false
|
||||
type: string
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-template-configuration) documentation."
|
||||
required: false
|
||||
type: template
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
required: false
|
||||
type: string
|
||||
name:
|
||||
description: The name of the light.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT Light
|
||||
on_command_type:
|
||||
description: "Defines when on the payload_on is sent. Using `last` (the default) will send any style (brightness, color, etc) topics first and then a `payload_on` to the `command_topic`. Using `first` will send the `payload_on` and then any style topics. Using `brightness` will only send brightness commands instead of the `payload_on` to turn the light on."
|
||||
required: false
|
||||
@ -131,16 +168,26 @@ optimistic:
|
||||
required: false
|
||||
type: boolean
|
||||
default: "`true` if no state topic defined, else `false`."
|
||||
payload_on:
|
||||
description: The payload that represents enabled state.
|
||||
payload_available:
|
||||
description: The payload that represents the available state.
|
||||
required: false
|
||||
type: string
|
||||
default: "ON"
|
||||
default: online
|
||||
payload_not_available:
|
||||
description: The payload that represents the unavailable state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
payload_off:
|
||||
description: The payload that represents disabled state.
|
||||
required: false
|
||||
type: string
|
||||
default: "OFF"
|
||||
payload_on:
|
||||
description: The payload that represents enabled state.
|
||||
required: false
|
||||
type: string
|
||||
default: "ON"
|
||||
qos:
|
||||
description: The maximum QoS level of the state topic.
|
||||
required: false
|
||||
@ -175,6 +222,10 @@ state_value_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the state value. The template should match the payload `on` and `off` values, so if your light uses `power on` to turn on, your `state_value_template` string should return `power on` when the switch is on. For example if the message is just `on`, your `state_value_template` should be `power {{ value }}`."
|
||||
required: false
|
||||
type: string
|
||||
unique_id:
|
||||
description: An ID that uniquely identifies this light. If two lights have the same unique ID, Home Assistant will raise an exception.
|
||||
required: false
|
||||
type: string
|
||||
white_value_command_topic:
|
||||
description: "The MQTT topic to publish commands to change the light's white value."
|
||||
required: false
|
||||
@ -204,57 +255,6 @@ xy_value_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the XY value."
|
||||
required: false
|
||||
type: string
|
||||
availability_topic:
|
||||
description: The MQTT topic subscribed to receive availability (online/offline) updates.
|
||||
required: false
|
||||
type: string
|
||||
payload_available:
|
||||
description: The payload that represents the available state.
|
||||
required: false
|
||||
type: string
|
||||
default: online
|
||||
payload_not_available:
|
||||
description: The payload that represents the unavailable state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
required: false
|
||||
type: string
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-template-configuration) documentation."
|
||||
required: false
|
||||
type: template
|
||||
device:
|
||||
description: 'Information about the device this light is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/docs/mqtt/discovery/) and when [`unique_id`](#unique_id) is set.'
|
||||
required: false
|
||||
type: map
|
||||
keys:
|
||||
identifiers:
|
||||
description: 'A list of IDs that uniquely identify the device. For example a serial number.'
|
||||
required: false
|
||||
type: [string, list]
|
||||
connections:
|
||||
description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": [["mac", "02:5b:26:a8:dc:12"]]`.'
|
||||
required: false
|
||||
type: list
|
||||
manufacturer:
|
||||
description: 'The manufacturer of the device.'
|
||||
required: false
|
||||
type: string
|
||||
model:
|
||||
description: 'The model of the device.'
|
||||
required: false
|
||||
type: string
|
||||
name:
|
||||
description: 'The name of the device.'
|
||||
required: false
|
||||
type: string
|
||||
sw_version:
|
||||
description: 'The firmware version of the device.'
|
||||
required: false
|
||||
type: string
|
||||
{% endconfiguration %}
|
||||
|
||||
<div class='note warning'>
|
||||
@ -382,19 +382,10 @@ light:
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
name:
|
||||
description: The name of the light.
|
||||
availability_topic:
|
||||
description: The MQTT topic subscribed to receive availability (online/offline) updates.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT JSON Light
|
||||
unique_id:
|
||||
description: An ID that uniquely identifies this light. If two lights have the same unique ID, Home Assistant will raise an exception.
|
||||
required: false
|
||||
type: string
|
||||
command_topic:
|
||||
description: The MQTT topic to publish commands to change the light’s state.
|
||||
required: true
|
||||
type: string
|
||||
brightness:
|
||||
description: Flag that defines if the light supports brightness.
|
||||
required: false
|
||||
@ -410,6 +401,39 @@ color_temp:
|
||||
required: false
|
||||
type: boolean
|
||||
default: false
|
||||
command_topic:
|
||||
description: The MQTT topic to publish commands to change the light’s state.
|
||||
required: true
|
||||
type: string
|
||||
device:
|
||||
description: 'Information about the device this light is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/docs/mqtt/discovery/) and when [`unique_id`](#unique_id) is set.'
|
||||
required: false
|
||||
type: map
|
||||
keys:
|
||||
connections:
|
||||
description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": [["mac", "02:5b:26:a8:dc:12"]]`.'
|
||||
required: false
|
||||
type: list
|
||||
identifiers:
|
||||
description: 'A list of IDs that uniquely identify the device. For example a serial number.'
|
||||
required: false
|
||||
type: [string, list]
|
||||
manufacturer:
|
||||
description: 'The manufacturer of the device.'
|
||||
required: false
|
||||
type: string
|
||||
model:
|
||||
description: 'The model of the device.'
|
||||
required: false
|
||||
type: string
|
||||
name:
|
||||
description: 'The name of the device.'
|
||||
required: false
|
||||
type: string
|
||||
sw_version:
|
||||
description: 'The firmware version of the device.'
|
||||
required: false
|
||||
type: string
|
||||
effect:
|
||||
description: Flag that defines if the light supports effects.
|
||||
required: false
|
||||
@ -429,11 +453,39 @@ flash_time_short:
|
||||
required: false
|
||||
type: integer
|
||||
default: 2
|
||||
hs:
|
||||
description: Flag that defines if the light supports HS colors.
|
||||
required: false
|
||||
type: boolean
|
||||
default: false
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-template-configuration) documentation."
|
||||
required: false
|
||||
type: template
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
required: false
|
||||
type: string
|
||||
name:
|
||||
description: The name of the light.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT JSON Light
|
||||
optimistic:
|
||||
description: Flag that defines if the light works in optimistic mode.
|
||||
required: false
|
||||
type: boolean
|
||||
default: "`true` if no state topic defined, else `false`."
|
||||
payload_available:
|
||||
description: The payload that represents the available state.
|
||||
required: false
|
||||
type: string
|
||||
default: online
|
||||
payload_not_available:
|
||||
description: The payload that represents the unavailable state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
qos:
|
||||
description: The maximum QoS level of the state topic.
|
||||
required: false
|
||||
@ -453,6 +505,10 @@ state_topic:
|
||||
description: The MQTT topic subscribed to receive state updates.
|
||||
required: false
|
||||
type: string
|
||||
unique_id:
|
||||
description: An ID that uniquely identifies this light. If two lights have the same unique ID, Home Assistant will raise an exception.
|
||||
required: false
|
||||
type: string
|
||||
white_value:
|
||||
description: Flag that defines if the light supports white values.
|
||||
required: false
|
||||
@ -463,62 +519,6 @@ xy:
|
||||
required: false
|
||||
type: boolean
|
||||
default: false
|
||||
hs:
|
||||
description: Flag that defines if the light supports HS colors.
|
||||
required: false
|
||||
type: boolean
|
||||
default: false
|
||||
availability_topic:
|
||||
description: The MQTT topic subscribed to receive availability (online/offline) updates.
|
||||
required: false
|
||||
type: string
|
||||
payload_available:
|
||||
description: The payload that represents the available state.
|
||||
required: false
|
||||
type: string
|
||||
default: online
|
||||
payload_not_available:
|
||||
description: The payload that represents the unavailable state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
required: false
|
||||
type: string
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-template-configuration) documentation."
|
||||
required: false
|
||||
type: template
|
||||
device:
|
||||
description: 'Information about the device this light is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/docs/mqtt/discovery/) and when [`unique_id`](#unique_id) is set.'
|
||||
required: false
|
||||
type: map
|
||||
keys:
|
||||
identifiers:
|
||||
description: 'A list of IDs that uniquely identify the device. For example a serial number.'
|
||||
required: false
|
||||
type: [string, list]
|
||||
connections:
|
||||
description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": [["mac", "02:5b:26:a8:dc:12"]]`.'
|
||||
required: false
|
||||
type: list
|
||||
manufacturer:
|
||||
description: 'The manufacturer of the device.'
|
||||
required: false
|
||||
type: string
|
||||
model:
|
||||
description: 'The model of the device.'
|
||||
required: false
|
||||
type: string
|
||||
name:
|
||||
description: 'The name of the device.'
|
||||
required: false
|
||||
type: string
|
||||
sw_version:
|
||||
description: 'The firmware version of the device.'
|
||||
required: false
|
||||
type: string
|
||||
{% endconfiguration %}
|
||||
|
||||
<div class='note warning'>
|
||||
@ -678,112 +678,47 @@ light:
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
name:
|
||||
description: The name of the light.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT Template Light
|
||||
unique_id:
|
||||
description: An ID that uniquely identifies this light. If two lights have the same unique ID, Home Assistant will raise an exception.
|
||||
required: false
|
||||
type: string
|
||||
effect_list:
|
||||
description: List of possible effects.
|
||||
required: false
|
||||
type: [string, list]
|
||||
command_topic:
|
||||
description: The MQTT topic to publish commands to change the light’s state.
|
||||
required: true
|
||||
type: string
|
||||
state_topic:
|
||||
description: The MQTT topic subscribed to receive state updates.
|
||||
required: false
|
||||
type: string
|
||||
command_on_template:
|
||||
description: "The [template](/docs/configuration/templating/#processing-incoming-data) for *on* state changes. Available variables: `state`, `brightness`, `red`, `green`, `blue`, `white_value`, `flash`, `transition` and `effect`."
|
||||
required: true
|
||||
type: string
|
||||
command_off_template:
|
||||
description: "The [template](/docs/configuration/templating/#processing-incoming-data) for *off* state changes. Available variables: `state` and `transition`."
|
||||
required: true
|
||||
type: string
|
||||
state_template:
|
||||
description: "[Template](/docs/configuration/templating/#processing-incoming-data) to extract state from the state payload value."
|
||||
required: false
|
||||
type: string
|
||||
brightness_template:
|
||||
description: "[Template](/docs/configuration/templating/#processing-incoming-data) to extract brightness from the state payload value."
|
||||
required: false
|
||||
type: string
|
||||
red_template:
|
||||
description: "[Template](/docs/configuration/templating/#processing-incoming-data) to extract red color from the state payload value."
|
||||
required: false
|
||||
type: string
|
||||
green_template:
|
||||
description: "[Template](/docs/configuration/templating/#processing-incoming-data) to extract green color from the state payload value."
|
||||
availability_topic:
|
||||
description: The MQTT topic subscribed to receive availability (online/offline) updates.
|
||||
required: false
|
||||
type: string
|
||||
blue_template:
|
||||
description: "[Template](/docs/configuration/templating/#processing-incoming-data) to extract blue color from the state payload value."
|
||||
required: false
|
||||
type: string
|
||||
brightness_template:
|
||||
description: "[Template](/docs/configuration/templating/#processing-incoming-data) to extract brightness from the state payload value."
|
||||
required: false
|
||||
type: string
|
||||
color_temp_template:
|
||||
description: "[Template](/docs/configuration/templating/#processing-incoming-data) to extract color temperature from the state payload value."
|
||||
required: false
|
||||
type: string
|
||||
effect_template:
|
||||
description: "[Template](/docs/configuration/templating/#processing-incoming-data) to extract effect from the state payload value."
|
||||
required: false
|
||||
command_off_template:
|
||||
description: "The [template](/docs/configuration/templating/#processing-incoming-data) for *off* state changes. Available variables: `state` and `transition`."
|
||||
required: true
|
||||
type: string
|
||||
white_value_template:
|
||||
description: "[Template](/docs/configuration/templating/#processing-incoming-data) to extract white value from the state payload value."
|
||||
required: false
|
||||
command_on_template:
|
||||
description: "The [template](/docs/configuration/templating/#processing-incoming-data) for *on* state changes. Available variables: `state`, `brightness`, `red`, `green`, `blue`, `white_value`, `flash`, `transition` and `effect`."
|
||||
required: true
|
||||
type: string
|
||||
optimistic:
|
||||
description: Flag that defines if the light works in optimistic mode.
|
||||
required: false
|
||||
command_topic:
|
||||
description: The MQTT topic to publish commands to change the light’s state.
|
||||
required: true
|
||||
type: string
|
||||
default: "`true` if no state topic or state template is defined, else `false`."
|
||||
qos:
|
||||
description: The maximum QoS level of the state topic.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
availability_topic:
|
||||
description: The MQTT topic subscribed to receive availability (online/offline) updates.
|
||||
required: false
|
||||
type: string
|
||||
payload_available:
|
||||
description: The payload that represents the available state.
|
||||
required: false
|
||||
type: string
|
||||
default: online
|
||||
payload_not_available:
|
||||
description: The payload that represents the unavailable state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
required: false
|
||||
type: string
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-template-configuration) documentation."
|
||||
required: false
|
||||
type: template
|
||||
device:
|
||||
description: 'Information about the device this light is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/docs/mqtt/discovery/) and when [`unique_id`](#unique_id) is set.'
|
||||
required: false
|
||||
type: map
|
||||
keys:
|
||||
identifiers:
|
||||
description: 'A list of IDs that uniquely identify the device. For example a serial number.'
|
||||
required: false
|
||||
type: [string, list]
|
||||
connections:
|
||||
description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": [["mac", "02:5b:26:a8:dc:12"]]`.'
|
||||
required: false
|
||||
type: list
|
||||
identifiers:
|
||||
description: 'A list of IDs that uniquely identify the device. For example a serial number.'
|
||||
required: false
|
||||
type: [string, list]
|
||||
manufacturer:
|
||||
description: 'The manufacturer of the device.'
|
||||
required: false
|
||||
@ -800,6 +735,71 @@ device:
|
||||
description: 'The firmware version of the device.'
|
||||
required: false
|
||||
type: string
|
||||
effect_list:
|
||||
description: List of possible effects.
|
||||
required: false
|
||||
type: [string, list]
|
||||
effect_template:
|
||||
description: "[Template](/docs/configuration/templating/#processing-incoming-data) to extract effect from the state payload value."
|
||||
required: false
|
||||
type: string
|
||||
green_template:
|
||||
description: "[Template](/docs/configuration/templating/#processing-incoming-data) to extract green color from the state payload value."
|
||||
required: false
|
||||
type: string
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-template-configuration) documentation."
|
||||
required: false
|
||||
type: template
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
required: false
|
||||
type: string
|
||||
name:
|
||||
description: The name of the light.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT Template Light
|
||||
optimistic:
|
||||
description: Flag that defines if the light works in optimistic mode.
|
||||
required: false
|
||||
type: string
|
||||
default: "`true` if no state topic or state template is defined, else `false`."
|
||||
payload_available:
|
||||
description: The payload that represents the available state.
|
||||
required: false
|
||||
type: string
|
||||
default: online
|
||||
payload_not_available:
|
||||
description: The payload that represents the unavailable state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
qos:
|
||||
description: The maximum QoS level of the state topic.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
red_template:
|
||||
description: "[Template](/docs/configuration/templating/#processing-incoming-data) to extract red color from the state payload value."
|
||||
required: false
|
||||
type: string
|
||||
state_template:
|
||||
description: "[Template](/docs/configuration/templating/#processing-incoming-data) to extract state from the state payload value."
|
||||
required: false
|
||||
type: string
|
||||
state_topic:
|
||||
description: The MQTT topic subscribed to receive state updates.
|
||||
required: false
|
||||
type: string
|
||||
unique_id:
|
||||
description: An ID that uniquely identifies this light. If two lights have the same unique ID, Home Assistant will raise an exception.
|
||||
required: false
|
||||
type: string
|
||||
white_value_template:
|
||||
description: "[Template](/docs/configuration/templating/#processing-incoming-data) to extract white value from the state payload value."
|
||||
required: false
|
||||
type: string
|
||||
{% endconfiguration %}
|
||||
|
||||
<div class='note warning'>
|
||||
|
@ -28,97 +28,27 @@ lock:
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
command_topic:
|
||||
description: The MQTT topic to publish commands to change the lock state.
|
||||
required: true
|
||||
type: string
|
||||
state_topic:
|
||||
description: The MQTT topic subscribed to receive state updates.
|
||||
required: false
|
||||
type: string
|
||||
name:
|
||||
description: The name of the lock.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT Lock
|
||||
payload_lock:
|
||||
description: The payload that represents enabled/locked state.
|
||||
required: false
|
||||
type: string
|
||||
default: LOCK
|
||||
payload_unlock:
|
||||
description: The payload that represents disabled/unlocked state.
|
||||
required: false
|
||||
type: string
|
||||
default: UNLOCK
|
||||
state_locked:
|
||||
description: The value that represents the lock to be in locked state
|
||||
required: false
|
||||
type: string
|
||||
default: LOCKED
|
||||
state_unlocked:
|
||||
description: The value that represents the lock to be in unlocked state
|
||||
required: false
|
||||
type: string
|
||||
default: UNLOCKED
|
||||
optimistic:
|
||||
description: Flag that defines if lock works in optimistic mode.
|
||||
required: false
|
||||
type: string
|
||||
default: "`true` if no `state_topic` defined, else `false`."
|
||||
qos:
|
||||
description: The maximum QoS level of the state topic.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
retain:
|
||||
description: If the published message should have the retain flag on or not.
|
||||
required: false
|
||||
type: boolean
|
||||
default: false
|
||||
value_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract a value from the payload."
|
||||
required: false
|
||||
type: string
|
||||
availability_topic:
|
||||
description: The MQTT topic subscribed to receive availability (online/offline) updates.
|
||||
required: false
|
||||
type: string
|
||||
payload_available:
|
||||
description: The payload that represents the available state.
|
||||
required: false
|
||||
command_topic:
|
||||
description: The MQTT topic to publish commands to change the lock state.
|
||||
required: true
|
||||
type: string
|
||||
default: online
|
||||
payload_not_available:
|
||||
description: The payload that represents the unavailable state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
required: false
|
||||
type: string
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-template-configuration) documentation."
|
||||
required: false
|
||||
type: template
|
||||
unique_id:
|
||||
description: An ID that uniquely identifies this lock. If two locks have the same unique ID, Home Assistant will raise an exception.
|
||||
required: false
|
||||
type: string
|
||||
device:
|
||||
description: 'Information about the device this lock is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/docs/mqtt/discovery/) and when [`unique_id`](#unique_id) is set.'
|
||||
required: false
|
||||
type: map
|
||||
keys:
|
||||
identifiers:
|
||||
description: 'A list of IDs that uniquely identify the device. For example a serial number.'
|
||||
required: false
|
||||
type: [string, list]
|
||||
connections:
|
||||
description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": [["mac", "02:5b:26:a8:dc:12"]]`.'
|
||||
required: false
|
||||
type: list
|
||||
identifiers:
|
||||
description: 'A list of IDs that uniquely identify the device. For example a serial number.'
|
||||
required: false
|
||||
type: [string, list]
|
||||
manufacturer:
|
||||
description: 'The manufacturer of the device.'
|
||||
required: false
|
||||
@ -135,6 +65,76 @@ device:
|
||||
description: 'The firmware version of the device.'
|
||||
required: false
|
||||
type: string
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-template-configuration) documentation."
|
||||
required: false
|
||||
type: template
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
required: false
|
||||
type: string
|
||||
name:
|
||||
description: The name of the lock.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT Lock
|
||||
optimistic:
|
||||
description: Flag that defines if lock works in optimistic mode.
|
||||
required: false
|
||||
type: string
|
||||
default: "`true` if no `state_topic` defined, else `false`."
|
||||
payload_available:
|
||||
description: The payload that represents the available state.
|
||||
required: false
|
||||
type: string
|
||||
default: online
|
||||
payload_lock:
|
||||
description: The payload that represents enabled/locked state.
|
||||
required: false
|
||||
type: string
|
||||
default: LOCK
|
||||
payload_not_available:
|
||||
description: The payload that represents the unavailable state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
payload_unlock:
|
||||
description: The payload that represents disabled/unlocked state.
|
||||
required: false
|
||||
type: string
|
||||
default: UNLOCK
|
||||
qos:
|
||||
description: The maximum QoS level of the state topic.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
retain:
|
||||
description: If the published message should have the retain flag on or not.
|
||||
required: false
|
||||
type: boolean
|
||||
default: false
|
||||
state_locked:
|
||||
description: The value that represents the lock to be in locked state
|
||||
required: false
|
||||
type: string
|
||||
default: LOCKED
|
||||
state_topic:
|
||||
description: The MQTT topic subscribed to receive state updates.
|
||||
required: false
|
||||
type: string
|
||||
state_unlocked:
|
||||
description: The value that represents the lock to be in unlocked state
|
||||
required: false
|
||||
type: string
|
||||
default: UNLOCKED
|
||||
unique_id:
|
||||
description: An ID that uniquely identifies this lock. If two locks have the same unique ID, Home Assistant will raise an exception.
|
||||
required: false
|
||||
type: string
|
||||
value_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract a value from the payload."
|
||||
required: false
|
||||
type: string
|
||||
{% endconfiguration %}
|
||||
|
||||
<div class='note warning'>
|
||||
|
@ -108,7 +108,7 @@ json_attributes:
|
||||
description: A list of keys to extract values from a JSON dictionary result and then set as sensor attributes. If the endpoint returns XML with the "text/xml" content type, it will automatically be converted to JSON according to this [specification](https://www.xml.com/pub/a/2006/05/31/converting-between-xml-and-json.html)
|
||||
required: false
|
||||
type: [string, list]
|
||||
json_path_attributes:
|
||||
json_attributes_path:
|
||||
description: A [JSONPath](https://goessner.net/articles/JsonPath/) that references the location of the `json_attributes` in the JSON content.
|
||||
required: false
|
||||
type: string
|
||||
|
@ -22,90 +22,23 @@ sensor:
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
state_topic:
|
||||
description: The MQTT topic subscribed to receive sensor values.
|
||||
required: true
|
||||
type: string
|
||||
name:
|
||||
description: The name of the MQTT sensor.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT Sensor
|
||||
qos:
|
||||
description: The maximum QoS level of the state topic.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
unit_of_measurement:
|
||||
description: Defines the units of measurement of the sensor, if any.
|
||||
required: false
|
||||
type: string
|
||||
icon:
|
||||
description: The icon for the sensor.
|
||||
required: false
|
||||
type: icon
|
||||
expire_after:
|
||||
description: Defines the number of seconds after the value expires if it's not updated.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
value_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the value."
|
||||
required: false
|
||||
type: template
|
||||
force_update:
|
||||
description: Sends update events even if the value hasn't changed. Useful if you want to have meaningful value graphs in history.
|
||||
reqired: false
|
||||
type: boolean
|
||||
default: false
|
||||
availability_topic:
|
||||
description: The MQTT topic subscribed to receive availability (online/offline) updates.
|
||||
required: false
|
||||
type: string
|
||||
payload_available:
|
||||
description: The payload that represents the available state.
|
||||
required: false
|
||||
type: string
|
||||
default: online
|
||||
payload_not_available:
|
||||
description: The payload that represents the unavailable state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Implies `force_update` of the current sensor state when a message is received on this topic.
|
||||
required: false
|
||||
type: string
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`."
|
||||
required: false
|
||||
type: template
|
||||
json_attributes:
|
||||
description: (Deprecated, replaced by json_attributes_topic) A list of keys to extract values from a JSON dictionary payload and then set as sensor attributes.
|
||||
required: false
|
||||
type: [string, list]
|
||||
unique_id:
|
||||
description: "An ID that uniquely identifies this sensor. If two sensors have the same unique ID, Home Assistant will raise an exception."
|
||||
required: false
|
||||
type: string
|
||||
device_class:
|
||||
description: The [type/class](/integrations/sensor/#device-class) of the sensor to set the icon in the frontend.
|
||||
required: false
|
||||
type: device_class
|
||||
default: None
|
||||
device:
|
||||
description: "Information about the device this sensor is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/docs/mqtt/discovery/) and when [`unique_id`](#unique_id) is set."
|
||||
required: false
|
||||
type: map
|
||||
keys:
|
||||
identifiers:
|
||||
description: A list of IDs that uniquely identify the device. For example a serial number.
|
||||
required: false
|
||||
type: [string, list]
|
||||
connections:
|
||||
description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": [["mac", "02:5b:26:a8:dc:12"]]`.'
|
||||
required: false
|
||||
type: list
|
||||
identifiers:
|
||||
description: A list of IDs that uniquely identify the device. For example a serial number.
|
||||
required: false
|
||||
type: [string, list]
|
||||
manufacturer:
|
||||
description: The manufacturer of the device.
|
||||
required: false
|
||||
@ -122,6 +55,73 @@ device:
|
||||
description: The firmware version of the device.
|
||||
required: false
|
||||
type: string
|
||||
device_class:
|
||||
description: The [type/class](/integrations/sensor/#device-class) of the sensor to set the icon in the frontend.
|
||||
required: false
|
||||
type: device_class
|
||||
default: None
|
||||
expire_after:
|
||||
description: Defines the number of seconds after the value expires if it's not updated.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
force_update:
|
||||
description: Sends update events even if the value hasn't changed. Useful if you want to have meaningful value graphs in history.
|
||||
reqired: false
|
||||
type: boolean
|
||||
default: false
|
||||
icon:
|
||||
description: The icon for the sensor.
|
||||
required: false
|
||||
type: icon
|
||||
json_attributes:
|
||||
description: (Deprecated, replaced by json_attributes_topic) A list of keys to extract values from a JSON dictionary payload and then set as sensor attributes.
|
||||
required: false
|
||||
type: [string, list]
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`."
|
||||
required: false
|
||||
type: template
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Implies `force_update` of the current sensor state when a message is received on this topic.
|
||||
required: false
|
||||
type: string
|
||||
name:
|
||||
description: The name of the MQTT sensor.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT Sensor
|
||||
payload_available:
|
||||
description: The payload that represents the available state.
|
||||
required: false
|
||||
type: string
|
||||
default: online
|
||||
payload_not_available:
|
||||
description: The payload that represents the unavailable state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
qos:
|
||||
description: The maximum QoS level of the state topic.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
state_topic:
|
||||
description: The MQTT topic subscribed to receive sensor values.
|
||||
required: true
|
||||
type: string
|
||||
unique_id:
|
||||
description: "An ID that uniquely identifies this sensor. If two sensors have the same unique ID, Home Assistant will raise an exception."
|
||||
required: false
|
||||
type: string
|
||||
unit_of_measurement:
|
||||
description: Defines the units of measurement of the sensor, if any.
|
||||
required: false
|
||||
type: string
|
||||
value_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the value."
|
||||
required: false
|
||||
type: template
|
||||
{% endconfiguration %}
|
||||
|
||||
## Examples
|
||||
|
@ -15,9 +15,9 @@ The `slack` platform allows you to deliver notifications from Home Assistant to
|
||||
|
||||
1. Create a [new app](https://api.slack.com/apps) under your Slack.com account
|
||||
2. Click the `OAuth & Permissions` link in the sidebar, under the Features heading
|
||||
2. In the Scopes section, add the `chat:write:user` scope, `Send messages as user`
|
||||
3. Scroll up to `OAuth Tokens & Redirect URLs` and click `Install App`
|
||||
4. Copy your `OAuth Access Token` and put that key into your `configuration.yaml` file -- see below
|
||||
3. In the Scopes section, add the `chat:write:user` scope, `Send messages as user`. If you wish to also be able to include files, you will need to include `files:write:user`. If you get a `missing_scope` error when trying to send a message, check these permissions.
|
||||
4. Scroll up to `OAuth Tokens & Redirect URLs` and click `Install App`
|
||||
5. Copy your `OAuth Access Token` and put that key into your `configuration.yaml` file -- see below
|
||||
|
||||
<div class='note'>
|
||||
|
||||
@ -132,6 +132,19 @@ Example for posting formatted attachment:
|
||||
}
|
||||
```
|
||||
|
||||
You can also use YAML to send messages from your automations
|
||||
|
||||
```yaml
|
||||
|
||||
- service: notify.slack
|
||||
data:
|
||||
message: "Latest notification"
|
||||
title: "Latest image"
|
||||
target: ["#home-assistant"]
|
||||
data:
|
||||
file:
|
||||
path: "/myfile.jpg"
|
||||
```
|
||||
Please note that both `message` is a required key, but is always shown, so use an empty (`""`) string for `message` if you don't want the extra text.
|
||||
|
||||
To use notifications, please see the [getting started with automation page](/getting-started/automation/).
|
||||
|
@ -50,16 +50,16 @@ surepetcare:
|
||||
required: true
|
||||
type: string
|
||||
feeders:
|
||||
description: The Sure Petcare flaps
|
||||
description: The Sure Petcare feeders
|
||||
required: true
|
||||
type: map
|
||||
keys:
|
||||
id:
|
||||
description: The Sure Petcare id of a flap
|
||||
description: The Sure Petcare id of a feeder
|
||||
required: true
|
||||
type: integer
|
||||
name:
|
||||
description: A name for the flap
|
||||
description: A name for the feeder
|
||||
required: true
|
||||
type: string
|
||||
pets:
|
||||
|
@ -28,97 +28,27 @@ switch:
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
command_topic:
|
||||
description: The MQTT topic to publish commands to change the switch state.
|
||||
required: false
|
||||
type: string
|
||||
name:
|
||||
description: The name to use when displaying this switch.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT Switch
|
||||
icon:
|
||||
description: Icon for the switch.
|
||||
required: false
|
||||
type: icon
|
||||
state_topic:
|
||||
description: The MQTT topic subscribed to receive state updates.
|
||||
required: false
|
||||
type: string
|
||||
state_on:
|
||||
description: The payload that represents the on state.
|
||||
required: false
|
||||
type: string
|
||||
default: "`payload_on` if defined, else ON"
|
||||
state_off:
|
||||
description: The payload that represents the off state.
|
||||
required: false
|
||||
type: string
|
||||
default: "`payload_off` if defined, else OFF"
|
||||
availability_topic:
|
||||
description: The MQTT topic subscribed to receive availability (online/offline) updates.
|
||||
required: false
|
||||
type: string
|
||||
payload_on:
|
||||
description: The payload that represents enabled state.
|
||||
command_topic:
|
||||
description: The MQTT topic to publish commands to change the switch state.
|
||||
required: false
|
||||
type: string
|
||||
default: "ON"
|
||||
payload_off:
|
||||
description: The payload that represents disabled state.
|
||||
required: false
|
||||
type: string
|
||||
default: "OFF"
|
||||
payload_available:
|
||||
description: The payload that represents the available state.
|
||||
required: false
|
||||
type: string
|
||||
default: online
|
||||
payload_not_available:
|
||||
description: The payload that represents the unavailable state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
optimistic:
|
||||
description: Flag that defines if switch works in optimistic mode.
|
||||
required: false
|
||||
type: boolean
|
||||
default: "`true` if no `state_topic` defined, else `false`."
|
||||
qos:
|
||||
description: The maximum QoS level of the state topic. Default is 0 and will also be used to publishing messages.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
retain:
|
||||
description: If the published message should have the retain flag on or not.
|
||||
required: false
|
||||
type: boolean
|
||||
default: false
|
||||
value_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract a value from the payload."
|
||||
required: false
|
||||
type: string
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
required: false
|
||||
type: string
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-template-configuration) documentation."
|
||||
required: false
|
||||
type: template
|
||||
device:
|
||||
description: "Information about the device this switch is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/docs/mqtt/discovery/) and when [`unique_id`](#unique_id) is set."
|
||||
required: false
|
||||
type: map
|
||||
keys:
|
||||
identifiers:
|
||||
description: A list of IDs that uniquely identify the device. For example a serial number.
|
||||
required: false
|
||||
type: [string, list]
|
||||
connections:
|
||||
description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": [["mac", "02:5b:26:a8:dc:12"]]`.'
|
||||
required: false
|
||||
type: list
|
||||
identifiers:
|
||||
description: A list of IDs that uniquely identify the device. For example a serial number.
|
||||
required: false
|
||||
type: [string, list]
|
||||
manufacturer:
|
||||
description: The manufacturer of the device.
|
||||
required: false
|
||||
@ -135,6 +65,76 @@ device:
|
||||
description: The firmware version of the device.
|
||||
required: false
|
||||
type: string
|
||||
icon:
|
||||
description: Icon for the switch.
|
||||
required: false
|
||||
type: icon
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-template-configuration) documentation."
|
||||
required: false
|
||||
type: template
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
required: false
|
||||
type: string
|
||||
name:
|
||||
description: The name to use when displaying this switch.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT Switch
|
||||
optimistic:
|
||||
description: Flag that defines if switch works in optimistic mode.
|
||||
required: false
|
||||
type: boolean
|
||||
default: "`true` if no `state_topic` defined, else `false`."
|
||||
payload_available:
|
||||
description: The payload that represents the available state.
|
||||
required: false
|
||||
type: string
|
||||
default: online
|
||||
payload_not_available:
|
||||
description: The payload that represents the unavailable state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
payload_off:
|
||||
description: The payload that represents disabled state.
|
||||
required: false
|
||||
type: string
|
||||
default: "OFF"
|
||||
payload_on:
|
||||
description: The payload that represents enabled state.
|
||||
required: false
|
||||
type: string
|
||||
default: "ON"
|
||||
qos:
|
||||
description: The maximum QoS level of the state topic. Default is 0 and will also be used to publishing messages.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
retain:
|
||||
description: If the published message should have the retain flag on or not.
|
||||
required: false
|
||||
type: boolean
|
||||
default: false
|
||||
state_off:
|
||||
description: The payload that represents the off state.
|
||||
required: false
|
||||
type: string
|
||||
default: "`payload_off` if defined, else OFF"
|
||||
state_on:
|
||||
description: The payload that represents the on state.
|
||||
required: false
|
||||
type: string
|
||||
default: "`payload_on` if defined, else ON"
|
||||
state_topic:
|
||||
description: The MQTT topic subscribed to receive state updates.
|
||||
required: false
|
||||
type: string
|
||||
value_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract a value from the payload."
|
||||
required: false
|
||||
type: string
|
||||
{% endconfiguration %}
|
||||
|
||||
<div class='note warning'>
|
||||
|
@ -24,12 +24,6 @@ To retrieve your device's details, please follow the instructions [here](https:/
|
||||
Please note, for the Switcher-V2-Python script to run successfully, you need to configure your device to work locally.
|
||||
</div>
|
||||
|
||||
<div class='note warning'>
|
||||
|
||||
Please note, on the original script repository, users recently reported difficulties controlling the device after upgrading the firmware to the new 3.0 version.As this integration is based on that script, please do not upgrade to version 3.0 until this issue is resolved. You can follow the issue [here](https://github.com/NightRang3r/Switcher-V2-Python/issues/3).
|
||||
|
||||
</div>
|
||||
|
||||
```yaml
|
||||
switcher_kis:
|
||||
phone_id: 'REPLACE_WITH_PHONE_ID'
|
||||
|
@ -14,7 +14,7 @@ The `telegram` platform uses [Telegram](https://web.telegram.org) to deliver not
|
||||
The requirements are:
|
||||
|
||||
- You need a [Telegram bot](https://core.telegram.org/bots). Please follow those [instructions](https://core.telegram.org/bots#6-botfather) to create one and get the token for your bot. Keep in mind that bots are not allowed to contact users. You need to make the first contact with your user. Meaning that you need to send a message to the bot from your user.
|
||||
- You need to configure a [Telegram bot in Home Assistant](/integrations/telegram_chatbot) and define there your API key and the allowed chat ids to interact with.
|
||||
- You need to configure a [Telegram bot in Home Assistant](/integrations/telegram_bot) and define there your API key and the allowed chat ids to interact with.
|
||||
- The `chat_id` of an allowed user.
|
||||
|
||||
**Method 1:** You can get your `chat_id` by sending any message to the [GetIDs bot](https://t.me/getidsbot).
|
||||
@ -87,7 +87,7 @@ notify:
|
||||
```
|
||||
|
||||
Refer to the platforms mentioned in the
|
||||
[Telegram chatbot page](/integrations/telegram_chatbot/) for
|
||||
[Telegram chatbot page](/integrations/telegram_bot/) for
|
||||
`telegram_bot` configuration.
|
||||
|
||||
{% configuration %}
|
||||
|
@ -1,6 +1,6 @@
|
||||
---
|
||||
title: "Telegram chatbot"
|
||||
description: "Telegram chatbot support"
|
||||
title: "Telegram bot"
|
||||
description: "Telegram bot support"
|
||||
logo: telegram.png
|
||||
ha_category:
|
||||
- Hub
|
@ -14,12 +14,6 @@ The `updater` binary sensor will check daily for new releases. The state will be
|
||||
|
||||
The updater integration will also collect basic information about the running Home Assistant instance and its environment. The information includes the current Home Assistant version, the time zone, Python version and operating system information. No identifiable information (i.e., IP address, GPS coordinates, etc.) will ever be collected. If you are concerned about your privacy, you are welcome to scrutinize the Python [source code](https://github.com/home-assistant/home-assistant/tree/dev/homeassistant/components/updater).
|
||||
|
||||
<div class='note'>
|
||||
|
||||
The `updater` binary sensor will wait one hour after startup until it performs the first update. For this period it will be in the state `unavailable`. After that it will check once a day for new releases.
|
||||
|
||||
</div>
|
||||
|
||||
## Configuration
|
||||
|
||||
This integration is by default enabled, unless you've disabled or removed the [`default_config:`](https://www.home-assistant.io/integrations/default_config/) line from your configuration. If that is the case, the following example shows you how to enable this integration manually:
|
||||
|
@ -29,55 +29,84 @@ vacuum:
|
||||
Legacy MQTT vacuum configuration section.
|
||||
|
||||
{% configuration %}
|
||||
availability_topic:
|
||||
description: The MQTT topic subscribed to receive availability (online/offline) updates.
|
||||
required: false
|
||||
type: string
|
||||
battery_level_template:
|
||||
description: Defines a [template](/topics/templating/) to define the battery level of the vacuum. This is required if `battery_level_topic` is set.
|
||||
required: false
|
||||
type: string
|
||||
battery_level_topic:
|
||||
description: The MQTT topic subscribed to receive battery level values from the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
charging_template:
|
||||
description: Defines a [template](/topics/templating/) to define the charging state of the vacuum. This is required if `charging_topic` is set.
|
||||
required: false
|
||||
type: string
|
||||
charging_topic:
|
||||
description: The MQTT topic subscribed to receive charging state values from the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
cleaning_template:
|
||||
description: Defines a [template](/topics/templating/) to define the cleaning state of the vacuum. This is required if `cleaning_topic` is set.
|
||||
required: false
|
||||
type: string
|
||||
cleaning_topic:
|
||||
description: The MQTT topic subscribed to receive cleaning state values from the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
command_topic:
|
||||
description: The MQTT topic to publish commands to control the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
docked_template:
|
||||
description: Defines a [template](/topics/templating/) to define the docked state of the vacuum. This is required if `docked_topic` is set.
|
||||
required: false
|
||||
type: string
|
||||
docked_topic:
|
||||
description: The MQTT topic subscribed to receive docked state values from the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
error_template:
|
||||
description: Defines a [template](/topics/templating/) to define potential error messages emitted by the vacuum. This is required if `error_topic` is set.
|
||||
required: false
|
||||
type: string
|
||||
error_topic:
|
||||
description: The MQTT topic subscribed to receive error messages from the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
fan_speed_list:
|
||||
description: List of possible fan speeds for the vacuum.
|
||||
required: false
|
||||
type: [string, list]
|
||||
fan_speed_template:
|
||||
description: Defines a [template](/topics/templating/) to define the fan speed of the vacuum. This is required if `fan_speed_topic` is set.
|
||||
required: false
|
||||
type: string
|
||||
fan_speed_topic:
|
||||
description: The MQTT topic subscribed to receive fan speed values from the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-template-configuration) documentation."
|
||||
required: false
|
||||
type: template
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
required: false
|
||||
type: string
|
||||
name:
|
||||
description: The name of the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT Vacuum
|
||||
schema:
|
||||
description: The schema to use.
|
||||
payload_available:
|
||||
description: The payload that represents the available state.
|
||||
required: false
|
||||
type: string
|
||||
default: legacy
|
||||
supported_features:
|
||||
description: List of features that the vacuum supports (possible values are `turn_on`, `turn_off`, `pause`, `stop`, `return_home`, `battery`, `status`, `locate`, `clean_spot`, `fan_speed`, `send_command`)."
|
||||
required: false
|
||||
type: [string, list]
|
||||
default: "`turn_on`, `turn_off`, `stop`, `return_home`, `status`, `battery`, `clean_spot`"
|
||||
command_topic:
|
||||
description: The MQTT topic to publish commands to control the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
qos:
|
||||
description: The maximum QoS level of the state topic.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
retain:
|
||||
description: If the published message should have the retain flag on or not.
|
||||
required: false
|
||||
type: boolean
|
||||
default: false
|
||||
payload_turn_on:
|
||||
description: The payload to send to the `command_topic` to begin the cleaning cycle.
|
||||
required: false
|
||||
type: string
|
||||
default: turn_on
|
||||
payload_turn_off:
|
||||
description: The payload to send to the `command_topic` to turn the vacuum off.
|
||||
required: false
|
||||
type: string
|
||||
default: turn_off
|
||||
payload_return_to_base:
|
||||
description: The payload to send to the `command_topic` to tell the vacuum to return to base.
|
||||
required: false
|
||||
type: string
|
||||
default: return_to_base
|
||||
payload_stop:
|
||||
description: The payload to send to the `command_topic` to stop the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
default: stop
|
||||
default: online
|
||||
payload_clean_spot:
|
||||
description: The payload to send to the `command_topic` to begin a spot cleaning cycle.
|
||||
required: false
|
||||
@ -88,93 +117,64 @@ payload_locate:
|
||||
required: false
|
||||
type: string
|
||||
default: locate
|
||||
payload_not_available:
|
||||
description: The payload that represents the unavailable state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
payload_return_to_base:
|
||||
description: The payload to send to the `command_topic` to tell the vacuum to return to base.
|
||||
required: false
|
||||
type: string
|
||||
default: return_to_base
|
||||
payload_start_pause:
|
||||
description: The payload to send to the `command_topic` to start or pause the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
default: start_pause
|
||||
battery_level_topic:
|
||||
description: The MQTT topic subscribed to receive battery level values from the vacuum.
|
||||
payload_stop:
|
||||
description: The payload to send to the `command_topic` to stop the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
battery_level_template:
|
||||
description: Defines a [template](/topics/templating/) to define the battery level of the vacuum. This is required if `battery_level_topic` is set.
|
||||
default: stop
|
||||
payload_turn_off:
|
||||
description: The payload to send to the `command_topic` to turn the vacuum off.
|
||||
required: false
|
||||
type: string
|
||||
charging_topic:
|
||||
description: The MQTT topic subscribed to receive charging state values from the vacuum.
|
||||
default: turn_off
|
||||
payload_turn_on:
|
||||
description: The payload to send to the `command_topic` to begin the cleaning cycle.
|
||||
required: false
|
||||
type: string
|
||||
charging_template:
|
||||
description: Defines a [template](/topics/templating/) to define the charging state of the vacuum. This is required if `charging_topic` is set.
|
||||
default: turn_on
|
||||
qos:
|
||||
description: The maximum QoS level of the state topic.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
retain:
|
||||
description: If the published message should have the retain flag on or not.
|
||||
required: false
|
||||
type: boolean
|
||||
default: false
|
||||
schema:
|
||||
description: The schema to use.
|
||||
required: false
|
||||
type: string
|
||||
cleaning_topic:
|
||||
description: The MQTT topic subscribed to receive cleaning state values from the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
cleaning_template:
|
||||
description: Defines a [template](/topics/templating/) to define the cleaning state of the vacuum. This is required if `cleaning_topic` is set.
|
||||
required: false
|
||||
type: string
|
||||
docked_topic:
|
||||
description: The MQTT topic subscribed to receive docked state values from the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
docked_template:
|
||||
description: Defines a [template](/topics/templating/) to define the docked state of the vacuum. This is required if `docked_topic` is set.
|
||||
required: false
|
||||
type: string
|
||||
error_topic:
|
||||
description: The MQTT topic subscribed to receive error messages from the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
error_template:
|
||||
description: Defines a [template](/topics/templating/) to define potential error messages emitted by the vacuum. This is required if `error_topic` is set.
|
||||
required: false
|
||||
type: string
|
||||
fan_speed_topic:
|
||||
description: The MQTT topic subscribed to receive fan speed values from the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
fan_speed_template:
|
||||
description: Defines a [template](/topics/templating/) to define the fan speed of the vacuum. This is required if `fan_speed_topic` is set.
|
||||
default: legacy
|
||||
send_command_topic:
|
||||
description: The MQTT topic to publish custom commands to the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
set_fan_speed_topic:
|
||||
description: The MQTT topic to publish commands to control the vacuum's fan speed.
|
||||
required: false
|
||||
type: string
|
||||
fan_speed_list:
|
||||
description: List of possible fan speeds for the vacuum.
|
||||
supported_features:
|
||||
description: List of features that the vacuum supports (possible values are `turn_on`, `turn_off`, `pause`, `stop`, `return_home`, `battery`, `status`, `locate`, `clean_spot`, `fan_speed`, `send_command`)."
|
||||
required: false
|
||||
type: [string, list]
|
||||
send_command_topic:
|
||||
description: The MQTT topic to publish custom commands to the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
availability_topic:
|
||||
description: The MQTT topic subscribed to receive availability (online/offline) updates.
|
||||
required: false
|
||||
type: string
|
||||
payload_available:
|
||||
description: The payload that represents the available state.
|
||||
required: false
|
||||
type: string
|
||||
default: online
|
||||
payload_not_available:
|
||||
description: The payload that represents the unavailable state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
required: false
|
||||
type: string
|
||||
json_attributes_template:
|
||||
description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-template-configuration) documentation."
|
||||
required: false
|
||||
type: template
|
||||
default: "`turn_on`, `turn_off`, `stop`, `return_home`, `status`, `battery`, `clean_spot`"
|
||||
{% endconfiguration %}
|
||||
|
||||
### Legacy configuration example
|
||||
@ -260,50 +260,32 @@ MQTT payload:
|
||||
State MQTT vacuum configuration section.
|
||||
|
||||
{% configuration %}
|
||||
availability_topic:
|
||||
description: The MQTT topic subscribed to receive availability (online/offline) updates.
|
||||
required: false
|
||||
type: string
|
||||
command_topic:
|
||||
description: The MQTT topic to publish commands to control the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
fan_speed_list:
|
||||
description: List of possible fan speeds for the vacuum.
|
||||
required: false
|
||||
type: [string, list]
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
required: false
|
||||
type: string
|
||||
name:
|
||||
description: The name of the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
default: MQTT Vacuum
|
||||
schema:
|
||||
description: The schema to use.
|
||||
payload_available:
|
||||
description: The payload that represents the available state.
|
||||
required: false
|
||||
type: string
|
||||
default: legacy
|
||||
supported_features:
|
||||
description: "List of features that the vacuum supports (possible values are `start`, `stop`, `pause`, `return_home`, `battery`, `status`, `locate`, `clean_spot`, `fan_speed`, `send_command`)."
|
||||
required: false
|
||||
type: [string, list]
|
||||
default: "`start`, `stop`, `return_home`, `status`, `battery`, `clean_spot`"
|
||||
command_topic:
|
||||
description: The MQTT topic to publish commands to control the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
qos:
|
||||
description: The maximum QoS level of the state topic.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
retain:
|
||||
description: If the published message should have the retain flag on or not.
|
||||
required: false
|
||||
type: boolean
|
||||
default: false
|
||||
payload_start:
|
||||
description: "The payload to send to the `command_topic` to begin the cleaning cycle."
|
||||
required: false
|
||||
type: string
|
||||
default: start
|
||||
payload_stop:
|
||||
description: "The payload to send to the `command_topic` to stop cleaning."
|
||||
required: false
|
||||
type: string
|
||||
default: stop
|
||||
payload_return_to_base:
|
||||
description: The payload to send to the `command_topic` to tell the vacuum to return to base.
|
||||
required: false
|
||||
type: string
|
||||
default: return_to_base
|
||||
default: online
|
||||
payload_clean_spot:
|
||||
description: The payload to send to the `command_topic` to begin a spot cleaning cycle.
|
||||
required: false
|
||||
@ -314,47 +296,65 @@ payload_locate:
|
||||
required: false
|
||||
type: string
|
||||
default: locate
|
||||
payload_not_available:
|
||||
description: The payload that represents the unavailable state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
payload_pause:
|
||||
description: The payload to send to the `command_topic` to pause the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
default: pause
|
||||
state_topic:
|
||||
description: The MQTT topic subscribed to receive state messages from the vacuum. State topic is extracting JSON if no `value_template` is defined.
|
||||
payload_return_to_base:
|
||||
description: The payload to send to the `command_topic` to tell the vacuum to return to base.
|
||||
required: false
|
||||
type: string
|
||||
value_template:
|
||||
description: "Defines a [template](/topics/templating/) to extract possible states from the vacuum."
|
||||
default: return_to_base
|
||||
payload_start:
|
||||
description: "The payload to send to the `command_topic` to begin the cleaning cycle."
|
||||
required: false
|
||||
type: string
|
||||
default: start
|
||||
payload_stop:
|
||||
description: "The payload to send to the `command_topic` to stop cleaning."
|
||||
required: false
|
||||
type: string
|
||||
default: stop
|
||||
qos:
|
||||
description: The maximum QoS level of the state topic.
|
||||
required: false
|
||||
type: integer
|
||||
default: 0
|
||||
retain:
|
||||
description: If the published message should have the retain flag on or not.
|
||||
required: false
|
||||
type: boolean
|
||||
default: false
|
||||
schema:
|
||||
description: The schema to use.
|
||||
required: false
|
||||
type: string
|
||||
default: legacy
|
||||
send_command_topic:
|
||||
description: The MQTT topic to publish custom commands to the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
set_fan_speed_topic:
|
||||
description: The MQTT topic to publish commands to control the vacuum's fan speed.
|
||||
required: false
|
||||
type: string
|
||||
fan_speed_list:
|
||||
description: List of possible fan speeds for the vacuum.
|
||||
state_topic:
|
||||
description: The MQTT topic subscribed to receive state messages from the vacuum. State topic is extracting JSON if no `value_template` is defined.
|
||||
required: false
|
||||
type: string
|
||||
supported_features:
|
||||
description: "List of features that the vacuum supports (possible values are `start`, `stop`, `pause`, `return_home`, `battery`, `status`, `locate`, `clean_spot`, `fan_speed`, `send_command`)."
|
||||
required: false
|
||||
type: [string, list]
|
||||
send_command_topic:
|
||||
description: The MQTT topic to publish custom commands to the vacuum.
|
||||
required: false
|
||||
type: string
|
||||
availability_topic:
|
||||
description: The MQTT topic subscribed to receive availability (online/offline) updates.
|
||||
required: false
|
||||
type: string
|
||||
payload_available:
|
||||
description: The payload that represents the available state.
|
||||
required: false
|
||||
type: string
|
||||
default: online
|
||||
payload_not_available:
|
||||
description: The payload that represents the unavailable state.
|
||||
required: false
|
||||
type: string
|
||||
default: offline
|
||||
json_attributes_topic:
|
||||
description: The MQTT topic subscribed to receive a JSON dictionary payload and then set as sensor attributes. Usage example can be found in [MQTT sensor](/integrations/sensor.mqtt/#json-attributes-topic-configuration) documentation.
|
||||
default: "`start`, `stop`, `return_home`, `status`, `battery`, `clean_spot`"
|
||||
value_template:
|
||||
description: "Defines a [template](/topics/templating/) to extract possible states from the vacuum."
|
||||
required: false
|
||||
type: string
|
||||
{% endconfiguration %}
|
||||
|
@ -20,7 +20,7 @@ ha_codeowners:
|
||||
- '@adminiuga'
|
||||
---
|
||||
|
||||
[Zigbee Home Automation](https://zigbee.org/zigbee-for-developers/applicationstandards/zigbeehomeautomation/)
|
||||
[Zigbee Home Automation](https://zigbeealliance.org)
|
||||
integration for Home Assistant allows you to connect many off-the-shelf Zigbee based devices to Home Assistant, using one of the available Zigbee radio modules that is compatible with [zigpy](https://github.com/zigpy/zigpy) (an open source Python library implementing a Zigbee stack, which in turn relies on separate libraries which can each interface a with Zigbee radio module a different manufacturer).
|
||||
|
||||
There is currently support for the following device types within Home Assistant:
|
||||
@ -35,7 +35,7 @@ There is currently support for the following device types within Home Assistant:
|
||||
|
||||
## ZHA exception and deviation handling
|
||||
|
||||
Zigbee devices that deviate from or do not fully conform to the standard specifications set by the [Zigbee Alliance](https://www.zigbee.org) may require the development of custom [ZHA Device Handlers](https://github.com/dmulcahey/zha-device-handlers) (ZHA custom quirks handler implementation) to for all their functions to work properly with the ZHA integration in Home Assistant. These ZHA Device Handlers for Home Assistant can thus be used to parse custom messages to and from Zigbee devices.
|
||||
Zigbee devices that deviate from or do not fully conform to the standard specifications set by the [Zigbee Alliance](https://zigbeealliance.org) may require the development of custom [ZHA Device Handlers](https://github.com/dmulcahey/zha-device-handlers) (ZHA custom quirks handler implementation) to for all their functions to work properly with the ZHA integration in Home Assistant. These ZHA Device Handlers for Home Assistant can thus be used to parse custom messages to and from Zigbee devices.
|
||||
|
||||
The custom quirks implementations for zigpy implemented as ZHA Device Handlers for Home Assistant are a similar concept to that of [Hub-connected Device Handlers for the SmartThings Classics platform](https://docs.smartthings.com/en/latest/device-type-developers-guide/) as well as that of [Zigbee-Shepherd Converters as used by Zigbee2mqtt](https://www.zigbee2mqtt.io/how_tos/how_to_support_new_devices.html), meaning they are each virtual representations of a physical device that expose additional functionality that is not provided out-of-the-box by the existing integration between these platforms.
|
||||
|
||||
@ -78,7 +78,7 @@ Use the plus button in the bottom right to add a new integration called **ZHA**.
|
||||
In the popup:
|
||||
|
||||
- USB Device Path - on a Linux system will be something like `/dev/ttyUSB0`
|
||||
- Radio type - select device type `ezsp`, `deconz` or `xbee`
|
||||
- Radio type - select device type `ezsp`, `deconz`, `ti_cc`, `xbee` or `zigate`
|
||||
- Submit
|
||||
|
||||
The success dialog will appear or an error will be displayed in the popup. An error is likely if Home Assistant can't access the USB device or your device is not up to date (see troubleshooting).
|
||||
@ -87,7 +87,7 @@ The success dialog will appear or an error will be displayed in the popup. An er
|
||||
|
||||
To configure the component, select ZHA on the Integrations page and provide the path to your Zigbee USB stick.
|
||||
|
||||
Or, you can manually confiure `zha` section in `configuration.yaml`. The path to the database which will persist your network data is required.
|
||||
Or, you can manually configure `zha` section in `configuration.yaml`. The path to the database which will persist your network data is required.
|
||||
|
||||
```yaml
|
||||
# Example configuration.yaml entry
|
||||
@ -104,7 +104,7 @@ If you are use ZiGate, you have to use some special usb_path configuration:
|
||||
|
||||
{% configuration %}
|
||||
radio_type:
|
||||
description: One of `ezsp`, `xbee`, `deconz` or `zigate`.
|
||||
description: One of `deconz`, `ezsp`, `ti_cc`, `xbee` or `zigate`.
|
||||
required: false
|
||||
type: string
|
||||
default: ezsp
|
||||
|
@ -472,7 +472,7 @@ Experiencing issues introduced by this release? Please report them in our [issue
|
||||
[switch.tplink docs]: /integrations/tplink
|
||||
[switch.wake_on_lan docs]: /integrations/wake_on_lan#switch
|
||||
[switch.wemo docs]: /integrations/wemo
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[telegram_bot.polling docs]: /integrations/telegram_polling
|
||||
[telegram_bot.webhooks docs]: /integrations/telegram_webhooks
|
||||
[tts.google docs]: /integrations/google_translate
|
||||
@ -493,7 +493,7 @@ Experiencing issues introduced by this release? Please report them in our [issue
|
||||
[cover.zwave docs]: /integrations/zwave#cover
|
||||
[recorder docs]: /integrations/recorder/
|
||||
[switch.wemo docs]: /integrations/wemo
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[telegram_bot.webhooks docs]: /integrations/telegram_webhooks
|
||||
[wemo docs]: /integrations/wemo/
|
||||
[#7271]: https://github.com/home-assistant/home-assistant/pull/7271
|
||||
|
@ -486,7 +486,7 @@ influxdb:
|
||||
[switch.thinkingcleaner docs]: /integrations/thinkingcleaner#switch
|
||||
[switch.wemo docs]: /integrations/wemo
|
||||
[switch.zha docs]: /integrations/zha
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[telegram_bot.polling docs]: /integrations/telegram_polling
|
||||
[telegram_bot.webhooks docs]: /integrations/telegram_webhooks
|
||||
[updater docs]: /integrations/updater/
|
||||
|
@ -413,9 +413,9 @@ Experiencing issues introduced by this release? Please report them in our [issue
|
||||
[sensor.wunderground docs]: /integrations/wunderground
|
||||
[sun docs]: /integrations/sun/
|
||||
[switch.rpi_pfio docs]: /integrations/rpi_pfio#switch
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[telegram_bot.polling docs]: /integrations/telegram_polling
|
||||
[telegram_bot.services.yaml docs]: /integrations/telegram_chatbot/#notification-services
|
||||
[telegram_bot.services.yaml docs]: /integrations/telegram_bot/#notification-services
|
||||
[telegram_bot.webhooks docs]: /integrations/telegram_webhooks
|
||||
[tradfri docs]: /integrations/tradfri/
|
||||
[vera docs]: /integrations/vera/
|
||||
@ -434,5 +434,5 @@ Experiencing issues introduced by this release? Please report them in our [issue
|
||||
[device_tracker.ubus docs]: /integrations/ubus
|
||||
[hassio docs]: /integrations/hassio/
|
||||
[media_player.volumio docs]: /integrations/volumio
|
||||
[telegram_bot.__init__ docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot.__init__ docs]: /integrations/telegram_bot/
|
||||
[discord]: https://discord.gg/c5DvZ4e
|
||||
|
@ -369,7 +369,7 @@ Experiencing issues introduced by this release? Please report them in our [issue
|
||||
[switch.broadlink docs]: /integrations/broadlink#switch
|
||||
[switch.rachio docs]: /integrations/rachio#switch
|
||||
[switch.rflink docs]: /integrations/switch.rflink/
|
||||
[telegram_bot.__init__ docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot.__init__ docs]: /integrations/telegram_bot/
|
||||
[telegram_bot.polling docs]: /integrations/telegram_polling
|
||||
[telegram_bot.webhooks docs]: /integrations/telegram_webhooks
|
||||
[tellduslive docs]: /integrations/tellduslive/
|
||||
|
@ -547,7 +547,7 @@ automation:
|
||||
[switch.raspihats docs]: /integrations/raspihats#switch
|
||||
[switch.rest docs]: /integrations/switch.rest/
|
||||
[switch.template docs]: /integrations/switch.template/
|
||||
[telegram_bot.__init__ docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot.__init__ docs]: /integrations/telegram_bot/
|
||||
[telegram_bot.polling docs]: /integrations/telegram_polling
|
||||
[telegram_bot.webhooks docs]: /integrations/telegram_webhooks
|
||||
[updater docs]: /integrations/updater/
|
||||
|
@ -504,7 +504,7 @@ light:
|
||||
[switch.verisure docs]: /integrations/verisure
|
||||
[switch.wake_on_lan docs]: /integrations/wake_on_lan#switch
|
||||
[tado docs]: /integrations/tado/
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[telegram_bot.webhooks docs]: /integrations/telegram_webhooks
|
||||
[tellduslive docs]: /integrations/tellduslive/
|
||||
[tts docs]: /integrations/tts/
|
||||
|
@ -488,7 +488,7 @@ amcrest:
|
||||
[@maikelwever]: https://github.com/maikelwever
|
||||
[@ypollart]: https://github.com/ypollart
|
||||
[binary_sensor.rfxtrx docs]: /integrations/binary_sensor.rfxtrx/
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[#8545]: https://github.com/home-assistant/home-assistant/pull/8545
|
||||
[#8571]: https://github.com/home-assistant/home-assistant/pull/8571
|
||||
[#8601]: https://github.com/home-assistant/home-assistant/pull/8601
|
||||
|
@ -442,7 +442,7 @@ vacuum:
|
||||
[switch.rainmachine docs]: /integrations/rainmachine#switch
|
||||
[switch.wink docs]: /integrations/wink#switch
|
||||
[switch.xiaomi_vacuum docs]: /integrations/vacuum.xiaomi_miio/
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[updater docs]: /integrations/updater/
|
||||
[vacuum docs]: /integrations/vacuum/
|
||||
[vacuum.demo docs]: /integrations/vacuum.demo/
|
||||
|
@ -439,7 +439,7 @@ frontend:
|
||||
[switch.rest docs]: /integrations/switch.rest/
|
||||
[switch.rfxtrx docs]: /integrations/switch.rfxtrx/
|
||||
[switch.knx docs]: /integrations/switch.knx/
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[tesla docs]: /integrations/tesla/
|
||||
[tradfri docs]: /integrations/tradfri/
|
||||
[volvooncall docs]: /integrations/volvooncall/
|
||||
|
@ -527,7 +527,7 @@ Experiencing issues introduced by this release? Please report them in our [issue
|
||||
[switch.tplink docs]: /integrations/tplink
|
||||
[switch.wink docs]: /integrations/wink#switch
|
||||
[switch.xiaomi_miio docs]: /integrations/switch.xiaomi_miio/
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[tesla docs]: /integrations/tesla/
|
||||
[toon docs]: /integrations/toon/
|
||||
[tradfri docs]: /integrations/tradfri/
|
||||
|
@ -469,7 +469,7 @@ Experiencing issues introduced by this release? Please report them in our [issue
|
||||
[switch.snmp docs]: /integrations/snmp#switch
|
||||
[switch.xiaomi_miio docs]: /integrations/switch.xiaomi_miio/
|
||||
[system_log docs]: /integrations/system_log/
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[telegram_bot.polling docs]: /integrations/telegram_polling
|
||||
[tradfri docs]: /integrations/tradfri/
|
||||
[tts docs]: /integrations/tts/
|
||||
|
@ -760,7 +760,7 @@ Note however, that this feature was replaced by a new ignore_string config optio
|
||||
[switch.transmission docs]: /integrations/transmission
|
||||
[switch.xiaomi_miio docs]: /integrations/switch.xiaomi_miio/
|
||||
[tahoma docs]: /integrations/tahoma/
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[timer docs]: /integrations/timer/
|
||||
[tts.baidu docs]: /integrations/baidu
|
||||
[tts.marytts docs]: /integrations/marytts
|
||||
|
@ -576,7 +576,7 @@ Experiencing issues introduced by this release? Please report them in our [issue
|
||||
[switch.smappee docs]: /integrations/smappee
|
||||
[switch.xiaomi_miio docs]: /integrations/switch.xiaomi_miio/
|
||||
[tahoma docs]: /integrations/tahoma/
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[vacuum.xiaomi_miio docs]: /integrations/vacuum.xiaomi_miio/
|
||||
[vera docs]: /integrations/vera/
|
||||
[weather.buienradar docs]: /integrations/buienradar
|
||||
|
@ -550,7 +550,7 @@ Experiencing issues introduced by this release? Please report them in our [issue
|
||||
[switch.vesync docs]: /integrations/vesync#switches
|
||||
[switch.xiaomi_miio docs]: /integrations/switch.xiaomi_miio/
|
||||
[switch.zha docs]: /integrations/zha
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[upcloud docs]: /integrations/upcloud/
|
||||
[vacuum.xiaomi_miio docs]: /integrations/vacuum.xiaomi_miio/
|
||||
[weather.darksky docs]: /integrations/weather.darksky/
|
||||
|
@ -432,7 +432,7 @@ Experiencing issues introduced by this release? Please report them in our [issue
|
||||
[switch.tahoma docs]: /integrations/tahoma
|
||||
[system_log docs]: /integrations/system_log/
|
||||
[tahoma docs]: /integrations/tahoma/
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[tts docs]: /integrations/tts/
|
||||
[updater docs]: /integrations/updater/
|
||||
[weather.bom docs]: /integrations/bom
|
||||
|
@ -480,7 +480,7 @@ The configuration value type should no longer be used. ([@endor-force] - [#15935
|
||||
[switch.tahoma docs]: /integrations/tahoma
|
||||
[switch.tplink docs]: /integrations/tplink
|
||||
[tahoma docs]: /integrations/tahoma/
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[tts docs]: /integrations/tts/
|
||||
[upnp docs]: /integrations/upnp/
|
||||
[vacuum docs]: /integrations/vacuum/
|
||||
|
@ -80,7 +80,7 @@ On the devices side, we got basic support for the new IKEA TRÅDFRI switches, Ho
|
||||
[camera.blink docs]: /integrations/blink
|
||||
[cloud docs]: /integrations/cloud/
|
||||
[sensor.blink docs]: /integrations/blink
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
|
||||
## Release 0.80.3 - October 18
|
||||
|
||||
@ -709,7 +709,7 @@ Experiencing issues introduced by this release? Please report them in our [issue
|
||||
[switch.tradfri docs]: /integrations/tradfri
|
||||
[switch.volvooncall docs]: /integrations/volvooncall
|
||||
[switch.xiaomi_aqara docs]: /integrations/switch.xiaomi_aqara/
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[tibber docs]: /integrations/tibber/
|
||||
[timer docs]: /integrations/timer/
|
||||
[tradfri docs]: /integrations/tradfri/
|
||||
|
@ -843,7 +843,7 @@ Experiencing issues introduced by this release? Please report them in our [issue
|
||||
[switch.xiaomi_aqara docs]: /integrations/switch.xiaomi_aqara/
|
||||
[switch.xiaomi_miio docs]: /integrations/switch.xiaomi_miio/
|
||||
[switch.zwave docs]: /integrations/zwave
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[tts docs]: /integrations/tts/
|
||||
[twilio docs]: /integrations/twilio/
|
||||
[unifi docs]: /integrations/unifi/
|
||||
|
@ -678,7 +678,7 @@ Experiencing issues introduced by this release? Please report them in our [issue
|
||||
[switch.xiaomi_aqara docs]: /integrations/switch.xiaomi_aqara/
|
||||
[switch.xiaomi_miio docs]: /integrations/switch.xiaomi_miio/
|
||||
[switch.zigbee docs]: /integrations/zigbee#switch
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[tts docs]: /integrations/tts/
|
||||
[twilio docs]: /integrations/twilio/
|
||||
[updater docs]: /integrations/updater/
|
||||
|
@ -713,7 +713,7 @@ Experiencing issues introduced by this release? Please report them in our [issue
|
||||
[switch.tplink docs]: /integrations/tplink
|
||||
[system_log docs]: /integrations/system_log/
|
||||
[tahoma docs]: /integrations/tahoma/
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[tellduslive docs]: /integrations/tellduslive/
|
||||
[tibber docs]: /integrations/tibber/
|
||||
[toon docs]: /integrations/toon/
|
||||
|
@ -831,7 +831,7 @@ Experiencing issues introduced by this release? Please report them in our [issue
|
||||
[switch docs]: /integrations/switch/
|
||||
[switchbot docs]: /integrations/switchbot/
|
||||
[systemmonitor docs]: /integrations/systemmonitor/
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[tellduslive docs]: /integrations/tellduslive/
|
||||
[tfiac docs]: /integrations/tfiac/
|
||||
[tibber docs]: /integrations/tibber/
|
||||
|
@ -1076,7 +1076,7 @@ Experiencing issues introduced by this release? Please report them in our [issue
|
||||
[stream docs]: /integrations/stream/
|
||||
[supla docs]: /integrations/supla/
|
||||
[switch docs]: /integrations/switch/
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[tellduslive docs]: /integrations/tellduslive/
|
||||
[tplink docs]: /integrations/tplink/
|
||||
[trend docs]: /integrations/trend/
|
||||
|
@ -853,7 +853,7 @@ Experiencing issues introduced by this release? Please report them in our [issue
|
||||
[systemmonitor docs]: /integrations/systemmonitor/
|
||||
[tapsaff docs]: /integrations/tapsaff/
|
||||
[ted5000 docs]: /integrations/ted5000/
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[tellduslive docs]: /integrations/tellduslive/
|
||||
[tensorflow docs]: /integrations/tensorflow/
|
||||
[thethingsnetwork docs]: /integrations/thethingsnetwork/
|
||||
|
@ -2028,7 +2028,7 @@ Make sure to fill in all fields of the issue template, that is helping us a lot!
|
||||
[tado docs]: /integrations/tado/
|
||||
[tahoma docs]: /integrations/tahoma/
|
||||
[tank_utility docs]: /integrations/tank_utility/
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[tellduslive docs]: /integrations/tellduslive/
|
||||
[template docs]: /integrations/template/
|
||||
[tesla docs]: /integrations/tesla/
|
||||
|
@ -228,7 +228,7 @@ Experiencing issues introduced by this release? Please report them in our [issue
|
||||
input_type: discrete_input
|
||||
```
|
||||
|
||||
- **Tado** - Adding support of multiple Tado accounts has changed the unique ID generation of sensor and climate devices, and now includes the ID of the home.
|
||||
- **Tado** - Adding support of multiple Tado accounts has changed the unique ID generation of sensor and climate devices, and now includes the ID of the home. As a result you will see new entity ID's for `sensor` and `climate` devices.
|
||||
|
||||
In addition, support for water heater zones has been added. Tado hot water zones with temperature control previously created a climate entity, e.g., `climate.hot_water`, and these will be replaced by a `water_heater.hot_water` entity. This change is not breaking for hot water zones without temperature control as they do not have a climate zone.
|
||||
|
||||
@ -333,6 +333,56 @@ Experiencing issues introduced by this release? Please report them in our [issue
|
||||
- Updated frontend to 20200220.4 ([@bramkragten] - [#32205]) ([frontend docs]) (beta fix)
|
||||
- Remove deprecated Hue options (fixes CI) ([@frenck] - [#32027]) ([hue docs]) (breaking change) (beta fix)
|
||||
|
||||
## Release 0.106.1 - February 27
|
||||
|
||||
- Add missing translations for light actions ([@emontnemery] - [#32216]) ([light docs])
|
||||
- Mark clients away if they have never been seen. ([@lociii] - [#32222]) ([unifi docs])
|
||||
- Fix DSMR 5 ([@dupondje] - [#32233]) ([dsmr docs])
|
||||
- Bump simplisafe-python to 9.0.0 ([@bachya] - [#32215]) ([simplisafe docs])
|
||||
- Bump simplisafe-python to 9.0.2 ([@bachya] - [#32273]) ([simplisafe docs])
|
||||
- deCONZ - Race condition on slower systems ([@Kane610] - [#32274]) ([deconz docs])
|
||||
- Catch more Hue errors ([@balloob] - [#32275]) ([hue docs])
|
||||
|
||||
[#32215]: https://github.com/home-assistant/home-assistant/pull/32215
|
||||
[#32216]: https://github.com/home-assistant/home-assistant/pull/32216
|
||||
[#32222]: https://github.com/home-assistant/home-assistant/pull/32222
|
||||
[#32233]: https://github.com/home-assistant/home-assistant/pull/32233
|
||||
[#32273]: https://github.com/home-assistant/home-assistant/pull/32273
|
||||
[#32274]: https://github.com/home-assistant/home-assistant/pull/32274
|
||||
[#32275]: https://github.com/home-assistant/home-assistant/pull/32275
|
||||
[@Kane610]: https://github.com/Kane610
|
||||
[@bachya]: https://github.com/bachya
|
||||
[@balloob]: https://github.com/balloob
|
||||
[@dupondje]: https://github.com/dupondje
|
||||
[@emontnemery]: https://github.com/emontnemery
|
||||
[@lociii]: https://github.com/lociii
|
||||
[deconz docs]: /integrations/deconz/
|
||||
[dsmr docs]: /integrations/dsmr/
|
||||
[hue docs]: /integrations/hue/
|
||||
[light docs]: /integrations/light/
|
||||
[simplisafe docs]: /integrations/simplisafe/
|
||||
[unifi docs]: /integrations/unifi/
|
||||
|
||||
## Release 0.106.2 - February 28
|
||||
|
||||
- Updated frontend to 20200220.5 ([@bramkragten] - [#32312]) ([frontend docs])
|
||||
- revent saving/deleting Lovelace config in safe mode ([@balloob] - [#32319]) ([lovelace docs])
|
||||
- UniFi - Temporary workaround to get device tracker to mark cli… ([@Kane610] - [#32321]) ([unifi docs])
|
||||
- Ensure rest sensors are marked unavailable when http requests… ([@bdraco] - [#32309]) ([rest docs])
|
||||
|
||||
[#32309]: https://github.com/home-assistant/home-assistant/pull/32309
|
||||
[#32312]: https://github.com/home-assistant/home-assistant/pull/32312
|
||||
[#32319]: https://github.com/home-assistant/home-assistant/pull/32319
|
||||
[#32321]: https://github.com/home-assistant/home-assistant/pull/32321
|
||||
[@Kane610]: https://github.com/Kane610
|
||||
[@balloob]: https://github.com/balloob
|
||||
[@bdraco]: https://github.com/bdraco
|
||||
[@bramkragten]: https://github.com/bramkragten
|
||||
[frontend docs]: /integrations/frontend/
|
||||
[lovelace docs]: /integrations/lovelace/
|
||||
[rest docs]: /integrations/rest/
|
||||
[unifi docs]: /integrations/unifi/
|
||||
|
||||
## All changes
|
||||
|
||||
- Change scan_interval defaults for Tesla ([@alandtse] - [#31194]) ([tesla docs]) (breaking change)
|
||||
@ -1097,7 +1147,7 @@ Experiencing issues introduced by this release? Please report them in our [issue
|
||||
[system_log docs]: /integrations/system_log/
|
||||
[tado docs]: /integrations/tado/
|
||||
[tahoma docs]: /integrations/tahoma/
|
||||
[telegram_bot docs]: /integrations/telegram_chatbot/
|
||||
[telegram_bot docs]: /integrations/telegram_bot/
|
||||
[template docs]: /integrations/template/
|
||||
[tensorflow docs]: /integrations/tensorflow/
|
||||
[tesla docs]: /integrations/tesla/
|
||||
|
100
source/_posts/2020-02-28-community-highlights.markdown
Normal file
100
source/_posts/2020-02-28-community-highlights.markdown
Normal file
@ -0,0 +1,100 @@
|
||||
---
|
||||
title: "Community Highlights: 4th edition"
|
||||
description: "3D All the things!"
|
||||
date: 2020-02-28 00:00:00
|
||||
date_formatted: "February 28, 2020"
|
||||
author: Franck Nijhof
|
||||
author_twitter: frenck
|
||||
categories: Community
|
||||
og_image: /images/blog/2020-02-28-community-highlights/social.png
|
||||
---
|
||||
|
||||
For the 4th edition, I thought it fitted to devote the community highlights to 3D!
|
||||
|
||||
_That is actually a lie, the [3rd edition](/blog/2020/02/19/community-highlights/)
|
||||
would have been much more fitting, but was hijacked by Paulus ;)
|
||||
At least it's my 3rd community highlight writeup, so that counts, right?_
|
||||
|
||||
Ready for some highly inspiring and mind-blowing 3D creations?
|
||||
|
||||
## 3D home navigation and control, using Unity
|
||||
|
||||
Are you sure you ready? Because Harrie de Groot created a fully navigatable
|
||||
3D model of his home using Unity, accessible from within Home Assistant.
|
||||
|
||||
You really **need** to watch the video below now...
|
||||
|
||||
<div class='videoWrapper'>
|
||||
<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/Ee7i3_EWyjk" frameborder="0" allowfullscreen></iframe>
|
||||
</div>
|
||||
|
||||
Well done, Harrie! That looks slick!
|
||||
|
||||
More details on his creation can be found on the
|
||||
[Home Assistant Community Forum](https://community.home-assistant.io/t/3d-home-navigation-control-unity-home-assistant/174972).
|
||||
|
||||
## 3D printed interactive floorplan
|
||||
|
||||
If you have been around a bit, you might have come across a screenshot of
|
||||
someone with an interactive floorplan in Home Assistant. [Ryan Connolly](https://twitter.com/rynam0)
|
||||
took that idea straight into the real world by 3D printing his floorplan,
|
||||
wired it, and hooked it up Home Assistant.
|
||||
|
||||
Talking about taking things into another dimension...
|
||||
|
||||
<blockquote class="twitter-tweet"><p lang="en" dir="ltr">A janky video of my 3d printed <a href="https://twitter.com/home_assistant?ref_src=twsrc%5Etfw">@home_assistant</a> floorplan running <a href="https://twitter.com/NervesProject?ref_src=twsrc%5Etfw">@NervesProject</a> on a <a href="https://twitter.com/Raspberry_Pi?ref_src=twsrc%5Etfw">@Raspberry_Pi</a> <a href="https://t.co/jrLyrR5TNO">pic.twitter.com/jrLyrR5TNO</a></p>— Ryan Connolly (@rynam0) <a href="https://twitter.com/rynam0/status/1232792092268691464?ref_src=twsrc%5Etfw">February 26, 2020</a>
|
||||
</blockquote>
|
||||
|
||||
### Getting started with your own 3D floorplan
|
||||
|
||||
Ok, so the above two, rather impressive, listings might be a bit out of reach
|
||||
for the most of us. Still, with some help, you could still achieve some pretty
|
||||
nice looking 3D floorplans. [Aaron Godfrey](https://github.com/boralyl) wrote a
|
||||
couple of excellent blog posts on this.
|
||||
|
||||
In his [first blog post](https://aarongodfrey.dev/home%20automation/floorplan-in-home-assistant/),
|
||||
Aaron shows you what his floorplan looks like
|
||||
|
||||
<div class='videoWrapper'>
|
||||
<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/ebMQwVjVewU" frameborder="0" allowfullscreen></iframe>
|
||||
</div>
|
||||
|
||||
He followed up with two blog posting on how to achieve this:
|
||||
|
||||
- [Tips for creating a Floorplan in Sweet Home 3D](https://aarongodfrey.dev/home%20automation/tips_for_creating_a_3d_floorplan_using_sweethome3d/)
|
||||
- [Creating an Interactive 3D Floorplan in Home Assistant](https://aarongodfrey.dev/home%20automation/creating-a-3d-floorplan-in-home-assistant/)
|
||||
|
||||
### Bonus tip: HomeByMe
|
||||
|
||||
I've personally got recommended a tool for creating a 3D floorplan with a tool
|
||||
that is generally lesser-known, but actually pretty awesome! [HomeByMe](https://home.by.me/en/)
|
||||
|
||||
<img src='/images/blog/2020-02-28-community-highlights/homebyme.png' alt='Screenshot of HomeByMe.' style='border: 0;box-shadow: none;'>
|
||||
|
||||
This is a result of a 3D floorplan created with [HomeByMe](https://home.by.me/en/).
|
||||
|
||||
It works fully in the browser and I enjoyed the experience using that.
|
||||
So credits where credits due: Thanks for recommending me this sweet little
|
||||
gem [Andrea Donno](https://www.twitter.com/andreadonno)!
|
||||
|
||||
## Got a tip for the next edition?
|
||||
|
||||
Have you seen (or made) something awesome, interesting, unique, amazing, inspirational, unusual or funny, using Home Assistant?
|
||||
|
||||
[Click here to send us your Community Highlight suggestion](/suggest-community-highlight).
|
||||
|
||||
Also, don't forget to share your creations with us via Social Media:
|
||||
|
||||
- Twitter it! Be sure to mention [@home_assistant][twitter]
|
||||
- Share it on our [Facebook group][facebook-group]
|
||||
- Post it to our [subreddit][reddit]
|
||||
- Tag [@homeasssistant][instagram] on Instagram
|
||||
- Or via chat, drop us a line in the [#lounge at Discord][chat]
|
||||
|
||||
See you next edition!
|
||||
|
||||
[chat]: https://www.home-assistant.io/join-chat
|
||||
[facebook-group]: https://www.facebook.com/groups/HomeAssistant/
|
||||
[instagram]: https://www.instagram.com/homeassistant/
|
||||
[reddit]: https://www.reddit.com/r/homeassistant
|
||||
[twitter]: https://www.twitter.com/home_assistant
|
@ -1885,7 +1885,7 @@
|
||||
/components/ted5000 /integrations/ted5000
|
||||
/components/teksavvy /integrations/teksavvy
|
||||
/components/telegram /integrations/telegram
|
||||
/components/telegram_bot /integrations/telegram_chatbot
|
||||
/components/telegram_bot /integrations/telegram_bot
|
||||
/components/tellduslive /integrations/tellduslive
|
||||
/components/tellstick /integrations/tellstick
|
||||
/components/telnet /integrations/telnet
|
||||
@ -2036,6 +2036,7 @@
|
||||
|
||||
# Breaking changes
|
||||
/integrations/switch.pca /integrations/elv
|
||||
/integrations/telegram_chatbot /integrations/telegram_bot
|
||||
|
||||
# Moved documentation
|
||||
/docs/ecosystem/ios/ https://companion.home-assistant.io/
|
||||
|
BIN
source/images/blog/2020-02-28-community-highlights/homebyme.png
Normal file
BIN
source/images/blog/2020-02-28-community-highlights/homebyme.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 155 KiB |
BIN
source/images/blog/2020-02-28-community-highlights/social.png
Normal file
BIN
source/images/blog/2020-02-28-community-highlights/social.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 94 KiB |
Binary file not shown.
Before Width: | Height: | Size: 3.7 KiB After Width: | Height: | Size: 2.0 KiB |
Loading…
x
Reference in New Issue
Block a user