From e31d2a977694159370c41b7fb12cc47c4468809d Mon Sep 17 00:00:00 2001 From: tleegaard Date: Fri, 2 Aug 2019 11:01:21 +0200 Subject: [PATCH 001/126] add co2 sensor to homekit_controller docs (#10037) --- source/_components/homekit_controller.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/homekit_controller.markdown b/source/_components/homekit_controller.markdown index 2df614d999e..a3454c71fb4 100644 --- a/source/_components/homekit_controller.markdown +++ b/source/_components/homekit_controller.markdown @@ -35,7 +35,7 @@ There is currently support for the following device types within Home Assistant: - Lock (HomeKit lock) - Switch (HomeKit switches) - Binary Sensor (HomeKit motion sensors and contact sensors) -- Sensor (HomeKit humidity, temperature, and light level sensors) +- Sensor (HomeKit humidity, temperature, co2 and light level sensors) The integration will be automatically configured if the [`discovery`](/components/discovery/) integration is enabled. From 4095d2e9743dfae8ab71add4450f3a6c8bfeebc1 Mon Sep 17 00:00:00 2001 From: SukramJ Date: Fri, 2 Aug 2019 12:44:08 +0200 Subject: [PATCH 002/126] Update homematicip_cloud.markdown (#10033) --- source/_components/homematicip_cloud.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_components/homematicip_cloud.markdown b/source/_components/homematicip_cloud.markdown index 8d16d1f54b5..fffeeac7b95 100644 --- a/source/_components/homematicip_cloud.markdown +++ b/source/_components/homematicip_cloud.markdown @@ -87,6 +87,7 @@ authtoken: * homematicip_cloud.binary_sensor * Window and door contact (*HmIP-SWDO, -I*) * Contact Interface flush-mount – 1 channel (*HmIP-FCI1*) + * Contact Interface (*HmIP-SCI*) * Window Rotary Handle Sensor (*HmIP-SRH*) * Smoke sensor and alarm (*HmIP-SWSD*) * Motion Detector with Brightness Sensor - indoor (*HmIP-SMI*) From 53e72ba9e8276be43abc490ac2ce5dadf130b36c Mon Sep 17 00:00:00 2001 From: Tom Date: Fri, 2 Aug 2019 13:43:04 +0200 Subject: [PATCH 003/126] Add Plugwise component (#9992) * Added Plugwise component * Update source/_components/plugwise.markdown Thanks for helping out! Co-Authored-By: Klaas Schoute * Suggestions applied, removed unneccesary use of other template information * Suggestions applied , removed unneccesary use of other template information * Move conf example below and update services * Actually moved the full config example as requested * :pencil2: Tweak * Apply review comments * Modified top section (improve grammer, rewording) * Rewording as suggested * Rewording as suggested, backticks * Combined proposed changes from review --- source/_components/plugwise.markdown | 163 ++++++++++++++++++++ source/images/supported_brands/plugwise.png | Bin 0 -> 38408 bytes 2 files changed, 163 insertions(+) create mode 100644 source/_components/plugwise.markdown create mode 100644 source/images/supported_brands/plugwise.png diff --git a/source/_components/plugwise.markdown b/source/_components/plugwise.markdown new file mode 100644 index 00000000000..efd96c7108e --- /dev/null +++ b/source/_components/plugwise.markdown @@ -0,0 +1,163 @@ +--- +title: "Plugwise" +description: "Plugwise Climate integration." +logo: plugwise.png +ha_category: Climate +ha_iot_class: Local Polling +ha_release: 0.98 +--- + +This enables [Plugwise](https://plugwise.com) [Anna](https://www.plugwise.com/en_US/products/anna) thermostats to be integrated. This integration talks locally to your **Smile** interface, and you will need its password and IP address. + +The password can be found on the bottom of your Smile, it should consist of 6 characters. To find your IP address use the Plugwise App: + + - Open the Plugwise App and choose the 'Settings'-icon (☰) and choose 'HTML-interface'. + - Go to the (lower) 'Settings'-icon (☰) and choose 'Preferences'. + - Choose 'System' then 'Networking' and your IP address will be shown. + +## Configuration + +You have to add the following to your configuration.yaml file: + +```yaml +# Minimal configuration.yaml entry +climate: + - platform: plugwise + password: YOUR_SHORT_IP + host: YOUR_SMILE_LOCAL_IP +``` + +{% configuration %} +password: + description: Your Smile ID (located on the bottom of the Smile, not the Anna). + required: true + type: string +host: + description: The IP address of your Smile. + required: true + type: string +name: + description: The name of your thermostat, i.e., "Anna". + required: false + type: string + default: "Plugwise Thermostat" +username: + description: Should you ever need to change this, you can. + required: false + type: string + default: smile +port: + description: When having a custom setup, you can change the port number. + required: false + type: integer + default: 80 +min_temp: + description: If you want to adjust the lower boundary, the integration will not allow temperatures below the set value. + required: false + type: integer + default: 4 +max_temp: + description: If you want to adjust the upper boundary, the integration will not allow temperatures above the set value. + required: false + type: integer + default: 30 +{% endconfiguration %} + +### Full configuration example + +```yaml +climate: + - platform: anna + name: YOUR_THERMOSTAT_NAME + password: YOUR_SHORT_ID + host: YOUR_SMILE_LOCAL_IP + port: YOUR_SMILE_PORT_NUMBER + min_temp: YOUR_MINIMAL_TARGET_TEMPERATURE + max_temp: YOUR_MAXIMAL_TARGET_TEMPERATURE +``` + +### Service + +#### Set HVAC mode (schedule) + +Service: `climate.set_hvac_mode` + +Available options include `auto` or `off`. The meaning of `auto` is that a schedule is active and the thermostat will change presets accordingly. The meaning of `off` is that there is no schedule active, i.e., the active preset or manually set temperature is to be used to control the climate of your house or rooms. +The last schedule that was active is determined the same way long-tapping the top of Anna works. + +Example: + +```yaml +# Example script change the temperature +script: + anna_reactive_last_schedule: + sequence: + - service: climate.set_hvac_mode + data: + hvac_mode: auto +``` + +Changing the active schedule can be done, though not easily: + +- Deactivate the schedule (press the power button on the UI-card). +- Look up the available schemas in the `states` view (attribute `available_schemas`). +- Change the attribute `active_schema` to the actual name of your schema as available from the above attribute or your Plugwise App. +- Activate the schedule (press the calendar button on the UI-card). + +#### Set temperature + +Service: `climate.set_temperature` + +Example: + +```yaml +# Example script change the temperature +script: + anna_set_predefined_temperature: + sequence: + - service: climate.set_temperature + data: + temperature: 19.5 +``` + +#### Set preset mode + +Service: `climate.set_preset_mode` + +Available options include: `home`, `vacation`, `no_frost`, `asleep` & `away`. + +Example: + +```yaml +# Example script changing the active (or currently set by schedule) preset +script: + anna_activate_preset_asleep: + sequence: + - service: climate.set_preset_mode + data: + preset_mode: asleep +``` + +### Troubleshooting + +Example of a working configuration excerpt (with debugging enabled): + +```txt +[homeassistant.loader] Loaded plugwise from custom_components.plugwise +[homeassistant.loader] You are using a custom integration for plugwise which has not been tested by Home Assistant. This component might cause stability problems, be sure to disable it if you do experience issues with Home Assistant. +[custom_components.plugwise.climate] Plugwise: custom component loading (Anna PlugWise climate) +[homeassistant.components.climate] Setting up climate.plugwise +[custom_components.plugwise.climate] Init called +[custom_components.plugwise.climate] Initializing API +[custom_components.plugwise.climate] platform ready +[custom_components.plugwise.climate] Update called +``` + +Example of something going wrong (IP address not set) excerpt is shown below. Correct your configuration and try again. If the errors persist, please share a larger excerpt of your logfile. + +```txt +1970-01-01 00:00:01 ERROR (MainThread) [homeassistant.components.climate] Error while setting up platform plugwise + File "/home/homeassistant/.homeassistant/custom_components/plugwise/climate.py", line 104, in setup_platform + File "/home/homeassistant/.homeassistant/custom_components/plugwise/climate.py", line 130, in __init__ + self._api = Haanna(self._username, self._password, self._host, self._port) +``` diff --git a/source/images/supported_brands/plugwise.png b/source/images/supported_brands/plugwise.png new file mode 100644 index 0000000000000000000000000000000000000000..f48480b7b135ffd1790a52b6ad99d5c687cd5379 GIT binary patch literal 38408 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 UUvzouC4qoXSIbbdQr#)+f4Z_IJpcdz literal 0 HcmV?d00001 From 2c9408cbb2aecd8286666653f86fd69f75345bea Mon Sep 17 00:00:00 2001 From: Robert Svensson Date: Fri, 2 Aug 2019 14:04:11 +0200 Subject: [PATCH 004/126] UniFi - description for dont_track_clients and dont_track_devices (#10034) * Add description for new parameters dont_track_clients and dont_track_devices * Fix Franks comment --- source/_components/unifi.markdown | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/source/_components/unifi.markdown b/source/_components/unifi.markdown index ec1c1a12d01..f507d756ded 100644 --- a/source/_components/unifi.markdown +++ b/source/_components/unifi.markdown @@ -39,7 +39,7 @@ unifi: site: My site ssid_filter: - 'HomeSSID' - 'IoTSSID' + - 'IoTSSID' ``` {% configuration %} @@ -63,6 +63,16 @@ detection_time: type: integer required: false default: 300 +dont_track_clients: + description: enable to not allow device tracker to track clients. + type: boolean + required: false + default: false +dont_track_devices: + description: enable to not allow device tracker to track devices. + type: boolean + required: false + default: false ssid_filter: description: Filter the SSIDs that tracking will occur on. type: list From 18ca5c4a92337a5c1f5d6b9fb9a2e22002cd2baf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Niels=20M=C3=BCndler?= Date: Fri, 2 Aug 2019 18:37:14 +0200 Subject: [PATCH 005/126] Add detailed overview over added components (#10028) * Add detailed overview over added components also note that now all templates are created automatically * :pencil2: Tweak * Add note about seemingly missing data * Fix configuration * :pencil2: Tweaks --- source/_components/fronius.markdown | 70 ++++++++++++++++------------- 1 file changed, 40 insertions(+), 30 deletions(-) diff --git a/source/_components/fronius.markdown b/source/_components/fronius.markdown index fb23ba7b51c..d317d18af1d 100644 --- a/source/_components/fronius.markdown +++ b/source/_components/fronius.markdown @@ -9,7 +9,7 @@ ha_iot_class: Local Polling ha_release: 0.96 --- -The `fronius` sensor will poll a [Fronius](http://www.fronius.com/) solar inverter, battery system or smart meter and present the values as sensors (or attributes of sensors) in Home Assistant. +The `fronius` sensor polls a [Fronius](http://www.fronius.com/) solar inverter, battery system or smart meter and present the values as sensors in Home Assistant. ## Configuration @@ -33,7 +33,7 @@ monitored_conditions: required: true type: list keys: - type: + sensor_type: description: "The kind of device, can be one of \"inverter\", \"storage\", \"meter\", or \"power_flow\"" required: true type: string @@ -48,6 +48,44 @@ monitored_conditions: default: "\"1\" for inverters and \"0\" for other devices such as storages in compliance with Fronius Specs" {% endconfiguration %} +## Monitored data + +Each sensor type chosen as monitored condition adds a set of sensors to Home Assistant. + +- `power_flow` + + Cumulative data such as the energy produced in the current day or year and overall produced energy. + Also, live values such as: + + - Power fed to the grid (if positive) or taken from the grid (if negative). + - Power load as a generator (if positive) or consumer (if negative). + - Battery charging power (if positive) or discharging power (if negative) and information about backup or standby mode. + - Photovoltaic production. + - Current relative self-consumption of produced energy. + - Current relative autonomy. + +- `inverter` + + Cumulative data such as the energy produced in the current day or year and overall produced energy. + Also, live values about AC/DC power, current, voltage and frequency. + The data is only shown when choosing device scope. + +- `meter` + + Detailed information about power, current and voltage, if supported split among the phases. + The data is only shown when choosing device scope. + +- `storage` + + Detailed information about current, voltage, state, cycle count, capacity and more about installed batteries. + +Note that some data (like photovoltaic production) is only provided by the Fronius device when non-zero. +The corresponding sensors are added to Home Assistant as entities as soon as they are available. +This means for example that when Home Assistant is started at night, +there might be no sensor providing photovoltaic related data. +This does not need to be problematic as the values will be added on sunrise, +when the Fronius devices begins providing the needed data. + ## Examples When including more of the components that one Fronius device offers, @@ -68,31 +106,3 @@ sensor: device: 0 - sensor_type: power_flow ``` - -## Sensors configuration - -To extract more detailed values from the state of each integrated sensor and to circumvent undefined values, -it is recommended to use template sensors as an interface: - -{% raw %} -```yaml -- platform: template - sensors: - electricity_inverter1_power_netto: - unit_of_measurement: 'W' - value_template: >- - {% if states.sensor.fronius_1921684247_inverter_1.attributes.power_ac is defined -%} - {{ states_attr('sensor.fronius_1921684247_inverter_1', 'power_ac') | float | round(2) }} - {%- else -%} - 0 - {%- endif %} - electricity_autonomy: - unit_of_measurement: '%' - value_template: >- - {% if states.sensor.fronius_1921684247_power_flow.attributes.relative_autonomy is defined -%} - {{ states_attr('sensor.fronius_1921684247_power_flow', 'relative_autonomy') | float | round(2) }} - {%- else -%} - 0 - {%- endif %} -``` -{% endraw %} From 10ec911f6c4abdf3a4509a0474539da064aa9cb3 Mon Sep 17 00:00:00 2001 From: Jeff Irion Date: Tue, 6 Aug 2019 03:07:25 -0700 Subject: [PATCH 006/126] Document the 'state_detection_rules' config parameter (#10036) * Document the 'state_detection_rules' config parameter * Add info about how to determine rules * Add comments about indentation This level of indentation for the `wake_lock_size` map is necessary to ensure that the YAML is parsed as intended. * Update the documentation of the 'state_detection_rules' config parameter --- source/_components/androidtv.markdown | 38 ++++++++++++++++++++++++++- 1 file changed, 37 insertions(+), 1 deletion(-) diff --git a/source/_components/androidtv.markdown b/source/_components/androidtv.markdown index 660860063a5..47e26e2e6a1 100644 --- a/source/_components/androidtv.markdown +++ b/source/_components/androidtv.markdown @@ -92,6 +92,11 @@ device_class: required: false default: auto type: string +state_detection_rules: + description: A dictionary whose keys are app IDs and whose values are lists of state detection rules; see the section [Custom State Detection](#custom-state-detection) for more info. + required: false + default: {} + type: map turn_on_command: description: An ADB shell command that will override the default `turn_on` command. required: false @@ -108,7 +113,8 @@ turn_off_command: # Example configuration.yaml entry media_player: # Use an ADB server to setup an Android TV device, provide - # an app name, and override the default turn on/off commands + # an app name, override the default turn on/off commands, + # and provide custom state detection rules - platform: androidtv name: Android TV device_class: androidtv @@ -118,6 +124,21 @@ media_player: com.amazon.tv.launcher: "Fire TV" turn_on_command: "input keyevent 3" turn_off_command: "input keyevent 223" + state_detection_rules: + 'com.amazon.tv.launcher': + - 'standby' + 'com.netflix.ninja': + - 'media_session_state' + 'com.ellation.vrv': + - 'audio_state' + 'com.plexapp.android': + - 'playing': + 'media_session_state': 3 # this indentation is important! + 'wake_lock_size': 3 # this indentation is important! + - 'paused': + 'media_session_state': 3 # this indentation is important! + 'wake_lock_size': 1 # this indentation is important! + - 'standby' # Use the Python ADB implementation with authentication # to setup a Fire TV device and don't get the running apps @@ -235,3 +256,18 @@ Available key commands include: The full list of key commands can be found [here](https://github.com/JeffLIrion/python-androidtv/blob/bf1058a2f746535921b3f5247801469c4567e51a/androidtv/constants.py#L143-L186). You can also use the command `GET_PROPERTIES` to retrieve the properties used by Home Assistant to update the device's state. These will be stored in the media player's `'adb_response'` attribute and logged at the INFO level, this information can be used to help improve state detection in the backend [androidtv](https://github.com/JeffLIrion/python-androidtv) package. + +## Custom State Detection + +The `state_detection_rules` configuration parameter allows you to provide your own rules for state detection. The keys are app IDs, and the values are lists of rules that are evaluated in order. Valid rules are: + +* `'standby'`, `'playing'`, `'paused'`, `'idle'`, `'stopped'`, or `'off'` + * If this is not a map, then this state will always be reported when this app is the current app + * If this is a map, then its entries are conditions that will be checked. If all of the conditions are true, then this state will be reported. Valid conditions pertain to 3 properties (see the example configuration above): + 1. ``'media_session_state'`` + 2. ``'audio_state'`` + 3. ``'wake_lock_size'`` +* `'media_session_state'` = try to use the `media_session_state` property to determine the state +* `'audio_state'` = try to use the `audio_state` property to determine the state + +To determine what these rules should be, you can use the `androidtv.adb_command` service with the command `GET_PROPERTIES`, as described in the [androidtv.adb_command](#androidtvadb_command) section. From 89a8a57899c9609e752ddcf6612d5b34ed929f6c Mon Sep 17 00:00:00 2001 From: Matthias Alphart Date: Tue, 6 Aug 2019 12:33:24 +0200 Subject: [PATCH 007/126] KNX component updates for xknx 0.11 (#9682) * xknx 0.11 * update for xknx 0.11.1 - state_address instead of address - sync_state option * :pencil2: Tweak - Please check if this config variable `device_class` belongs here. For now it breaks netlify with building. * copy and past error -.- * even more typos * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweaks * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweaks * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweak --- source/_components/binary_sensor.knx.markdown | 21 +++- source/_components/climate.knx.markdown | 42 ++++--- source/_components/cover.knx.markdown | 9 +- source/_components/knx.markdown | 33 ++--- source/_components/light.knx.markdown | 18 ++- source/_components/notify.knx.markdown | 8 +- source/_components/scene.knx.markdown | 12 +- source/_components/sensor.knx.markdown | 114 +++++++++++------- source/_components/switch.knx.markdown | 10 +- 9 files changed, 176 insertions(+), 91 deletions(-) diff --git a/source/_components/binary_sensor.knx.markdown b/source/_components/binary_sensor.knx.markdown index 34148af2a5a..2af616f8fd4 100644 --- a/source/_components/binary_sensor.knx.markdown +++ b/source/_components/binary_sensor.knx.markdown @@ -5,11 +5,19 @@ logo: knx.png ha_category: - Binary Sensor ha_release: 0.24 -ha_iot_class: Local Polling +ha_iot_class: Local Push --- +
+ +The `knx` integration must be configured correctly to use this integration, see [KNX Integration](/components/knx). + +
+ The `knx` sensor platform allows you to monitor [KNX](http://www.knx.org) binary sensors. +Binary sensors are read-only. To write to the knx-bus configure an exposure [KNX Integration - Expose](/components/knx/#exposing-sensor-values-or-time-to-knx-bus). + ## Configuration The `knx` integration must be configured correctly, see [KNX Integration](/components/knx). @@ -18,11 +26,11 @@ The `knx` integration must be configured correctly, see [KNX Integration](/compo # Example configuration.yaml entry binary_sensor: - platform: knx - address: '6/0/2' + state_address: '6/0/2' ``` {% configuration %} -address: +state_address: description: KNX group address of the binary sensor. required: true type: string @@ -30,6 +38,11 @@ name: description: A name for this device used within Home Assistant. required: false type: string +sync_state: + description: Actively read the value from the bus. If `False` no GroupValueRead telegrams will be sent to the bus. + required: false + type: boolean + default: True device_class: description: Sets the [class of the device](/components/binary_sensor/), changing the device state and icon that is displayed on the frontend. required: false @@ -54,7 +67,7 @@ You can also attach actions to binary sensors (e.g., to switch on a light when a binary_sensor: - platform: knx name: Livingroom.3Switch3 - address: '5/0/26' + state_address: '5/0/26' automation: - counter: 1 hook: 'on' diff --git a/source/_components/climate.knx.markdown b/source/_components/climate.knx.markdown index 9abcffc5443..a0d63bac21b 100644 --- a/source/_components/climate.knx.markdown +++ b/source/_components/climate.knx.markdown @@ -5,12 +5,16 @@ logo: knx.png ha_category: - Climate ha_release: 0.25 -ha_iot_class: Local Polling +ha_iot_class: Local Push --- -The `knx` climate platform is used as in interface with KNX thermostats. +
+ +The `knx` integration must be configured correctly to use this integration, see [KNX Integration](/components/knx). -The `knx` integration must be configured correctly, see [KNX Integration](/components/knx). +
+ +The `knx` climate platform is used as an interface to KNX thermostats and room controllers. To use your KNX thermostats in your installation, add the following lines to your `configuration.yaml` file: @@ -24,6 +28,7 @@ climate: setpoint_shift_state_address: '5/1/3' target_temperature_state_address: '5/1/4' operation_mode_address: '5/1/5' + operation_mode_state_address: '5/1/6' ``` Alternatively, if your device has dedicated binary group addresses for frost/night/comfort mode: @@ -40,10 +45,11 @@ climate: operation_mode_frost_protection_address: '5/1/5' operation_mode_night_address: '5/1/6' operation_mode_comfort_address: '5/1/7' + operation_mode_state_address: '5/1/8' ``` If your device doesn't support setpoint_shift calculations (i.e. if you don't provide a `setpoint_shift_address` value) please set the `min_temp` and `max_temp` -attributes of the climate device to avoid issues with increasing the temperature in the frontend. Please do also make sure to add the `target_temperature_address` +attributes of the climate device to avoid issues with exceeding valid temperature values in the frontend. Please do also make sure to add the `target_temperature_address` to the config in this case.: ```yaml @@ -57,11 +63,13 @@ climate: operation_mode_frost_protection_address: '5/1/5' operation_mode_night_address: '5/1/6' operation_mode_comfort_address: '5/1/7' + operation_mode_state_address: '5/1/8' min_temp: 7.0 max_temp: 32.0 ``` `operation_mode_frost_protection_address` / `operation_mode_night_address` / `operation_mode_comfort_address` are not necessary if `operation_mode_address` is specified. +If the actor doesn't support explicit state communication objects the *_state_address can be configured with the same group address as the writeable *_address. The Read-Flag for the *_state_address communication object has to be set in ETS to support initial reading eg. when starting home-assistant. The following values are valid for the `hvac_mode` attribute: @@ -86,27 +94,27 @@ name: default: KNX Climate type: string temperature_address: - description: KNX group address for reading current room temperature from KNX bus. + description: KNX group address for reading current room temperature from KNX bus. *DPT 9.001* required: true type: string target_temperature_address: - description: KNX group address for setting target temperature. + description: KNX group address for setting target temperature. *DPT 9.001* required: false type: string target_temperature_state_address: - description: KNX group address for reading current target temperature from KNX bus. + description: KNX group address for reading current target temperature from KNX bus. *DPT 9.001* required: true type: string setpoint_shift_address: - description: KNX address for setpoint_shift. + description: KNX address for setpoint_shift. *DPT 6.010* required: false type: string setpoint_shift_state_address: - description: Explicit KNX address for reading setpoint_shift. + description: KNX address for reading setpoint_shift. *DPT 6.010* required: false type: string setpoint_shift_step: - description: Defines for step size in Kelvin for each step of setpoint_shift. + description: Defines the step size in Kelvin for each step of setpoint_shift. required: false default: 0.5 type: float @@ -114,18 +122,18 @@ setpoint_shift_min: description: Minimum value of setpoint shift. required: false default: -6 - type: integer + type: float setpoint_shift_max: description: Maximum value of setpoint shift. required: false default: 6 - type: integer + type: float operation_mode_address: - description: KNX address for operation mode (Frost protection/night/comfort). + description: KNX address for setting operation mode (Frost protection/night/comfort). *DPT 20.102* required: false type: string operation_mode_state_address: - description: Explicit KNX address for reading operation mode. + description: KNX address for reading operation mode. *DPT 20.102* required: false type: string controller_status_address: @@ -133,15 +141,15 @@ controller_status_address: required: false type: string controller_status_state_address: - description: Explicit KNX address for reading HVAC controller status. + description: KNX address for reading HVAC controller status. required: false type: string controller_mode_address: - description: KNX address for handling controller modes. + description: KNX address for setting HVAC controller modes. *DPT 20.105* required: false type: string controller_mode_state_address: - description: Explicit KNX address for reading HVAC Control Mode. + description: KNX address for reading HVAC Control Mode. *DPT 20.105* required: false type: string operation_mode_frost_protection_address: diff --git a/source/_components/cover.knx.markdown b/source/_components/cover.knx.markdown index e8f48ef6ca7..ff25c2eef65 100644 --- a/source/_components/cover.knx.markdown +++ b/source/_components/cover.knx.markdown @@ -5,13 +5,16 @@ logo: knx.png ha_category: - Cover ha_release: 0.48 -ha_iot_class: Local Polling +ha_iot_class: Local Push --- +
-The `knx` cover platform is used as in interface with KNX covers. +The `knx` integration must be configured correctly to use this integration, see [KNX Integration](/components/knx). -The `knx` integration must be configured correctly, see [KNX Integration](/components/knx). +
+ +The `knx` cover platform is used as an interface to KNX covers. To use your KNX covers in your installation, add the following to your `configuration.yaml` file: diff --git a/source/_components/knx.markdown b/source/_components/knx.markdown index 1414e90544b..68cc868899d 100644 --- a/source/_components/knx.markdown +++ b/source/_components/knx.markdown @@ -5,17 +5,15 @@ logo: knx.png ha_category: - Hub ha_release: 0.24 -ha_iot_class: Local Polling +ha_iot_class: Local Push --- The [KNX](https://www.knx.org) integration for Home Assistant allows you to connect to a KNX/IP devices. -The integration requires a local KNX/IP interface like the [Weinzierl 730](https://www.weinzierl.de/index.php/en/all-knx/knx-devices-en/produktarchiv-en/knx-ip-interface-730-en). Through this, it will send and receive commands to and from other devices to the KNX bus. - -
- - Please note, the `knx` platform does not support Windows and needs at least python version 3.5. +The integration requires a local KNX/IP interface or a KNX/IP router. Through this, it will send and receive commands to and from other devices to the KNX bus. +
+Please note, the `knx` platform does not support Windows.
There is currently support for the following device types within Home Assistant: @@ -69,19 +67,21 @@ knx: host: description: Host of the KNX/IP tunneling device. type: string + required: true port: description: Port of the KNX/IP tunneling device. type: integer + required: false local_ip: description: IP of the local interface. type: string + required: false {% endconfiguration %} Explicit connection to a KNX/IP routing device: ```yaml knx: - config_file: '/path/to/xknx.yaml' routing: local_ip: '192.168.2.109' ``` @@ -90,6 +90,7 @@ knx: local_ip: description: The local IP address of interface (which should be used for multicasting). type: string + required: true {% endconfiguration %} ```yaml @@ -117,7 +118,7 @@ state_updater: ### Services -In order to directly interact with the KNX bus, you can now use the following service: +In order to directly interact with the KNX bus, you can use the following service: ``` Domain: knx @@ -145,6 +146,12 @@ knx: - type: 'temperature' entity_id: 'sensor.owm_temperature' address: '0/0/2' + - type: 'string' + address: '0/6/4' + entity_id: "sensor.owm_weather" + - type: 'binary' + entity_id: 'binary_sensor.kitchen_window' + address: '0/6/5' - type: 'time' address: '0/0/1' - type: 'datetime' @@ -153,16 +160,14 @@ knx: {% configuration %} type: - description: Type of the exposed value. Either time or datetime or any supported type of [KNX Sensor](/components/sensor.knx/) (e.g., "temperature" or "humidity"). + description: Type of the exposed value. Either 'binary', 'time', 'date', 'datetime' or any supported type of [KNX Sensor](/components/sensor.knx/) (e.g., "temperature" or "humidity"). type: string + required: true entity_id: - description: Entity id of the HASS integration to be exposed. Not necessary for types time and datetime. + description: Entity id to be exposed. Not needed for types time, date and datetime. type: string address: description: KNX group address. type: string + required: true {% endconfiguration %} - -### Known issues - -Due to lame multicast support the routing abstraction and the gateway scanner only work with Python >=3.5. diff --git a/source/_components/light.knx.markdown b/source/_components/light.knx.markdown index 04372579312..f97ee085522 100644 --- a/source/_components/light.knx.markdown +++ b/source/_components/light.knx.markdown @@ -5,9 +5,15 @@ logo: knx.png ha_category: - Light ha_release: 0.44 -ha_iot_class: Local Polling +ha_iot_class: Local Push --- +
+ +The `knx` integration must be configured correctly to use this integration, see [KNX Integration](/components/knx). + +
+ The `knx light` integration is used as an interface to control knx actuators for lighting applications such as: - switching actuators @@ -15,8 +21,6 @@ The `knx light` integration is used as an interface to control knx actuators for - LED controllers - DALI gateways -The `knx` integration must be configured correctly to use this component, see [KNX Component](/components/knx). - ## Configuration To use your KNX light in your installation, add the following lines to your `configuration.yaml` file: @@ -57,6 +61,14 @@ color_state_address: description: KNX group address for retrieving the RGB color of the light. *DPT 232.600* required: false type: string +rgbw_address: + description: KNX group address for setting the RGBW color of the light. *DPT 251.600* + required: false + type: string +rgbw_state_address: + description: KNX group address for retrieving the RGBW color of the light. *DPT 251.600* + required: false + type: string color_temperature_address: description: KNX group address for setting the color temperature of the light. *DPT 5.001 or 7.600 based on color_temperature_mode* required: false diff --git a/source/_components/notify.knx.markdown b/source/_components/notify.knx.markdown index 2f3572ba211..e01f5a874a5 100644 --- a/source/_components/notify.knx.markdown +++ b/source/_components/notify.knx.markdown @@ -8,9 +8,13 @@ ha_release: 0.53 ha_iot_class: Local Push --- -The `knx` notify platform allows you to send notifications to [KNX](http://www.knx.org) devices. +
+ +The `knx` integration must be configured correctly to use this integration, see [KNX Integration](/components/knx). -The `knx` integration must be configured correctly, see [KNX Component](/components/knx). +
+ +The `knx` notify platform allows you to send notifications to [KNX](http://www.knx.org) devices. ## Configuration diff --git a/source/_components/scene.knx.markdown b/source/_components/scene.knx.markdown index 0ee4c644c9b..6a05b862f57 100644 --- a/source/_components/scene.knx.markdown +++ b/source/_components/scene.knx.markdown @@ -7,9 +7,13 @@ ha_category: ha_release: 0.63 --- -The `knx` scenes platform allows you to trigger [KNX](http://www.knx.org) scenes. +
+ +The `knx` integration must be configured correctly to use this integration, see [KNX Integration](/components/knx). -The `knx` integration must be configured correctly, see [KNX Component](/components/knx). +
+ +The `knx` scenes platform allows you to trigger [KNX](http://www.knx.org) scenes. ## Configuration @@ -26,11 +30,11 @@ scene: {% configuration %} address: - description: KNX group address of the binary sensor. + description: KNX group address for the scene. required: true type: string scene_number: - description: Zero-indexed KNX scene number to be activated. + description: KNX scene number to be activated. ( 1 ... 64 ) required: true type: integer name: diff --git a/source/_components/sensor.knx.markdown b/source/_components/sensor.knx.markdown index dbd09b75cff..2432e35c78c 100644 --- a/source/_components/sensor.knx.markdown +++ b/source/_components/sensor.knx.markdown @@ -1,6 +1,6 @@ --- title: "KNX Sensor" -description: "Instructions on how to use the KNX Sensor with Home Assistant." +description: "Instructions on how to use a KNX Sensor with Home Assistant." logo: knx.png ha_category: - Sensor @@ -8,9 +8,16 @@ ha_release: 0.29 ha_iot_class: Local Push --- -The `knx` sensor platform allows you to monitor [KNX](http://www.knx.org) sensors. +
+ +The `knx` integration must be configured correctly to use this integration, see [KNX Integration](/components/knx). + +
+ +The `knx` sensor platform allows you to monitor [KNX](http://www.knx.org) sensors. + +Sensors are read-only. To write to the knx-bus configure an exposure [KNX Integration - Expose](/components/knx/#exposing-sensor-values-or-time-to-knx-bus). -The `knx` integration must be configured correctly, see [KNX Component](/components/knx). ## Configuration @@ -21,11 +28,11 @@ To use your KNX sensor in your installation, add the following lines to your `co sensor: - platform: knx name: Heating.Valve1 - address: '2/0/0' + state_address: '2/0/0' ``` {% configuration %} -address: +state_address: description: KNX group address of the sensor. required: true type: string @@ -33,44 +40,68 @@ name: description: A name for this device used within Home Assistant. required: false type: string -type: - description: A type from the following table can be defined. The DPT of the group address should match the expected KNX DPT to be parsed correctly. +sync_state: + description: Actively read the value from the bus. If `False` no GroupValueRead telegrams will be sent to the bus. required: false + type: boolean + default: True +type: + description: A type from the following table must be defined. The DPT of the group address should match the expected KNX DPT to be parsed correctly. + required: true type: string {% endconfiguration %} -| type | unit | expected KNX DPT | -|--------------------|------|------------------| -| percent | % | 5.001 | -| pulse | | 5.010 | -| temperature | °C | 9.001 | -| humidity | % | 9.007 | -| illuminance | lx | 9.004 | -| brightness | lx | 7.013 | -| speed_ms | m/s | 9.005 | -| current | mA | 7.012 | -| voltage | mV | 9.020 | -| power | W | 14.056 | -| electric_current | A | 14.019 | -| electric_potential | V | 14.027 | -| energy | J | 14.031 | -| frequency | Hz | 14.033 | -| heatflowrate | W | 14.036 | -| phaseanglerad | rad | 14.054 | -| phaseangledeg | ° | 14.055 | -| powerfactor | | 14.057 | -| speed | m/s | 14.065 | -| enthalpy | H | 9.* | -| ppm | ppm | 9.008 | -| DPT-7 | | 7.* | -| 2byte_unsigned | | 7.* | -| DPT-9 | | 9.* | -| DPT-12 | | 12.* | -| 4byte_unsigned | | 12.* | -| DPT-13 | | 13.* | -| 4byte_signed | | 13.* | -| DPT-14 | | 14.* | -| 4byte_float | | 14.* | +| KNX DPT | type | size in byte | unit | +|--------:|--------------------|-------------:|----------------| +| 5.001 | percent | 1 | % | +| 5.003 | angle | 1 | ° | +| 5.004 | percentU8 | 1 | % | +| 5.010 | pulse | 1 | | +| 5.010 | DPT-5 | 1 | | +| 5.010 | 1byte_unsigned | 1 | | +| 6.001 | percentV8 | 1 | % | +| 6.010 | counter_pulses | 1 | counter pulses | +| 7.*** | DPT-7 | 2 | | +| 7.001 | 2byte_unsigned | 2 | pulses | +| 7.012 | current | 2 | mA | +| 7.013 | brightness | 2 | lx | +| 7.600 | color_temperature | 2 | K | +| 8.*** | DPT-8 | 2 | | +| 8.001 | 2byte_signed | 2 | pulses | +| 8.002 | delta_time_ms | 2 | ms | +| 8.005 | delta_time_sec | 2 | s | +| 8.006 | delta_time_min | 2 | min | +| 8.007 | delta_time_hrs | 2 | h | +| 8.010 | percentV16 | 2 | % | +| 8.011 | rotation_angle | 2 | ° | +| 9.* | enthalpy | 2 | H | +| 9.*** | DPT-9 | 2 | | +| 9.001 | temperature | 2 | °C | +| 9.004 | illuminance | 2 | lx | +| 9.005 | speed_ms | 2 | m/s | +| 9.007 | humidity | 2 | % | +| 9.008 | ppm | 2 | ppm | +| 9.020 | voltage | 2 | mV | +| 12.*** | DPT-12 | 4 | | +| 12.*** | 4byte_unsigned | 4 | | +| 13.*** | DPT-13 | 4 | | +| 13.*** | 4byte_signed | 4 | | +| 14.*** | DPT-14 | 4 | | +| 14.*** | 4byte_float | 4 | | +| 14.019 | electric_current | 4 | A | +| 14.027 | electric_potential | 4 | V | +| 14.031 | energy | 4 | J | +| 14.033 | frequency | 4 | Hz | +| 14.036 | heatflowrate | 4 | W | +| 14.042 | luminous_flux | 4 | lm | +| 14.054 | phaseanglerad | 4 | rad | +| 14.055 | phaseangledeg | 4 | ° | +| 14.056 | power | 4 | W | +| 14.057 | powerfactor | 4 | | +| 14.058 | pressure | 4 | Pa | +| 14.065 | speed | 4 | m/s | +| 16.000 | string | 14 | | +| 17.001 | scene_number | 1 | | ## Full example @@ -79,10 +110,11 @@ type: sensor: - platform: knx name: Heating.Valve1 - address: '2/0/0' + state_address: '2/0/0' type: 'percent' - platform: knx name: Kitchen.Temperature - address: '6/2/1' + state_address: '6/2/1' + sync_state: False type: 'temperature' ``` diff --git a/source/_components/switch.knx.markdown b/source/_components/switch.knx.markdown index 7765c7c7059..231340dfc2b 100644 --- a/source/_components/switch.knx.markdown +++ b/source/_components/switch.knx.markdown @@ -5,12 +5,16 @@ logo: knx.png ha_category: - Switch ha_release: 0.24 -ha_iot_class: Local Polling +ha_iot_class: Local Push --- -The `knx` switch integration is used as in interface to switching actuators. +
+ +The `knx` integration must be configured correctly to use this integration, see [KNX Integration](/components/knx). -The `knx` integration must be configured correctly, see [KNX Component](/components/knx). +
+ +The `knx` switch platform is used as an interface to switching actuators. ## Configuration From 66d7f4e126e80ef03597f494a6bffff873b3da7e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20RAMAGE?= Date: Tue, 6 Aug 2019 12:34:24 +0200 Subject: [PATCH 008/126] Add zigate support to zha (#9990) * Add zigate support * Update zha.markdown --- source/_components/zha.markdown | 2 ++ 1 file changed, 2 insertions(+) diff --git a/source/_components/zha.markdown b/source/_components/zha.markdown index 13e66e8c7a4..9bdd2bc7cb3 100644 --- a/source/_components/zha.markdown +++ b/source/_components/zha.markdown @@ -56,6 +56,8 @@ The custom quirks implementations for zigpy implemented as ZHA Device Handlers f - [ConBee II (a.k.a. ConBee 2) USB adapter from Dresden-Elektronik](https://shop.dresden-elektronik.de/conbee-2.html) - [ConBee USB adapter from Dresden-Elektronik](https://www.dresden-elektronik.de/conbee/) - [RaspBee Raspberry Pi Shield from Dresden-Elektronik](https://www.dresden-elektronik.de/raspbee/) +- ZiGate based radios (via the [zigpy-zigate](https://github.com/doudz/zigpy-zigate) library for zigpy) + - ZiGate USB modules (require firmware 3.1a or later) ## Configuration From 8bf6bf1874c8f43153acbbd305156fb5bfe3f150 Mon Sep 17 00:00:00 2001 From: Ross Dargan Date: Tue, 6 Aug 2019 11:35:54 +0100 Subject: [PATCH 009/126] Update how the ring platform updates it's sensors. (#9993) * add in ring switch docs * add support for light * remove the other platforms to match the smaller pr * Update ring.markdown update following p/r --- source/_components/ring.markdown | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/source/_components/ring.markdown b/source/_components/ring.markdown index 8f4a469f0e0..899ea4b6323 100644 --- a/source/_components/ring.markdown +++ b/source/_components/ring.markdown @@ -20,7 +20,7 @@ The `ring` implementation allows you to integrate your [Ring.com](https://ring.c There is currently support for the following device types within Home Assistant: - [Binary Sensor](#binary-sensor) -- [Camera](#camera) - downloading and playing Ring video will require a Ring Protect plan. +- [Camera](#camera) - [Sensor](#sensor) Currently only doorbells are supported by this sensor. @@ -49,11 +49,16 @@ password: description: The password for accessing your Ring account. required: true type: string +scan_interval: + description: How frequently to query for new video, or current sensor values in seconds + required: false + type: integer + default: 10 {% endconfiguration %} ## Binary Sensor -Once you have enabled the [Ring component](/components/ring), you can start using a binary sensor. Add the following to your `configuration.yaml` file: +Once you have enabled the [Ring integration](/components/ring), you can start using a binary sensor. Add the following to your `configuration.yaml` file: ```yaml # Example configuration.yaml entry @@ -81,7 +86,7 @@ Currently it supports doorbell, external chimes and stickup cameras. Please note that downloading and playing Ring video will require a Ring Protect plan.
-Once you have enabled the [Ring component](/components/ring), you can start using the camera platform. Add the following to your `configuration.yaml` file: +Once you have enabled the [Ring integration](/components/ring), you can start using the camera platform. Add the following to your `configuration.yaml` file: ```yaml # Example configuration.yaml entry @@ -94,11 +99,6 @@ ffmpeg_arguments: description: Extra options to pass to ffmpeg, e.g., image quality or video filter options. required: false type: string -scan_interval: - description: How frequently to query for new video in seconds. - required: false - type: integer - default: 90 {% endconfiguration %} **Note:** To be able to playback the last capture, it is required to install the `ffmpeg` component. Make sure to follow the steps mentioned at [FFMPEG](/components/ffmpeg/) documentation. @@ -155,7 +155,7 @@ hass.services.call('downloader', 'download_file', data) ## Sensor -Once you have enabled the [Ring component](/components/ring), you can start using the sensor platform. Add the following to your `configuration.yaml` file: +Once you have enabled the [Ring integration](/components/ring), you can start using the sensor platform. Add the following to your `configuration.yaml` file: ```yaml # Example configuration.yaml entry From c0ad45d1541ca96160c99446eddfa07049ada38a Mon Sep 17 00:00:00 2001 From: Robert Svensson Date: Tue, 6 Aug 2019 12:36:47 +0200 Subject: [PATCH 010/126] Configuration option to not track wired clients (#10040) --- source/_components/unifi.markdown | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/source/_components/unifi.markdown b/source/_components/unifi.markdown index f507d756ded..df7ccad1d65 100644 --- a/source/_components/unifi.markdown +++ b/source/_components/unifi.markdown @@ -73,6 +73,11 @@ dont_track_devices: type: boolean required: false default: false +dont_track_wired_clients: + description: enable to not allow device tracker to track wired clients. + type: boolean + required: false + default: false ssid_filter: description: Filter the SSIDs that tracking will occur on. type: list From 031517c05be3c484503b99ad1ccac04b236ede4d Mon Sep 17 00:00:00 2001 From: Ross Dargan Date: Tue, 6 Aug 2019 15:53:25 +0100 Subject: [PATCH 011/126] Add support for ring switch platform (#10062) * Add in support for the switch platform * :pencil2: Tweak --- source/_components/ring.markdown | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/source/_components/ring.markdown b/source/_components/ring.markdown index 899ea4b6323..343c2f4aa49 100644 --- a/source/_components/ring.markdown +++ b/source/_components/ring.markdown @@ -7,6 +7,7 @@ ha_category: - Binary Sensor - Camera - Sensor + - Switch ha_release: 0.42 ha_iot_class: Cloud Polling redirect_from: @@ -22,6 +23,7 @@ There is currently support for the following device types within Home Assistant: - [Binary Sensor](#binary-sensor) - [Camera](#camera) - [Sensor](#sensor) +- [Switch](#switch) Currently only doorbells are supported by this sensor. @@ -186,3 +188,15 @@ monitored_conditions: {% endconfiguration %} Currently it supports doorbell, external chimes and stickup cameras. + +## Switch + +Once you have enabled the [Ring integration](/components/ring), you can start using the switch platform. Add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +switch: + - platform: ring +``` + +This will add a switch for every camera that supports a siren. Note the siren will only turn on for 30 seconds before automatically turning off. From 72c95d56a57a4c80897205bf99d8360ab0ee43b5 Mon Sep 17 00:00:00 2001 From: Patrick Easters Date: Wed, 7 Aug 2019 16:09:29 -0400 Subject: [PATCH 012/126] Fix typo for Fortinet Developer Network URL (#10073) --- source/_components/fortios.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/fortios.markdown b/source/_components/fortios.markdown index 404f369cc8e..4ec9a0de4c0 100644 --- a/source/_components/fortios.markdown +++ b/source/_components/fortios.markdown @@ -31,7 +31,7 @@ host: required: true type: string token: - description: "See [Fortinet Developer Network](https://fndn.fortinet.com) for how to create an API token. Remember this integration only needs read access to a FortiGate, so configure the API user to only to have limited and read-only access." + description: "See [Fortinet Developer Network](https://fndn.fortinet.net) for how to create an API token. Remember this integration only needs read access to a FortiGate, so configure the API user to only to have limited and read-only access." required: true type: string verify_ssl: From 6969fa724887e9297618ea16b31f59300fad6005 Mon Sep 17 00:00:00 2001 From: Franck Nijhof Date: Wed, 7 Aug 2019 23:19:52 +0200 Subject: [PATCH 013/126] Deprecates sytadin integration (ADR-0004) (#10068) --- source/_components/sytadin.markdown | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/source/_components/sytadin.markdown b/source/_components/sytadin.markdown index 8333a70c646..164a64fec34 100644 --- a/source/_components/sytadin.markdown +++ b/source/_components/sytadin.markdown @@ -12,6 +12,14 @@ redirect_from: The `sytadin` sensor platform allows you to monitor traffic details from [Sytadin](http://www.sytadin.fr). +
+ +This integration is deprecated and will be removed in Home Assistant 0.100.0. + +For more information see [Architecture Decision Record: 0004](https://github.com/home-assistant/architecture/blob/master/adr/0004-webscraping.md). + +
+ ## Configuration To add Sytadin to your installation, add the following to your `configuration.yaml` file: From 4d9ba361efa4476b042da506a85dbc6d8ea0f0b9 Mon Sep 17 00:00:00 2001 From: Franck Nijhof Date: Wed, 7 Aug 2019 23:20:08 +0200 Subject: [PATCH 014/126] Deprecates fedex integration (ADR-0004) (#10070) --- source/_components/fedex.markdown | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/source/_components/fedex.markdown b/source/_components/fedex.markdown index f76314d70bb..384656d9c82 100644 --- a/source/_components/fedex.markdown +++ b/source/_components/fedex.markdown @@ -10,6 +10,14 @@ redirect_from: - /components/sensor.fedex/ --- +
+ +This integration is deprecated and will be removed in Home Assistant 0.100.0. + +For more information see [Architecture Decision Record: 0004](https://github.com/home-assistant/architecture/blob/master/adr/0004-webscraping.md). + +
+ The `fedex` platform allows one to track deliveries by [FedEx](http://www.fedex.com/). To use this sensor, you need a [FedEx Delivery Manager](https://www.fedex.com/us/delivery/) account. ## Configuration From a3dbdfb09265cd6013f2df87d7e85c35b017aab6 Mon Sep 17 00:00:00 2001 From: Franck Nijhof Date: Wed, 7 Aug 2019 23:20:35 +0200 Subject: [PATCH 015/126] Deprecates ups integration (ADR-0004) (#10071) --- source/_components/ups.markdown | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/source/_components/ups.markdown b/source/_components/ups.markdown index 441b01f6c28..9a1c385bcd6 100644 --- a/source/_components/ups.markdown +++ b/source/_components/ups.markdown @@ -10,6 +10,14 @@ redirect_from: - /components/sensor.ups/ --- +
+ +This integration is deprecated and will be removed in Home Assistant 0.100.0. + +For more information see [Architecture Decision Record: 0004](https://github.com/home-assistant/architecture/blob/master/adr/0004-webscraping.md). + +
+ The `ups` platform allows one to track deliveries by the [UPS](https://www.ups.com/). To use this sensor, you need a [My UPS Account](https://www.ups.com/mychoice). ## Configuration From 9dcf78f50684175019ab902c2c164d6fab80125f Mon Sep 17 00:00:00 2001 From: Franck Nijhof Date: Wed, 7 Aug 2019 23:21:06 +0200 Subject: [PATCH 016/126] Deprecates usps integration (ADR-0004) (#10069) --- source/_components/usps.markdown | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/source/_components/usps.markdown b/source/_components/usps.markdown index 92defd842fc..cb23482db1d 100644 --- a/source/_components/usps.markdown +++ b/source/_components/usps.markdown @@ -13,6 +13,14 @@ redirect_from: - /components/sensor.usps/ --- +
+ + This integration is deprecated and will be removed in Home Assistant 0.100.0. + + For more information see [Architecture Decision Record: 0004](https://github.com/home-assistant/architecture/blob/master/adr/0004-webscraping.md). + +
+ The `usps` platform allows one to track deliveries and inbound mail from the [US Postal Service (USPS)](https://www.usps.com/). In addition to having a USPS account, you will need to complete the "Opt-In" process for packages by clicking "Get Started Now" on [this page](https://my.usps.com/mobileWeb/pages/intro/start.action). You must also "Opt-In" to [Informed Delivery](https://informeddelivery.usps.com/box/pages/intro/start.action) to see inbound mail. From bf4cf20ba0f694ff2ad30a34c2777ac606925a25 Mon Sep 17 00:00:00 2001 From: Franck Nijhof Date: Wed, 7 Aug 2019 23:21:31 +0200 Subject: [PATCH 017/126] Deprecates srp_energy integration (ADR-0004) (#10072) --- source/_components/srp_energy.markdown | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/source/_components/srp_energy.markdown b/source/_components/srp_energy.markdown index b166efaa6e1..c204277e9aa 100644 --- a/source/_components/srp_energy.markdown +++ b/source/_components/srp_energy.markdown @@ -9,6 +9,14 @@ redirect_from: - /components/sensor.srp_energy/ --- +
+ + This integration is deprecated and will be removed in Home Assistant 0.100.0. + + For more information see [Architecture Decision Record: 0004](https://github.com/home-assistant/architecture/blob/master/adr/0004-webscraping.md). + +
+ The `srp_energy` integration shows information from Srp hourly energy usage report for their customers. The srpenergy module fetches the data found on the website. You need a Username, Password, and AccountId which you can create at [Srp](https://www.srpnet.com). From e1afd9fb029c0729b3b775bae4fc56acda8d31ce Mon Sep 17 00:00:00 2001 From: corneels <18464324+corneels@users.noreply.github.com> Date: Thu, 8 Aug 2019 17:12:36 +1000 Subject: [PATCH 018/126] Remove password requirement from documentation (#10082) With a recent change Google Passwords are no longer required. https://github.com/home-assistant/home-assistant/pull/25316 Removed reference to password requirement from documentation. --- source/_components/google_maps.markdown | 4 ---- 1 file changed, 4 deletions(-) diff --git a/source/_components/google_maps.markdown b/source/_components/google_maps.markdown index b6a7dc4d694..15ed3d36da1 100644 --- a/source/_components/google_maps.markdown +++ b/source/_components/google_maps.markdown @@ -42,10 +42,6 @@ username: description: The email address for the Google account that has access to your shared location. required: true type: string -password: - description: The password for your given username. - required: true - type: string max_gps_accuracy: description: Sometimes Google Maps can report GPS locations with a very low accuracy (few kilometers). That can trigger false zoning. Using this parameter, you can filter these false GPS reports. The number has to be in meters. For example, if you put 200 only GPS reports with an accuracy under 200 will be taken into account - Defaults to 100km if not specified. required: false From 0b0a9cee8f08a4995b47a04cf79f4f5d23b22218 Mon Sep 17 00:00:00 2001 From: Glenn Morrison Date: Thu, 8 Aug 2019 02:13:45 -0500 Subject: [PATCH 019/126] config example incorrect (#10083) changed ip_address to host as in docs below --- source/_components/apache_kafka.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/apache_kafka.markdown b/source/_components/apache_kafka.markdown index 7169c51bd3e..9442b8613df 100644 --- a/source/_components/apache_kafka.markdown +++ b/source/_components/apache_kafka.markdown @@ -18,7 +18,7 @@ To use the `apache_kafka` integration in your installation, add the following to ```yaml apache_kafka: - ip_address: localhost + host: localhost port: 9092 topic: home_assistant_1 ``` From cb9fc9873daaec04732fc9f320a146f359234c87 Mon Sep 17 00:00:00 2001 From: michaeldavie Date: Thu, 8 Aug 2019 03:21:49 -0400 Subject: [PATCH 020/126] Typo in environment_canada (#10080) --- source/_components/environment_canada.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/environment_canada.markdown b/source/_components/environment_canada.markdown index 8b07398d502..1a230d56c52 100644 --- a/source/_components/environment_canada.markdown +++ b/source/_components/environment_canada.markdown @@ -144,7 +144,7 @@ scan_interval: default: 600 {% endconfiguration %} -###Alert TTS Script +### Alert TTS Script If you would like to have alerts announced via a text-to-speech service, you can use a script similar to the following: From 922114f5bb83b10c612feabe1aede0d1d4ecbaa0 Mon Sep 17 00:00:00 2001 From: Greg <34967045+gtdiehl@users.noreply.github.com> Date: Thu, 8 Aug 2019 00:36:24 -0700 Subject: [PATCH 021/126] Update initial HA Release from 0.96 to 0.97 (#10078) Sensor Integration for the Rainforest Eagle-200 did not make it into 0.96. The initial release was 0.97. --- source/_components/rainforest_eagle.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/rainforest_eagle.markdown b/source/_components/rainforest_eagle.markdown index 99414c1e55b..d4b50ec4198 100644 --- a/source/_components/rainforest_eagle.markdown +++ b/source/_components/rainforest_eagle.markdown @@ -5,7 +5,7 @@ logo: rainforest_automation_logo.png ha_category: - Energy - Sensor -ha_release: 0.96 +ha_release: 0.97 ha_iot_class: Local Polling --- From a6a687c360e3f86776679d95afbfbcee757b1e9c Mon Sep 17 00:00:00 2001 From: bigwoof Date: Thu, 8 Aug 2019 18:05:29 +1000 Subject: [PATCH 022/126] remove password from configuration options (#10076) Update documentation to reflect the recent change in 0.97.0 release From 382b852f9aa799edc13ab262486923578e4d2f29 Mon Sep 17 00:00:00 2001 From: Andrea Donno Date: Thu, 8 Aug 2019 10:35:11 +0200 Subject: [PATCH 023/126] replace address with state_address (#10084) as per 0.97 release notes xKNX climate now uses : state_address instead of address --- source/_components/sensor.knx.markdown | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/source/_components/sensor.knx.markdown b/source/_components/sensor.knx.markdown index dbd09b75cff..bce9e43f2b3 100644 --- a/source/_components/sensor.knx.markdown +++ b/source/_components/sensor.knx.markdown @@ -21,11 +21,11 @@ To use your KNX sensor in your installation, add the following lines to your `co sensor: - platform: knx name: Heating.Valve1 - address: '2/0/0' + state_address: '2/0/0' ``` {% configuration %} -address: +state_address: description: KNX group address of the sensor. required: true type: string @@ -79,10 +79,10 @@ type: sensor: - platform: knx name: Heating.Valve1 - address: '2/0/0' + state_address: '2/0/0' type: 'percent' - platform: knx name: Kitchen.Temperature - address: '6/2/1' + state_address: '6/2/1' type: 'temperature' ``` From ff05cc5e5a3a6a4eaef3b9c1c1c2eddaeac7e974 Mon Sep 17 00:00:00 2001 From: SNoof85 Date: Thu, 8 Aug 2019 16:34:53 +0200 Subject: [PATCH 024/126] Missing web links (#10063) --- source/_components/darksky.markdown | 9 +++------ 1 file changed, 3 insertions(+), 6 deletions(-) diff --git a/source/_components/darksky.markdown b/source/_components/darksky.markdown index c7ae5bca389..3c8f07eae5a 100644 --- a/source/_components/darksky.markdown +++ b/source/_components/darksky.markdown @@ -84,9 +84,9 @@ monitored_conditions: summary: description: A human-readable text summary. icon: - description: A machine-readable text summary, suitable for selecting an icon for display. See [Dark Sky API documentation][] for the list of possible values. + description: A machine-readable text summary, suitable for selecting an icon for display. See [Dark Sky API documentation](https://darksky.net/dev/docs) for the list of possible values. precip_type: - description: The type of precipitation occurring at the given time. If `precip_intensity` is zero, then this property will be `unknown`. See [Dark Sky API documentation][] for the list of possible values. + description: The type of precipitation occurring at the given time. If `precip_intensity` is zero, then this property will be `unknown`. See [Dark Sky API documentation](https://darksky.net/dev/docs) for the list of possible values. precip_intensity: description: The intensity of precipitation occurring at the given time. This value is conditional on probability (that is, assuming any precipitation occurs at all). precip_probability: @@ -238,7 +238,4 @@ All language options are described in this table that you can use for the dark s While the platform is called "darksky" the sensors will show up in Home Assistant as "dark_sky" (eg: sensor.dark_sky_summary). -More details about the API are available in the [Dark Sky API documentation][]. - -[Dark Sky API documentation]: https://darksky.net/dev/docs - +More details about the API are available in the [Dark Sky API documentation](https://darksky.net/dev/docs). From e8a69322a883877f238866515be65e627ce0c4e1 Mon Sep 17 00:00:00 2001 From: cogneato Date: Wed, 7 Aug 2019 17:38:49 -0600 Subject: [PATCH 025/126] fix google calendar docs link google calendar docs linking to wrong page --- source/_posts/2019-08-07-release-97.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_posts/2019-08-07-release-97.markdown b/source/_posts/2019-08-07-release-97.markdown index 110ab89d05c..9c19cf6b369 100644 --- a/source/_posts/2019-08-07-release-97.markdown +++ b/source/_posts/2019-08-07-release-97.markdown @@ -95,7 +95,7 @@ Experiencing issues introduced by this release? Please report them in our [issue - **Z-Wave** - Improve handling of Z-Wave config entry vs yaml config. If a Z-Wave `network_key` is specified in configuration.yaml it will override a `network_key` specified in the Z-Wave config entry. ([@cgarwood] - [#25112]) ([zwave docs]) - **Unifi** - Unifi Device tracker is now part of config entry. After initial import the unifi device tracker configuration is no longer needed. If configuring SSID filter or detection time you will need to use the new configuration from UniFi. See UniFi component documentation for details. ([@Kane610] - [#24367]) ([unifi docs]) - **Ecobee** - Ecobee presets now represent the different Ecobee comfort settings. Selectable by name instead of unknown ID. ([@balloob] - PR link todo) -- **Calendar** - Rewrite calendar component - The calendar integration has been rewritten to follow our current standards and is mostly non breaking. The reset (clean up) of state attributes upon an event time passing has been removed, though. Attributes are no longer set to an arbitrary default value, and will now keep the attributes representing the last event. With this change, automations that rely on state attributes getting reset will need to be updated. All platforms have been converted. - ([@MartinHjelmare] - [#24950]) ([caldav docs]) ([calendar docs]) ([demo docs]) ([google docs]) ([todoist docs]) +- **Calendar** - Rewrite calendar component - The calendar integration has been rewritten to follow our current standards and is mostly non breaking. The reset (clean up) of state attributes upon an event time passing has been removed, though. Attributes are no longer set to an arbitrary default value, and will now keep the attributes representing the last event. With this change, automations that rely on state attributes getting reset will need to be updated. All platforms have been converted. - ([@MartinHjelmare] - [#24950]) ([caldav docs]) ([calendar docs]) ([demo docs]) ([google cal docs]) ([todoist docs]) - **SyncThru** - The monitored_conditions configuration option has been removed. All available monitored conditions will be used by default. Users that have been using the monitored_conditions option need to remove it from the syncthru section in configuration.yaml. ([@nielstron] - [#25052]) ([syncthru docs]) - **KNX** - Updates the knx component to use xknx 0.11.1 . This introduces several new features and bugfixes. For a complete list see: https://github.com/XKNX/xknx/releases/tag/0.11.0 ([@farmio] - [#24738]) ([knx docs]) - `scene:` `scene_number` is now 1 indexed according to KNX standards. Previously it was 0 based. Please add 1 to your already configured scene numbers (`scene_number: 5` becomes `scene_number: 6`). @@ -695,7 +695,7 @@ Experiencing issues introduced by this release? Please report them in our [issue [fortigate docs]: /components/fortigate/ [fortios docs]: /components/fortios/ [geniushub docs]: /components/geniushub/ -[google docs]: /components/google/ +[google cal docs]: /components/calendar.google/ [google_assistant docs]: /components/google_assistant/ [google_maps docs]: /components/google_maps/ [google_travel_time docs]: /components/google_travel_time/ From 8a0dff1ff281c7739553cc86ebbf4d0df29581bf Mon Sep 17 00:00:00 2001 From: mbo18 Date: Thu, 8 Aug 2019 20:28:12 +0200 Subject: [PATCH 026/126] Update example following #9957 (#10086) Update example following updater changes in Home-Assistant #25418 --- .../notify_if__new_ha_release.markdown | 40 ++++++++++--------- 1 file changed, 22 insertions(+), 18 deletions(-) diff --git a/source/_cookbook/notify_if__new_ha_release.markdown b/source/_cookbook/notify_if__new_ha_release.markdown index bf02f857a8b..771693bdd37 100644 --- a/source/_cookbook/notify_if__new_ha_release.markdown +++ b/source/_cookbook/notify_if__new_ha_release.markdown @@ -15,34 +15,38 @@ notify: recipient: recipient@jabber.org automation: - - alias: Update notifications + - alias: Update notification trigger: - platform: state - entity_id: updater.updater + entity_id: binary_sensor.updater + from: 'off' + to: 'on' action: - service: notify.jabber - data: - message: 'There is a new Home Assistant release available.' + - service: notify.jabber + data: + message: 'There is a new Home Assistant release available.' ``` You can use [templates](/topics/templating/) to include the release number of Home Assistant if you prefer. The following example sends a notification via [Pushbullet](/components/notify.pushbullet/) with the Home Assistant version in the message. ```yaml notify: - platform: pushbullet - api_key: 'YOUR_KEY_HERE' - name: pushbullet + - platform: pushbullet + api_key: 'YOUR_KEY_HERE' + name: pushbullet automation: - - alias: Update notifications - trigger: - - platform: state - entity_id: updater.updater - action: - service: notify.pushbullet - data_template: - title: 'New Home Assistant Release' - target: 'YOUR_TARGET_HERE' #See Pushbullet integration for usage - message: "Home Assistant {% raw %} {{ states('updater.updater') }} {% endraw %} is now available." + - alias: Update notification + trigger: + - platform: state + entity_id: binary_sensor.updater + from: 'off' + to: 'on' + action: + - service: notify.pushbullet + data_template: + title: 'New Home Assistant Release' + target: 'YOUR_TARGET_HERE' #See Pushbullet integration for usage + message: "Home Assistant {% raw %} {{ state_attr('binary_sensor.updater', 'newest_version') }} {% endraw %} is now available." ``` From a904b18d8776c7a4fe3d04d9f770050312d6d2ae Mon Sep 17 00:00:00 2001 From: Ross Dargan Date: Thu, 8 Aug 2019 19:28:59 +0100 Subject: [PATCH 027/126] Add in light support (#10064) --- source/_components/ring.markdown | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/source/_components/ring.markdown b/source/_components/ring.markdown index 343c2f4aa49..03d096030d8 100644 --- a/source/_components/ring.markdown +++ b/source/_components/ring.markdown @@ -8,6 +8,7 @@ ha_category: - Camera - Sensor - Switch + - Light ha_release: 0.42 ha_iot_class: Cloud Polling redirect_from: @@ -200,3 +201,15 @@ switch: ``` This will add a switch for every camera that supports a siren. Note the siren will only turn on for 30 seconds before automatically turning off. + +## Light + +Once you have enabled the [Ring integration](/components/ring), you can start using the light platform. Add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +light: + - platform: ring +``` + +This will add a light for every camera that supports a light (such as a flood light). From 429995413cfc1d0de55a72668d401087cc2e80a4 Mon Sep 17 00:00:00 2001 From: Robert Dunmire III Date: Thu, 8 Aug 2019 14:30:09 -0400 Subject: [PATCH 028/126] Add Mikrotik hub category and update example config (#10044) * Updating for Mikrotik Hub * Add hub category and example config --- source/_components/mikrotik.markdown | 35 +++++++++++++++++++++------- 1 file changed, 26 insertions(+), 9 deletions(-) diff --git a/source/_components/mikrotik.markdown b/source/_components/mikrotik.markdown index 1ab056dc995..fdb23f8e7c9 100644 --- a/source/_components/mikrotik.markdown +++ b/source/_components/mikrotik.markdown @@ -3,6 +3,7 @@ title: "MikroTik" description: "Instructions on how to integrate MikroTik/RouterOS based devices into Home Assistant." logo: mikrotik.png ha_category: + - Hub - Presence Detection ha_release: 0.44 redirect_from: @@ -11,7 +12,11 @@ redirect_from: The `mikrotik` platform offers presence detection by looking at connected devices to a [MikroTik RouterOS](http://mikrotik.com) based router. -## Configuring `mikrotik` device tracker +There is currently support for the following device types within Home Assistant: + +- Presence Detection + +## Configuring `mikrotik` hub You have to enable accessing the RouterOS API on your router to use this platform. @@ -33,9 +38,8 @@ To use a MikroTik router in your installation, add the following to your `config ```yaml # Example configuration.yaml entry -device_tracker: - - platform: mikrotik - host: IP_ADDRESS +mikrotik: + - host: IP_ADDRESS username: ROUTEROS_USERNAME password: ROUTEROS_PASSWORD ``` @@ -70,9 +74,14 @@ ssl: default: false type: boolean method: - description: Override autodetection of device scanning method. Can be `wireless` to use local wireless registration, `capsman` for capsman wireless registration, or `ip` for DHCP leases. + description: Override autodetection of device scanning method. Can be `wireless` to use local wireless registration, `capsman` for capsman wireless registration, or `dhcp` for DHCP leases. required: false type: string +arp_ping: + description: Use ARP ping with DHCP method for device scanning. + required: false + default: false + type: boolean {% endconfiguration %}
@@ -113,17 +122,25 @@ To use this device tracker you need restricted privileges only. To enhance the s /user set password="YOUR_PASSWORD" homeassistant ``` -## Using the additional configuration to the `mikrotik` device tracker entry in your `configuration.yaml` file: +## Using the additional configuration to the `mikrotik` entry in your `configuration.yaml` file: ```yaml -device_tracker: - - platform: mikrotik - host: 192.168.88.1 +mikrotik: + - host: 192.168.88.1 + username: homeassistant + password: YOUR_PASSWORD + ssl: true + arp_ping: true + method: dhcp + track_devices: true + + - host: 192.168.88.2 username: homeassistant password: YOUR_PASSWORD ssl: true port: 8729 method: capsman + track_devices: true ``` See the [device tracker integration page](/components/device_tracker/) for instructions on how to configure the people to be tracked. From fefb36c058453b1e881228e1f500eadce4c5a595 Mon Sep 17 00:00:00 2001 From: Santobert Date: Thu, 8 Aug 2019 20:33:10 +0200 Subject: [PATCH 029/126] replace operating_mode with hvac_mode (#10075) --- source/_components/zwave.markdown | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/source/_components/zwave.markdown b/source/_components/zwave.markdown index 106a95d6c20..fd69e0c8045 100644 --- a/source/_components/zwave.markdown +++ b/source/_components/zwave.markdown @@ -83,10 +83,10 @@ automation: - platform: time at: "20:00:00" action: - - service: climate.set_operation_mode + - service: climate.set_hvac_mode data: entity_id: climate.remotec_zxt120_heating_1_id - operation_mode: Heat + hvac_mode: Heat - service: climate.set_temperature data: entity_id: climate.remotec_zxt120_heating_1_39 @@ -102,10 +102,10 @@ automation: - platform: time at: "21:00:00" action: - - service: climate.set_operation_mode + - service: climate.set_hvac_mode data: entity_id: climate.remotec_zxt120_heating_1_id - operation_mode: 'Off' + hvac_mode: 'Off' ``` **Note:** In the example above, the word `Off` is encased in single quotes to be valid YAML. @@ -117,7 +117,7 @@ A simple way to test if your Z-Wave climate device is working is to use Date: Thu, 8 Aug 2019 11:34:29 -0700 Subject: [PATCH 030/126] Scene support for Zooz Z-Wave Switches (#10067) Added instructions on how to update the switch and openzwave config file to add scene support for Zooz Zen26 & Zen27 switches. --- source/_docs/z-wave/device-specific.markdown | 155 +++++++++++++++++++ 1 file changed, 155 insertions(+) diff --git a/source/_docs/z-wave/device-specific.markdown b/source/_docs/z-wave/device-specific.markdown index 59b9ff49900..6ed30e45d2c 100644 --- a/source/_docs/z-wave/device-specific.markdown +++ b/source/_docs/z-wave/device-specific.markdown @@ -191,6 +191,161 @@ Triple tap on|2|4 5x tap off|1|6 5x tap on|2|6 +### Zooz Scene Capable On/Off and Dimmer Wall Switches (Zen26 & Zen27 - Firmware 2.0+) + +Many Zooz Zen26/27 switches that have been sold do not have firmware 2.0+. Contact Zooz to obtain the over the air firmware update instructions and new user manual for the switches. + +Once the firmware is updated, the the new configuration paramters will have to be added to the `zwcfg` file. Replace the existing `COMMAND_CLASS_CONFIGURATION` with the one of the following options (depending on your model of switch): + +Zen26 (On/Off Switch): +```xml + + + + Normal mode: Upper paddle turns the light on, lower paddle turns the light off. Reverse will reverse those functions. Any will toggle the light regardless of which button is pushed. + + + + + + LED Indication light function. Normal has the LED Indication on when the switch is off, off when the switch is on. + + + + + + + Enable or disable the auto turn-off timer function. + + + + + Time, in seconds, for auto-off timer delay. 60 (default). + + + Enable or disable the auto turn-on timer function. + + + + + Time, in minutes, for auto-on timer delay. 60 (default). + + + Status after power on after power failure. OFF will always turn light off. ON will always turn light on. Restore will remember the latest state and restore that state. + + + + + + Enable or disable scene control functionality for quick double tap triggers. + + + + + Enable or disable local on/off control. If enabled, you'll only be able to control the connected light via Z-Wave. + + + + +``` + +Zen27 (Dimmer): +```xml + + + + Normal mode: Upper paddle turns the light on, lower paddle turns the light off. Reverse will reverse those functions. Any will toggle the light regardless of which button is pushed. + + + + + + LED Indication light function. Normal has the LED Indication on when the switch is off, off when the switch is on. + + + + + + + + + + + Time, in minutes, for auto-off timer delay. + + + + + + + Time, in minutes, for auto-off timer delay. + + + Status after power on after power failure. OFF will always turn light off. ON will always turn light on. Restore will remember the latest state and restore that state. + + + + + + Adjust the ramp rate for your dimmer (fade-in / fade-out effect for on / off operation). Values correspond to the number of seconds it take for the dimmer to reach full brightness or turn off when operated manually. + + + Set the minimum brightness level for your dimmer. You won't be able to dim the light below the set value. + + + Set the maximum brightness level for your dimmer. You won't be able to add brightness to the light beyond the set value. Note: if Parameter 12 is set to value "Full", Parameter 11 is automatically disabled. + + + Double Tap action. When set to Full, turns light on to 100%. If set to Maximum Level, turns light on to % set in Parameter 11. + + + + + Enable or disable scene control functionality for quick double tap triggers. + + + + + Enable the double tap or disable the double tap function and assign brightness level to single tap. + + + + + + Enable or disable local on/off control. If enabled, light will only be able to be controlled via Z-Wave. + + + + +``` + +For Zooz switches, you'll need to update (or possibly add) the `COMMAND_CLASS_CENTRAL_SCENE` for each node in your `zwcfg` file with the following: +```xml + + + + + + +``` + +Go to the Z-Wave Network Management section in the Home Assistant Configuration, select the node which has just been updated and enable the scene support configuration paramter. + +Once this is complete, you should see the following `zwave.scene_activated` events: + +**Action**|**scene\_id**|**scene\_data** +:-----:|:-----:|:-----: +Single tap off|1|7680 +Single tap on|2|7680 +Double tap off|1|7860 +Double tap on|2|7860 +Triple tap off|1|7920 +Triple tap on|2|7920 +4x tap off|1|7980 +4x tap on|2|7980 +5x tap off|1|8040 +5x tap on|2|8040 + ### HomeSeer Switches For the HomeSeer devices specifically, you may need to update the `COMMAND_CLASS_CENTRAL_SCENE` for each node in your `zwcfg` file with the following: From 3b597bb3bd523f2e0f856b3f24ee49abe5ce789a Mon Sep 17 00:00:00 2001 From: Matthias Alphart Date: Tue, 6 Aug 2019 12:33:24 +0200 Subject: [PATCH 031/126] KNX component updates for xknx 0.11 (#9682) * xknx 0.11 * update for xknx 0.11.1 - state_address instead of address - sync_state option * :pencil2: Tweak - Please check if this config variable `device_class` belongs here. For now it breaks netlify with building. * copy and past error -.- * even more typos * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweaks * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweaks * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweak * :pencil2: Tweak --- source/_components/binary_sensor.knx.markdown | 21 +++- source/_components/climate.knx.markdown | 42 ++++--- source/_components/cover.knx.markdown | 9 +- source/_components/knx.markdown | 29 +++-- source/_components/light.knx.markdown | 18 ++- source/_components/notify.knx.markdown | 8 +- source/_components/scene.knx.markdown | 12 +- source/_components/sensor.knx.markdown | 106 ++++++++++++------ source/_components/switch.knx.markdown | 10 +- 9 files changed, 172 insertions(+), 83 deletions(-) diff --git a/source/_components/binary_sensor.knx.markdown b/source/_components/binary_sensor.knx.markdown index 34148af2a5a..2af616f8fd4 100644 --- a/source/_components/binary_sensor.knx.markdown +++ b/source/_components/binary_sensor.knx.markdown @@ -5,11 +5,19 @@ logo: knx.png ha_category: - Binary Sensor ha_release: 0.24 -ha_iot_class: Local Polling +ha_iot_class: Local Push --- +
+ +The `knx` integration must be configured correctly to use this integration, see [KNX Integration](/components/knx). + +
+ The `knx` sensor platform allows you to monitor [KNX](http://www.knx.org) binary sensors. +Binary sensors are read-only. To write to the knx-bus configure an exposure [KNX Integration - Expose](/components/knx/#exposing-sensor-values-or-time-to-knx-bus). + ## Configuration The `knx` integration must be configured correctly, see [KNX Integration](/components/knx). @@ -18,11 +26,11 @@ The `knx` integration must be configured correctly, see [KNX Integration](/compo # Example configuration.yaml entry binary_sensor: - platform: knx - address: '6/0/2' + state_address: '6/0/2' ``` {% configuration %} -address: +state_address: description: KNX group address of the binary sensor. required: true type: string @@ -30,6 +38,11 @@ name: description: A name for this device used within Home Assistant. required: false type: string +sync_state: + description: Actively read the value from the bus. If `False` no GroupValueRead telegrams will be sent to the bus. + required: false + type: boolean + default: True device_class: description: Sets the [class of the device](/components/binary_sensor/), changing the device state and icon that is displayed on the frontend. required: false @@ -54,7 +67,7 @@ You can also attach actions to binary sensors (e.g., to switch on a light when a binary_sensor: - platform: knx name: Livingroom.3Switch3 - address: '5/0/26' + state_address: '5/0/26' automation: - counter: 1 hook: 'on' diff --git a/source/_components/climate.knx.markdown b/source/_components/climate.knx.markdown index 9abcffc5443..a0d63bac21b 100644 --- a/source/_components/climate.knx.markdown +++ b/source/_components/climate.knx.markdown @@ -5,12 +5,16 @@ logo: knx.png ha_category: - Climate ha_release: 0.25 -ha_iot_class: Local Polling +ha_iot_class: Local Push --- -The `knx` climate platform is used as in interface with KNX thermostats. +
+ +The `knx` integration must be configured correctly to use this integration, see [KNX Integration](/components/knx). -The `knx` integration must be configured correctly, see [KNX Integration](/components/knx). +
+ +The `knx` climate platform is used as an interface to KNX thermostats and room controllers. To use your KNX thermostats in your installation, add the following lines to your `configuration.yaml` file: @@ -24,6 +28,7 @@ climate: setpoint_shift_state_address: '5/1/3' target_temperature_state_address: '5/1/4' operation_mode_address: '5/1/5' + operation_mode_state_address: '5/1/6' ``` Alternatively, if your device has dedicated binary group addresses for frost/night/comfort mode: @@ -40,10 +45,11 @@ climate: operation_mode_frost_protection_address: '5/1/5' operation_mode_night_address: '5/1/6' operation_mode_comfort_address: '5/1/7' + operation_mode_state_address: '5/1/8' ``` If your device doesn't support setpoint_shift calculations (i.e. if you don't provide a `setpoint_shift_address` value) please set the `min_temp` and `max_temp` -attributes of the climate device to avoid issues with increasing the temperature in the frontend. Please do also make sure to add the `target_temperature_address` +attributes of the climate device to avoid issues with exceeding valid temperature values in the frontend. Please do also make sure to add the `target_temperature_address` to the config in this case.: ```yaml @@ -57,11 +63,13 @@ climate: operation_mode_frost_protection_address: '5/1/5' operation_mode_night_address: '5/1/6' operation_mode_comfort_address: '5/1/7' + operation_mode_state_address: '5/1/8' min_temp: 7.0 max_temp: 32.0 ``` `operation_mode_frost_protection_address` / `operation_mode_night_address` / `operation_mode_comfort_address` are not necessary if `operation_mode_address` is specified. +If the actor doesn't support explicit state communication objects the *_state_address can be configured with the same group address as the writeable *_address. The Read-Flag for the *_state_address communication object has to be set in ETS to support initial reading eg. when starting home-assistant. The following values are valid for the `hvac_mode` attribute: @@ -86,27 +94,27 @@ name: default: KNX Climate type: string temperature_address: - description: KNX group address for reading current room temperature from KNX bus. + description: KNX group address for reading current room temperature from KNX bus. *DPT 9.001* required: true type: string target_temperature_address: - description: KNX group address for setting target temperature. + description: KNX group address for setting target temperature. *DPT 9.001* required: false type: string target_temperature_state_address: - description: KNX group address for reading current target temperature from KNX bus. + description: KNX group address for reading current target temperature from KNX bus. *DPT 9.001* required: true type: string setpoint_shift_address: - description: KNX address for setpoint_shift. + description: KNX address for setpoint_shift. *DPT 6.010* required: false type: string setpoint_shift_state_address: - description: Explicit KNX address for reading setpoint_shift. + description: KNX address for reading setpoint_shift. *DPT 6.010* required: false type: string setpoint_shift_step: - description: Defines for step size in Kelvin for each step of setpoint_shift. + description: Defines the step size in Kelvin for each step of setpoint_shift. required: false default: 0.5 type: float @@ -114,18 +122,18 @@ setpoint_shift_min: description: Minimum value of setpoint shift. required: false default: -6 - type: integer + type: float setpoint_shift_max: description: Maximum value of setpoint shift. required: false default: 6 - type: integer + type: float operation_mode_address: - description: KNX address for operation mode (Frost protection/night/comfort). + description: KNX address for setting operation mode (Frost protection/night/comfort). *DPT 20.102* required: false type: string operation_mode_state_address: - description: Explicit KNX address for reading operation mode. + description: KNX address for reading operation mode. *DPT 20.102* required: false type: string controller_status_address: @@ -133,15 +141,15 @@ controller_status_address: required: false type: string controller_status_state_address: - description: Explicit KNX address for reading HVAC controller status. + description: KNX address for reading HVAC controller status. required: false type: string controller_mode_address: - description: KNX address for handling controller modes. + description: KNX address for setting HVAC controller modes. *DPT 20.105* required: false type: string controller_mode_state_address: - description: Explicit KNX address for reading HVAC Control Mode. + description: KNX address for reading HVAC Control Mode. *DPT 20.105* required: false type: string operation_mode_frost_protection_address: diff --git a/source/_components/cover.knx.markdown b/source/_components/cover.knx.markdown index e8f48ef6ca7..ff25c2eef65 100644 --- a/source/_components/cover.knx.markdown +++ b/source/_components/cover.knx.markdown @@ -5,13 +5,16 @@ logo: knx.png ha_category: - Cover ha_release: 0.48 -ha_iot_class: Local Polling +ha_iot_class: Local Push --- +
-The `knx` cover platform is used as in interface with KNX covers. +The `knx` integration must be configured correctly to use this integration, see [KNX Integration](/components/knx). -The `knx` integration must be configured correctly, see [KNX Integration](/components/knx). +
+ +The `knx` cover platform is used as an interface to KNX covers. To use your KNX covers in your installation, add the following to your `configuration.yaml` file: diff --git a/source/_components/knx.markdown b/source/_components/knx.markdown index 0cbabc45cfe..68cc868899d 100644 --- a/source/_components/knx.markdown +++ b/source/_components/knx.markdown @@ -5,17 +5,15 @@ logo: knx.png ha_category: - Hub ha_release: 0.24 -ha_iot_class: Local Polling +ha_iot_class: Local Push --- The [KNX](https://www.knx.org) integration for Home Assistant allows you to connect to a KNX/IP devices. -The integration requires a local KNX/IP interface like the [Weinzierl 730](https://www.weinzierl.de/index.php/en/all-knx/knx-devices-en/produktarchiv-en/knx-ip-interface-730-en). Through this, it will send and receive commands to and from other devices to the KNX bus. - -
- - Please note, the `knx` platform does not support Windows. +The integration requires a local KNX/IP interface or a KNX/IP router. Through this, it will send and receive commands to and from other devices to the KNX bus. +
+Please note, the `knx` platform does not support Windows.
There is currently support for the following device types within Home Assistant: @@ -69,19 +67,21 @@ knx: host: description: Host of the KNX/IP tunneling device. type: string + required: true port: description: Port of the KNX/IP tunneling device. type: integer + required: false local_ip: description: IP of the local interface. type: string + required: false {% endconfiguration %} Explicit connection to a KNX/IP routing device: ```yaml knx: - config_file: '/path/to/xknx.yaml' routing: local_ip: '192.168.2.109' ``` @@ -90,6 +90,7 @@ knx: local_ip: description: The local IP address of interface (which should be used for multicasting). type: string + required: true {% endconfiguration %} ```yaml @@ -117,7 +118,7 @@ state_updater: ### Services -In order to directly interact with the KNX bus, you can now use the following service: +In order to directly interact with the KNX bus, you can use the following service: ``` Domain: knx @@ -145,6 +146,12 @@ knx: - type: 'temperature' entity_id: 'sensor.owm_temperature' address: '0/0/2' + - type: 'string' + address: '0/6/4' + entity_id: "sensor.owm_weather" + - type: 'binary' + entity_id: 'binary_sensor.kitchen_window' + address: '0/6/5' - type: 'time' address: '0/0/1' - type: 'datetime' @@ -153,12 +160,14 @@ knx: {% configuration %} type: - description: Type of the exposed value. Either time or datetime or any supported type of [KNX Sensor](/components/sensor.knx/) (e.g., "temperature" or "humidity"). + description: Type of the exposed value. Either 'binary', 'time', 'date', 'datetime' or any supported type of [KNX Sensor](/components/sensor.knx/) (e.g., "temperature" or "humidity"). type: string + required: true entity_id: - description: Entity id of the HASS integration to be exposed. Not necessary for types time and datetime. + description: Entity id to be exposed. Not needed for types time, date and datetime. type: string address: description: KNX group address. type: string + required: true {% endconfiguration %} diff --git a/source/_components/light.knx.markdown b/source/_components/light.knx.markdown index 04372579312..f97ee085522 100644 --- a/source/_components/light.knx.markdown +++ b/source/_components/light.knx.markdown @@ -5,9 +5,15 @@ logo: knx.png ha_category: - Light ha_release: 0.44 -ha_iot_class: Local Polling +ha_iot_class: Local Push --- +
+ +The `knx` integration must be configured correctly to use this integration, see [KNX Integration](/components/knx). + +
+ The `knx light` integration is used as an interface to control knx actuators for lighting applications such as: - switching actuators @@ -15,8 +21,6 @@ The `knx light` integration is used as an interface to control knx actuators for - LED controllers - DALI gateways -The `knx` integration must be configured correctly to use this component, see [KNX Component](/components/knx). - ## Configuration To use your KNX light in your installation, add the following lines to your `configuration.yaml` file: @@ -57,6 +61,14 @@ color_state_address: description: KNX group address for retrieving the RGB color of the light. *DPT 232.600* required: false type: string +rgbw_address: + description: KNX group address for setting the RGBW color of the light. *DPT 251.600* + required: false + type: string +rgbw_state_address: + description: KNX group address for retrieving the RGBW color of the light. *DPT 251.600* + required: false + type: string color_temperature_address: description: KNX group address for setting the color temperature of the light. *DPT 5.001 or 7.600 based on color_temperature_mode* required: false diff --git a/source/_components/notify.knx.markdown b/source/_components/notify.knx.markdown index 2f3572ba211..e01f5a874a5 100644 --- a/source/_components/notify.knx.markdown +++ b/source/_components/notify.knx.markdown @@ -8,9 +8,13 @@ ha_release: 0.53 ha_iot_class: Local Push --- -The `knx` notify platform allows you to send notifications to [KNX](http://www.knx.org) devices. +
+ +The `knx` integration must be configured correctly to use this integration, see [KNX Integration](/components/knx). -The `knx` integration must be configured correctly, see [KNX Component](/components/knx). +
+ +The `knx` notify platform allows you to send notifications to [KNX](http://www.knx.org) devices. ## Configuration diff --git a/source/_components/scene.knx.markdown b/source/_components/scene.knx.markdown index 0ee4c644c9b..6a05b862f57 100644 --- a/source/_components/scene.knx.markdown +++ b/source/_components/scene.knx.markdown @@ -7,9 +7,13 @@ ha_category: ha_release: 0.63 --- -The `knx` scenes platform allows you to trigger [KNX](http://www.knx.org) scenes. +
+ +The `knx` integration must be configured correctly to use this integration, see [KNX Integration](/components/knx). -The `knx` integration must be configured correctly, see [KNX Component](/components/knx). +
+ +The `knx` scenes platform allows you to trigger [KNX](http://www.knx.org) scenes. ## Configuration @@ -26,11 +30,11 @@ scene: {% configuration %} address: - description: KNX group address of the binary sensor. + description: KNX group address for the scene. required: true type: string scene_number: - description: Zero-indexed KNX scene number to be activated. + description: KNX scene number to be activated. ( 1 ... 64 ) required: true type: integer name: diff --git a/source/_components/sensor.knx.markdown b/source/_components/sensor.knx.markdown index bce9e43f2b3..2432e35c78c 100644 --- a/source/_components/sensor.knx.markdown +++ b/source/_components/sensor.knx.markdown @@ -1,6 +1,6 @@ --- title: "KNX Sensor" -description: "Instructions on how to use the KNX Sensor with Home Assistant." +description: "Instructions on how to use a KNX Sensor with Home Assistant." logo: knx.png ha_category: - Sensor @@ -8,9 +8,16 @@ ha_release: 0.29 ha_iot_class: Local Push --- -The `knx` sensor platform allows you to monitor [KNX](http://www.knx.org) sensors. +
+ +The `knx` integration must be configured correctly to use this integration, see [KNX Integration](/components/knx). + +
+ +The `knx` sensor platform allows you to monitor [KNX](http://www.knx.org) sensors. + +Sensors are read-only. To write to the knx-bus configure an exposure [KNX Integration - Expose](/components/knx/#exposing-sensor-values-or-time-to-knx-bus). -The `knx` integration must be configured correctly, see [KNX Component](/components/knx). ## Configuration @@ -33,44 +40,68 @@ name: description: A name for this device used within Home Assistant. required: false type: string -type: - description: A type from the following table can be defined. The DPT of the group address should match the expected KNX DPT to be parsed correctly. +sync_state: + description: Actively read the value from the bus. If `False` no GroupValueRead telegrams will be sent to the bus. required: false + type: boolean + default: True +type: + description: A type from the following table must be defined. The DPT of the group address should match the expected KNX DPT to be parsed correctly. + required: true type: string {% endconfiguration %} -| type | unit | expected KNX DPT | -|--------------------|------|------------------| -| percent | % | 5.001 | -| pulse | | 5.010 | -| temperature | °C | 9.001 | -| humidity | % | 9.007 | -| illuminance | lx | 9.004 | -| brightness | lx | 7.013 | -| speed_ms | m/s | 9.005 | -| current | mA | 7.012 | -| voltage | mV | 9.020 | -| power | W | 14.056 | -| electric_current | A | 14.019 | -| electric_potential | V | 14.027 | -| energy | J | 14.031 | -| frequency | Hz | 14.033 | -| heatflowrate | W | 14.036 | -| phaseanglerad | rad | 14.054 | -| phaseangledeg | ° | 14.055 | -| powerfactor | | 14.057 | -| speed | m/s | 14.065 | -| enthalpy | H | 9.* | -| ppm | ppm | 9.008 | -| DPT-7 | | 7.* | -| 2byte_unsigned | | 7.* | -| DPT-9 | | 9.* | -| DPT-12 | | 12.* | -| 4byte_unsigned | | 12.* | -| DPT-13 | | 13.* | -| 4byte_signed | | 13.* | -| DPT-14 | | 14.* | -| 4byte_float | | 14.* | +| KNX DPT | type | size in byte | unit | +|--------:|--------------------|-------------:|----------------| +| 5.001 | percent | 1 | % | +| 5.003 | angle | 1 | ° | +| 5.004 | percentU8 | 1 | % | +| 5.010 | pulse | 1 | | +| 5.010 | DPT-5 | 1 | | +| 5.010 | 1byte_unsigned | 1 | | +| 6.001 | percentV8 | 1 | % | +| 6.010 | counter_pulses | 1 | counter pulses | +| 7.*** | DPT-7 | 2 | | +| 7.001 | 2byte_unsigned | 2 | pulses | +| 7.012 | current | 2 | mA | +| 7.013 | brightness | 2 | lx | +| 7.600 | color_temperature | 2 | K | +| 8.*** | DPT-8 | 2 | | +| 8.001 | 2byte_signed | 2 | pulses | +| 8.002 | delta_time_ms | 2 | ms | +| 8.005 | delta_time_sec | 2 | s | +| 8.006 | delta_time_min | 2 | min | +| 8.007 | delta_time_hrs | 2 | h | +| 8.010 | percentV16 | 2 | % | +| 8.011 | rotation_angle | 2 | ° | +| 9.* | enthalpy | 2 | H | +| 9.*** | DPT-9 | 2 | | +| 9.001 | temperature | 2 | °C | +| 9.004 | illuminance | 2 | lx | +| 9.005 | speed_ms | 2 | m/s | +| 9.007 | humidity | 2 | % | +| 9.008 | ppm | 2 | ppm | +| 9.020 | voltage | 2 | mV | +| 12.*** | DPT-12 | 4 | | +| 12.*** | 4byte_unsigned | 4 | | +| 13.*** | DPT-13 | 4 | | +| 13.*** | 4byte_signed | 4 | | +| 14.*** | DPT-14 | 4 | | +| 14.*** | 4byte_float | 4 | | +| 14.019 | electric_current | 4 | A | +| 14.027 | electric_potential | 4 | V | +| 14.031 | energy | 4 | J | +| 14.033 | frequency | 4 | Hz | +| 14.036 | heatflowrate | 4 | W | +| 14.042 | luminous_flux | 4 | lm | +| 14.054 | phaseanglerad | 4 | rad | +| 14.055 | phaseangledeg | 4 | ° | +| 14.056 | power | 4 | W | +| 14.057 | powerfactor | 4 | | +| 14.058 | pressure | 4 | Pa | +| 14.065 | speed | 4 | m/s | +| 16.000 | string | 14 | | +| 17.001 | scene_number | 1 | | ## Full example @@ -84,5 +115,6 @@ sensor: - platform: knx name: Kitchen.Temperature state_address: '6/2/1' + sync_state: False type: 'temperature' ``` diff --git a/source/_components/switch.knx.markdown b/source/_components/switch.knx.markdown index 7765c7c7059..231340dfc2b 100644 --- a/source/_components/switch.knx.markdown +++ b/source/_components/switch.knx.markdown @@ -5,12 +5,16 @@ logo: knx.png ha_category: - Switch ha_release: 0.24 -ha_iot_class: Local Polling +ha_iot_class: Local Push --- -The `knx` switch integration is used as in interface to switching actuators. +
+ +The `knx` integration must be configured correctly to use this integration, see [KNX Integration](/components/knx). -The `knx` integration must be configured correctly, see [KNX Component](/components/knx). +
+ +The `knx` switch platform is used as an interface to switching actuators. ## Configuration From 0b9fb8ed3363c6f50410bff5f418d13b258ef19c Mon Sep 17 00:00:00 2001 From: Pascal Vizeli Date: Fri, 9 Aug 2019 08:54:45 +0200 Subject: [PATCH 032/126] Update docker.markdown --- source/_docs/installation/docker.markdown | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/source/_docs/installation/docker.markdown b/source/_docs/installation/docker.markdown index 392e5bf5523..5fd8131f0cc 100644 --- a/source/_docs/installation/docker.markdown +++ b/source/_docs/installation/docker.markdown @@ -11,19 +11,19 @@ Installation with Docker is straightforward. Adjust the following command so tha ### Linux ```bash -$ docker run --init -d --name="home-assistant" -v /PATH_TO_YOUR_CONFIG:/config -v /etc/localtime:/etc/localtime:ro --net=host homeassistant/home-assistant +$ docker run --init -d --name="home-assistant" -e "TZ=America/New_York" -v /PATH_TO_YOUR_CONFIG:/config --net=host homeassistant/home-assistant ``` ### Raspberry Pi 3 (Raspbian) ```bash -$ docker run --init -d --name="home-assistant" -v /PATH_TO_YOUR_CONFIG:/config -v /etc/localtime:/etc/localtime:ro --net=host homeassistant/raspberrypi3-homeassistant +$ docker run --init -d --name="home-assistant" -e "TZ=America/New_York" -v /PATH_TO_YOUR_CONFIG:/config --net=host homeassistant/raspberrypi3-homeassistant ``` You need to replace `/PATH_TO_YOUR_CONFIG` with your path to the configuration, for example if you choose your configuration path to be `/home/pi/homeassistant`, then command would be: ```bash -$ docker run --init -d --name="home-assistant" -v /home/pi/homeassistant:/config -v /etc/localtime:/etc/localtime:ro --net=host homeassistant/raspberrypi3-homeassistant +$ docker run --init -d --name="home-assistant" -e "TZ=America/New_York" -v /home/pi/homeassistant:/config --net=host homeassistant/raspberrypi3-homeassistant ``` ### macOS @@ -33,7 +33,7 @@ When using `docker-ce` (or `boot2docker`) on macOS, you are unable to map the lo If you wish to browse directly to `http://localhost:8123` from your macOS host, meaning forward ports directly to the container, replace the `--net=host` switch with `-p 8123:8123`. More detail can be found in [the docker forums](https://forums.docker.com/t/should-docker-run-net-host-work/14215/10). ```bash -$ docker run --init -d --name="home-assistant" -v /PATH_TO_YOUR_CONFIG:/config -e "TZ=America/Los_Angeles" -p 8123:8123 homeassistant/home-assistant +$ docker run --init -d --name="home-assistant" -e "TZ=America/Los_Angeles" -v /PATH_TO_YOUR_CONFIG:/config -p 8123:8123 homeassistant/home-assistant ``` Alternatively, `docker-compose` works with any recent release of `docker-ce` on macOS. Note that (further down this page) we provide an example `docker-compose.yml` however it differs from the `docker run` example above. To make the .yml directives match, you would need to make _two_ changes: first add the equivalent `ports:` directive, then _remove_ the `network_mode: host` section. This is because `Port mapping is incompatible with network_mode: host:`. More details can be found at [Docker networking docs](https://docs.docker.com/engine/userguide/networking/#default-networks). Note also the `/dev/tty*` device name used by your Arduino etc. devices will differ from the Linux example, so the compose `mount:` may require updates. @@ -41,7 +41,7 @@ Alternatively, `docker-compose` works with any recent release of `docker-ce` on ### Windows ```powershell -$ docker run --init -d --name="home-assistant" -v /PATH_TO_YOUR_CONFIG:/config -e "TZ=America/Los_Angeles" --net=host homeassistant/home-assistant +$ docker run --init -d --name="home-assistant" -e "TZ=America/Los_Angeles" -v /PATH_TO_YOUR_CONFIG:/config --net=host homeassistant/home-assistant ``` When running Home Assistant in Docker on Windows, you may have some difficulty getting ports to map for routing (since the `--net=host` switch actually applies to the hypervisor's network interface). To get around this, you will need to add port proxy ipv4 rules to your local Windows machine, like so (Replacing '192.168.1.10' with whatever your Windows IP is, and '10.0.50.2' with whatever your Docker container's IP is): @@ -239,6 +239,8 @@ or in a `docker-compose.yml` file: - /dev/ttyUSB0:/dev/ttyUSB0 - /dev/ttyUSB1:/dev/ttyUSB1 - /dev/ttyACM0:/dev/ttyACM0 + environment: + - TZ=America/New_York restart: always network_mode: host ``` From a962ed8925ee6560e9ca48ee49332eab582acee4 Mon Sep 17 00:00:00 2001 From: Pascal Vizeli Date: Fri, 9 Aug 2019 08:56:12 +0200 Subject: [PATCH 033/126] Update docker.markdown --- source/_docs/installation/docker.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_docs/installation/docker.markdown b/source/_docs/installation/docker.markdown index 5fd8131f0cc..3bb1195486f 100644 --- a/source/_docs/installation/docker.markdown +++ b/source/_docs/installation/docker.markdown @@ -197,7 +197,8 @@ As the docker command becomes more complex, switching to `docker-compose` can be image: homeassistant/home-assistant volumes: - /PATH_TO_YOUR_CONFIG:/config - - /etc/localtime:/etc/localtime:ro + environment: + - TZ=America/New_York restart: always network_mode: host ``` @@ -220,7 +221,7 @@ In order to use Z-Wave, Zigbee or other integrations that require access to devi ```bash $ docker run --init -d --name="home-assistant" -v /PATH_TO_YOUR_CONFIG:/config \ - -v /etc/localtime:/etc/localtime:ro --device /dev/ttyUSB0:/dev/ttyUSB0 \ + -e TZ=Australia/Melbourne --device /dev/ttyUSB0:/dev/ttyUSB0 \ --net=host homeassistant/home-assistant ``` @@ -234,7 +235,6 @@ or in a `docker-compose.yml` file: image: homeassistant/home-assistant volumes: - /PATH_TO_YOUR_CONFIG:/config - - /etc/localtime:/etc/localtime:ro devices: - /dev/ttyUSB0:/dev/ttyUSB0 - /dev/ttyUSB1:/dev/ttyUSB1 From 77197e6e73aee24eb27d7d124adc102991e06434 Mon Sep 17 00:00:00 2001 From: Pascal Vizeli Date: Fri, 9 Aug 2019 08:56:38 +0200 Subject: [PATCH 034/126] Update docker.markdown --- source/_docs/installation/docker.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_docs/installation/docker.markdown b/source/_docs/installation/docker.markdown index 3bb1195486f..72ae3082e0d 100644 --- a/source/_docs/installation/docker.markdown +++ b/source/_docs/installation/docker.markdown @@ -221,7 +221,7 @@ In order to use Z-Wave, Zigbee or other integrations that require access to devi ```bash $ docker run --init -d --name="home-assistant" -v /PATH_TO_YOUR_CONFIG:/config \ - -e TZ=Australia/Melbourne --device /dev/ttyUSB0:/dev/ttyUSB0 \ + -e "TZ=Australia/Melbourne" --device /dev/ttyUSB0:/dev/ttyUSB0 \ --net=host homeassistant/home-assistant ``` From ff06792366cfc7f58b8e1746e55d4e5f009824f0 Mon Sep 17 00:00:00 2001 From: jack1142 <6032823+jack1142@users.noreply.github.com> Date: Fri, 9 Aug 2019 09:28:46 +0200 Subject: [PATCH 035/126] Update installation.markdown (#10091) --- source/_docs/installation.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_docs/installation.markdown b/source/_docs/installation.markdown index 1b66be349eb..712384f1a16 100644 --- a/source/_docs/installation.markdown +++ b/source/_docs/installation.markdown @@ -119,7 +119,7 @@ These guides are provided as-is. Some of these install methods are more limited
FreeNAS
 - +
From 10c3af1838f85e823b1ab160dbb93436124328c8 Mon Sep 17 00:00:00 2001 From: Franck Nijhof Date: Fri, 9 Aug 2019 16:47:31 +0200 Subject: [PATCH 036/126] Deprecates linksys_ap integration (ADR-0004) (#10092) --- source/_components/linksys_ap.markdown | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/source/_components/linksys_ap.markdown b/source/_components/linksys_ap.markdown index e0d1f34f93e..05285897853 100644 --- a/source/_components/linksys_ap.markdown +++ b/source/_components/linksys_ap.markdown @@ -9,6 +9,14 @@ redirect_from: - /components/device_tracker.linksys_ap/ --- +
+ +This integration is deprecated and will be removed in Home Assistant 0.100.0. + +For more information see [Architecture Decision Record: 0004](https://github.com/home-assistant/architecture/blob/master/adr/0004-webscraping.md). + +
+ The `linksys_ap` platform offers presence detection by looking at connected devices to a Linksys based access point. It was tested with a LAPAC1750 AC1750 Dual Band Access Point. From 5c93c2681ef6db22b35f15b036885bfefe157681 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Fri, 9 Aug 2019 11:25:55 -0700 Subject: [PATCH 037/126] 0.97.1 --- _config.yml | 4 ++-- source/_posts/2019-08-07-release-97.markdown | 24 ++++++++++++++++++++ 2 files changed, 26 insertions(+), 2 deletions(-) diff --git a/_config.yml b/_config.yml index b7388353e08..86248e7f9d5 100644 --- a/_config.yml +++ b/_config.yml @@ -99,8 +99,8 @@ social: # Home Assistant release details current_major_version: 0 current_minor_version: 97 -current_patch_version: 0 -date_released: 2019-08-07 +current_patch_version: 1 +date_released: 2019-08-09 # Either # or the anchor link to latest release notes in the blog post. # Must be prefixed with a # and have double quotes around it. diff --git a/source/_posts/2019-08-07-release-97.markdown b/source/_posts/2019-08-07-release-97.markdown index 9c19cf6b369..b8faf81b170 100644 --- a/source/_posts/2019-08-07-release-97.markdown +++ b/source/_posts/2019-08-07-release-97.markdown @@ -79,6 +79,28 @@ We wrote about how we use Azure DevOps to automate the development of Home Assis - Add De Lijn (Flemish Public Transport) component ([@bollewolle] - [#24265]) ([delijn docs]) (new-integration) (new-platform) - Add Support for VeSync Devices - Outlets and Switches ([@webdjoe] - [#24953]) ([vesync docs]) (new-platform) +## Release 0.97.1 - August 9 + +A new breaking change was introduced with 0.97.1 to accomodate for the HaveIBeenPwned shutting down v2 of their API on August 18. The integration has been migrated to using v3. + +- Update HIBP sensor to use API v3 and API Key ([@aetaric] - [#25699]) ([haveibeenpwned docs]) (breaking change) +- Update Cisco Mobility Express module version ([@fbradyirl] - [#25770]) ([cisco_mobility_express docs]) +- Don't track unstable attributes ([@jjlawren] - [#25787]) ([unifi docs]) (breaking change) +- Fix deconz allow_clip_sensor and allow_deconz_groups options ([@Anonym-tsk] - [#25811]) ([deconz docs]) + +[#25699]: https://github.com/home-assistant/home-assistant/pull/25699 +[#25770]: https://github.com/home-assistant/home-assistant/pull/25770 +[#25787]: https://github.com/home-assistant/home-assistant/pull/25787 +[#25811]: https://github.com/home-assistant/home-assistant/pull/25811 +[@Anonym-tsk]: https://github.com/Anonym-tsk +[@aetaric]: https://github.com/aetaric +[@fbradyirl]: https://github.com/fbradyirl +[@jjlawren]: https://github.com/jjlawren +[cisco_mobility_express docs]: /components/cisco_mobility_express/ +[deconz docs]: /components/deconz/ +[haveibeenpwned docs]: /components/haveibeenpwned/ +[unifi docs]: /components/unifi/ + ## If you need help... ...don't hesitate to use our very active [forums](https://community.home-assistant.io/) or join us for a little [chat](https://discord.gg/c5DvZ4e). @@ -146,6 +168,8 @@ Experiencing issues introduced by this release? Please report them in our [issue - Due in -> due_in - Due at -> due_at +- **haveibeenpwned** - the v2 API is now replaced with the v3 API, which requires an API key. v2 of the API will stop working on August 18. + ## Beta Fixes - Expose comfort presets as HA presets ([@balloob] - [#25491]) ([ecobee docs]) (breaking change) (beta fix) From f475ab32e05fbd54bb842c50ff1efb3d60735749 Mon Sep 17 00:00:00 2001 From: Lorenzo Milesi Date: Sat, 10 Aug 2019 08:19:35 +0200 Subject: [PATCH 038/126] Replace port(s) -> pin(s) (#10095) To be verified, but should be correct --- source/_components/mcp23017.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_components/mcp23017.markdown b/source/_components/mcp23017.markdown index 0b2813a20dc..4991a3c7d67 100644 --- a/source/_components/mcp23017.markdown +++ b/source/_components/mcp23017.markdown @@ -98,12 +98,12 @@ i2c_address: required: false type: integer default: "`0x20`" -ports: +pins: description: Array of used pins. required: true type: list keys: - port: + pin: description: The pin numbers (from 0 to 15) and corresponding names. required: true type: [integer, string] From cc180eaf583dc47528de16f8412db08dd160d8b6 Mon Sep 17 00:00:00 2001 From: Tomi Lehto Date: Sat, 10 Aug 2019 09:49:51 +0300 Subject: [PATCH 039/126] Update Modbus sensor docs for HA PR #25672 (#10043) Added note about possible floating point conversion related precision loss when dealing with large values and floating point scale and offset parameters. --- source/_components/sensor.modbus.markdown | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/source/_components/sensor.modbus.markdown b/source/_components/sensor.modbus.markdown index 5b2ee02cc8f..13378090288 100644 --- a/source/_components/sensor.modbus.markdown +++ b/source/_components/sensor.modbus.markdown @@ -111,6 +111,12 @@ registers: It's possible to change the default 30 seconds scan interval for the sensor updates as shown in the [Platform options](/docs/configuration/platform_options/#scan-interval) documentation. +
+ +If you specify scale or offset as floating point values, double precision floating point arithmetic will be used to calculate final value. This can cause loss of precision for values that are larger than 2^53. + +
+ ### Full example Example a temperature sensor with a 10 seconds scan interval: From 0066d5d48e7577d84f85f550dcb456da31c76ce8 Mon Sep 17 00:00:00 2001 From: Paul Tarjan Date: Sat, 10 Aug 2019 11:07:57 -0700 Subject: [PATCH 040/126] Add Fulfillment section Without this being filled in, that oauth flow wouldn't start for me. I found it in this video: https://www.youtube.com/watch?v=MMtCzX6US9M --- source/_components/google_assistant.markdown | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/source/_components/google_assistant.markdown b/source/_components/google_assistant.markdown index 4dc35bc5a0b..45c030da0be 100644 --- a/source/_components/google_assistant.markdown +++ b/source/_components/google_assistant.markdown @@ -79,11 +79,12 @@ You need to create an API Key with the [Google Cloud API Console](https://consol 9. Testing instructions: Enter anything. It doesn't matter since you won't submit this app. Screenshot: Account linking - -3. Back on the overview page. Click `Simulator` under `TEST`. It will create a new draft version Test App. You don't have to actually test, but you need to generate this draft version Test App. -4. Add the `google_assistant` integration configuration to your `configuration.yaml` file and restart Home Assistant following the [configuration guide](#configuration) below. -5. Open the Google Home app and go into `Account > Settings > Assistant > Home Control`. -6. Click the `+` sign, and near the bottom, you should have `[test] your app name` listed under 'Add new.' Selecting that should lead you to a browser to login your Home Assistant instance, then redirect back to a screen where you can set rooms for your devices or nicknames for your devices. +3. Under `Build your Action` click `Add Action(s)`. + 1. Under `Fulfillment` fill in this URL (replace with your actual URL): `https://[YOUR HOME ASSISTANT URL:PORT]/api/google_assistant`. +4. Back on the overview page. Click `Simulator` under `TEST`. It will create a new draft version Test App. You don't have to actually test, but you need to generate this draft version Test App. +5. Add the `google_assistant` integration configuration to your `configuration.yaml` file and restart Home Assistant following the [configuration guide](#configuration) below. +6. Open the Google Home app and go into `Account > Settings > Assistant > Home Control`. +7. Click the `+` sign, and near the bottom, you should have `[test] your app name` listed under 'Add new.' Selecting that should lead you to a browser to login your Home Assistant instance, then redirect back to a screen where you can set rooms for your devices or nicknames for your devices.
From 4a301ca3916a03cd88905ca4e73b347e32bab4d9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Per=20Osb=C3=A4ck?= Date: Sat, 10 Aug 2019 22:15:53 +0200 Subject: [PATCH 041/126] Change for Prometheus metrics naming (#9518) * Add docs for PR #24103 * :pencil2: Tweak * updated to only show required configuration in first example * :pencil2: Tweak * :pencil2: Tweak * Remove top level domain name * Fix configuration section --- source/_components/prometheus.markdown | 63 +++++++++++++++++++++++++- 1 file changed, 62 insertions(+), 1 deletion(-) diff --git a/source/_components/prometheus.markdown b/source/_components/prometheus.markdown index 748bfbe51c2..95157c7c450 100644 --- a/source/_components/prometheus.markdown +++ b/source/_components/prometheus.markdown @@ -3,12 +3,14 @@ title: "Prometheus" description: "Record events in Prometheus." logo: prometheus.png ha_category: - - "History" + - History ha_release: 0.49 --- The `prometheus` integration exposes metrics in a format which [Prometheus](https://prometheus.io/) can read. +## Configuration + To use the `prometheus` integration in your installation, add the following to your `configuration.yaml` file: ```yaml @@ -42,8 +44,67 @@ filter: description: The list of domains to be included from recordings. If set, all other entities will not be recorded. Values set by the **exclude_*** option will prevail. required: false type: list +default_metric: + type: string + description: Metric name to use when an entity doesn't have a unit. + required: false + default: uses the entity id of the entity +override_metric: + type: string + description: Metric name to use instead of unit or default metric. This will store all data points in a single metric. + required: false +component_config: + type: string + required: false + description: This attribute contains component-specific override values. See [Customizing devices and services](/getting-started/customizing-devices/) for format. + keys: + override_metric: + type: string + description: Metric name to use instead of unit or default metric. This will store all data points in a single metric. + required: false +component_config_domain: + type: string + required: false + description: This attribute contains domain-specific component override values. See [Customizing devices and services](/getting-started/customizing-devices/) for format. + keys: + override_metric: + type: string + description: Metric name to use instead of unit or default metric. This will store all data points in a single metric. + required: false +component_config_glob: + type: string + required: false + description: This attribute contains component-specific override values. See [Customizing devices and services](/getting-started/customizing-devices/) for format. + keys: + override_metric: + type: string + description: Metric name to use instead of unit or default metric. This will store all data points in a single metric. + required: false + {% endconfiguration %} +## Full Example + +Advanced configuration example: + +```yaml +# Advanced configuration.yaml entry +prometheus: + namespace: hass + component_config_glob: + sensor.*_hum: + override_metric: humidity_percent + sensor.*_temp: + override_metric: temperature_c + sensor.temperature*: + override_metric: temperature_c + sensor.*_bat: + override_metric: battery_percent + filter: + include_domains: + - sensor +``` + You can then configure Prometheus to fetch metrics from Home Assistant by adding to its `scrape_configs` configuration. ```yaml From 51c6252a7cfcad8442eca7c2fea8ba8370d66866 Mon Sep 17 00:00:00 2001 From: Malte Franken Date: Sun, 11 Aug 2019 06:19:09 +1000 Subject: [PATCH 042/126] GeoNet NZ Quakes feed integration (#10077) * added documentation for new geonetnz_quakes integration * mentioned the use of the integrations feature in the ui * added new source * removed hint about configuration.yaml * fixed typo --- source/_components/geo_location.markdown | 1 + source/_components/geonetnz_quakes.markdown | 115 ++++++++++++++++++ .../screenshots/geonetnz-quakes-feed-map.png | Bin 0 -> 175243 bytes source/images/supported_brands/geonet-nz.png | Bin 0 -> 4927 bytes 4 files changed, 116 insertions(+) create mode 100644 source/_components/geonetnz_quakes.markdown create mode 100644 source/images/screenshots/geonetnz-quakes-feed-map.png create mode 100644 source/images/supported_brands/geonet-nz.png diff --git a/source/_components/geo_location.markdown b/source/_components/geo_location.markdown index a4ef666e619..cd95864cf06 100644 --- a/source/_components/geo_location.markdown +++ b/source/_components/geo_location.markdown @@ -16,6 +16,7 @@ The [Geolocation trigger](/docs/automation/trigger/#geolocation-trigger) can be | Platform | Source | |---------------------------------------------------|-------------------------------| | GeoJSON Events | `geo_json_events` | +| GeoNet New Zealand Quakes | `geonetnz_quakes` | | IGN Sismología | `ign_sismologia` | | NSW Rural Fire Service Incidents | `nsw_rural_fire_service_feed` | | Queensland Bushfire Alert | `qld_bushfire` | diff --git a/source/_components/geonetnz_quakes.markdown b/source/_components/geonetnz_quakes.markdown new file mode 100644 index 00000000000..56753cc44d9 --- /dev/null +++ b/source/_components/geonetnz_quakes.markdown @@ -0,0 +1,115 @@ +--- +title: "GeoNet NZ Quakes" +description: "Instructions on how to integrate the GeoNet New Zealand Quakes feed into Home Assistant." +logo: geonet-nz.png +ha_category: + - Geolocation +ha_iot_class: Cloud Polling +ha_release: 0.98 +--- + +The `geonetnz_quakes` integration lets you use a GeoJSON feed provided by +New Zealand's [GeoNet](https://www.geonet.org.nz/) with information +about quakes in the New Zealand region that happened within the last 7 days. +It retrieves incidents from a feed and +shows information of those incidents filtered by distance to Home Assistant's +location. + +Entities are generated, updated and removed automatically with each update +from the feed. Each entity defines latitude and longitude and will be shown +on the default map automatically, or on a map card by defining the source +`geonetnz_quakes`. The distance is available as the state of each entity, and +converted to the unit (kilometers or miles) configured in Home Assistant. + +

+ +

+ +The data is updated every 5 minutes. + +
+ +The material used by this integration is provided under the [Creative Commons Attribution 3.0 New Zealand (CC BY 3.0 NZ) license](http://creativecommons.org/licenses/by/3.0/nz/). +It has only been modified for the purpose of presenting the material in Home Assistant. +Please refer to the [creator's disclaimer notice](https://www.geonet.org.nz/disclaimer) and [data policy](https://www.geonet.org.nz/policy) for more information. + +We acknowledge the New Zealand GeoNet project and its sponsors EQC, GNS Science and LINZ, for providing data/images used in this integration. + +
+ + +## Configuration + +To integrate the GeoNet New Zealand Quakes feed use the "Integrations" feature +in the GUI, you find it under Configurations - Integrations, or add the +following line to your `configuration.yaml`. + +```yaml +# Example configuration.yaml entry +geonetnz_quakes: +``` + +{% configuration %} +mmi: + description: Request quakes that may have caused shaking greater than or equal to the [MMI](https://www.geonet.org.nz/earthquake/mmi) value. Allowable values are -1..8 inclusive. Value -1 is used for quakes that are too small to calculate a stable MMI value for. + required: false + type: integer + default: 2 +minimum_magnitude: + description: The minimum magnitude of an earthquake to be included. + required: false + type: float + default: 0.0 +radius: + description: The radius around your location to monitor; defaults to 50 km or mi (depending on the unit system defined in your `configuration.yaml`). + required: false + type: float + default: 50.0 +latitude: + description: Latitude of the coordinates around which quakes are considered. + required: false + type: float + default: Latitude defined in your configuration. +longitude: + description: Longitude of the coordinates around which quakes are considered. + required: false + type: float + default: Longitude defined in your configuration. +{% endconfiguration %} + + +## State Attributes + +The following state attributes are available for each entity in addition to +the standard ones: + +| Attribute | Description | +|-------------|-------------| +| latitude | Latitude of the quake. | +| longitude | Longitude of the quake. | +| source | `geonetnz_quakes` to be used in conjunction with `geo_location` automation trigger. | +| external_id | The external ID used in the feed to identify the quake in the feed. | +| title | Title of this entry. | +| mmi | The calculated MMI shaking at the closest locality in the New Zealand region. +| magnitude | The summary magnitude for the quake. | +| depth | The depth of the quake in km. | +| time | The origin date and time of the quake. | +| locality | Distance and direction to the nearest locality. | +| quality | The quality of this information: best, good, caution, deleted. | + +Please note that the reported MMI may be lower than the minimum requested MMI. +This integration is passing the requested MMI value to the feed source and +displays all entries retrieved without further filtering by MMI. + + +## Full Configuration + +```yaml +# Example configuration.yaml entry +geonetnz_quakes: + radius: 100 + mmi: 4 + minimum_magnitude: 4.5 + latitude: -41.2 + longitude: 174.7 +``` diff --git a/source/images/screenshots/geonetnz-quakes-feed-map.png b/source/images/screenshots/geonetnz-quakes-feed-map.png new file mode 100644 index 0000000000000000000000000000000000000000..8f432e511a17d5e3e33b8f452a723c19c09352ee GIT binary patch literal 175243 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 literal 0 HcmV?d00001 diff --git a/source/images/supported_brands/geonet-nz.png b/source/images/supported_brands/geonet-nz.png new file mode 100644 index 0000000000000000000000000000000000000000..69768c2902fb4894ad49d413302f3b52f4740c46 GIT binary patch literal 4927 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 z -u*|^B(KmBZ(*jME&t#*VM8Cih4hdWX)c$3E@w28Ksiz zqJnYbudj7DLdNMFyRzN~IPSwpZuwd0MfRcAaNrJ`Rw7(Ex5ncc?=8O_r8Xk#x#nS4 zwdoTzng&LZoq5-_eBz1&2Un1GjDzq@Dv7FF#Xidz1qhwAFX@pxxkqhk)a#yfVf*&zu%JU@82p?J;)~m{HR+@td3!{bT|>$!CwPtN^Z{X)(-2lB+CIc+JF6RT=EfWSxZqn3TZt<@mth}us zvJdt!VsCr37lB7~g2j7H`Oy4_6TSzZl{oZcNz6K-M%d3&G@8xRvH*kW4NQ37ji#16 z>#Jy~c=MiK?6H2D>R*Fj;-cfn9L-w06$JfcX>AC4VlZp#b|M$nxDb8wS!%b%LiBpA zKmFPinx-xym{=>#4?PO#$NVXOC(OLsBsH$VBuoVm=9RuHpR#6)cfZilSvcg6lW>gT zWBqV+9b<)z2Gj~wPZ^08IN9CA+ zW=2H^Q68W<@-Ne-X6UTvq_heQa+S936Z{*eRQIr~El!BD!{!Qx6Amh~SaAb6w*kU= z9!Dx2b(XOP)2TpV7f`M3`u1boh)DI&7w|v(`-ebnMRH>MMNA1E?Hi|tJA=KpJ}6D_ z@mO4Q2Zod!^4cUjJY-um`AsM4Ts$olfYQp7lxe4TL#qiy#VI6XlcSsY&ijsDrKTxIYFe*1 zd5eZ;n?oGfs`#J`5ZA~%lWh&-u2rQ3#{1^mPCdZ;jxNdJmEHyJ@y;%3dXepzo9`5p zq3efiPk_tgx)CKcU&(oHKo&EsPIz8f-#CwvjtQ~yG0m!ze>;j!zQ8Mgx*Mr6{*%En zjL7WyI!QBkmd~_ru8TVv?KO@xX~9!-&=c=?!(5FMJeA%s?r#zE3tGQfuO0+ymV{@N ztfI1gT>>nQ3BPo*03yQJ4LQuMIX(AI@h^CTTN2-wihQ+)q!`^~1-A4bnIjtFsO6f< z?6Xi5# Date: Sun, 11 Aug 2019 15:54:38 -0500 Subject: [PATCH 043/126] Update fortigate.markdown (#10111) --- source/_components/fortigate.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/fortigate.markdown b/source/_components/fortigate.markdown index 3d063e675d4..a5e2b815d25 100644 --- a/source/_components/fortigate.markdown +++ b/source/_components/fortigate.markdown @@ -43,7 +43,7 @@ Add the following to your `configuration.yaml` file: # Example configuration.yaml entry fortigate: host: HOST_IP - username: YPUR_USERNAME + username: YOUR_USERNAME api_key: YOUR_API_KEY ``` From c59ef65d2d793e860eac66c4030eff0f7580ea12 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Sun, 11 Aug 2019 20:51:33 -0700 Subject: [PATCH 044/126] Release 97.2 --- _config.yml | 4 +-- source/_posts/2019-08-07-release-97.markdown | 32 ++++++++++++++++++++ 2 files changed, 34 insertions(+), 2 deletions(-) diff --git a/_config.yml b/_config.yml index 86248e7f9d5..e2bb0812a7f 100644 --- a/_config.yml +++ b/_config.yml @@ -99,8 +99,8 @@ social: # Home Assistant release details current_major_version: 0 current_minor_version: 97 -current_patch_version: 1 -date_released: 2019-08-09 +current_patch_version: 2 +date_released: 2019-08-12 # Either # or the anchor link to latest release notes in the blog post. # Must be prefixed with a # and have double quotes around it. diff --git a/source/_posts/2019-08-07-release-97.markdown b/source/_posts/2019-08-07-release-97.markdown index b8faf81b170..c1601dedffb 100644 --- a/source/_posts/2019-08-07-release-97.markdown +++ b/source/_posts/2019-08-07-release-97.markdown @@ -101,6 +101,38 @@ A new breaking change was introduced with 0.97.1 to accomodate for the HaveIBeen [haveibeenpwned docs]: /components/haveibeenpwned/ [unifi docs]: /components/unifi/ +## Release 0.97.2 - August 11 + +- Fix eco preset for Wink Air Conditioner ([@cameronrmorris] - [#25763]) ([wink docs]) +- Update pyvera to 0.3.3 ([@brandond] - [#25820]) ([vera docs]) +- Fix Netatmo climate issue ([@cgtobi] - [#25830]) ([netatmo docs]) +- Fix KNX Climate mode change callback ([@tombbo] - [#25851]) ([knx docs]) +- Always populate hvac_modes in SmartThings climate platform ([@andrewsayre] - [#25859]) ([smartthings docs]) +- UniFi - Use state to know if device is online ([@Kane610] - [#25876]) ([unifi docs]) +- Fix issue with nuki new available state ([@pvizeli] - [#25881]) ([nuki docs]) + +[#25763]: https://github.com/home-assistant/home-assistant/pull/25763 +[#25820]: https://github.com/home-assistant/home-assistant/pull/25820 +[#25830]: https://github.com/home-assistant/home-assistant/pull/25830 +[#25851]: https://github.com/home-assistant/home-assistant/pull/25851 +[#25859]: https://github.com/home-assistant/home-assistant/pull/25859 +[#25876]: https://github.com/home-assistant/home-assistant/pull/25876 +[#25881]: https://github.com/home-assistant/home-assistant/pull/25881 +[@Kane610]: https://github.com/Kane610 +[@andrewsayre]: https://github.com/andrewsayre +[@brandond]: https://github.com/brandond +[@cameronrmorris]: https://github.com/cameronrmorris +[@cgtobi]: https://github.com/cgtobi +[@pvizeli]: https://github.com/pvizeli +[@tombbo]: https://github.com/tombbo +[knx docs]: /components/knx/ +[netatmo docs]: /components/netatmo/ +[nuki docs]: /components/nuki/ +[smartthings docs]: /components/smartthings/ +[unifi docs]: /components/unifi/ +[vera docs]: /components/vera/ +[wink docs]: /components/wink/ + ## If you need help... ...don't hesitate to use our very active [forums](https://community.home-assistant.io/) or join us for a little [chat](https://discord.gg/c5DvZ4e). From 5c945feb9a6a30ebe85fe98f464cb063ae3bea53 Mon Sep 17 00:00:00 2001 From: Klaas Schoute Date: Mon, 12 Aug 2019 10:06:15 +0200 Subject: [PATCH 045/126] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Add=20more=20infor?= =?UTF-8?q?mation=20to=20Deconz=20(#10112)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * :pencil2: Add more information to Deconz * :pencil2: Improve text about cover devices --- source/_components/deconz.markdown | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/source/_components/deconz.markdown b/source/_components/deconz.markdown index b88395d9023..3b205c7491f 100644 --- a/source/_components/deconz.markdown +++ b/source/_components/deconz.markdown @@ -320,6 +320,8 @@ The `entity_id` name will be `binary_sensor.device_name`, where `device_name` is - Philips Hue Motion Sensor - Xiaomi Motion Sensor - Xiaomi Smart Home Aqara Human Body Sensor +- Water leakage detection + - Xiaomi Aqara water leak Sensor ## Climate @@ -340,7 +342,7 @@ The `entity_id` name will be `climate.device_name`, where `device_name` is defin Covers are devices like ventilation dampers or smart window covers. -Note that devices in the cover platform identify as lights, so there is a manually curated list that defines which "lights" are covers. +Note that devices in the cover platform identify as lights, so there is a manually curated list that defines which "lights" are covers. You therefore add a cover device as a light device in deCONZ (phoscon app). The `entity_id` name will be `cover.device_name`, where `device_name` is defined in deCONZ. From 67a7b19e120c05014cd2930986f6a7d11e391d3d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Thomas=20Lov=C3=A9n?= Date: Mon, 12 Aug 2019 14:22:14 +0200 Subject: [PATCH 046/126] Documentation for home-assistant/home-assistant-polymer#3451 (#10051) * Documentation for home-assistant/home-assistant-polymer#3451 * Add entity_ids and example for card_size. * :pencil2: Tweak --- source/_lovelace/markdown.markdown | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/source/_lovelace/markdown.markdown b/source/_lovelace/markdown.markdown index 63a8d298ca1..e9ef40c5b76 100644 --- a/source/_lovelace/markdown.markdown +++ b/source/_lovelace/markdown.markdown @@ -18,13 +18,23 @@ type: type: string content: required: true - description: "Content to render as [markdown](http://commonmark.org/help/)." + description: "Content to render as [markdown](http://commonmark.org/help/). May contain [templates](/configuration/templating/)." type: string title: required: false description: The card title. type: string default: none +card_size: + required: false + type: integer + default: none + description: The algorithm for placing cards aesthetically in lovelace may have problems with the markdown card if it contains templates. You can use this value to help it estimate the height of the card in units of 50 pixels (approximately 3 lines of text in default size). (e.g., `4`) +entity_id: + required: false + type: [string, list] + default: none + description: "A list of entity IDs so a template in `content:` only reacts to the state changes of these entities. This can be used if the automatic analysis fails to find all relevant entities." {% endconfiguration %} ## Example From 43da41b820f7a84bed26b4b1cd1276b4634b6358 Mon Sep 17 00:00:00 2001 From: Jeff Irion Date: Mon, 12 Aug 2019 09:08:20 -0700 Subject: [PATCH 047/126] Update documentation for Kodi services (#10081) * Working on Kodi services documentation * Update Kodi services documentation * Remove description of deprecated 'kodi_set_shuffle' service * Add accidentally deleted '|' * 'kodi_call_method' -> 'kodi.call_method' --- source/_components/kodi.markdown | 31 ++++++++++++------------------- 1 file changed, 12 insertions(+), 19 deletions(-) diff --git a/source/_components/kodi.markdown b/source/_components/kodi.markdown index 57142d81195..8190ab09397 100644 --- a/source/_components/kodi.markdown +++ b/source/_components/kodi.markdown @@ -86,7 +86,7 @@ timeout: ### Services -#### Service `kodi_add_to_playlist` +#### Service `kodi.add_to_playlist` Add music to the default playlist (i.e. playlistid=0). @@ -98,14 +98,7 @@ Add music to the default playlist (i.e. playlistid=0). | `media_name` | no| Optional media name for filtering media. Can be 'ALL' when `media_type` is 'ALBUM' and `artist_name` is specified, to add all songs from one artist. | | `artist_name` | no | Optional artist name for filtering media. | -#### Service `media_player/kodi_set_shuffle` - -| Service data attribute | Optional | Description | -|------------------------|----------|-------------| -| `entity_id` | yes | Target a specific media player. It must be of type kodi. | -| `shuffle_on` | no | True/false for shuffle on/off. | - -#### Service `kodi_call_method` +#### Service `kodi.call_method` Call a [Kodi JSONRPC API](http://kodi.wiki/?title=JSON-RPC_API) method with optional parameters. Results of the Kodi API call will be redirected in a Home Assistant event: `kodi_call_method_result`. @@ -117,7 +110,7 @@ Call a [Kodi JSONRPC API](http://kodi.wiki/?title=JSON-RPC_API) method with opti ### Event triggering -When calling the `kodi_call_method` service, if the Kodi JSONRPC API returns data, when received by Home Assistant it will fire a `kodi_call_method_result` event on the event bus with the following `event_data`: +When calling the `kodi.call_method` service, if the Kodi JSONRPC API returns data, when received by Home Assistant it will fire a `kodi_call_method_result` event on the event bus with the following `event_data`: ```yaml entity_id: "" @@ -156,7 +149,7 @@ media_player: - platform: kodi host: 192.168.0.123 turn_off_action: - service: media_player.kodi_call_method + service: kodi.call_method data: entity_id: media_player.kodi method: Application.Quit @@ -169,7 +162,7 @@ media_player: - platform: kodi host: 192.168.0.123 turn_off_action: - service: media_player.kodi_call_method + service: kodi.call_method data: entity_id: media_player.kodi method: System.Hibernate @@ -182,7 +175,7 @@ media_player: - platform: kodi host: 192.168.0.123 turn_off_action: - service: media_player.kodi_call_method + service: kodi.call_method data: entity_id: media_player.kodi method: System.Suspend @@ -195,7 +188,7 @@ media_player: - platform: kodi host: 192.168.0.123 turn_off_action: - service: media_player.kodi_call_method + service: kodi.call_method data: entity_id: media_player.kodi method: System.Reboot @@ -208,7 +201,7 @@ media_player: - platform: kodi host: 192.168.0.123 turn_off_action: - service: media_player.kodi_call_method + service: kodi.call_method data: entity_id: media_player.kodi method: System.Shutdown @@ -223,7 +216,7 @@ media_player: - platform: kodi host: 192.168.0.123 turn_on_action: - service: media_player.kodi_call_method + service: kodi.call_method data: entity_id: media_player.kodi method: Addons.ExecuteAddon @@ -234,7 +227,7 @@ media_player: - service: media_player.media_stop data: entity_id: media_player.kodi - - service: media_player.kodi_call_method + - service: kodi.call_method data: entity_id: media_player.kodi method: Addons.ExecuteAddon @@ -293,7 +286,7 @@ script: alias: Update Kodi Library sequence: - alias: Call Kodi update - service: media_player.kodi_call_method + service: kodi.call_method data: entity_id: media_player.kodi method: VideoLibrary.Scan @@ -384,4 +377,4 @@ data: type: integer {% endconfiguration %} -To use notifications, please see the [getting started with automation page](/getting-started/automation/). \ No newline at end of file +To use notifications, please see the [getting started with automation page](/getting-started/automation/). From d713c7ad8be802030def17cc1d4ad427f5605806 Mon Sep 17 00:00:00 2001 From: derandiunddasbo Date: Mon, 12 Aug 2019 22:24:13 +0200 Subject: [PATCH 048/126] Remove initial_state attributes from the examples (#10119) Recently I had an extensive discussion about the pros and cons of using the `initial_state` attribute in automations and in the end I had to admit, that there are good arguments against using it unless absolutely necessary and only if one really knows what he or she is doing. In the examples above I can't see a good reason for using `initial_state` and thus I'd propose to delete it from both examples. ...and they were inkonsistent in both examples anyways. ;-) One of them used 'on' and the other used true. --- source/_components/frontend.markdown | 2 -- 1 file changed, 2 deletions(-) diff --git a/source/_components/frontend.markdown b/source/_components/frontend.markdown index 6efe0efa3da..5576c691f5f 100644 --- a/source/_components/frontend.markdown +++ b/source/_components/frontend.markdown @@ -86,7 +86,6 @@ Set a theme at the startup of Home Assistant: ```yaml automation: - alias: 'Set theme at startup' - initial_state: 'on' trigger: - platform: homeassistant event: start @@ -101,7 +100,6 @@ To enable "night mode": ```yaml automation: - alias: 'Set dark theme for the night' - initial_state: true trigger: - platform: time at: '21:00:00' From 4ce2550e2c460d81b0ecea9efa710642e53cadd0 Mon Sep 17 00:00:00 2001 From: Tobias Perschon Date: Mon, 12 Aug 2019 22:27:07 +0200 Subject: [PATCH 049/126] Update webhooks.markdown (#10122) updated default trusted ips --- source/_components/webhooks.markdown | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/source/_components/webhooks.markdown b/source/_components/webhooks.markdown index 2bf0a0ddb35..3e6f3c4acc2 100644 --- a/source/_components/webhooks.markdown +++ b/source/_components/webhooks.markdown @@ -63,7 +63,7 @@ trusted_networks: description: Telegram server access ACL as list. required: false type: string - default: 149.154.167.197-233 + default: 149.154.160.0/20, 91.108.4.0/22 {% endconfiguration %} To get your `chat_id` and `api_key` follow the instructions [here](/components/notify.telegram). As well as authorizing the chat, if you have added your bot to a group you will also need to authorize any user that will be interacting with the webhook. When an unauthorized user tries to interact with the webhook Home Assistant will raise an error ("Incoming message is not allowed"), you can easily obtain the users id by looking in the "from" section of this error message. @@ -81,12 +81,8 @@ telegram_bot: - platform: webhooks api_key: YOUR_API_KEY trusted_networks: - - 149.154.167.197/32 - - 149.154.167.198/31 - - 149.154.167.200/29 - - 149.154.167.208/28 - - 149.154.167.224/29 - - 149.154.167.232/31 + - 149.154.160.0/20 + - 91.108.4.0/22 allowed_chat_ids: - 12345 - 67890 From de1c436802a1515958be400bcab9b6ea3f711b00 Mon Sep 17 00:00:00 2001 From: tomlut <10679300+tomlut@users.noreply.github.com> Date: Tue, 13 Aug 2019 06:29:03 +1000 Subject: [PATCH 050/126] Corrected template examples (#10114) Template examples were incorrectly quoted. --- source/_components/garadget.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_components/garadget.markdown b/source/_components/garadget.markdown index 38f382effe0..2d5e969d857 100644 --- a/source/_components/garadget.markdown +++ b/source/_components/garadget.markdown @@ -89,13 +89,13 @@ sensor: sensors: garage_door_status: friendly_name: 'State of the door' - value_template: '{{ states('cover.garage_door') }}' + value_template: "{{ states('cover.garage_door') }}" garage_door_time_in_state: friendly_name: 'Since' - value_template: '{{ state_attr('cover.garage_door', 'time_in_state') }}' + value_template: "{{ state_attr('cover.garage_door', 'time_in_state') }}" garage_door_wifi_signal_strength: friendly_name: 'WiFi strength' - value_template: '{{ state_attr('cover.garage_door', 'wifi_signal_strength') }}' + value_template: "{{ state_attr('cover.garage_door', 'wifi_signal_strength') }}" unit_of_measurement: 'dB' group: From e9c12b07123d302c515142feed316e3f26787547 Mon Sep 17 00:00:00 2001 From: Alec Rust Date: Mon, 12 Aug 2019 21:54:00 +0100 Subject: [PATCH 051/126] Mention integration in ZHA docs (#10108) Due to the previous wording of this I thought a `zha` entry was necessary in `configuration.yaml`, which wasn't working for me on Hass.io. Adding ZHA from the Integrations page did work, but this isn't mentioned in the docs. --- source/_components/zha.markdown | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/source/_components/zha.markdown b/source/_components/zha.markdown index 13e66e8c7a4..864bf966471 100644 --- a/source/_components/zha.markdown +++ b/source/_components/zha.markdown @@ -59,8 +59,9 @@ The custom quirks implementations for zigpy implemented as ZHA Device Handlers f ## Configuration -To configure the component, a `zha` section must be present in the `configuration.yaml`, -and the path to the serial device for the radio and path to the database which will persist your network data is required. +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. ```yaml # Example configuration.yaml entry From 9cb6f9d466888edd4f7ca59b3515c1c624ff04f7 Mon Sep 17 00:00:00 2001 From: Ties de Kock Date: Tue, 13 Aug 2019 00:23:14 +0200 Subject: [PATCH 052/126] Document the buienradar camera component (#10106) * Document the buienradar camera component Buienradar camera had been added in 0.95 but documentation was not added. * :pencil2: Tweak --- source/_components/buienradar.markdown | 49 ++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) diff --git a/source/_components/buienradar.markdown b/source/_components/buienradar.markdown index 3eda01e9741..2a796080b5a 100644 --- a/source/_components/buienradar.markdown +++ b/source/_components/buienradar.markdown @@ -3,6 +3,7 @@ title: "Buienradar" description: "Instructions on how to integrate buienradar.nl weather within Home Assistant." logo: buienradar.png ha_category: + - Camera - Weather ha_release: 0.47 ha_iot_class: Cloud Polling @@ -14,6 +15,11 @@ The `buienradar` platform uses [buienradar.nl](http://buienradar.nl/) as a sourc The relevant weather station used will be automatically selected based on the location specified in the Home Assistant configuration (or in the Buienradar weather/sensor component). A map of all available weather stations can be found [here](https://www.google.com/maps/d/embed?mid=1NivHkTGQUOs0dwQTnTMZi8Uatj0). +Besides the weather platform, there is currently support for the following additional device types: + +- [Camera](#camera): Radar map +- [Sensor](/components/sensor.buienradar/): More customizable + ## Configuration To add the Buienradar weather to your installation, add the following to your `configuration.yaml` file: @@ -59,6 +65,7 @@ weather: forecast: true ``` +
This platform is an alternative to the [`buienradar`](/components/sensor.buienradar/) sensor. @@ -66,5 +73,47 @@ The weather platform is easier to configure but less customizable.
+## Camera + +The `buienradar` camera platform uses [buienradar.nl](http://buienradar.nl/) as a source for the last rain radar map. The overview image of the whole of the Netherlands is loaded and shown as a camera in Home Assistant. + +Internally this component uses the radar map image as [documented](https://www.buienradar.nl/overbuienradar/gratis-weerdata) on buienradar.nl. +The downloaded image is cached to prevent Home Assistant from making a new request to buienradar.nl multiple times a minute when Home Assistant checks for new stills from the camera. + +To add `buienradar` camera to Home Assistant, add the following section to your +`configuration.yaml` file: +```yaml +# Example configuration.yaml entry +camera: + - platform: buienradar +``` + +{% configuration %} +name: + description: You can (optionally) specify the name of the camera. The name + will be shown in the user interface below the radar image. + required: false + type: string +dimension: + description: Size of the image to be loaded from buienradar.nl + (120 to 700 pixels) + required: false + default: 512 + type: integer +delta: + description: Time interval in seconds between image updates + required: false + default: 600 + type: integer +{% endconfiguration %} + +### The `name` Variable + +If you specify a name, the camera will get this name as its label. A slugified +version of the name will be used as the name of the entity. + +With the default of "Buienradar loop" the entity name becomes +`camera.buienradar_loop`. + [Usage statement:](https://www.buienradar.nl/overbuienradar/gratis-weerdata) > Buienradar makes free weather data available for use by individuals and businesses (website/intranet). The use of the weather data is allowed for **non-commercial purposes**. Please refer to the full usage statement linked above to confirm your use or to request permission. From 7aa1ecd69e059d3254d73f77dac2a11658888625 Mon Sep 17 00:00:00 2001 From: Okke Garling Date: Tue, 13 Aug 2019 00:52:19 +0200 Subject: [PATCH 053/126] prefix HTTP scheme in example base_url (#10118) * prefixed HTTP protocol in example base_url * :pencil2: Tweak --- source/_components/google_translate.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/google_translate.markdown b/source/_components/google_translate.markdown index d0e7875433c..2f78f4c5f72 100644 --- a/source/_components/google_translate.markdown +++ b/source/_components/google_translate.markdown @@ -55,5 +55,5 @@ If you are using SSL certificate or Docker, you may need to add the `base_url` c ```yaml #Example configuration.yaml entry http: - base_url: example.duckdns.org + base_url: https://example.duckdns.org ``` From 16fbc41a910ce3916d9b2eca13dfff7dd828f8e9 Mon Sep 17 00:00:00 2001 From: Dubh Ad Date: Tue, 13 Aug 2019 00:02:48 +0100 Subject: [PATCH 054/126] Added config check for Docker (#10100) Added the config check steps for Docker --- source/_docs/configuration/troubleshooting.markdown | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/source/_docs/configuration/troubleshooting.markdown b/source/_docs/configuration/troubleshooting.markdown index d2faea397b6..a3af594e399 100644 --- a/source/_docs/configuration/troubleshooting.markdown +++ b/source/_docs/configuration/troubleshooting.markdown @@ -20,7 +20,9 @@ If you have incorrect entries in your configuration files you can use the [`chec One of the most common problems with Home Assistant is an invalid `configuration.yaml` file. - - You can test your configuration using the command line with: `hass --script check_config`. On Hass.io you can use the [hassio command](/hassio/commandline/#home-assistant): `hassio homeassistant check`. + - You can test your configuration using the command line with: `hass --script check_config`. + - On Hass.io you can use the [hassio command](/hassio/commandline/#home-assistant): `hassio homeassistant check`. + - On Docker you can use `docker exec home-assistant python -m homeassistant --script check_config --config /config` - where `homeassistant` is the name of the container. - You can verify your configuration's yaml structure using [this online YAML parser](http://yaml-online-parser.appspot.com/) or [YAML Lint](http://www.yamllint.com/). - To learn more about the quirks of YAML, read [YAML IDIOSYNCRASIES](https://docs.saltstack.com/en/latest/topics/troubleshooting/yaml_idiosyncrasies.html) by SaltStack (the examples there are specific to SaltStack, but do explain YAML issues well). From e21de0f1047e98e468759edc0ee86054ad3e6a67 Mon Sep 17 00:00:00 2001 From: Tomi Lehto Date: Tue, 13 Aug 2019 02:08:15 +0300 Subject: [PATCH 055/126] Add documentation for arcus trigonometry functions (#9982) --- source/_docs/configuration/templating.markdown | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/_docs/configuration/templating.markdown b/source/_docs/configuration/templating.markdown index 88646073fb2..08789841c4a 100644 --- a/source/_docs/configuration/templating.markdown +++ b/source/_docs/configuration/templating.markdown @@ -268,6 +268,10 @@ Some of these functions can also be used in a [filter](http://jinja.pocoo.org/do - `sin(value)` will return the sine of the input. Can be used as a filter. - `cos(value)` will return the cosine of the input. Can be used as a filter. - `tan(value)` will return the tangent of the input. Can be used as a filter. +- `asin(value)` will return the arcus sine of the input. Can be used as a filter. +- `acos(value)` will return the arcus cosine of the input. Can be used as a filter. +- `atan(value)` will return the arcus tangent of the input. Can be used as a filter. +- `atan2(y, x)` will return the four quadrant arcus tangent of y / x. Can be used as a filter. - `sqrt(value)` will return the square root of the input. Can be used as a filter. - `e` mathematical constant, approximately 2.71828. - `pi` mathematical constant, approximately 3.14159. From 4ac2d9e50b8f4d0fbc8357bc64da126b073b031c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Niels=20M=C3=BCndler?= Date: Tue, 13 Aug 2019 07:33:41 +0800 Subject: [PATCH 056/126] Add note about language issues with syncthru (#10109) * Add note about language issues with syncthru * :pencil2: Tweak --- source/_components/syncthru.markdown | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/_components/syncthru.markdown b/source/_components/syncthru.markdown index 1d8f4de2d31..04b26afa2a8 100644 --- a/source/_components/syncthru.markdown +++ b/source/_components/syncthru.markdown @@ -44,3 +44,7 @@ The following information is displayed in separate sensors, if it is available: - Black, cyan, magenta and yellow drum state - First to fifth paper input tray state - First to sixth paper output tray state + +
+Note that this component or parts thereof may not work if the language of your printer is not configured to be English. +
From 21d66af0eff61e42e3acc4a8d1790213ce6cd23b Mon Sep 17 00:00:00 2001 From: escoand Date: Tue, 13 Aug 2019 01:35:36 +0200 Subject: [PATCH 057/126] add description for Traccar Client (#10090) --- source/_components/traccar.markdown | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/source/_components/traccar.markdown b/source/_components/traccar.markdown index 1f0cfe181af..3f9706bb1e1 100644 --- a/source/_components/traccar.markdown +++ b/source/_components/traccar.markdown @@ -10,11 +10,15 @@ redirect_from: - /components/device_tracker.traccar/ --- -`Traccar` uses GPS for tracking and has support for over 1500 different types of devices. +`Traccar` uses GPS for tracking and has support for over 1500 different types of devices. One option is to track the [Traccar Client](https://www.traccar.org/client/) app on a smartphone via `webhook`. The other option is to connect to an existing [Traccar Server](https://www.traccar.org/server/) installation which is also available as Hass.io addon. -## Configuration +## Traccar Client -To integrate Traccar GPS tracker in Home Assistant, add the following section to your `configuration.yaml` file: +To configure Traccar Client, you must set it up via the integrations panel in the configuration screen. This will give you the webhook URL to use during mobile device configuration. This URL has to be set in the Traccar app. + +## Traccar Server + +To integrate Traccar Server in Home Assistant, add the following section to your `configuration.yaml` file: ```yaml # Example configuration.yaml entry From 00431e9a4cf7d891ae657fe2b215edafb9fc14fa Mon Sep 17 00:00:00 2001 From: Dustin Essington Date: Mon, 12 Aug 2019 16:37:06 -0700 Subject: [PATCH 058/126] Update HaveIBeenPwned to include API Key (#9977) * Update HaveIBeenPwned to include API Key * Update haveibeenpwned.markdown * :ambulance: Small Markdown fix * :pencil2: Tweak --- source/_components/haveibeenpwned.markdown | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/source/_components/haveibeenpwned.markdown b/source/_components/haveibeenpwned.markdown index 15de845e3d1..067c142799b 100644 --- a/source/_components/haveibeenpwned.markdown +++ b/source/_components/haveibeenpwned.markdown @@ -12,6 +12,12 @@ redirect_from: The `haveibeenpwned` sensor platform creates sensors that check for breached email accounts on [haveibeenpwned](https://haveibeenpwned.com). +
+ + The HaveIBeenPwned API now requires you to pay $3.50 a month in order to query the API. More info can be found [here](https://www.troyhunt.com/authentication-and-the-have-i-been-pwned-api/) + +
+ ## Configuration To enable this sensor, add the following lines to your `configuration.yaml`, it will list every specified email address as a sensor showing @@ -24,6 +30,7 @@ sensor: email: - your_email1@domain.com - your_email2@domain.com + api_key: API_KEY ``` {% configuration %} @@ -31,6 +38,10 @@ email: description: List of email addresses. required: true type: list +api_key: + description: HaveIBeenPwned API Key + required: true + type: string {% endconfiguration %} ## Breach meta data From b8876b7b829dbf46d92773fcff51cbd3003206ec Mon Sep 17 00:00:00 2001 From: Dustin Essington Date: Mon, 12 Aug 2019 16:37:06 -0700 Subject: [PATCH 059/126] Update HaveIBeenPwned to include API Key (#9977) * Update HaveIBeenPwned to include API Key * Update haveibeenpwned.markdown * :ambulance: Small Markdown fix * :pencil2: Tweak --- source/_components/haveibeenpwned.markdown | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/source/_components/haveibeenpwned.markdown b/source/_components/haveibeenpwned.markdown index 15de845e3d1..067c142799b 100644 --- a/source/_components/haveibeenpwned.markdown +++ b/source/_components/haveibeenpwned.markdown @@ -12,6 +12,12 @@ redirect_from: The `haveibeenpwned` sensor platform creates sensors that check for breached email accounts on [haveibeenpwned](https://haveibeenpwned.com). +
+ + The HaveIBeenPwned API now requires you to pay $3.50 a month in order to query the API. More info can be found [here](https://www.troyhunt.com/authentication-and-the-have-i-been-pwned-api/) + +
+ ## Configuration To enable this sensor, add the following lines to your `configuration.yaml`, it will list every specified email address as a sensor showing @@ -24,6 +30,7 @@ sensor: email: - your_email1@domain.com - your_email2@domain.com + api_key: API_KEY ``` {% configuration %} @@ -31,6 +38,10 @@ email: description: List of email addresses. required: true type: list +api_key: + description: HaveIBeenPwned API Key + required: true + type: string {% endconfiguration %} ## Breach meta data From d4c06b2fc7df1704efb91897879873c3d09c65fe Mon Sep 17 00:00:00 2001 From: Santobert Date: Tue, 13 Aug 2019 01:45:28 +0200 Subject: [PATCH 060/126] Edit updater component to match PR #25418 (#9957) * Edit updater component to match PR #25418 * Make this a binary sensor * :pencil2: Tweak * :pencil2: Tweak --- source/_components/updater.markdown | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) diff --git a/source/_components/updater.markdown b/source/_components/updater.markdown index 3b5f99d0709..ab4f81cc2d5 100644 --- a/source/_components/updater.markdown +++ b/source/_components/updater.markdown @@ -3,14 +3,14 @@ title: "Updater" description: "Detecting when Home Assistant updates are available." logo: home-assistant.png ha_category: - - Other + - binary_sensor ha_qa_scale: internal ha_release: 0.8 --- -The `updater` integration will check daily for new releases. It will show a badge in the frontend if a new version is found. As [Hass.io](/hassio/) has its own schedule for release it doesn't make sense to use this integration on Hass.io. +The `updater` binary sensor will check daily for new releases. The state will be "on" when an update is available. Otherwise, the state will be "off". The newer version, as well as the link to the release notes, are attributes of the updater. As [Hass.io](/hassio/) has its own schedule for release it doesn't make sense to use this binary sensor on Hass.io. -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/blob/dev/homeassistant/components/updater.py#L91). +The updater 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/blob/dev/homeassistant/components/updater.py#L91). ## Configuration @@ -59,12 +59,14 @@ For an added bonus, an automation integration can be created to send a message w ```yaml # Example configuration.yaml entry automation: - alias: 'Update Available Notifications' + alias: Update Available Notification trigger: - platform: state - entity_id: updater.updater + - platform: state + entity_id: binary_sensor.updater + from: 'off' + to: 'on' action: - service: notify.notify - data: - message: 'Update for Home Assistant is available.' + - service: notify.notify + data: + message: 'Update for Home Assistant is available.' ``` From 7308f30d054eaea3a46ad39a33e373a091868e5c Mon Sep 17 00:00:00 2001 From: Jeff Irion Date: Mon, 12 Aug 2019 23:53:02 -0700 Subject: [PATCH 061/126] Add info about customizing entity_picture for a person (#10120) * Add info about customizing entity_picture for a person * Add ':', change JPG to jpg * Add link to the customizing entities page --- source/_components/person.markdown | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/source/_components/person.markdown b/source/_components/person.markdown index 8c523124714..515c3989d41 100644 --- a/source/_components/person.markdown +++ b/source/_components/person.markdown @@ -86,3 +86,15 @@ person: - device_tracker.stacey - device_tracker.beacon ``` + +### Customizing the picture for a person + +By following the instructions on the [customizing entities](/docs/configuration/customizing-devices#entity_picture) page, you can customize the picture used for a person entity in the `customize:` section of your configuration. For example: + +```yaml +customize: + person.ada6789: + entity_picture: "/local/ada.jpg" +``` + +See the documentation about [hosting files](/components/http/#hosting-files) for more information about the `www` folder. From 089dc3fe07fc071c11218b4240b456a74a68de41 Mon Sep 17 00:00:00 2001 From: Dubh Ad Date: Tue, 13 Aug 2019 15:34:44 +0100 Subject: [PATCH 062/126] Clarity edit about `websocket-client` (#10129) The constant references to installing the Python package causes confusion for Hass.io and Docker users, breaking these out. --- source/_components/samsungtv.markdown | 55 ++++++++++++++++++++------- 1 file changed, 41 insertions(+), 14 deletions(-) diff --git a/source/_components/samsungtv.markdown b/source/_components/samsungtv.markdown index cc32df32043..e62de8ebff5 100644 --- a/source/_components/samsungtv.markdown +++ b/source/_components/samsungtv.markdown @@ -33,7 +33,7 @@ host: required: true type: string port: - description: The port of the Samsung Smart TV. If set to 8001, the new websocket connection will be used (required for 2016+ TVs). + description: The port of the Samsung Smart TV. If set to 8001, the new websocket connection will be used (required for 2016+ TVs) - for installs other than Hass.io or Docker you may need to install a Python package, see below. required: false type: integer default: 55000 @@ -77,23 +77,23 @@ Currently known supported models: - K5579 (port must be set to 8001, On/Off, Forward/Backward, Volume control, but no Play button) - K5600AK (partially supported, turn on works but state is not updated) - K6500AF (port must be set to 8001) -- KS7005 (port must be set to 8001, and `pip3 install websocket-client` must be executed, MAC address must be provided, On/Off, Volume are OK, no channel change) -- KS7502 (port must be set to 8001, and `pip3 install websocket-client` must be executed, turn on doesn't work, turn off works fine) -- KS8000 (port must be set to 8001, and `pip3 install websocket-client` must be executed) -- KS8005 (port must be set to 8001, and `pip3 install websocket-client` must be executed) -- KS8500 (port must be set to 8001, and `pip3 install websocket-client` must be executed) -- KU6020 (port must be set to 8001, and `pip3 install websocket-client` must be executed) -- KU6100 (port must be set to 8001, and `pip3 install websocket-client` must be executed) +- KS7005 (port must be set to 8001, MAC address must be provided, On/Off, Volume are OK, no channel change) +- KS7502 (port must be set to 8001, turn on doesn't work, turn off works fine) +- KS8000 (port must be set to 8001) +- KS8005 (port must be set to 8001) +- KS8500 (port must be set to 8001) +- KU6020 (port must be set to 8001) +- KU6100 (port must be set to 8001) - KU6290 (port must be set to 8001) -- KU6400U (port must be set to 8001, and `pip3 install websocket-client` must be executed) +- KU6400U (port must be set to 8001) - KU7000 (port must be set to 8001) -- M5620 (port must be set to 8001, and `pip3 install websocket-client` must be executed) -- MU6170UXZG (port must be set to 8001, and `pip3 install websocket-client` must be executed) +- M5620 (port must be set to 8001) +- MU6170UXZG (port must be set to 8001) - NU7090 (port must be set to 8801, On/Off, MAC must be specified for Power On) -- NU7400 (port set to 8001 and `pip3 install websocket-client` executed) +- NU7400 (port set to 8001) - NU8000 - U6000 (port must be set to 8001) -- U6300 (port must be set to 8001, and `pip3 install websocket-client` must be executed) +- U6300 (port must be set to 8001) - UE6199UXZG (port must be set to 8001, On/Off, Forward/Backward, Volume control, but no Play button) - UE65KS8005 (port must be set to 8001, On/Off, Forward/Backward, Volume are OK, but no Play button) - UE49KU6470 (port must be set to 8001, On/Off, Forward/Backward, Volume are OK, but no Play button) @@ -112,7 +112,7 @@ Currently tested but not working models: - JU7000 - Unable to see state and unable to control (but port 8001 *is* open) - JU7500 - Unable to see state and unable to control - MU6125 - Unable to see state and unable to control (Tested on UE58MU6125 on port 8001 and 8801) -- MU6300 - Port set to 8001, `pip3 install websocket-client` must be executed, turning on works, status not working reliably, turning off is not permanent (it comes back on) +- MU6300 - Port set to 8001, turning on works, status not working reliably, turning off is not permanent (it comes back on) - Q7F - State is always "off" and unable to control via port 8001. None of the 2014 (H) and 2015 (J) model series (e.g., J5200) will work, since Samsung have used a different (encrypted) type of interface for these. @@ -134,3 +134,30 @@ with the following payload: ``` Currently the ability to select a source is not implemented. + +### Hass.io + +No additional actions are required + +### Docker + +No additional actions are required + +### Hassbian + +You will need to activate the venv and install the websocket library: + +```bash +$ sudo -u homeassistant -H -s +$ source /srv/homeassistant/bin/activate +$ pip3 install websocket-client +``` +### Other install methods + +You will need to install the `websocket-client` Python package in your Home Assistant install. This will probably be done with: + +```bash +$ pip3 install websocket-client +``` + +Remembering to activate your venv if you're using a venv install. From 9369061cb2394dc1dbd0d73a57fe02eeaaba24d0 Mon Sep 17 00:00:00 2001 From: emilgil <40168194+emilgil@users.noreply.github.com> Date: Tue, 13 Aug 2019 16:46:37 +0200 Subject: [PATCH 063/126] Update twitter.markdown (#10128) Twitter has new regulations in place regarding their developer accounts and API access, all applications for dev-accounts are handled manually which can take several weeks even if the application is filled in correctly. --- source/_components/twitter.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/twitter.markdown b/source/_components/twitter.markdown index e710baf500a..8b3296a21c6 100644 --- a/source/_components/twitter.markdown +++ b/source/_components/twitter.markdown @@ -14,7 +14,7 @@ The `twitter` notification platform uses [Twitter](https://twitter.com) to deliv ## Setup -Go to [Twitter Apps](https://apps.twitter.com/app/new) and create an application. Visit "Keys and Access Tokens" of the application to get the details (Consumer Key, Consumer Secret, Access Token and Access Token Secret which needs to be generated). +Make sure you have a developer account registered with Twitter, then go to [Twitter Apps](https://apps.twitter.com/app/new) and create an application. If you don't have a developer account you need to apply for one, it can take some time to get approved. Visit "Keys and Access Tokens" of the application to get the details (Consumer Key, Consumer Secret, Access Token and Access Token Secret which needs to be generated). ## Configuration From fbbd00cbcf596a67f528a3428f0564620b9fd99e Mon Sep 17 00:00:00 2001 From: Jonathan Weinberg Date: Tue, 13 Aug 2019 15:07:49 -0400 Subject: [PATCH 064/126] small typo (#10132) lowercase `F` for `false` --- source/_components/homekit.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/homekit.markdown b/source/_components/homekit.markdown index 64ef560e215..5ad244ef746 100644 --- a/source/_components/homekit.markdown +++ b/source/_components/homekit.markdown @@ -248,7 +248,7 @@ In some cases it might be desirable to check that all entities are available bef ```yaml # Example checking specific entities to be available before start homekit: - auto_start: False + auto_start: false automation: - alias: 'Start HomeKit' From 8e3445d62267e9f968d776bb28834c12e030a6dd Mon Sep 17 00:00:00 2001 From: jbrody17 Date: Tue, 13 Aug 2019 15:21:13 -0400 Subject: [PATCH 065/126] Thermostat sensor changed from hvac_mode to hvac_state (#10133) --- source/_components/nest.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/nest.markdown b/source/_components/nest.markdown index 7df45246460..0874daf4f25 100644 --- a/source/_components/nest.markdown +++ b/source/_components/nest.markdown @@ -313,7 +313,7 @@ The following conditions are available by device: - preset\_mode - temperature - target - - hvac\_mode: The currently active state of the HVAC system, `heat`, `cool` or `off` (previously `heating`, `cooling` or `off`). + - hvac\_state: The currently active state of the HVAC system, `heat`, `cool` or `off` (previously `heating`, `cooling` or `off`). - Nest Protect: - co\_status: `Ok`, `Warning` or `Emergency` - smoke\_status: `Ok`, `Warning` or `Emergency` From 74f49ab44298640e58b8d9a4a99454258fdf7c9a Mon Sep 17 00:00:00 2001 From: HUANG da Date: Fri, 16 Aug 2019 02:31:12 +0900 Subject: [PATCH 066/126] Update aquostv.markdown (#10135) --- source/_components/aquostv.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_components/aquostv.markdown b/source/_components/aquostv.markdown index df895237204..5e87d5fd04a 100644 --- a/source/_components/aquostv.markdown +++ b/source/_components/aquostv.markdown @@ -74,5 +74,6 @@ Currently known supported models: - LC-60LE857U - LC-60EQ10U - LC-60SQ15U +- LC-50US40 (no volume control, not fully tested) If your model is not on the list then give it a test, if everything works correctly then add it to the list on [GitHub](https://github.com/home-assistant/home-assistant.io/blob/current/source/_components/aquostv.markdown). From 8b308dbdd5488a9927ef5d3c33a12c3de867883d Mon Sep 17 00:00:00 2001 From: Ermanno Baschiera Date: Thu, 15 Aug 2019 20:35:48 +0200 Subject: [PATCH 067/126] fix quotes in example code (#10142) --- source/_components/alert.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/alert.markdown b/source/_components/alert.markdown index 2097ba258c8..1791e897d33 100644 --- a/source/_components/alert.markdown +++ b/source/_components/alert.markdown @@ -153,7 +153,7 @@ binary_sensor: - platform: template sensors: motion_battery_low: - value_template: '{{ state_attr('sensor.motion', 'battery') < 15 }}' + value_template: "{{ state_attr('sensor.motion', 'battery') < 15 }}" friendly_name: 'Motion battery is low' alert: From 08d831676becac089754909ef84ba91bb80b5b47 Mon Sep 17 00:00:00 2001 From: Jon Evans Date: Thu, 15 Aug 2019 21:50:09 +0100 Subject: [PATCH 068/126] Add note about BASE_URL format (#10143) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Hopefully others can learn from my frustration. 😄 --- source/_components/alexa.smart_home.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/alexa.smart_home.markdown b/source/_components/alexa.smart_home.markdown index f3618932853..b93b05bd19f 100644 --- a/source/_components/alexa.smart_home.markdown +++ b/source/_components/alexa.smart_home.markdown @@ -99,7 +99,7 @@ Next you need create a Lambda function. - Click your Lambda Function icon in the middle of the diagram, scroll down you will see a `Function code` window. - Clear the example code, copy the Python script from: (modified code to support Alexa's proactive mode, see details below) - Scroll down a little bit, you will find `Environment variables`, you need add 4 environment variables: - * BASE_URL *(required)*: your Home Assistant instance's Internet accessible URL with port if need + * BASE_URL *(required)*: your Home Assistant instance's Internet accessible URL with port if needed. *Do not include the trailing `/`*. * NOT_VERIFY_SSL *(optional)*: you can set it to *True* to ignore the SSL issue, if you don't have a valid SSL certificate or you are using self-signed certificate. * DEBUG *(optional)*: set to *True* to log the debug message * LONG_LIVED_ACCESS_TOKEN *(optional, not recommend)*: you will connect your Alexa Smart Home skill with your Home Assistant user account in the later steps, so that you don't need to use long-lived access token here. However, the access token you got from login flow is only valid for 30 minutes. It will be hard for you to test lambda function with the access token in test data. So for your convinces, you can remove the access token from the test data, [generate a long-lived access token][generate-long-lived-access-token] put here, then the function will fall back to read token from environment variables. (tips: You did not enable the security storage for your environment variables, so your token saved here is not that safe. You should only use it for debugging and testing purpose. You should remove and delete the long-lived access token after you finish the debugging.) From 7635135fd928190575cbccedc7cb8a1760974d10 Mon Sep 17 00:00:00 2001 From: Anders Melchiorsen Date: Fri, 16 Aug 2019 00:59:29 +0200 Subject: [PATCH 069/126] Add netgear_lte.disconnect_lte (#10144) --- source/_components/netgear_lte.markdown | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/source/_components/netgear_lte.markdown b/source/_components/netgear_lte.markdown index 5905d2950b8..e264c4dfbb2 100644 --- a/source/_components/netgear_lte.markdown +++ b/source/_components/netgear_lte.markdown @@ -148,6 +148,14 @@ This service asks the modem to establish its LTE connection, useful if the modem | ---------------------- | -------- | ----------- | | `host` | yes | The modem that should connect (optional when just one modem is configured). +### Service `netgear_lte.disconnect_lte` + +This service asks the modem to close its LTE connection. + +| Service data attribute | Optional | Description | +| ---------------------- | -------- | ----------- | +| `host` | yes | The modem that should disconnect (optional when just one modem is configured). + ### Service `netgear_lte.delete_sms` The integration makes a service available to delete messages from the modem inbox. This can be used to clean up after incoming SMS events. From e5261577e996481e33c03516dbc716d816d91c1a Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Thu, 15 Aug 2019 21:59:20 -0700 Subject: [PATCH 070/126] Add HA Cast promo --- source/images/frontpage/cast-frontpage.png | Bin 0 -> 19608 bytes source/index.html | 11 +++++++++++ 2 files changed, 11 insertions(+) create mode 100644 source/images/frontpage/cast-frontpage.png diff --git a/source/images/frontpage/cast-frontpage.png b/source/images/frontpage/cast-frontpage.png new file mode 100644 index 0000000000000000000000000000000000000000..e94ce24913c5c2a34a274d14518f90b2116f8db6 GIT binary patch literal 19608 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 TEl|Xa00000NkvXXu0mjfQgwv0 literal 0 HcmV?d00001 diff --git a/source/index.html b/source/index.html index 4f6349ff5a8..a736d8601cb 100644 --- a/source/index.html +++ b/source/index.html @@ -48,6 +48,17 @@ description: Open source home automation that puts local control and privacy fir Read our founder's vision for the perfect home automation + + +
+
Take over all the screens
+
Home Assistant Cast makes each TV a display.
+
+
From 1b2f4058e965737c78e48ddaceb7dbc7d18d008c Mon Sep 17 00:00:00 2001 From: Dubh Ad Date: Fri, 16 Aug 2019 18:04:46 +0100 Subject: [PATCH 071/126] Markdown fix (#10154) * Markdown fix Fixing the markdown * Fix --- source/_docs/z-wave/controllers.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_docs/z-wave/controllers.markdown b/source/_docs/z-wave/controllers.markdown index b82dddb5f69..b9fafaac92e 100644 --- a/source/_docs/z-wave/controllers.markdown +++ b/source/_docs/z-wave/controllers.markdown @@ -7,11 +7,11 @@ description: "Extended instructions how to setup Z-Wave." You need to have a compatible Z-Wave stick or module installed. This needs to be a *static controller*, which most Z-Wave sticks and modules will be. If yours is a *bridge* device then it won't work with [OpenZWave](http://openzwave.com/), which is what provides Home Assistant's Z-Wave capabilities. The following devices have been confirmed to work: -

- +

+ There have [been reports](https://www.raspberrypi.org/forums/viewtopic.php?f=28&t=245031#p1502030) of the Aeotec stick not working on the Raspberry Pi 4. -

+
* Aeotec Z-Stick Series 5 * Everspring USB stick - Gen 5 From dd622430ce0c9a44949abf2ad531fef97ea4fc1e Mon Sep 17 00:00:00 2001 From: J <49540618+Tediore@users.noreply.github.com> Date: Fri, 16 Aug 2019 12:09:51 -0500 Subject: [PATCH 072/126] Add note about purge_keep_days (#10152) The purge_keep_days variable in the recorder component limits the max duration of a history stats sensor. This might not be clear to some users. --- source/_components/history_stats.markdown | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/source/_components/history_stats.markdown b/source/_components/history_stats.markdown index fa23b01dd0f..68b05276c75 100644 --- a/source/_components/history_stats.markdown +++ b/source/_components/history_stats.markdown @@ -119,6 +119,12 @@ duration: minutes: 30 ``` +
+ + If the duration exceeds the number of days of history stored by the `recorder` component (`purge_keep_days`), the history statistics sensor will not have all the information it needs to look at the entire duration. For example, if `purge_keep_days` is set to 7, a history statistics sensor with a duration of 30 days will only report a value based on the last 7 days of history. + +
+ ### Examples Here are some examples of periods you could work with, and what to write in your `configuration.yaml`: From d4100e1703329ab8b9a42c4b1493586c98da4035 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Fri, 16 Aug 2019 10:10:31 -0700 Subject: [PATCH 073/126] Update PR template (#10147) --- .github/PULL_REQUEST_TEMPLATE.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index 1b5db6f56d7..439b1e26c04 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -1,11 +1,11 @@ **Description:** -**Pull request in [home-assistant](https://github.com/home-assistant/home-assistant) (if applicable):** home-assistant/home-assistant# +**Pull request in home-assistant (if applicable):** home-assistant/home-assistant# ## Checklist: -- [ ] Branch: `next` is for changes and new documentation that will go public with the next [home-assistant](https://github.com/home-assistant/home-assistant) release. Fixes, changes and adjustments for the current release should be created against `current`. +- [ ] Branch: `next` is for changes and new documentation that will go public with the next Home Assistant release. Fixes, changes and adjustments for the current release should be created against `current`. - [ ] The documentation follows the [standards][standards]. [standards]: https://developers.home-assistant.io/docs/documentation_standards.html From 40376bf80eb48312d33a035c2e509a2c8a35e232 Mon Sep 17 00:00:00 2001 From: Jc2k Date: Fri, 16 Aug 2019 18:31:30 +0100 Subject: [PATCH 074/126] homekit_controller updates + troubleshooting (#10153) * homekit_controller updates * Minor changes --- .../_components/homekit_controller.markdown | 61 +++++++++++++++++-- 1 file changed, 57 insertions(+), 4 deletions(-) diff --git a/source/_components/homekit_controller.markdown b/source/_components/homekit_controller.markdown index a3454c71fb4..8d182278ccf 100644 --- a/source/_components/homekit_controller.markdown +++ b/source/_components/homekit_controller.markdown @@ -1,6 +1,6 @@ --- title: "HomeKit controller support" -description: "Instructions how to integrate your HomeKit devices within Home Assistant." +description: "Instructions for how to integrate your HomeKit devices within Home Assistant." logo: apple-homekit.png ha_category: - Hub @@ -24,7 +24,13 @@ redirect_from: - /components/sensor.homekit_controller/ --- -[HomeKit](https://developer.apple.com/homekit/) controller integration for Home Assistant allows you to connect HomeKit accessories to Home Assistant. This integration should not be confused with the [HomeKit](/components/homekit/) integration, which allows you to control Home Assistant devices via HomeKit. +The [HomeKit](https://developer.apple.com/homekit/) controller integration allows you to use accessories with the "Works with HomeKit" logo with Home Assistant. This integration should not be confused with the [HomeKit](/components/homekit/) integration, which allows you to control Home Assistant devices via HomeKit. + +The integration will automatically detect HomeKit compatible devices that are ready to pair if the [`zeroconf`](/components/zeroconf/) integration is enabled. This is enabled by default on new installations via the [`default_config`](/components/default_config/) component. + +To see which devices have been discovered see the "Integrations" page in your Home Assistant dashboard. When you click on "Configure" you can enter your HomeKit PIN and the device should be added to your Home Assistant instance. If your device is currently paired with an Apple device via HomeKit, you will need to reset it in order to pair it with Home Assistant. Once Home Assistant is configured to work with the device, you can export it back to Siri and Apple Home with the [`HomeKit`](/components/homekit/) integration. + +## Supported devices There is currently support for the following device types within Home Assistant: @@ -37,6 +43,53 @@ There is currently support for the following device types within Home Assistant: - Binary Sensor (HomeKit motion sensors and contact sensors) - Sensor (HomeKit humidity, temperature, co2 and light level sensors) -The integration will be automatically configured if the [`discovery`](/components/discovery/) integration is enabled. +HomeKit IP accessories for these device types may work with some caveats: -For each detected HomeKit accessory, a configuration prompt will appear in the web front end. Use this to provide the HomeKit PIN. Note that HomeKit accessories can only be paired to one device at once. If your device is currently paired with Siri, you will need to reset it in order to pair it with Home Assistant. Once Home Assistant is configured to work with the device, you can export it back to Siri with the [`HomeKit`](/components/homekit/) integration. +- If the device is WiFi based and has no physical controls or screen then you may need an Apple HomeKit device like an iPhone or iPad to get the accessory onto your WiFi network. For example, for a Koogeek LS1 you must add the accessory to HomeKit on your iOS device, then remove it from the iOS device. This leaves the LS1 in an unpaired state but still on your WiFi. Then Home Assistant can find it and pair with it. +- You need to know the HomeKit PIN. There is no way to recover this if you do not have it. You will need to contact the manufacturer to see what options you have. + +Home Assistant does not currently support HomeKit BLE. + +## Troubleshooting + +### I don't have a HomeKit PIN + +When you buy a certified HomeKit enabled device the PIN maybe with the instructions or on a sticker on the side or under the accessory. + +Devices with screens like thermostats may not have PIN codes in the packaging at all. Every time you click on "Configure" in the Home Assistant front end your accessory will generate a new pairing code and show it on the display. + +If your device doesn't have a display and got HomeKit support after it was released you may not have a pairing code. Dealing with this is manufacturer specific. Some manufacturers allow you to see the pairing code in their iOS app. Others force you to use their app to configure HomeKit and don't let you have the pairing pin - right now you won't be able to use HomeKit controller with those devices. + +If you have lost your PIN code then you may not be able to repair your accessory. You should contact the manufacturer to see if there is anything you can do. + +### My accessory isn't updating straight away + +This is normal - HomeKit controller is currently a local polling based integration. It polls your accessory for its latest state once a minute. + +### Home Assistant cannot discover my device + +For IP accessories, Home Assistant can only find devices that are already on the same network as your device. If an accessory is WiFi based and has no user interface for joining it to your Wifi network you will need an Apple HomeKit controller device (an iPhone or iPad). You should pair it with the controller and then remove the pairing in the UI (but do not reset the accessory itself). This will leave the accessory on your WiFi network but in an unpaired state, and then Home Assistant can find it. + +Home Assistant can only find accessories that aren't already paired. Even if you reset your Home Assistant configuration the accessory will still think it is paired and you won't be able to use it with Home Assistant. You should reset the accessory according to the manufacturer instructions. Some devices have a "Reset HomeKit" option, and some may require a full reset. + +### HomeKit controller is finding devices on my network even though I don't have any Apple device + +This is completely normal. Unlike many other commercial IoT offerings the HomeKit protocol is a local and offline protocol that does not rely on the Apple ecosystem to function. You do not need an Apple online account to use a "Works with HomeKit" device. Some WiFi devices may need an iOS briefly to get them onto your WiFi but other than that you do not need any Apple hardware on your network either. + +Many IoT devices are getting a post-launch HomeKit upgrade. This might mean your device starts showing in Home Assistant as a `homekit_controller` device even though when you bought it without HomeKit support. If maybe this is a better choice for you than a native integration. For example, a lot of climate devices have an online-only API and a HomeKit API. The HomeKit one might not expose all of the settings and controls you are used to but won't break if your internet connection goes down or the cloud service goes away. + +### I have a warning in my logs about HomeKit controller skipping updates + +You may say a log entry that looks like this: + +```log +HomeKit controller update skipped as previous poll still in flight +``` + +In these cases it's unlikely that HomeKit controller itself is directly responsible. This is a safety feature to avoid overloading your HomeAssistant instance. It means that Home Assistant tried to poll your accessory but the previous poll was still happening. This means it is taking over 1 minute to poll your accessory. This could be caused by a number of things: + +- You have too many blocking synchronous integrations for your Home Assistant instance. All synchronous integrations share a thread pool and if there are lots of tasks to run on it they will queued, causing delays. In the worst cases this queue can build up faster than it can be emptied. Faster hardware may help, but you may need to disable some integrations. +- Your network connection to an accessory is poor and HomeKit controller is unable to reach the accessory reliably. This will likely require a change to your network setup to improve WiFi coverage or replace damaged cabling etc. +- There is a problem with the actual accessory and this may be causing intermittent network issues. + +In these cases HomeKit controller will skip polling to avoid a build up of back pressure in your instance. From c8f5a564e89b02585db6c7ac105e200c76baaacc Mon Sep 17 00:00:00 2001 From: Keith Pine Date: Fri, 16 Aug 2019 10:32:14 -0700 Subject: [PATCH 075/126] Remove update_config from zwave services (#10139) --- source/_docs/z-wave/services.markdown | 1 - 1 file changed, 1 deletion(-) diff --git a/source/_docs/z-wave/services.markdown b/source/_docs/z-wave/services.markdown index 80290954c88..a6014382cb9 100644 --- a/source/_docs/z-wave/services.markdown +++ b/source/_docs/z-wave/services.markdown @@ -31,7 +31,6 @@ The `zwave` integration exposes multiple services to help maintain the network. | stop_network | Stops the Z-Wave network. | | test_network | Tells the controller to send no-op commands to each node and measure the time for a response. In theory, this can also bring back nodes which have been marked "presumed dead." | | test_node | Tells the controller to send no-op command(s) to a specific node. Requires `node_id` field. You can specify amount of test_messages to send by specifying it with `messages` field. In theory, this could bring back nodes marked as "presumed dead" -| update_config | Attempt to update OZW configuration files from git to support newer devices. After you run this, wait a few minutes then stop Home Assistant. You can now back up your `zwcfg_*.xml` file, then delete the relevant entries from your `zwcfg_*.xml` (between and including `` and ``), and finally start Home Assistant. | The `soft_reset` and `heal_network` commands can be used to help keep a Z-Wave network running reliably. This is a configuration option for the `zwave` component. The option defaults to `false` but can be enabled by setting `autoheal` to true. This, however, is bad practice since it introduces overhead that can be avoided since you only need to do a `heal_network` whenever one of the following actions are done: From 9490bf4665026fd2fc92ff54c384c820146d879f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ab=C3=ADlio=20Costa?= Date: Fri, 16 Aug 2019 18:32:45 +0100 Subject: [PATCH 076/126] edp_redy: remove component (#10145) The service has moved to a new portal and the previous API does not work anymore. --- source/_components/edp_redy.markdown | 45 ---------------------------- 1 file changed, 45 deletions(-) delete mode 100644 source/_components/edp_redy.markdown diff --git a/source/_components/edp_redy.markdown b/source/_components/edp_redy.markdown deleted file mode 100644 index a1a8347af11..00000000000 --- a/source/_components/edp_redy.markdown +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: "EDP re:dy" -description: "Instructions on how to integrate the EDP re:dy platform into Home Assistant." -logo: edp_redy.png -ha_category: - - Hub - - Sensor - - Switch -ha_release: 0.79 -ha_iot_class: Cloud Polling -redirect_from: - - /components/sensor.edp_redy/ - - /components/switch.edp_redy/ ---- - -[EDP re:dy](https://www.edp.pt/particulares/servicos/redy/) is a Home Automation platform from Portuguese energy provider EDP, that allows control of appliances and other devices, as well as monitoring power consumption. This integration allows integrating EDP re:dy into Home Assistant. - -## Configuration - -You will need your re:dy login information (username and password) to use this component. - -To set it up, add the following to your `configuration.yaml` file: - -```yaml -# Example configuration.yaml entry -edp_redy: - username: YOUR_USERNAME - password: YOUR_PASSWORD -``` - -{% configuration %} -username: - description: The username for accessing your re:dy account. - required: true - type: string -password: - description: The password for accessing your re:dy account. - required: true - type: string -{% endconfiguration %} - -After configuring the component, it will automatically add to Home Assistant: - -* A switch per toggleable device (switch, plug, etc). -* A sensor per each device that reports power consumption (SmartMeter, plug, meter) From 683b24663266c2626950f9c57c535c1ee2ebbd27 Mon Sep 17 00:00:00 2001 From: Twan Coenraad Date: Fri, 16 Aug 2019 19:34:45 +0200 Subject: [PATCH 077/126] Add OTGW domestic hot water enable option as service (#10105) --- source/_components/opentherm_gw.markdown | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/source/_components/opentherm_gw.markdown b/source/_components/opentherm_gw.markdown index f410e61d6d9..39fb93c00ea 100644 --- a/source/_components/opentherm_gw.markdown +++ b/source/_components/opentherm_gw.markdown @@ -108,6 +108,19 @@ Please read [this information](http://otgw.tclcode.com/standalone.html) from the
+### Service `opentherm_gw.set_hot_water_ovrd` + +Set the domestic hot water enable option on the OpenTherm Gateway. +Control the domestic hot water enable option. If the boiler has +been configured to let the room unit control when to keep a +small amount of water preheated, this command can influence +that. + +| Service data attribute | Optional | Description | +| ---------------------- | -------- | ----------- | +| `gateway_id` | no | The `gateway_id` as specified in `configuration.yaml`. +| `dhw_override` | no | The domestic hot water override state. Value should be 0 or 1 to enable the override in off or on state, or "A" to disable the override. + ### Service `opentherm_gw.set_gpio_mode` Configure the GPIO behavior on the OpenTherm Gateway. From 8acebed618de3b34b79d2babc15195a34785edf1 Mon Sep 17 00:00:00 2001 From: akasma74 Date: Fri, 16 Aug 2019 20:38:51 +0300 Subject: [PATCH 078/126] add record service to the list of services (#10137) and rearranged services alphabetically --- source/_components/camera.markdown | 114 ++++++++++++++--------------- 1 file changed, 57 insertions(+), 57 deletions(-) diff --git a/source/_components/camera.markdown b/source/_components/camera.markdown index 1ba029c33f7..03eb5bd36c7 100644 --- a/source/_components/camera.markdown +++ b/source/_components/camera.markdown @@ -26,7 +26,23 @@ This option will keep the stream alive, and preload the feed on Home Assistant s Once loaded, the `camera` platform will expose services that can be called to perform various actions. -Available services: `turn_on`, `turn_off`, `enable_motion_detection`, `disable_motion_detection`, `snapshot`, and `play_stream`. +Available services: `enable_motion_detection`, `disable_motion_detection`, `play_stream`, `record`, `snapshot`, `turn_off` and `turn_on`. + +#### Service `enable_motion_detection` + +Enable the motion detection in a camera. + +| Service data attribute | Optional | Description | +| ---------------------- | -------- | ----------- | +| `entity_id` | yes | Name(s) of entities to enable motion detection, e.g., `camera.living_room_camera`. | + +#### Service `disable_motion_detection` + +Disable the motion detection in a camera. + +| Service data attribute | Optional | Description | +| ---------------------- | -------- | ----------- | +| `entity_id` | yes | Name(s) of entities to disable motion detection, e.g., `camera.living_room_camera`. | #### Service `play_stream` @@ -48,61 +64,6 @@ action: media_player: media_player.chromecast ``` -#### Service `turn_on` - -Turn on camera. Not all camera models support this service, please consult individual camera page. - -| Service data attribute | Optional | Description | -| ---------------------- | -------- | ----------- | -| `entity_id` | yes | Name(s) of entities to turn on, e.g., `camera.living_room_camera`. | - -#### Service `turn_off` - -Turn off camera. Not all camera models support this service, please consult individual camera page. - -| Service data attribute | Optional | Description | -| ---------------------- | -------- | ----------- | -| `entity_id` | yes | Name(s) of entities to turn off, e.g., `camera.living_room_camera`. | - -#### Service `enable_motion_detection` - -Enable the motion detection in a camera. - -| Service data attribute | Optional | Description | -| ---------------------- | -------- | ----------- | -| `entity_id` | yes | Name(s) of entities to enable motion detection, e.g., `camera.living_room_camera`. | - -#### Service `disable_motion_detection` - -Disable the motion detection in a camera. - -| Service data attribute | Optional | Description | -| ---------------------- | -------- | ----------- | -| `entity_id` | yes | Name(s) of entities to disable motion detection, e.g., `camera.living_room_camera`. | - -#### Service `snapshot` - -Take a snapshot from a camera. - -| Service data attribute | Optional | Description | -| ---------------------- | -------- | ----------- | -| `entity_id` | no | Name(s) of entities to create a snapshot from, e.g., `camera.living_room_camera`. | -| `filename` | no | Template of a file name. Variable is `entity_id`, e.g., {% raw %}`/tmp/snapshot_{{ entity_id }}`{% endraw %}. | - -The path part of `filename` must be an entry in the `whitelist_external_dirs` in your [`homeassistant:`](/docs/configuration/basic/) section of your `configuration.yaml` file. - -For example, the following action in an automation would take a snapshot from "yourcamera" and save it to /tmp with a timestamped filename. - -{% raw %} -```yaml -action: - service: camera.snapshot - data: - entity_id: camera.yourcamera - filename: '/tmp/yourcamera_{{ now().strftime("%Y%m%d-%H%M%S") }}.jpg' -``` -{% endraw %} - #### Service `record` Make a `.mp4` recording from a camera stream. Requires `stream` integration to be set up. @@ -130,6 +91,45 @@ action: ``` {% endraw %} +#### Service `snapshot` + +Take a snapshot from a camera. + +| Service data attribute | Optional | Description | +| ---------------------- | -------- | ----------- | +| `entity_id` | no | Name(s) of entities to create a snapshot from, e.g., `camera.living_room_camera`. | +| `filename` | no | Template of a file name. Variable is `entity_id`, e.g., {% raw %}`/tmp/snapshot_{{ entity_id }}`{% endraw %}. | + +The path part of `filename` must be an entry in the `whitelist_external_dirs` in your [`homeassistant:`](/docs/configuration/basic/) section of your `configuration.yaml` file. + +For example, the following action in an automation would take a snapshot from "yourcamera" and save it to /tmp with a timestamped filename. + +{% raw %} +```yaml +action: + service: camera.snapshot + data: + entity_id: camera.yourcamera + filename: '/tmp/yourcamera_{{ now().strftime("%Y%m%d-%H%M%S") }}.jpg' +``` +{% endraw %} + +#### Service `turn_off` + +Turn off camera. Not all camera models support this service, please consult individual camera page. + +| Service data attribute | Optional | Description | +| ---------------------- | -------- | ----------- | +| `entity_id` | yes | Name(s) of entities to turn off, e.g., `camera.living_room_camera`. | + +#### Service `turn_on` + +Turn on camera. Not all camera models support this service, please consult individual camera page. + +| Service data attribute | Optional | Description | +| ---------------------- | -------- | ----------- | +| `entity_id` | yes | Name(s) of entities to turn on, e.g., `camera.living_room_camera`. | + ### Test if it works A simple way to test if you have set up your `camera` platform correctly, is to use service developer tool icon **Services** from the **Developer Tools**. Choose your service from the dropdown menu **Service**, enter something like the sample below into the **Service Data** field, and hit **CALL SERVICE**. @@ -138,4 +138,4 @@ A simple way to test if you have set up your `camera` platform correctly, is to { "entity_id": "camera.living_room_camera" } -``` \ No newline at end of file +``` From 9b6abcc93343198a587eb975f458e25308615baf Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Fri, 16 Aug 2019 10:39:23 -0700 Subject: [PATCH 079/126] Document ecobee attributes (#10146) --- source/_components/ecobee.markdown | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/source/_components/ecobee.markdown b/source/_components/ecobee.markdown index 004ac5f2633..2f02b20e83d 100644 --- a/source/_components/ecobee.markdown +++ b/source/_components/ecobee.markdown @@ -140,6 +140,17 @@ The _HVAC mode_ of the device is the currently active operational modes that the Ecobee thermostat provides: heat, auxHeatOnly, cool, auto, and off. +## Attributes + +The Ecobee climate entity has some extra attributes to represent the state of the thermostat. + +| Name | Description | +| ---- | ----------- | +| `fan` | If the fan is currently on or off: `on` / `off`. +| `climate_mode` | This is the climate mode that is active, or would be active if no override is active. +| `equipment_running` | This is a comma seperated list of equipment that is currently running. +| `fan_min_on_time` | The minimum amount of minutes that the fan will be on when it's turned on. + ## Services Besides the standard services provided by the Home Assistant [Climate](https://www.home-assistant.io/components/climate/) integration, the following extra service is provided by the Ecobee Thermostat: `resume_program`. From 811cb61520c00374db1fc7a89f5979e9469868ee Mon Sep 17 00:00:00 2001 From: Andrew Chatham Date: Fri, 16 Aug 2019 10:39:44 -0700 Subject: [PATCH 080/126] Document Lutron Powr Savr occupancy sensor support (#10110) * Document Lutron Powr Savr occupancy sensor support * Minor change --- source/_components/lutron.markdown | 3 +++ 1 file changed, 3 insertions(+) diff --git a/source/_components/lutron.markdown b/source/_components/lutron.markdown index f905a6c2b8e..c88bd94505d 100644 --- a/source/_components/lutron.markdown +++ b/source/_components/lutron.markdown @@ -75,3 +75,6 @@ The Lutron scene platform allows you to control scenes programmed into your SeeT After setup, scenes will appear in Home Assistant using the area, keypad and button name. +## Occupancy Sensors + +Any configured Powr Savr occuancy sensors will be added as occupancy binary sensors. Lutron reports occupancy for an area, rather than reporting individual sensors. Sensitivity and timeouts are controlled on the sensors themselves, not in software. From 0f3b7c1a31756e2801782ae4c4248b1267ae3b1e Mon Sep 17 00:00:00 2001 From: zhumuht <40521367+zhumuht@users.noreply.github.com> Date: Sat, 17 Aug 2019 01:40:01 +0800 Subject: [PATCH 081/126] add retry option description for broadlink (#10150) * add retry option description for broadlink * Add default --- source/_components/broadlink.markdown | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/source/_components/broadlink.markdown b/source/_components/broadlink.markdown index ff8b32e040e..c0bbc2c2b39 100644 --- a/source/_components/broadlink.markdown +++ b/source/_components/broadlink.markdown @@ -149,6 +149,11 @@ timeout: description: Timeout in seconds for the connection to the device. required: false type: integer +retry: + description: Retry times for fetch data if failed. + required: false + type: integer + default: 2 friendly_name: description: The name used to display the switch in the frontend. required: false @@ -216,6 +221,7 @@ switch: host: 192.168.1.2 mac: 'B4:43:0D:CC:0F:58' timeout: 15 + retry: 5 switches: # Will work on most Phillips TVs: tv_phillips: @@ -263,6 +269,7 @@ switch: host: IP_ADDRESS mac: 'MAC_ADDRESS' type: sp2 + retry: 5 friendly_name: 'Humidifier' ``` From e985bf69b1a8db9f8c12022ea25c821114eb130e Mon Sep 17 00:00:00 2001 From: Glenn Morrison Date: Fri, 16 Aug 2019 14:42:48 -0500 Subject: [PATCH 082/126] Notification of non working status Added text at the beginning to let folks know that this integration is currently not working --- source/_components/googlehome.markdown | 2 ++ 1 file changed, 2 insertions(+) diff --git a/source/_components/googlehome.markdown b/source/_components/googlehome.markdown index 0921c73dbe5..48091c2bab9 100644 --- a/source/_components/googlehome.markdown +++ b/source/_components/googlehome.markdown @@ -12,6 +12,8 @@ redirect_from: - /components/device_tracker.googlehome/ --- +This integration is currently not working as Google have disabled access to their unofficial API. A workaround may be in progress, but for now, this integration should not be included in your setup. + The `googlehome` integration allows you to connect to your Google Home device using an [unofficial Google Home API][googlehomeapi]. This integration will provide: From c8a729905cd65fbe974e3b28f177716e5c9b75cb Mon Sep 17 00:00:00 2001 From: Klaas Schoute Date: Fri, 16 Aug 2019 21:55:31 +0200 Subject: [PATCH 083/126] :pencil2: Tweak --- source/_components/googlehome.markdown | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/source/_components/googlehome.markdown b/source/_components/googlehome.markdown index 48091c2bab9..0d1733c286a 100644 --- a/source/_components/googlehome.markdown +++ b/source/_components/googlehome.markdown @@ -12,7 +12,11 @@ redirect_from: - /components/device_tracker.googlehome/ --- -This integration is currently not working as Google have disabled access to their unofficial API. A workaround may be in progress, but for now, this integration should not be included in your setup. +
+ + This integration is currently not working as Google have disabled access to their unofficial API. A workaround may be in progress, but for now, this integration should not be included in your setup. + +
The `googlehome` integration allows you to connect to your Google Home device using an [unofficial Google Home API][googlehomeapi]. From bcee33a88a385c317bdf01091b994438fb918a2d Mon Sep 17 00:00:00 2001 From: Douglas Paz Date: Sat, 17 Aug 2019 05:47:01 -0300 Subject: [PATCH 084/126] Add python3-dev in Raspberry Pi installation commands (#10046) --- source/_docs/installation/raspberry-pi.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_docs/installation/raspberry-pi.markdown b/source/_docs/installation/raspberry-pi.markdown index 631dc2fb877..1d662e30ffc 100644 --- a/source/_docs/installation/raspberry-pi.markdown +++ b/source/_docs/installation/raspberry-pi.markdown @@ -41,7 +41,7 @@ $ sudo apt-get upgrade -y Install the dependencies. ```bash -$ sudo apt-get install python3 python3-venv python3-pip libffi-dev libssl-dev autoconf +$ sudo apt-get install python3 python3-dev python3-venv python3-pip libffi-dev libssl-dev ``` Add an account for Home Assistant called `homeassistant`. From e75a38b4ddb4f92934246a37785c29e9ace5b8e7 Mon Sep 17 00:00:00 2001 From: Douglas Paz Date: Sat, 17 Aug 2019 05:47:01 -0300 Subject: [PATCH 085/126] Add python3-dev in Raspberry Pi installation commands (#10046) --- source/_docs/installation/raspberry-pi.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_docs/installation/raspberry-pi.markdown b/source/_docs/installation/raspberry-pi.markdown index 631dc2fb877..1d662e30ffc 100644 --- a/source/_docs/installation/raspberry-pi.markdown +++ b/source/_docs/installation/raspberry-pi.markdown @@ -41,7 +41,7 @@ $ sudo apt-get upgrade -y Install the dependencies. ```bash -$ sudo apt-get install python3 python3-venv python3-pip libffi-dev libssl-dev autoconf +$ sudo apt-get install python3 python3-dev python3-venv python3-pip libffi-dev libssl-dev ``` Add an account for Home Assistant called `homeassistant`. From b5331d7c792d58e4425351b31934c8508b2c6ed2 Mon Sep 17 00:00:00 2001 From: majuss Date: Sat, 17 Aug 2019 10:50:27 +0200 Subject: [PATCH 086/126] Fixed elv / pca 301 (#9995) * fixed elv/pca * fixed indent --- source/_components/switch.pca.markdown | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/source/_components/switch.pca.markdown b/source/_components/switch.pca.markdown index 53fabf8fa38..33de8832c39 100644 --- a/source/_components/switch.pca.markdown +++ b/source/_components/switch.pca.markdown @@ -15,9 +15,8 @@ To use your PCA 301 switch or socket in your installation, add the following to ```yaml # Example configuration.yaml entry -switch: - - platform: pca - device: SERIAL_PORT +elv: + device: SERIAL_PORT ``` This platform will add all PCA 301 switches which are in range. You can read the total used energy in KWh and the current power in Watt. From 62e60fb116574a315fc8b3cde71fd9c0b6e5296b Mon Sep 17 00:00:00 2001 From: Courtenay Date: Sat, 17 Aug 2019 01:57:17 -0700 Subject: [PATCH 087/126] Slight changes to wording on customization help page (#10057) * Update customizing-devices.markdown * :pencil2: Tweak * Minor changes --- .../_docs/configuration/customizing-devices.markdown | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/source/_docs/configuration/customizing-devices.markdown b/source/_docs/configuration/customizing-devices.markdown index 420cd090a76..d2724cd03bc 100644 --- a/source/_docs/configuration/customizing-devices.markdown +++ b/source/_docs/configuration/customizing-devices.markdown @@ -8,19 +8,25 @@ redirect_from: /getting-started/customizing-devices/ You can use the UI to change the `entity_id` and friendly name of supported entities. To do this: -1. Select the entity, either from or from the frontend, or by clicking next to the entity in the dev-states menu +1. Select the entity, either from the frontend or by clicking next to the entity in the dev-states menu 2. Click on the cog in the right corner of the entity's dialog 3. Enter the new name or the new entity ID (remember not to change the domain of the entity - the part before the `.`) 4. Select *Save* +If your entity is not supported, or you cannot customize what you need via this method, please see below for more options: + ## Customizing entities By default, all of your devices will be visible and have a default icon determined by their domain. You can customize the look and feel of your front page by altering some of these parameters. This can be done by overriding attributes of specific entities. ### Customization using the UI -Under the *Configuration* menu you'll find the *Customization* menu. If this menu item is not visible, enable advanced mode on your [profile page](/docs/authentication/#your-account-profile) first. When you select an entity to customize, you'll see all the existing attributes listed and you can customize those, or select an additional supported attribute ([see below](/docs/configuration/customizing-devices/#possible-values)). +Under the *Configuration* menu you'll find the *Customization* menu. If this menu item is not visible, enable advanced mode on your [profile page](/docs/authentication/#your-account-profile) first. When you select an entity to customize, you'll see all the existing attributes listed and you can customize those or select an additional supported attribute ([see below](/docs/configuration/customizing-devices/#possible-values)). You may also need to add the following to your `configuration.yaml` file, depending when you started using Home Assistant: +```yaml +homeassistant: + customize: !include customize.yaml +``` #### Possible values {% configuration customize %} From 4502a89f06964467b0c642f7e88fcc3ac9e9b12e Mon Sep 17 00:00:00 2001 From: Courtenay Date: Sat, 17 Aug 2019 01:57:17 -0700 Subject: [PATCH 088/126] Slight changes to wording on customization help page (#10057) * Update customizing-devices.markdown * :pencil2: Tweak * Minor changes --- .../_docs/configuration/customizing-devices.markdown | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/source/_docs/configuration/customizing-devices.markdown b/source/_docs/configuration/customizing-devices.markdown index 420cd090a76..d2724cd03bc 100644 --- a/source/_docs/configuration/customizing-devices.markdown +++ b/source/_docs/configuration/customizing-devices.markdown @@ -8,19 +8,25 @@ redirect_from: /getting-started/customizing-devices/ You can use the UI to change the `entity_id` and friendly name of supported entities. To do this: -1. Select the entity, either from or from the frontend, or by clicking next to the entity in the dev-states menu +1. Select the entity, either from the frontend or by clicking next to the entity in the dev-states menu 2. Click on the cog in the right corner of the entity's dialog 3. Enter the new name or the new entity ID (remember not to change the domain of the entity - the part before the `.`) 4. Select *Save* +If your entity is not supported, or you cannot customize what you need via this method, please see below for more options: + ## Customizing entities By default, all of your devices will be visible and have a default icon determined by their domain. You can customize the look and feel of your front page by altering some of these parameters. This can be done by overriding attributes of specific entities. ### Customization using the UI -Under the *Configuration* menu you'll find the *Customization* menu. If this menu item is not visible, enable advanced mode on your [profile page](/docs/authentication/#your-account-profile) first. When you select an entity to customize, you'll see all the existing attributes listed and you can customize those, or select an additional supported attribute ([see below](/docs/configuration/customizing-devices/#possible-values)). +Under the *Configuration* menu you'll find the *Customization* menu. If this menu item is not visible, enable advanced mode on your [profile page](/docs/authentication/#your-account-profile) first. When you select an entity to customize, you'll see all the existing attributes listed and you can customize those or select an additional supported attribute ([see below](/docs/configuration/customizing-devices/#possible-values)). You may also need to add the following to your `configuration.yaml` file, depending when you started using Home Assistant: +```yaml +homeassistant: + customize: !include customize.yaml +``` #### Possible values {% configuration customize %} From eec2864ebd3e103ac6a1ffbad6346f5d8f6a3fa8 Mon Sep 17 00:00:00 2001 From: Franck Nijhof Date: Sat, 17 Aug 2019 15:25:29 +0200 Subject: [PATCH 089/126] Revert "Notification of non working status" (#10158) --- source/_components/googlehome.markdown | 6 ------ 1 file changed, 6 deletions(-) diff --git a/source/_components/googlehome.markdown b/source/_components/googlehome.markdown index 0d1733c286a..0921c73dbe5 100644 --- a/source/_components/googlehome.markdown +++ b/source/_components/googlehome.markdown @@ -12,12 +12,6 @@ redirect_from: - /components/device_tracker.googlehome/ --- -
- - This integration is currently not working as Google have disabled access to their unofficial API. A workaround may be in progress, but for now, this integration should not be included in your setup. - -
- The `googlehome` integration allows you to connect to your Google Home device using an [unofficial Google Home API][googlehomeapi]. This integration will provide: From e1b4d61a4d69cfedf97d1adfc84a8e3ea3fcf4bb Mon Sep 17 00:00:00 2001 From: Daniel Shokouhi Date: Sat, 17 Aug 2019 10:23:12 -0700 Subject: [PATCH 090/126] Correct typo in service call (#10160) --- source/_components/neato.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/neato.markdown b/source/_components/neato.markdown index e7e5505f2bc..df88b15dcc9 100644 --- a/source/_components/neato.markdown +++ b/source/_components/neato.markdown @@ -64,7 +64,7 @@ Currently supported services are: - `stop` - `return_to_base` - `locate` -- `spot_clean` +- `clean_spot` And a specific Platform Service: From b6299d2d5483b3d1687a6be6ed3c4412fcc4433c Mon Sep 17 00:00:00 2001 From: lyghtnox <33329184+lyghtnox@users.noreply.github.com> Date: Sat, 17 Aug 2019 23:25:42 +0200 Subject: [PATCH 091/126] Update domain (#10164) I messed up when I submitted the updated doc for snapcast. Sorry about that, here is the correct one with the snapcast domain --- source/_components/snapcast.markdown | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/source/_components/snapcast.markdown b/source/_components/snapcast.markdown index a272fdd5ca8..ca8d6d88e54 100644 --- a/source/_components/snapcast.markdown +++ b/source/_components/snapcast.markdown @@ -37,7 +37,7 @@ port: The snapcast components provides a few services registered under the media_player component. -### Service `media_player.snapcast_snapshot` +### Service `snapcast.snapshot` Take a snapshot of what is currently playing on one or more speakers. This service, and the following one, are useful if you want to play a doorbell or notification sound and resume playback afterwards. @@ -45,7 +45,7 @@ Take a snapshot of what is currently playing on one or more speakers. This servi | ---------------------- | -------- | ----------- | | `entity_id` | no | The speakers to snapshot. -### Service `media_player.snapcast_restore` +### Service `snapcast.restore` Restore a previously taken snapshot of one or more speakers. @@ -53,7 +53,7 @@ Restore a previously taken snapshot of one or more speakers. | ---------------------- | -------- | ----------- | | `entity_id` | no | String or list of `entity_id`s that should have their snapshot restored. -### Service `media_player.snapcast_join` +### Service `snapcast.join` Group players together under a single group. @@ -62,7 +62,7 @@ Group players together under a single group. | `master` | no | Entity ID of the player to synchronize to. | `entity_id` | yes | String or list of `entity_id`s to join to the master. -### Service `media_player.snapcast_unjoin` +### Service `snapcast.unjoin` Remove one or more speakers from their group of speakers. From 8203c67fc62dc2fc7079c77e111bdd23e726e860 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Sat, 17 Aug 2019 15:44:12 -0700 Subject: [PATCH 092/126] Fix note end --- source/_components/nest.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/nest.markdown b/source/_components/nest.markdown index 0874daf4f25..492d35d5906 100644 --- a/source/_components/nest.markdown +++ b/source/_components/nest.markdown @@ -195,7 +195,7 @@ script: You must have the [Nest component](/components/nest/) configured to use the platforms below. -
+
## Binary Sensor From c3f0aa16fce6e257bb79138dc9adbb1393876b24 Mon Sep 17 00:00:00 2001 From: zhumuht <40521367+zhumuht@users.noreply.github.com> Date: Sun, 18 Aug 2019 10:58:45 +0800 Subject: [PATCH 093/126] add support for yeelight: Yeelight Serene Eye-Friendly Desk Lamp (#10159) * add support for yeelight: Yeelight Serene Eye-Friendly Desk Lamp (YLTD03YL) . product url: https://www.yeelight.com/en_US/product/muse it is can use model 'mono', tested pass. * :pencil2: Tweak --- source/_components/yeelight.markdown | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/source/_components/yeelight.markdown b/source/_components/yeelight.markdown index cfc496bf392..1ba375a4a5f 100644 --- a/source/_components/yeelight.markdown +++ b/source/_components/yeelight.markdown @@ -142,7 +142,7 @@ This integration is tested to work with the following models. If you have a diff | ?, may be `ceiling3` | YLXD04YL | Yeelight Ceiling Light (Jiaoyue 450) | | `ceiling3` | YLXD05YL | Yeelight Ceiling Light (Jiaoyue 480) | | `ceiling4` | YLXD02YL | Yeelight Ceiling Light (Jiaoyue 650) | - +| `mono` | YLTD03YL | Yeelight Serene Eye-Friendly Desk Lamp | ## Platform Services @@ -155,7 +155,6 @@ Set an operation mode. | `entity_id` | no | Only act on a specific lights. | | `mode` | no | Operation mode. Valid values are 'last', 'normal', 'rgb', 'hsv', 'color_flow', 'moonlight'. | - ### Service `yeelight.start_flow` Start flow with specified transitions From 76fa1b14e6086be02ad361266bf66a053a7dd71f Mon Sep 17 00:00:00 2001 From: Juan Date: Sun, 18 Aug 2019 07:07:55 -0400 Subject: [PATCH 094/126] Update joaoapps_join.markdown (#10167) --- source/_components/joaoapps_join.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/joaoapps_join.markdown b/source/_components/joaoapps_join.markdown index 878bf842718..03e28627f66 100644 --- a/source/_components/joaoapps_join.markdown +++ b/source/_components/joaoapps_join.markdown @@ -14,7 +14,7 @@ The `joaoapps_join` integration exposes services from [Join](http://joaoapps.com/join). In Home Assistant, the Join features are divided up in two locations, the Join component, and the Join notify platform. The notify platform allows us to send messages to Join devices, the component -allows us to access the other special features that Join offers. When in doubt, you can reference the [API documentation](https://joaoapps.com/join/api/) this this is based on. +allows us to access the other special features that Join offers. When in doubt, you can reference the [API documentation](https://joaoapps.com/join/api/) this is based on. In the `configuration.yaml` file you need to provide the api key and device id or name of the target device. You can find your device id and api key From 32141dd2b9605c01f955b888b0f5c0dc8b5072c2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ville=20Skytt=C3=A4?= Date: Sun, 18 Aug 2019 14:26:48 +0300 Subject: [PATCH 095/126] Document homematic default local IP (#10170) --- source/_components/homematic.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_components/homematic.markdown b/source/_components/homematic.markdown index f83e5acabe7..8bd3b3ab4cd 100644 --- a/source/_components/homematic.markdown +++ b/source/_components/homematic.markdown @@ -70,6 +70,7 @@ local_ip: description: IP of device running Home Assistant. Override auto-detected value for exotic network setups. required: false type: string + default: 0.0.0.0 local_port: description: Port for connection with Home Assistant. By default it is randomly assigned. required: false From 8b7a01a05159d007417a39bf0787916e8ad2230c Mon Sep 17 00:00:00 2001 From: Paul Tarjan Date: Sun, 18 Aug 2019 08:16:50 -0700 Subject: [PATCH 096/126] Update to required (#10174) If you don't have this you get: ``` Invalid config for [roku]: required key not provided @ data['roku'][0]['host']. Got None. (See ?, line ?). Please check the docs at https://home-assistant.io/components/roku/ ``` --- source/_components/roku.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_components/roku.markdown b/source/_components/roku.markdown index 69602f122db..2b48e436ea8 100644 --- a/source/_components/roku.markdown +++ b/source/_components/roku.markdown @@ -30,8 +30,8 @@ roku: {% configuration %} host: - description: Set the IP address of the Roku device. Use only if you don't want to autodiscover devices. - required: false + description: Set the IP address of the Roku device. + required: true type: string {% endconfiguration %} From f17055b624878c7f85b099950bba00fc02ea01bc Mon Sep 17 00:00:00 2001 From: Dubh Ad Date: Sun, 18 Aug 2019 20:42:53 +0100 Subject: [PATCH 097/126] Fixing indents and formatting (#10176) Too many indents, and some extra spaces --- source/_components/opengarage.markdown | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/source/_components/opengarage.markdown b/source/_components/opengarage.markdown index 5f0da78a861..751c7a74e91 100644 --- a/source/_components/opengarage.markdown +++ b/source/_components/opengarage.markdown @@ -20,14 +20,14 @@ To enable OpenGarage Covers in your installation, add the following to your `con cover: platform: opengarage covers: - garage: - host: 192.168.1.12 - device_key: opendoor - name: Left Garage Door - garage2: - host: 192.168.1.13 - device_key: opendoor - name: Right Garage Door + garage: + host: 192.168.1.12 + device_key: opendoor + name: Left Garage Door + garage2: + host: 192.168.1.13 + device_key: opendoor + name: Right Garage Door ``` {% configuration %} From 3faca387516413e54dc1accec5f97b7bcccd159a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ab=C3=ADlio=20Costa?= Date: Mon, 19 Aug 2019 01:01:09 +0100 Subject: [PATCH 098/126] Delete edp_redy.png (#10182) This follows https://github.com/home-assistant/home-assistant.io/pull/10145 --- source/images/supported_brands/edp_redy.png | Bin 8327 -> 0 bytes 1 file changed, 0 insertions(+), 0 deletions(-) delete mode 100644 source/images/supported_brands/edp_redy.png diff --git a/source/images/supported_brands/edp_redy.png b/source/images/supported_brands/edp_redy.png deleted file mode 100644 index 0371f81f6a795844a9c118e3232e67e1b6a37dad..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 8327 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

UphWxqA(iR(c5$L3Nl1 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 Pi&{_H_)P98O3?oRYP9aR From 43c1eab9a91233d751fa0040a7c3e7ba2414a858 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Joakim=20S=C3=B8rensen?= Date: Mon, 19 Aug 2019 13:17:36 +0200 Subject: [PATCH 099/126] Remove the documentation for the ruter integration (#10169) * Remove the documentation for the ruter integration * Remove image --- source/_components/ruter.markdown | 58 ----------------------- source/images/supported_brands/ruter.png | Bin 6958 -> 0 bytes 2 files changed, 58 deletions(-) delete mode 100644 source/_components/ruter.markdown delete mode 100644 source/images/supported_brands/ruter.png diff --git a/source/_components/ruter.markdown b/source/_components/ruter.markdown deleted file mode 100644 index aba13cb5772..00000000000 --- a/source/_components/ruter.markdown +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: "Ruter Public Transport" -description: "Instructions on how to integrate departure times from Ruter within Home Assistant." -logo: ruter.png -ha_category: - - Transport -ha_iot_class: Cloud Polling -ha_release: 0.83 -redirect_from: - - /components/sensor.ruter/ ---- - -

- -The API used for this sensor is shutting down soon, you should consider starting to use the [`entur_public_transport`](/components/sensor.entur_public_transport/) sensor before that happen. -To read the deprecation warning visit [ruter.no/labs](https://ruter.no/labs/), - -
- -The `ruter` sensor will provide you departure information for the larger Oslo area in Norway from the [Ruter][ruter] public transportation service. - -This platform is using the [Ruter reisapi API][ruter-api] to gather the information. - -To find the `stop_id` you need to visit the [Ruter][ruter] site and search for your stop. -In the URL after you have searched, there will be an ID right after the `Stoppested/` in a format like this `(2190400)`, the numbers there is what you need to put in the `stop_id:` configuration option. - -Add the data to your `configuration.yaml` file as shown in the example: - -```yaml -# Example configuration.yaml entry -sensor: - - platform: ruter - stop_id: STOPID -``` - -{% configuration %} -stop_id: - description: The stop id for the stop you want to monitor. - required: true - type: string -destination: - description: A destination name to show only departures that has this as the final stop. - required: false - type: string -offset: - description: An offset for the next departure, 0 will give the first one. - required: false - type: integer - default: 0 -name: - description: Name of the sensor. - required: false - type: string - default: Ruter -{% endconfiguration %} - -[ruter]: https://ruter.no/reiseplanlegger/ -[ruter-api]: http://reisapi.ruter.no/Help diff --git a/source/images/supported_brands/ruter.png b/source/images/supported_brands/ruter.png deleted file mode 100644 index 180231202503fffa369e8659ba6cacd7b445e224..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 6958 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 From f6f90f21bda5370b4b11aa36eaa748942cc1ad99 Mon Sep 17 00:00:00 2001 From: Philipp Danner Date: Mon, 19 Aug 2019 15:25:33 +0200 Subject: [PATCH 100/126] Added documentation for the keba-charging-station component (#9616) * Added documentation for the keba-charging-station component * Update source/_components/keba.markdown push version number to 0.95 Co-Authored-By: Klaas Schoute * added refresh_interval documentation and service call examples * bumped ha_release to 0.96, hopefully ;) * :pencil2: Tweak - Remove linkable title (no longer needed) - Put service name in the title/header * updated documentation for new services * small addition * Update source/_components/keba.markdown Co-Authored-By: Martin Hjelmare * Update source/_components/keba.markdown Co-Authored-By: Martin Hjelmare * Update source/_components/keba.markdown Co-Authored-By: Martin Hjelmare * Update source/_components/keba.markdown Co-Authored-By: Martin Hjelmare * :pencil2: Tweak * :pencil2: Fix link * :pencil2: Last tweak --- source/_components/keba.markdown | 123 ++++++++++++++++++++++++ source/images/supported_brands/keba.png | Bin 0 -> 4726 bytes 2 files changed, 123 insertions(+) create mode 100644 source/_components/keba.markdown create mode 100644 source/images/supported_brands/keba.png diff --git a/source/_components/keba.markdown b/source/_components/keba.markdown new file mode 100644 index 00000000000..9ff867d9778 --- /dev/null +++ b/source/_components/keba.markdown @@ -0,0 +1,123 @@ +--- +title: "Keba Charging Station" +description: "Instructions on how to setup your Keba charging station with Home Assistant." +logo: keba.png +ha_category: + - Binary Sensor + - Lock + - Sensor +ha_release: 0.98 +--- + +The `keba` integrates your Keba charging station (wallbox) into your home assistant instance. It was tested with a BMW Wallbox but should also work with a Keba P20/P30 according to the developers [manual](https://www.keba.com/web/downloads/e-mobility/KeContact_P20_P30_UDP_ProgrGuide_en.pdf). The fetching interval to the charging station is set to 5 seconds, same as in the official mobile app. + +This component provides the following platforms: + +- Binary Sensors: Online state, plug state, Charging state and failsafe mode state. +- Lock: Authorization (like with the RFID card). +- Sensors: current set by the user, target energy set by the user, charging power, charged energy of the current session and total energy charged. +- Services: authorize, deauthorize, set energy target, set maximum allowed current and manually update the states. More details can be found [here](/components/keba/#services). + +## Configuration + +To enable this component in your installation, add at least the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +keba: + host: KEBA_HOST +``` + +{% configuration %} +keba: + description: configuration + required: true + type: map + keys: + host: + description: Keba host. + required: true + type: string + rfid: + description: RFID tag used for authorization. + required: false + type: string + default: "00845500" + failsafe: + description: Enable failsafe mode at home assistant startup. + required: false + type: boolean + default: false + failsafe_timeout: + description: Timeout of the failsafe mode in seconds. Allowed values are between 10 seconds and 600 seconds (this parameter is only used if failsafe mode is enabled). Make sure to call the `keba.set_curr` service regularly within this timeout period! + required: false + type: integer + default: 30 + failsafe_fallback: + description: Fallback current of the failsafe mode in A. Allowed values are between 6 Ampere and 63 Ampere. 0 Ampere disables the running charging process completely (this parameter is only used if failsafe mode is enabled). + required: false + type: integer + default: 6 + failsafe_persist: + description: Saving the failsafe configuration to internal EEPROM of the Keba charging station. 1 means save it, 0 means do only keep this configuration until the next restart of the charging station (this parameter is only used if failsafe mode is enabled). + required: false + type: integer + default: 0 + refresh_interval: + description: Refresh interval to fetch new data from the charging station. 5 seconds (same as in the official app) is recommended. + required: false + type: integer + default: 5 +{% endconfiguration %} + +## Services + +The `keba` component offers several services. Using these services will change the state of your charging station. So use these services with care! + +### Authorizing and Deauthorizing `keba.authorize` and `keba.deauthorize` + +The charging station can be authorized and deauthorized via service calls (`keba.authorize` and `keba.deauthorize`) or via the lock component that is created automatically for the charging station. In both cases the RFID tag from the configuration is used. + +### Start and Stop `keba.start` and `keba.stop` + +The service `keba.start` and `keba.stop` controls the charging process if the car is already authorized. Technically it sends `ena 1` or `ena 0` commands to the charging station. + +### Set Target Energy `keba.set_energy` + +The service `keba.set_energy` sets the target energy for the current session to the given energy attribute in kWh. Payload example: + +```json +{ + "energy": 10.0 +} +``` + +### Maximum Current `keba.set_curr` + +The service `keba.set_curr` sets the maximum current to the given current attribute in Ampere. Payload example: + +```json +{ + "current": 16.0 +} +``` + +### Request New Data `keba.request_data` + +The service `keba.request_data` sends data update requests to the charging station. + +### Request New Data `keba.set_failsafe` + +The service `keba.set_failsafe` sets the failsafe mode of the charging station. Payload example: + +```json +{ + "failsafe_timeout": 30, + "failsafe_fallback": 6, + "failsafe_persist": 0 +} +``` + +## Disclaimer + +This software is not affiliated with or endorsed by Keba. diff --git a/source/images/supported_brands/keba.png b/source/images/supported_brands/keba.png new file mode 100644 index 0000000000000000000000000000000000000000..ac182405dc41c05a7bd1c06d2252cdec846e7a9f GIT binary patch literal 4726 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 literal 0 HcmV?d00001 From 41cf9b8a52502b30f86ceef1004551392643cdfe Mon Sep 17 00:00:00 2001 From: Jay Date: Mon, 19 Aug 2019 12:06:47 -0400 Subject: [PATCH 101/126] Dialogflow v2 documentation (#10149) * Dialogflow v2 documentation * :pencil2: Tweak * :pencil2: Tweak url --- source/_components/dialogflow.markdown | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/source/_components/dialogflow.markdown b/source/_components/dialogflow.markdown index 62f7868afb9..eebb94698b7 100644 --- a/source/_components/dialogflow.markdown +++ b/source/_components/dialogflow.markdown @@ -39,8 +39,6 @@ To get the webhook URL, go to the integrations page in the configuration screen - Click on "Create Agent" - Select name, language (if you are planning to use Google Actions check their [supported languages](https://support.google.com/assistant/answer/7108196?hl=en)) and time zone - Click "Save" -- Go to project settings (cog symbol in left menu) -- under "API VERSION" click on "V1 API" - Now go to "Fulfillment" (in the left menu) - Enable Webhook and set your Dialogflow webhook url as the endpoint, e.g., `https://myhome.duckdns.org/api/webhook/800b4cb4d27d078a8871656a90854a292651b20635685f8ea23ddb7a09e8b417` - Click "Save" @@ -53,6 +51,12 @@ To get the webhook URL, go to the integrations page in the configuration screen - On the top right, where is written "Try it now...", write, or say, the phrase you have previously defined and hit enter - Dialogflow has send a request to your Home Assistant server +
+ + The V1 api will be deprecated on October 23, 2019. If you are still using the V1 API, it is recommended to change your settings in Dialogflow to use the V2 API. No changes to your intents yaml configuration need to take place after upgrading to the V2 API. Change to the V2 API by clicking on the cog button [here](https://console.dialogflow.com/) and then select the V2 API. + +
+ Take a look to "Integrations", in the left menu, to configure third parties. ### Configuring Home Assistant From 88b7e6ec92f286713ab9141537eb04869584387e Mon Sep 17 00:00:00 2001 From: kimvonmullen Date: Mon, 19 Aug 2019 20:20:45 +0200 Subject: [PATCH 102/126] Change of notification icon placement (#10187) Change of notification icon placement => Just updated to new placement --- source/_components/calendar.google.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/calendar.google.markdown b/source/_components/calendar.google.markdown index 1c54c4fdc0a..fb2ade2bd60 100644 --- a/source/_components/calendar.google.markdown +++ b/source/_components/calendar.google.markdown @@ -65,7 +65,7 @@ track_new_calendar: The next steps will require you to have Home Assistant running. -After you have it running complete the Google authentication that pops up in notification (the little bell icon in the upper right corner). +After you have it running complete the Google authentication that pops up in notification (the little bell icon in the lower left corner). It will give you a URL and a code to enter. This will grant your Home Assistant service access to all the Google Calendars that the account you From c27a7218bb0644660300c9b7e7f91833c026ebcc Mon Sep 17 00:00:00 2001 From: Eirik Z <46269073+atxbyea@users.noreply.github.com> Date: Tue, 20 Aug 2019 07:53:13 +0200 Subject: [PATCH 103/126] Update tensorflow.markdown (#10183) * Update tensorflow.markdown Update with examples of scan interval and callng the scanning process based on state from an entity * :pencil2: Tweak --- source/_components/tensorflow.markdown | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/source/_components/tensorflow.markdown b/source/_components/tensorflow.markdown index 38066ccb35e..11253c3af22 100644 --- a/source/_components/tensorflow.markdown +++ b/source/_components/tensorflow.markdown @@ -160,3 +160,25 @@ image_processing: ## Optimising resources [Image processing components](/components/image_processing/) process the image from a camera at a fixed period given by the `scan_interval`. This leads to excessive processing if the image on the camera hasn't changed, as the default `scan_interval` is 10 seconds. You can override this by adding to your config `scan_interval: 10000` (setting the interval to 10,000 seconds), and then call the `image_processing.scan` service when you actually want to perform processing. + +```yaml +# Example advanced configuration.yaml entry +image_processing: + - platform: tensorflow + scan_interval: 10000 + source: + - entity_id: camera.driveway + - entity_id: camera.backyard +``` + +```yaml +# Example advanced automations.yaml entry +- alias: Tensorflow scanning + trigger: + - platform: state + entity_id: + - binary_sensor.driveway + action: + - service: image_processing.scan + entity_id: camera.driveway +``` From ed3edaa01f8beb2aae6361731fb0121f3523885c Mon Sep 17 00:00:00 2001 From: Klaas Schoute Date: Tue, 20 Aug 2019 07:53:57 +0200 Subject: [PATCH 104/126] =?UTF-8?q?=F0=9F=9A=A7=20Add=20remove=20warning?= =?UTF-8?q?=20for=20edp=5Fredy=20integration=20(#10178)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- source/_components/edp_redy.markdown | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/source/_components/edp_redy.markdown b/source/_components/edp_redy.markdown index a1a8347af11..9422702ef13 100644 --- a/source/_components/edp_redy.markdown +++ b/source/_components/edp_redy.markdown @@ -13,6 +13,12 @@ redirect_from: - /components/switch.edp_redy/ --- +
+ + The API of this integration has been stopped and will therefore be removed in a future release. See also [this pull request](https://github.com/home-assistant/home-assistant/pull/25971) + +
+ [EDP re:dy](https://www.edp.pt/particulares/servicos/redy/) is a Home Automation platform from Portuguese energy provider EDP, that allows control of appliances and other devices, as well as monitoring power consumption. This integration allows integrating EDP re:dy into Home Assistant. ## Configuration From d3ef85208ea08ba685dba4b23d34ffad0282a84d Mon Sep 17 00:00:00 2001 From: TychoWerner <34608981+TychoWerner@users.noreply.github.com> Date: Tue, 20 Aug 2019 07:54:40 +0200 Subject: [PATCH 105/126] Added warning for integration getting removed (#10168) * Added warning for integration getting removed The googlehome integration is getting removed so letting users know when they wish to setup they know it's going away according to this pull: https://github.com/home-assistant/home-assistant/pull/26035 * :pencil2: Tweak --- source/_components/googlehome.markdown | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/source/_components/googlehome.markdown b/source/_components/googlehome.markdown index 0921c73dbe5..932a1298cdf 100644 --- a/source/_components/googlehome.markdown +++ b/source/_components/googlehome.markdown @@ -12,6 +12,12 @@ redirect_from: - /components/device_tracker.googlehome/ --- +
+ + For a couple of weeks / months this integration is broken, therefore it will be removed in the future according to [this pull request](https://github.com/home-assistant/home-assistant/pull/26035). + +
+ The `googlehome` integration allows you to connect to your Google Home device using an [unofficial Google Home API][googlehomeapi]. This integration will provide: From e512602c2a7051c525dbe36375f6f74aa5c8d4a0 Mon Sep 17 00:00:00 2001 From: Chris Thornton <54046872+cj-thornton@users.noreply.github.com> Date: Tue, 20 Aug 2019 10:06:57 +0000 Subject: [PATCH 106/126] Add path option to SABnzbd component docs (#10124) --- source/_components/sabnzbd.markdown | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/source/_components/sabnzbd.markdown b/source/_components/sabnzbd.markdown index 389b11a4b3d..fcb9672c003 100644 --- a/source/_components/sabnzbd.markdown +++ b/source/_components/sabnzbd.markdown @@ -39,6 +39,10 @@ host: required: false default: localhost type: string +path: + description: Path to your SABnzbd instance corresponding to its `url_base` setting, e.g., `/sabnzbd`. + required: false + type: string name: description: The name of your SABnzbd instance (this will be the prefix for all created sensors). required: false @@ -81,6 +85,7 @@ Available sensors are: sabnzbd: api_key: YOUR_SABNZBD_API_KEY host: 192.168.1.32 + path: /sabnzbd name: sab port: 9090 ssl: true From a20e6ac7014fa59170a2daee3a785fdf504f3213 Mon Sep 17 00:00:00 2001 From: Klaas Schoute Date: Tue, 20 Aug 2019 16:12:57 +0200 Subject: [PATCH 107/126] =?UTF-8?q?=F0=9F=94=A8=20Fix=20broken=20links=20(?= =?UTF-8?q?part=205)=20(#10181)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * 🔨 Fix broken links (part 5) * Update name --- source/_addons/samba.markdown | 2 +- source/_components/asuswrt.markdown | 2 +- .../{cppm.markdown => cppm_tracker.markdown} | 2 ++ source/_components/gc100.markdown | 3 +- source/_components/introduction.markdown | 22 ------------- source/_components/luci.markdown | 2 +- source/_components/mercedesme.markdown | 30 ------------------ source/_components/qwikswitch.markdown | 8 ++--- source/_components/recollect_waste.markdown | 2 +- source/_components/tikteck.markdown | 2 +- source/_components/todoist.markdown | 2 +- source/_components/updater.markdown | 2 +- ...lc-telnet.markdown => vlc_telnet.markdown} | 2 ++ ...orm_actions_based_on_input_select.markdown | 2 +- source/_docs/ecosystem/appdaemon.markdown | 2 +- ...rea-entity-registry-and-event-cli.markdown | 2 +- source/_posts/2019-04-24-release-92.markdown | 8 ++--- source/developers/credits.markdown | 6 ++-- source/images/supported_brands/mercedesme.png | Bin 2557 -> 0 bytes 19 files changed, 26 insertions(+), 75 deletions(-) rename source/_components/{cppm.markdown => cppm_tracker.markdown} (97%) delete mode 100644 source/_components/introduction.markdown delete mode 100644 source/_components/mercedesme.markdown rename source/_components/{vlc-telnet.markdown => vlc_telnet.markdown} (98%) delete mode 100644 source/images/supported_brands/mercedesme.png diff --git a/source/_addons/samba.markdown b/source/_addons/samba.markdown index df767826ac6..488f0d75cf8 100644 --- a/source/_addons/samba.markdown +++ b/source/_addons/samba.markdown @@ -4,7 +4,7 @@ description: "Manage your Home Assistant and custom add-ons over Samba." featured: true --- -This add-on allows you to set up a [Samba](https://samba.org/) server to access Hass.io folders using Windows network shares. +This add-on allows you to set up a [Samba](https://www.samba.org) server to access Hass.io folders using Windows network shares.
diff --git a/source/_components/asuswrt.markdown b/source/_components/asuswrt.markdown index d4886aaac05..09e7cfa2edb 100644 --- a/source/_components/asuswrt.markdown +++ b/source/_components/asuswrt.markdown @@ -85,7 +85,7 @@ sensors:
-You need to [enable telnet](https://www.asus.com/support/faq/1005449/) on your router if you choose to use `protocol: telnet`. +You need to enable telnet on your router if you choose to use `protocol: telnet`.
diff --git a/source/_components/cppm.markdown b/source/_components/cppm_tracker.markdown similarity index 97% rename from source/_components/cppm.markdown rename to source/_components/cppm_tracker.markdown index d30b472ec27..c8d86e219fc 100644 --- a/source/_components/cppm.markdown +++ b/source/_components/cppm_tracker.markdown @@ -6,6 +6,8 @@ ha_category: - Presence Detection ha_release: "0.90" ha_iot_class: Local Polling +redirect_from: + - /components/cppm/ --- This platform allows you to detect presence by looking at connected devices to [Aruba Clearpass](https://www.arubanetworks.com/products/security/network-access-control/). diff --git a/source/_components/gc100.markdown b/source/_components/gc100.markdown index b073fba7e30..11765aaa454 100644 --- a/source/_components/gc100.markdown +++ b/source/_components/gc100.markdown @@ -17,7 +17,8 @@ hardware device which has an array of relays, RS232 serial ports, and flexible p There is currently support for the following device types within Home Assistant: -- [Binary Sensor](binary-sensor) +- [Configuration](#configuration) +- [Binary Sensor](#binary-sensor) - [Switch](#switch) Currently, only relays and ports configured to be digital inputs are supported in Home Assistant. For IR support, please use the [iTach remote platform](/components/remote.itach/), but note that it will likely not function concurrently on the same GC100 due to limitations in the TCP socket server implementation used by Global Caché. diff --git a/source/_components/introduction.markdown b/source/_components/introduction.markdown deleted file mode 100644 index 265de216c48..00000000000 --- a/source/_components/introduction.markdown +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: "Introduction" -description: "Details about the introduction within Home Assistant." -logo: home-assistant.png -ha_qa_scale: internal -ha_release: 0.7 ---- - -
-This integration has been removed in Home Assistant 0.92. The UI will now take care of this text. -
- -The introduction integration will show a card in the UI with 'Welcome Home!' and steps on how to get started. It will also print the same message to the console when starting up. - -The introduction integration is loaded by default on a new Home Assistant instance. - -```yaml -# Example configuration.yaml entry -introduction: -``` - -To disable this component, remove the `introduction:` entry from your `configuration.yaml` file. diff --git a/source/_components/luci.markdown b/source/_components/luci.markdown index 531ef336064..4830ee51947 100644 --- a/source/_components/luci.markdown +++ b/source/_components/luci.markdown @@ -9,7 +9,7 @@ redirect_from: - /components/device_tracker.luci/ --- -_This is one of multiple ways we support OpenWRT. For an overview, see [openwrt](/components/device_tracker.openwrt/)._ +_This is one of multiple ways we support OpenWRT. For an overview, see [openwrt](/components/openwrt/)._ This is a presence detection scanner for OpenWRT using [luci](http://wiki.openwrt.org/doc/techref/luci). diff --git a/source/_components/mercedesme.markdown b/source/_components/mercedesme.markdown deleted file mode 100644 index 43f57f29790..00000000000 --- a/source/_components/mercedesme.markdown +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: "Mercedes me" -description: "Instructions on how to integrate Mercedes car with Mercedes me into Home Assistant." -logo: mercedesme.png -ha_category: - - Car - - Binary Sensor - - Presence Detection - - Sensor -ha_release: 0.63 -ha_iot_class: Cloud Polling -redirect_from: - - /components/binary_sensor.mercedesme/ - - /components/device_tracker.mercedesme/ - - /components/sensor.mercedesme/ ---- - -The `mercedesme` integration offers integration with the [Mercedes me](https://www.mercedes-benz.com/de/mercedes-me/) cloud service and provides presence detection as well as sensors such as doors, tires, windows, and service interval. - -This integration provides the following platforms: - -- Binary Sensors: Windows, tires, doors and lock. -- Sensors:Fuel status, service interval, remaining km, etc. -- Device tracker: To track location of your car. - -Platforms will be automatically configured if Mercedes me integration is configured. - -
- The integration was removed. The vendor disabled the API endpoint and a new API is not available currently. -
diff --git a/source/_components/qwikswitch.markdown b/source/_components/qwikswitch.markdown index 56b08c28e58..b54ba2605e7 100644 --- a/source/_components/qwikswitch.markdown +++ b/source/_components/qwikswitch.markdown @@ -22,12 +22,12 @@ There is currently support for the following device types within Home Assistant: - Binary Sensor - Light -- Sensor -- Switch +- [Sensor](#qwikswitch-sensors) +- [Switch](#switch) -The `qwikswitch` integration discovers all devices from QS Mobile. Currently, Relays and LED dimmers are discovered in Home Assistant. Relay devices are [lights](/components/light.qwikswitch/) by default, and can be configured as [switches](/components/switch.qwikswitch/). +The `qwikswitch` integration discovers all devices from QS Mobile. Currently, Relays and LED dimmers are discovered in Home Assistant. Relay devices are lights by default, and can be configured as [switches](#switch). -Configuration +## Configuration ```yaml # Example configuration.yaml entry diff --git a/source/_components/recollect_waste.markdown b/source/_components/recollect_waste.markdown index 90b66fdd41d..d409d181630 100644 --- a/source/_components/recollect_waste.markdown +++ b/source/_components/recollect_waste.markdown @@ -10,7 +10,7 @@ redirect_from: - /components/sensor.recollect_waste/ --- -The `Recollect Waste` platform allows you to track the next scheduled waste pickup and what type of waste from [Recollect](https://recollect.net/solutions/waste/). To use this sensor your city's waste company must be Recollect and you will need to find your place_id and service_id. +The `recollect_waste` integration allows you to track the next scheduled waste pickup and what type of waste from [Recollect](https://recollect.net/private-waste-haulers/). To use this sensor your city's waste company must be Recollect and you will need to find your place_id and service_id. 1. In Chrome open developer tools and go to the network tab. 2. Go to your city's Recollect collection calendar. diff --git a/source/_components/tikteck.markdown b/source/_components/tikteck.markdown index 1cb6013bca9..e237c431538 100644 --- a/source/_components/tikteck.markdown +++ b/source/_components/tikteck.markdown @@ -41,7 +41,7 @@ devices: type: string {% endconfiguration %} -The password can be obtained from an Android device using an app like [aLogcat](https://play.google.com/store/apps/details?id=org.jtb.alogcat&hl=en) or the `adb logcat` command for phones in developer mode. Look for a line like: +The password can be obtained from an Android device using an app like [aLogcat](https://play.google.com/store/apps/details?id=rs.pedjaapps.alogcatroot.app&hl=en) or the `adb logcat` command for phones in developer mode. Look for a line like: ``` E LedoBleSDK: login =skName=======[Smart Light]=======skPw==[password] diff --git a/source/_components/todoist.markdown b/source/_components/todoist.markdown index 4d97b34a28f..f8fc8c8cc50 100644 --- a/source/_components/todoist.markdown +++ b/source/_components/todoist.markdown @@ -91,7 +91,7 @@ As you can see, there are 4 custom projects here: You can mix-and-match these attributes to create all sorts of custom projects. You can even use [IFTTT](https://ifttt.com/todoist) to create a task with a certain label, then have Home Assistant do some kind of automation when a task with that label comes due. -Home Assistant does its best to [determine what task in each project is "most" important](https://github.com/home-assistant/home-assistant/blob/master/homeassistant/components/calendar/todoist.py#L432), and it's that task which has its state reported. You can access the other tasks you have due soon via the `all_tasks` array (see below). +Home Assistant does its best to [determine what task in each project is "most" important](https://github.com/home-assistant/home-assistant/blob/master/homeassistant/components/todoist/calendar.py), and it's that task which has its state reported. You can access the other tasks you have due soon via the `all_tasks` array (see below). ### Sensor attributes diff --git a/source/_components/updater.markdown b/source/_components/updater.markdown index 3b5f99d0709..b991e36bc54 100644 --- a/source/_components/updater.markdown +++ b/source/_components/updater.markdown @@ -10,7 +10,7 @@ ha_release: 0.8 The `updater` integration will check daily for new releases. It will show a badge in the frontend if a new version is found. As [Hass.io](/hassio/) has its own schedule for release it doesn't make sense to use this integration on Hass.io. -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/blob/dev/homeassistant/components/updater.py#L91). +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/blob/dev/homeassistant/components/updater). ## Configuration diff --git a/source/_components/vlc-telnet.markdown b/source/_components/vlc_telnet.markdown similarity index 98% rename from source/_components/vlc-telnet.markdown rename to source/_components/vlc_telnet.markdown index 7bef2182ebd..d15e8a4fb32 100644 --- a/source/_components/vlc-telnet.markdown +++ b/source/_components/vlc_telnet.markdown @@ -6,6 +6,8 @@ ha_category: - Media Player ha_release: 0.95 ha_iot_class: Local Polling +redirect_from: + - /components/vlc-telnet --- The `vlc_telnet` platform allows you to control a [VLC media player](http://www.videolan.org/vlc/index.html) using the built in telnet interface. diff --git a/source/_cookbook/perform_actions_based_on_input_select.markdown b/source/_cookbook/perform_actions_based_on_input_select.markdown index 2fc59a90bb7..bead33bdf04 100644 --- a/source/_cookbook/perform_actions_based_on_input_select.markdown +++ b/source/_cookbook/perform_actions_based_on_input_select.markdown @@ -4,7 +4,7 @@ description: "Example playing media to Chromecast based on input select element" ha_category: Automation Examples --- -This example uses an [`input_select`](/components/input_select/) element to pick which mp3 file to play on a [Chromecast](components/media_player.cast/). +This example uses an [`input_select`](/components/input_select/) element to pick which mp3 file to play on a [Chromecast](/components/cast/). ```yaml # Define our dropdown list diff --git a/source/_docs/ecosystem/appdaemon.markdown b/source/_docs/ecosystem/appdaemon.markdown index 58b20ea4642..f4c05863a79 100755 --- a/source/_docs/ecosystem/appdaemon.markdown +++ b/source/_docs/ecosystem/appdaemon.markdown @@ -101,4 +101,4 @@ Of course, if I wanted to make this App or its predecessor reusable, I would hav In addition, Apps can write to `AppDaemon`'s log files, and there is a system of constraints that allows you to control when and under what circumstances Apps and callbacks are active to keep the logic clean and simple. -For full installation instructions, see the [AppDaemon Project Documentation pages](http://appdaemon.readthedocs.io/en/stable/). If you're using Hassbian, then the [Hassbian scripts](https://github.com/home-assistant/hassbian-scripts/blob/dev/docs/appdaemon.md) make it easy to install. +For full installation instructions, see the [AppDaemon Project Documentation pages](http://appdaemon.readthedocs.io/en/stable/). If you're using Hassbian, then the [Hassbian scripts](https://github.com/home-assistant/hassbian-scripts/blob/dev/docs/suites/appdaemon.md) make it easy to install. diff --git a/source/_posts/2019-02-11-hass-cli-0-dot-5-area-entity-registry-and-event-cli.markdown b/source/_posts/2019-02-11-hass-cli-0-dot-5-area-entity-registry-and-event-cli.markdown index ddf0f0edbe1..3940cf811bb 100644 --- a/source/_posts/2019-02-11-hass-cli-0-dot-5-area-entity-registry-and-event-cli.markdown +++ b/source/_posts/2019-02-11-hass-cli-0-dot-5-area-entity-registry-and-event-cli.markdown @@ -144,7 +144,7 @@ Minor fixes: * fix bad typing [499b544](http://github.com/home-assistant/home-assistant-cli/commit/499b5449b0441b546ea48aff212754433457dbd5) @maxandersen * fix editor formatting [86d9bf8](http://github.com/home-assistant/home-assistant-cli/commit/86d9bf8bf6bfb5bec1a9f28177c105f84912a91b) @maxandersen * Fix version [3765a03](http://github.com/home-assistant/home-assistant-cli/commit/3765a03ccf11f0865baa7e70937279bcaa245352) @maxandersen -* Fix version marker [edbe4bf](http://github.com/homeassistant/homeassistant-cli/commit/edbe4bf42e7d0993d68a367ca04ad80217aac395) @maxandersen +* Fix version marker [edbe4bf](http://github.com/home-assistant/home-assistant-cli/commit/edbe4bf42e7d0993d68a367ca04ad80217aac395) @maxandersen Have fun! diff --git a/source/_posts/2019-04-24-release-92.markdown b/source/_posts/2019-04-24-release-92.markdown index 8ef8d80b108..58984611a7c 100644 --- a/source/_posts/2019-04-24-release-92.markdown +++ b/source/_posts/2019-04-24-release-92.markdown @@ -229,7 +229,7 @@ Experiencing issues introduced by this release? Please report them in our [issue - Always set latest pin ([@balloob] - [#23328]) ([cloud docs]) (beta fix) - Add sensor and binary senseor to default expose ([@balloob] - [#23332]) ([google_assistant docs]) (beta fix) - Support unicode in configuration migration ([@awarecan] - [#23335]) (beta fix) -- Remove ghost folder ([@awarecan] - [#23350]) (aws_lambda docs) ([aws_sns docs]) ([aws_sqs docs]) (beta fix) +- Remove ghost folder ([@awarecan] - [#23350]) (aws_lambda docs) (aws_sns docs) (aws_sqs docs) (beta fix) ## All changes @@ -301,7 +301,7 @@ Experiencing issues introduced by this release? Please report them in our [issue - Google Assistant: Add support for open/close binary sensors ([@balloob] - [#22674]) ([binary_sensor docs]) ([google_assistant docs]) - Update light/services.yaml ([@emontnemery] - [#22662]) - Fix connection loss issues for Harmony ([@ehendrix23] - [#22687]) ([harmony docs]) -- Remove aws_* notify platforms ([@awarecan] - [#22698]) (aws_lambda docs) ([aws_sns docs]) ([aws_sqs docs]) +- Remove aws_* notify platforms ([@awarecan] - [#22698]) (aws_lambda docs) (aws_sns docs) (aws_sqs docs) - Add manifests ([@balloob] - [#22699]) - Add a .codecov.yml to control coverage statuses and enable notifications ([@robbiet480] - [#22707]) - Raise ConfigEntryNotReady for MQTT connection exception ([@aav7fl] - [#22540]) @@ -542,7 +542,7 @@ Experiencing issues introduced by this release? Please report them in our [issue - Always set latest pin ([@balloob] - [#23328]) ([cloud docs]) (beta fix) - Add sensor and binary senseor to default expose ([@balloob] - [#23332]) ([google_assistant docs]) (beta fix) - Support unicode in configuration migration ([@awarecan] - [#23335]) (beta fix) -- Remove ghost folder ([@awarecan] - [#23350]) (aws_lambda docs) ([aws_sns docs]) ([aws_sqs docs]) (beta fix) +- Remove ghost folder ([@awarecan] - [#23350]) (aws_lambda docs) (aws_sns docs) (aws_sqs docs) (beta fix) [#19590]: https://github.com/home-assistant/home-assistant/pull/19590 [#20256]: https://github.com/home-assistant/home-assistant/pull/20256 @@ -966,8 +966,6 @@ Experiencing issues introduced by this release? Please report them in our [issue [automation docs]: /components/automation/ [awair docs]: /components/awair/ [aws docs]: /components/aws/ -[aws_sns docs]: /components/aws_sns/ -[aws_sqs docs]: /components/aws_sqs/ [axis docs]: /components/axis/ [binary_sensor docs]: /components/binary_sensor/ [bloomsky docs]: /components/bloomsky/ diff --git a/source/developers/credits.markdown b/source/developers/credits.markdown index 45b545902d3..4769d6ad038 100644 --- a/source/developers/credits.markdown +++ b/source/developers/credits.markdown @@ -4541,7 +4541,7 @@ This page contains a list of people who have contributed in one way or another t - [jaminh (@jaminh)](https://github.com/jaminh "1 total commits to the Home Assistant orga: 1 commit to open-zwave ") -- [JammyDodger231 (@JammyDodger231)](https://github.com/JammyDodger231 "6 total commits to the Home Assistant orga: +- [JamesMcClelland (@JamesMcClelland)](https://github.com/JamesMcClelland "6 total commits to the Home Assistant orga: 6 commits to home-assistant.io ") - [Jan Almeroth (@jalmeroth)](https://github.com/jalmeroth "8 total commits to the Home Assistant orga: @@ -7698,7 +7698,7 @@ This page contains a list of people who have contributed in one way or another t 12 commits to home-assistant 9 commits to home-assistant.io ") -- [Nick Zelei (@zelein)](https://github.com/zelein "1 total commits to the Home Assistant orga: +- [Nick Zelei (@nickzelei)](https://github.com/nickzelei "1 total commits to the Home Assistant orga: 1 commit to home-assistant.io ") - [Nicko van Someren (@nickovs)](https://github.com/nickovs "9 total commits to the Home Assistant orga: @@ -8350,7 +8350,7 @@ This page contains a list of people who have contributed in one way or another t - [Peter Tisovčík (@mienkofax)](https://github.com/mienkofax "1 total commits to the Home Assistant orga: 1 commit to open-zwave ") -- [Peter Weidenkaff (@hansgans)](https://github.com/hansgans "1 total commits to the Home Assistant orga: +- [Peter Weidenkaff (@weidenka)](https://github.com/weidenka "1 total commits to the Home Assistant orga: 1 commit to home-assistant.io ") - [Peter Zsak (@wroadd)](https://github.com/wroadd "1 total commits to the Home Assistant orga: diff --git a/source/images/supported_brands/mercedesme.png b/source/images/supported_brands/mercedesme.png deleted file mode 100644 index 008791b1a702796d711e789a3c717591d15e0a44..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2557 zcmVPx#hfqvZMF0Q*0vaO)B{BgJ77GgtBO@de6BGac{{sXC z00|8n8ynWw*t4^2|9s6oBIZB8oWAL(I_jw0-~QyL$tsNlwqXX|vY7 zru=9V5wkz`h~j3m+UD5#argd9wZmbz&uxco9ktT>&vmWZM)8Mz{qR(TyOUer4|-Hy}dn+O7Puox8LF4gElV92BHT+A&3zp1?a)H z93PtFIC$W2*yomG+13LXm@~gUKgCwQ-`3aSvW-=Pt86Xc^4G4E_~rQ}w)1WNhe`Jx zP)v?mS~ZD3K0l{0?X~r1F_~}GfVpZC`t&@3I&$mpG6D*C30p4-7lDA;z9m)o7Lc%& zl28#87O3M!D|Gw~TQNs{b6{PoX|dvK95`f^Bx6)qwf!~G)(AqT%K0kCD)V_-QM-P8 zj*WdJR_#AN2ZiF?b~ZmiA+>K?KY#K)0Dm z%*TuA&=Kq*Jwt(M^gKin7uJP0?C^gIAhPr-6eCMPA}_+hZBwc=38q#Vka*)3*$h2q zM#l);ruT%J7vZ6y$x@FZ8pNG+@1{_*BRp-vqPS8Bq_O~wkIrE*2x@{59QDc%W(gc+ zHv)9Vu4)5SwPeF2}37C%r=U#Y`62r|D zNW3u11jlsVqBGM!RBcGGY66hSSn+wrWQCVx z>a?gV(+ycNlF95Kd8B%?vIKJ?ed3jU%0CAI-Rss6Rw&h!@HeSU`BvgbHa7suFP(h> z=`?Rd(vW_DL|&GfCh0i{nE#n-!OjYE+DO2Z7DqH7URfKxPy^ z0s|`BRJlhtqKdR3ph6_ejN5(FXyJ5S$nF@RPo_8UlqzU)P@Y`ml!P%pC!%673j%!^?HOyCXYby93d*{ zEAr?H1QQ~PSuA$uEwh78p9s=-$!lUpaoi5OAId}tJC z1a+#*r5MmtPK#PrTMmN6QAf2P`d3H<8dkMQP|hgYgozLjhxC+U8_+NiZQeG5O1M!rjs{8%|YiORhmHKBHgvKZ_sd(&RkzMi8zHd9fv_h819-V%mNkA z#76}7bIY!d6QMVIxlsydq{5KA%}v!EAYG-~p$$vP2c zsrK@8$ckbTFbx^5{D}ynPW0K#kXcN<5ZO>%gD3{8jO381lDX5uy{`qRlP5UTJv3`oQavJsR>_+8wx#9Zv$8ld?!m;mk z^OpW?Ev0?4=%XmCm_D*?HK zg<0?UN-PT^%{{Jqd|!!Wsau}kpHcD(mbH?Y<+JbKj%QCVR&B2(?)dDxH-P>2?P%4j zc}nE_%=sP(eR<)lQHWN__ckg%JxhB{&$Uq{-?0z*{N&`TdLH~elK6Sz^}04pfRB9r z$u0@AxXxErF8Yq|e369rLu=)$d#;W5roKc%`aoLw`Zi23B(ZPb01<}+aM+v8T1jp* zc_yE;cAXqp$J&l#-?U4}c~bkF*SefyxS!Yl_x-Yd{_^&O+nCq8*h7U_`QK4k{q*|M z-oCN+e~MjpZ8`ORTmPwIaq8pi>(R3FwQsls)2b~i-|e=a)U>|6KfJylZR=mRov%VE z^)?4lcZUPO;Oip{mMcDl0XX#Q*8%$K{6Y2&>bFPiExyKc*y(mah~3@>qsr@t*`>w+ z1z7L}tL@(4sMmXd;?drHqjtVO9{1`cG2H+PZSL_l)w=jv)ls)SG| Date: Tue, 20 Aug 2019 09:55:04 -0700 Subject: [PATCH 108/126] Update frontend.markdown --- source/_components/frontend.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/frontend.markdown b/source/_components/frontend.markdown index 5576c691f5f..508ae23f407 100644 --- a/source/_components/frontend.markdown +++ b/source/_components/frontend.markdown @@ -17,7 +17,7 @@ frontend: {% configuration %} javascript_version: - description: "Version of the JavaScript to serve to clients. Options: `es5` - transpiled so old browsers understand it. `latest` - not transpiled, so will work on recent browsers only. `auto` - select a version according to the browser user-agent. The value in the config can be overiden by putting `es5` or `latest` in the URL. For example `http://localhost:8123/states?es5` " + description: "DEPRECATED, it is now done using feature detection in the browser. Version of the JavaScript to serve to clients. Options: `es5` - transpiled so old browsers understand it. `latest` - not transpiled, so will work on recent browsers only. `auto` - select a version according to the browser user-agent. The value in the config can be overiden by putting `es5` or `latest` in the URL. For example `http://localhost:8123/states?es5` " required: false type: string default: auto From 5a1cb8b2d8e14a1d8c6269b6b04ca70be98e5058 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Joakim=20S=C3=B8rensen?= Date: Tue, 20 Aug 2019 19:56:27 +0200 Subject: [PATCH 109/126] Removes the documentation for the googlehome integration (#10166) * Removes the documentation for the googlehome integration * remove image --- source/_components/googlehome.markdown | 76 ------------------ .../images/supported_brands/google_home.png | Bin 24223 -> 0 bytes 2 files changed, 76 deletions(-) delete mode 100644 source/_components/googlehome.markdown delete mode 100644 source/images/supported_brands/google_home.png diff --git a/source/_components/googlehome.markdown b/source/_components/googlehome.markdown deleted file mode 100644 index 0921c73dbe5..00000000000 --- a/source/_components/googlehome.markdown +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: "Google Home" -description: "Instructions on how to connect to your Google Home device." -logo: google_home.png -ha_release: 0.88 -ha_category: - - Hub - - Presence Detection - - Sensor -ha_iot_class: Local Polling -redirect_from: - - /components/device_tracker.googlehome/ ---- - -The `googlehome` integration allows you to connect to your Google Home device using an [unofficial Google Home API][googlehomeapi]. - -This integration will provide: -- [device_tracker](/components/device_tracker/) platform to track nearby bluetooth devices; -- [sensor](/components/sensor/) platform to track the alarms and the timers. - -## Configuration - -To integrate the `googlehome` integration in Home Assistant, add the following section to your `configuration.yaml` file: - -```yaml -# Example configuration.yaml entry -googlehome: - devices: - - host: IP_ADDRESS -``` - -{% configuration %} -devices: - description: A list of Google Home devices. - required: true - type: list - keys: - host: - description: The IP address of the Google Home device. - required: true - type: string - rssi_threshold: - description: The threshold for the RSSI signal of the device. - required: false - default: -70 - type: integer - device_types: - description: Device types that will be tracked [see device types](#device_types), by default all types are tracked. - required: false - type: list - track_alarms: - description: Setting to tell the integration to track the alarms of the device. - required: false - type: boolean - default: false - track_devices: - description: Setting to tell the integration to track nearby devices. - required: false - type: boolean - default: true -{% endconfiguration %} - -## Device types - -Device type | Description --- | -- -1 | Classic - BR/EDR devices -2 | Low Energy - LE-only -3 | Dual Mode - BR/EDR/LE - -## Notes - -Devices will appear in the format `device_tracker._`. Note that dots are removed from the IP and BT MAC addresses. - -[googlehomeapi]: https://rithvikvibhu.github.io/GHLocalApi/ -[devicetrackerconfig]: /components/device_tracker/#configuring-a-device_tracker-platform diff --git a/source/images/supported_brands/google_home.png b/source/images/supported_brands/google_home.png deleted file mode 100644 index 645627d6a4581a85f739132754836bba03046412..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 24223 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 a>;HheEiSE$e)j)$>S}A~tJkTaBK`-As{&2{ From 019b66c779d3aa8617a55a8e1660bf19faf5e54a Mon Sep 17 00:00:00 2001 From: tiagofreire-pt <41837236+tiagofreire-pt@users.noreply.github.com> Date: Tue, 20 Aug 2019 19:32:25 +0100 Subject: [PATCH 110/126] Add mention for TX-55CX680B (#10191) --- source/_components/panasonic_viera.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_components/panasonic_viera.markdown b/source/_components/panasonic_viera.markdown index 01cfb0474eb..270159f227d 100644 --- a/source/_components/panasonic_viera.markdown +++ b/source/_components/panasonic_viera.markdown @@ -19,6 +19,7 @@ Currently known supported models: - TX-49DX650B - TX-50DX700B - TX-55CX700E +- TX-55CX680B - TX-55EXW584 - TX-65EXW784 - TX-L42ET50 From 69c22d8d9baf0e804fa2327cde443cbc89f08664 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20RAMAGE?= Date: Wed, 21 Aug 2019 00:09:30 +0200 Subject: [PATCH 111/126] Add zigate to configuration variable (#10194) --- source/_components/zha.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/zha.markdown b/source/_components/zha.markdown index 9bdd2bc7cb3..6ccb9a356f4 100644 --- a/source/_components/zha.markdown +++ b/source/_components/zha.markdown @@ -73,7 +73,7 @@ zha: {% configuration %} radio_type: - description: One of `ezsp`, `xbee` or `deconz`. + description: One of `ezsp`, `xbee`, `deconz` or `zigate`. required: false type: string default: ezsp From 50f1f44151924fe5e31cbf1289d49966f6972992 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 21 Aug 2019 09:55:03 +0200 Subject: [PATCH 112/126] Bump nokogiri from 1.10.3 to 1.10.4 (#10190) Bumps [nokogiri](https://github.com/sparklemotion/nokogiri) from 1.10.3 to 1.10.4. - [Release notes](https://github.com/sparklemotion/nokogiri/releases) - [Changelog](https://github.com/sparklemotion/nokogiri/blob/master/CHANGELOG.md) - [Commits](https://github.com/sparklemotion/nokogiri/compare/v1.10.3...v1.10.4) Signed-off-by: dependabot[bot] --- Gemfile | 2 +- Gemfile.lock | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/Gemfile b/Gemfile index b09f53b62f0..1a06732930d 100644 --- a/Gemfile +++ b/Gemfile @@ -19,4 +19,4 @@ group :jekyll_plugins do end gem 'sinatra', '2.0.5' -gem 'nokogiri', '1.10.3' +gem 'nokogiri', '1.10.4' diff --git a/Gemfile.lock b/Gemfile.lock index f125a245016..222b24c147a 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -70,7 +70,7 @@ GEM mini_portile2 (2.4.0) multi_json (1.13.1) mustermann (1.0.3) - nokogiri (1.10.3) + nokogiri (1.10.4) mini_portile2 (~> 2.4.0) pathutil (0.16.2) forwardable-extended (~> 2.6) @@ -109,7 +109,7 @@ DEPENDENCIES jekyll-redirect-from (= 0.15.0) jekyll-sitemap (= 1.3.1) jekyll-time-to-read (= 0.1.2) - nokogiri (= 1.10.3) + nokogiri (= 1.10.4) rake (= 12.3.2) sass-globbing (= 1.1.5) sinatra (= 2.0.5) From ae1a821b64e2f73e373575442f7f690d96c7b7af Mon Sep 17 00:00:00 2001 From: Tomas Kislan Date: Wed, 21 Aug 2019 22:48:56 +0200 Subject: [PATCH 113/126] Add minio documentation (#9267) * Add minio documentation * Update minio.markdown * Update minio.markdown * Review changes * :pencil2: Tweak * Update minio.markdown * :pencil2: Tweak * :pencil2: Tweak --- source/_components/minio.markdown | 153 +++++++++++++++++++++++ source/images/supported_brands/minio.png | Bin 0 -> 11496 bytes 2 files changed, 153 insertions(+) create mode 100644 source/_components/minio.markdown create mode 100644 source/images/supported_brands/minio.png diff --git a/source/_components/minio.markdown b/source/_components/minio.markdown new file mode 100644 index 00000000000..e4bba03e2ea --- /dev/null +++ b/source/_components/minio.markdown @@ -0,0 +1,153 @@ +--- +title: "Minio" +description: "Integration for interacting with Minio object storage." +logo: minio.png +ha_category: Utility +ha_iot_class: Cloud Push +ha_release: 0.98 +--- + +This integration adds interaction with [Minio](https://min.io). +Also enables to listen for bucket notifications: [watch docs](https://docs.min.io/docs/minio-client-complete-guide.html#watch) + +To download or upload files, folders must be added to [whitelist_external_dirs](/docs/configuration/basic/). + +## Configuration + +To enable the Minio integration in your installation, add the following to your `configuration.yaml` file: + +```yaml +minio: + host: localhost + port: 9000 + access_key: ACCESS_KEY + secret_key: SECRET_KEY + secure: false +``` + +{% configuration %} +host: + description: Minio server host + required: true + type: string +port: + description: Minio server port + required: true + type: integer +access_key: + description: Minio server access key + required: true + type: string +secret_key: + description: Minio server secret key + required: true + type: string +secure: + description: Whether to use http or https connection + required: true + type: boolean + default: false +listen: + description: List of configurations to listen for events to + required: false + default: [] + type: list + keys: + bucket: + description: Bucket to use + required: true + type: string + prefix: + description: What prefix to use to filter file events + required: false + type: string + default: "" + suffix: + description: What file suffix to use to filter file events + required: false + type: string + default: ".*" + events: + description: What file + required: false + type: string + default: "s3:ObjectCreated:*" +{% endconfiguration %} + +## Automations + +Automations can be triggered on new files created on the Minio server using the `data_template`. + +{% raw %} +```yaml +#Automatically upload new local files +automation: +- alias: Upload camera snapshot + trigger: + platform: event + event_type: folder_watcher + event_data: + event_type: created + action: + - delay: '00:00:01' + - service: minio.put + data_template: + file_path: "{{ trigger.event.data.path }}" + bucket: "camera-image-object-detection" + key: "input/{{ now().year }}/{{ (now().month | string).zfill(2) }}/{{ (now().day | string).zfill(2) }}/{{ trigger.event.data.file }}" + - delay: '00:00:01' + - service: shell_command.remove_file + data_template: + file: "{{ trigger.event.data.path }}" + +- alias: Download new Minio file + trigger: + - platform: event + event_type: minio + + condition: [] + action: + - service: minio.get + data_template: + bucket: "{{trigger.event.data.bucket}}" + key: "{{trigger.event.data.key}}" + file_path: "/tmp/{{ trigger.event.data.file_name }}" +``` +{% endraw %} + +## Platform Services + +These services are provided: + +- `get` +- `put` +- `remove` + +### Service `minio.get` + +Download file. + +| Service data attribute | Required | Description | +|---------------------------|----------|---------------------------------------------------| +| `bucket` | yes | Bucket to use | +| `key` | yes | Object key of the file | +| `file_path` | yes | File path on the local file system | + +### Service `minio.put` + +Upload file. + +| Service data attribute | Required | Description | +|---------------------------|----------|---------------------------------------------------| +| `bucket` | yes | Bucket to use | +| `key` | yes | Object key of the file | +| `file_path` | yes | File path on the local file system | + +### Service `minio.remove` + +Delete file. + +| Service data attribute | Required | Description | +|---------------------------|----------|---------------------------------------------------| +| `bucket` | yes | Bucket to use | +| `key` | yes | Object key of the file | diff --git a/source/images/supported_brands/minio.png b/source/images/supported_brands/minio.png new file mode 100644 index 0000000000000000000000000000000000000000..38f6ff9f01d54b07a8af71ccc6b52eb7e18e4ba6 GIT binary patch literal 11496 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 DnX+}P literal 0 HcmV?d00001 From 64fa33f8609c3fab415e2169e7693fa99098ae21 Mon Sep 17 00:00:00 2001 From: Johann Kellerman Date: Wed, 21 Aug 2019 22:55:50 +0200 Subject: [PATCH 114/126] Update sma.markdown (#10163) * Update sma.markdown * Update sma.markdown * :pencil2: Tweaks --- source/_components/sma.markdown | 98 ++++++++++++++++----------------- 1 file changed, 46 insertions(+), 52 deletions(-) diff --git a/source/_components/sma.markdown b/source/_components/sma.markdown index 4b440b9f8f4..af30b3b28f5 100644 --- a/source/_components/sma.markdown +++ b/source/_components/sma.markdown @@ -12,22 +12,36 @@ redirect_from: The `sma` sensor will poll a [SMA](http://www.sma-solar.com/) [(US)](http://www.sma-america.com/) solar inverter and present the values as sensors (or attributes of sensors) in Home Assistant. -This sensor uses the web interface and in order to use it you have to be able to connect to the solar inverter from your favorite web browser. +This sensor uses the web interface and to use it, you have to be able to connect to the solar inverter from your favorite web browser. ## Configuration To enable this sensor, add the following lines to your `configuration.yaml` file: ```yaml -# Example configuration.yaml entry +# Example configuration.yaml entry (http) sensor: - platform: sma host: IP_ADDRESS_OF_DEVICE password: YOUR_SMA_PASSWORD sensors: - current_consumption: [total_consumption] - pv_power: - total_yield: + - current_consumption + - total_consumption + - pv_power + - total_yield + +# Example configuration.yaml entry (https) +sensor: + - platform: sma + host: IP_ADDRESS_OF_DEVICE + ssl: true + verify_ssl: false + password: YOUR_SMA_PASSWORD + sensors: + - current_consumption + - total_consumption + - pv_power + - total_yield ``` {% configuration %} @@ -55,50 +69,10 @@ group: default: user type: string sensors: - description: A list of sensors that will be added. The value of the list can include a list of sensor names that will be used as attributes. + description: A list of sensors that will be added. Refer to the table in the Sensors section below. If not specified all the sensors in the library will be added. required: false default: All sensors type: list - keys: - pv_power: - description: Current power generated by the inverter (W). - pv_gen_meter: - description: Total kWh generated to date (kWh) - total_yield: - description: Total power yield from solar installation (kWh). - daily_yield: - description: The yield for today (Wh) - - current_consumption: - description: Power that you are currently drawing, depending on your installation it can be a combination of the inverter and the grid (W). - total_consumption: - description: Total power consumption (kWh). - - grid_power_supplied: - description: Power supplied (W) - grid_power_absorbed: - description: Power absorbed (W) - grid_total_yield: - description: Total power fom the grid (kWh) - grid_total_absorbed: - description: Total power supplied to the grid - - grid_power: - description: Power supplied by the grid (W) - frequency: - description: Grid frequency (W) - voltage_l1: - description: Voltage for phase 1 (V) - voltage_l2: - description: Voltage for phase 2 (V) - voltage_l2: - description: Voltage for phase 3 (V) - - status: - description: Status of the solar plant. - - your-custom-sensor: - description: Any sensor name defined in the `custom:` section custom: description: A dictionary of custom sensor key values and units. required: false @@ -117,16 +91,36 @@ custom: required: false default: 1 type: float + path: + description: A custom JMESpath to extract the sensor value (typically not required, advanced use only). + required: false + type: string {% endconfiguration %} -You can create composite sensors, where the sub-sensors will be attributes of the main sensor. E.g., +## Sensors -```yaml - sensors: - - current_power: [total_power, total_consumption] -``` +Sensors available in the library: -The SMA WebConnect module supports a wide variety of sensors, and not all these have been mapped to standard sensors. Custom sensors can be defined by using the `custom` section of the configuration. You will need: A sensor name (no spaces), the SMA sensor key and the unit +| name | Unit | Description | +|--------------|------|:-------------------------------------------| +| pv_power | W | Current power generated by the inverter. | +| pv_gen_meter | kWh | Total kWh generated to date. | +| total_yield | kWh | Total power yield from a solar installation. | +| daily_yield | Wh | The solar plant's yield for today. ! +| current_consumption | W | Power that you are currently drawing, depending on your installation it can be a combination of the inverter and the grid. | +| total_consumption | kWh | Total power consumption. | +| grid_power_supplied | W | Power supplied. | +| grid_power_absorbed | W | Power absorbed. | +| grid_total_yield | kWh | Total power from the grid. | +| grid_total_absorbed | Wh | Total power supplied to the grid +| grid_power | W | Power supplied by the grid. | +| frequency | Hz | Grid frequency. | +| voltage_l1 | V | Voltage for phase 1. | +| voltage_l2 | V | Voltage for phase 2. | +| voltage_l2 | V | Voltage for phase 3. | +| status | | Status of the solar plant. | + +The SMA WebConnect module supports a wide variety of sensors, and not all these have been mapped in the `pysma` library. Custom sensors can be defined by using the `custom` section of the configuration. You will need: A sensor name (no spaces), the SMA sensor key and the unit. Example: From e4f9b60987ccf09d36a9fee53bb644660af0fc07 Mon Sep 17 00:00:00 2001 From: Pascal Vizeli Date: Wed, 21 Aug 2019 23:05:28 +0200 Subject: [PATCH 115/126] Remove vagrant (#10192) * Remove vagrant * Remove references and unused asset --- source/_docs/installation.markdown | 6 -- source/_docs/installation/updating.markdown | 6 +- source/_docs/installation/vagrant.markdown | 112 -------------------- source/images/supported_brands/vagrant.png | Bin 2115 -> 0 bytes 4 files changed, 3 insertions(+), 121 deletions(-) delete mode 100644 source/_docs/installation/vagrant.markdown delete mode 100644 source/images/supported_brands/vagrant.png diff --git a/source/_docs/installation.markdown b/source/_docs/installation.markdown index 712384f1a16..14021f1d3b6 100644 --- a/source/_docs/installation.markdown +++ b/source/_docs/installation.markdown @@ -107,12 +107,6 @@ These guides are provided as-is. Some of these install methods are more limited
Synology
- -
- -
-
Vagrant
-
diff --git a/source/_docs/installation/updating.markdown b/source/_docs/installation/updating.markdown index 737bc171273..70caea19b07 100644 --- a/source/_docs/installation/updating.markdown +++ b/source/_docs/installation/updating.markdown @@ -6,7 +6,7 @@ redirect_from: /getting-started/updating/
-The upgrade process differs depending on the installation you have, so please review the documentation that is specific to your install [Hass.io](/hassio/), [Hassbian](/docs/installation/hassbian/common-tasks/#update-home-assistant), [Vagrant](/docs/installation/vagrant/), or [Virtualenv](/docs/installation/virtualenv/#upgrading-home-assistant). +The upgrade process differs depending on the installation you have, so please review the documentation that is specific to your install [Hass.io](/hassio/), [Hassbian](/docs/installation/hassbian/common-tasks/#update-home-assistant), or [Virtualenv](/docs/installation/virtualenv/#upgrading-home-assistant).
@@ -14,7 +14,7 @@ Check what's new in the latest version and potentially impacts your system in [H
-To avoid permission errors, the upgrade must be run as the same user as the installation was completed, again review the documentation specific to your install [Hass.io](/hassio/), [Hassbian](/docs/hassbian/installation/), [Vagrant](/docs/installation/vagrant/), or [Virtualenv](/docs/installation/virtualenv). +To avoid permission errors, the upgrade must be run as the same user as the installation was completed, again review the documentation specific to your install [Hass.io](/hassio/), [Hassbian](/docs/hassbian/installation/), or [Virtualenv](/docs/installation/virtualenv).
@@ -75,6 +75,6 @@ Best practice for updating a Hass.io installation: 1. Backup your installation, using the snapshot functionality Hass.io offers. 2. Check the release notes for breaking changes on [Home Assistant release notes](https://github.com/home-assistant/home-assistant/releases). Be sure to check all release notes between the version you are running and the one you are upgrading to. Use the search function in your browser (`CTRL + f`) and search for **Breaking Changes**. -3. Check your configuration using the [Check Home Assistant configuration](/addons/check_config/) add-on. +3. Check your configuration using the [Check Home Assistant configuration](/addons/check_config/) add-on. 4. If the check passes, you can safely update. If not, update your configuration accordingly. 5. Update Home Assistant. diff --git a/source/_docs/installation/vagrant.markdown b/source/_docs/installation/vagrant.markdown deleted file mode 100644 index 3731173cd40..00000000000 --- a/source/_docs/installation/vagrant.markdown +++ /dev/null @@ -1,112 +0,0 @@ ---- -title: "Installation on Vagrant" -description: "Instructions to run Home Assistant on a Vagrant VM." -redirect_from: /getting-started/installation-vagrant/ ---- - -A `Vagrantfile` is available into `virtualization/vagrant` folder for quickly spinning up a Linux virtual machine running Home Assistant. This can be beneficial for those who want to experiment with Home Assistant and/or developers willing to easily test local changes and run test suite against them. In the same `virtualization/vagrant` folder there's also a `provision.sh` shell script which provides an easy way to interact with the Home Assistant instance running within the Vagrant VM. For Windows, use the batch script `provision.bat`. - -
-Vagrant is intended for testing/development only. It is NOT recommended for permanent installations. -
- -## Install Vagrant - -You must have [Vagrant](https://www.vagrantup.com/downloads.html) and [Virtualbox](https://www.virtualbox.org/wiki/Downloads) installed on your workstation. Vagrant and Virtualbox support all the main platforms, including Windows, MacOS and Linux. - -Limited support is available for Hyper-V on Windows, see below. - -## Get Home Assistant source code - -Download the Home Assistant source code by either downloading the .zip file from [GitHub releases page](https://github.com/home-assistant/home-assistant/releases) or by using [Git](https://git-scm.com/) - -```bash -$ git clone https://github.com/home-assistant/home-assistant.git -$ cd home-assistant/virtualization/vagrant -``` - -
- -The following instructions will assume you changed your working directory to be `home-assistant/virtualization/vagrant`. This is mandatory because Vagrant will look for information about the running VM inside that folder and won't work otherwise - -
- -
- -When using Vagrant on Windows, change git's `auto.crlf` to input before cloning the Home Assistant repository. With input setting git won't automatically change line endings from Unix LF to Windows CRLF. Shell scripts executed during provision won't work with Windows line endings. - -
- -```bash -$ git config --global core.autocrlf input -``` - -## Create the Vagrant VM and start Home Assistant - -```bash -$ ./provision.sh setup -``` - -This will download and start a virtual machine using Virtualbox, which will internally setup the development environment necessary to start Home Assistant. The whole process might take up to 30 minutes to complete, depending on Internet connection speed and workstation resources. After the VM has started successfully, the Home Assistant frontend will be accessible locally from your browser at [http://localhost:8123](http://localhost:8123) - -## Stopping Vagrant - -To shutdown the Vagrant host: - -```bash -$ ./provision.sh stop -``` - -To start it again: - -```bash -$ ./provision.sh start -``` - -## Restarting Home Assistant process to test changes - -The root `home-assistant` directory on your workstation will be mirrored with `/home-assistant` inside the VM. In `virtualization/vagrant` there's also a `config` folder that you can use to drop configuration files (Check the [Configuration section](/docs/configuration/) in the docmentation for more information about how to configure Home Assistant). - -Any changes made to the local directory on your workstation will be available from the Vagrant host, so to apply your changes to the Home Assistant process, just restart it using the provided `provision.sh` wrapper script: - -```bash -$ ./provision.sh restart -``` - -
-This command will only restart the Home Assistant process inside the Vagrant VM, it will not reboot the virtual machine. If that's what you want, the right command is vagrant reload -
- -## Run test suite (Tox) - -To run tests against the local version of Home Assistant code: - -```bash -$ ./provision.sh tests -``` - -## Cleanup - -To completely remove the VM - -```bash -$ ./provision.sh destroy -``` - -To completely remove the VM **and** setup a fresh new environment: - -```bash -$ ./provision.sh recreate -``` - -## Windows - -On Windows, Vagrant is launched through an elevated `PowerShell`. Use the batch script `provision.bat` instead of the shell script `provision.sh`. - -## Hyper-V - -It is possible to use Hyper-V instead of Virtualbox on Windows, with some limitations. - -Samba is used for the virtual machine to access files, for which the Windows credentials are needed when the machine is created. -As Hyper-V does not allow for port forwarding, NAT is used by default for the network. Through creating an external network switch in Hyper-V it is possible to access the machine on the network. -The IP address is visible on creation, and through the Hyper-V manager. diff --git a/source/images/supported_brands/vagrant.png b/source/images/supported_brands/vagrant.png deleted file mode 100644 index b924569ea71135319753c3075434139f560ba150..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2115 zcmV-J2)y@+P)Px#icm~cMMrQgww1>gMU{m&fDk>gww1>gnm}VzA;Nkjp2K%P5e{>gwuMsoXP`&qJTpbGF{nz>ptk(W~ydMs~KgrU41n%%@m97-y?GrGV{r+0w{rGbHuHXLD zdwNLyQ2DYj zPSbvcAe6TK2@Uh`@im(axWm{#r+&X*BS=WQaX(r5`gpTd#m6t*w(aS#PLQgj<9>JA zZ*N6Fz@zBIVUN50*a67%+xkGVkoL#JmJTvht|A~vx(Uwp?Qn+w?f3n--@mRf{l+yN z&c|&>+i?dd+v!p`K>|?(f8YH1HH_YfLzj{^DStkN17BIO=YAUKvu!2kz#Re9ujrF~->Qs$A4d*rko zM{CNXM0yMUN)Qw3B(|AieN5tuOAZO5vMkdmAm$EXS3)HhCu96D!mpWcOJlcHowT+; zejf*zc@zXWXM|!iv=Zbg&=*V3EAbB&UP06+&%V{7 z^BQx$3U&BN4^1ZgMyfs~HNKR$ZCGS!nwGg=lnSKUFl(v=pouj-b=YP$h!5S*!)b`kCU2sk>P8!jwfEqOVFP{-=cTen0dsjXx6smfe)368_;A`mv_t7(EA z01pkzx-AF-NnGs`0V1uy2keJ@p0zrWVf$WBd*F#I0A*eJ!>;O{MuYLfMv-yZUqb&wPv`c;fLQ$=d z3d#k=Fb)#r>7uF|IiZh`y?oX(XgB;D5Uwl;PNOaUVC|CoASnl7f7Hy2n9g|(;W=P` z9qP8W{MN;yTO35YQvVE9#4HP60>sCOq-Rf;Tt5Cy^OY& zKzsxu9~c;I30EtZ+y@~A?FJDhI2hta!7%6=VRPE4k~Bu`0~ zEP%u{)6_Jys96WSA&>#C%&n+oXk04`r8EqZRYf2xdzf&8z9r1A(jfR#YDBYw_i*P}));010SIAf)N~ z?P0q&>qI6d%Bu^#yQ1PDVJXW@wWPZNk}B{bMu`}i(3TDx?vf=Crih`3MF-X4J_vV= z8f1R+Bw|uBO&2^zYCmBskme4EaA6Exdyev#`ZC0h(3S?_E?ESLD=LbH*4Dre$Kz?d zT2a|~0;blTLy#)xL5>%^_5sEDwpuG(jC7~3!5h}-xXF? zV_jTUIyXIT5baZ(QVf4eNx{nMPtt_N^uvJd1!qd zA=Sw$3AH`2doHscLm(_lWF5K#LMpLgqO>)jy{wy|&L`COeK~+Q_p^&jBFP4MQPo~u z6@C`+Nl$$rsVMV(wx!@(?^=mChG(Yu#vER{glX9Y+L2^kvQ1; zYJk{aAs;?%k2`@eu#K*_hXQd*)@b!SbG3u$OeR>Q^#4Jq|LylzLqB$E|DA80Owbbd z>wHIb&wTL$L9Ps0iJ#b;&=>M(ApHH6ppf-s+MZYYj_O{xH&pNTj^-6s{BR)b{T27d zbo@3TuaCz8&5XzQfY09= ty$4kls*JhU^-nK>^Y|7N&yQ3+{s9ArF@X4FRCE9U002ovPDHLkV1f)K4u1du From bada3f499c02847cdffec154fb3525e44b2c7fff Mon Sep 17 00:00:00 2001 From: Dougal Matthews Date: Wed, 21 Aug 2019 22:06:12 +0100 Subject: [PATCH 116/126] Update climate.markdown (#10199) --- source/_components/climate.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/climate.markdown b/source/_components/climate.markdown index 07687206975..1b367c3e967 100644 --- a/source/_components/climate.markdown +++ b/source/_components/climate.markdown @@ -168,7 +168,7 @@ automation: ### Service `climate.set_swing_mode` -Set operation mode for climate device +Set swing operation mode for climate device | Service data attribute | Optional | Description | | ---------------------- | -------- | ----------- | From 60922d12dcfbfa83c0b2031b7b7cb1e896a9e9d2 Mon Sep 17 00:00:00 2001 From: Jeff Irion Date: Wed, 21 Aug 2019 14:11:23 -0700 Subject: [PATCH 117/126] Add descriptive fields to script documentation (#10180) * Add descriptive fields to script documentation * Remove comment * Add descriptions of configuration variables * Working on documenting configuration variables --- source/_components/script.markdown | 52 ++++++++++++++++++++++++++++-- 1 file changed, 50 insertions(+), 2 deletions(-) diff --git a/source/_components/script.markdown b/source/_components/script.markdown index 499d234b114..09ba6536dcd 100644 --- a/source/_components/script.markdown +++ b/source/_components/script.markdown @@ -10,6 +10,8 @@ ha_release: 0.7 The `script` integration allows users to specify a sequence of actions to be executed by Home Assistant when turned on. The script integration will create an entity for each script and allow them to be controlled via services. +## Configuration + The sequence of actions is specified using the [Home Assistant Script Syntax](/getting-started/scripts/). ```yaml @@ -29,11 +31,49 @@ Script names (e.g., `message_temperature` in the example above) are not allowed
+{% configuration %} +alias: + description: Friendly name for the script. + required: false + type: string +description: + description: A description of the script that will be displayed in the Services tab under Developer Tools. + required: false + default: '' + type: string +fields: + description: Information about the parameters that the script uses; see the [Passing variables to scripts](#passing-variables-to-scripts) section below. + required: false + default: {} + type: map + keys: + PARAMETER_NAME: + description: A parameter used by this script. + type: map + keys: + description: + description: A description of PARAMETER_NAME. + type: string + example: + description: An example value for PARAMETER_NAME. + type: string +sequence: + description: The sequence of actions to be performed in the script. + required: true + type: list +{% endconfiguration %} + +### Full Configuration + ```yaml script:  - # Turns on the bedroom lights and then the living room lights 1 minute later wakeup: alias: Wake Up + description: 'Turns on the bedroom lights and then the living room lights after a delay' + fields: + minutes: + description: 'The amount of time to wait before turning on the living room lights' + example: 1 sequence: # This is Home Assistant Script Syntax - event: LOGBOOK_ENTRY @@ -49,7 +89,7 @@ script:  brightness: 100 - delay: # supports seconds, milliseconds, minutes, hours - minutes: 1 + minutes: {{ minutes }} - alias: Living room lights on service: light.turn_on data: @@ -102,6 +142,14 @@ Using the variables in the script requires the use of `data_template`: # Example configuration.yaml entry script: notify_pushover: + description: 'Send a pushover notification' + fields: + title: + description: 'The title of the notification' + example: 'State change' + message: + description: 'The message content' + example: 'The light is on!' sequence: - condition: state entity_id: switch.pushover_notifications From c6e529535539fa19eb22aef87c956fce12203f2f Mon Sep 17 00:00:00 2001 From: pdeelen <47855097+pdeelen@users.noreply.github.com> Date: Wed, 21 Aug 2019 23:12:16 +0200 Subject: [PATCH 118/126] Update utility_meter.markdown (#10175) Hi, I was adding the last part of this page to my Home Assistant installation. Icon was not allowed, and the value must between quotes. --- source/_components/utility_meter.markdown | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/source/_components/utility_meter.markdown b/source/_components/utility_meter.markdown index a79537d2ee2..59af11842ce 100644 --- a/source/_components/utility_meter.markdown +++ b/source/_components/utility_meter.markdown @@ -188,13 +188,11 @@ sensor: sensors: daily_power: friendly_name: Daily Power - icon: mdi:counter unit_of_measurement: kWh - value_template: {{ states('sensor.daily_power_offpeak')|float + states('sensor.daily_power_peak')|float }} + value_template: "{{ states('sensor.daily_power_offpeak')|float + states('sensor.daily_power_peak')|float }}" monthly_power: friendly_name: Monthly Power - icon: mdi:counter unit_of_measurement: kWh - value_template: {{ states('sensor.monthly_power_offpeak')|float + states('sensor.monthly_power_peak')|float }} + value_template: "{{ states('sensor.monthly_power_offpeak')|float + states('sensor.monthly_power_peak')|float }}" ``` {% endraw %} From 61da52ca1fd334d6d8491b17c5ed174addee2741 Mon Sep 17 00:00:00 2001 From: michaeldavie Date: Wed, 21 Aug 2019 17:12:44 -0400 Subject: [PATCH 119/126] Correct specification for radar site IDs (#10148) * Correct specification for radar site IDs * :pencil2: Tweak --- source/_components/environment_canada.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_components/environment_canada.markdown b/source/_components/environment_canada.markdown index 1a230d56c52..8ec9178bbeb 100644 --- a/source/_components/environment_canada.markdown +++ b/source/_components/environment_canada.markdown @@ -129,7 +129,7 @@ longitude: required: inclusive type: float station: - description: The station code of a specific weather station to use. If provided, this station will be used and any latitude/longitude coordinates provided will be ignored. Station codes must be in the form of `AB/s0000123`, where `AB`is a provincial abbreviation and `s0000123` is a numeric station code. + description: The station code of a specific weather station to use. If provided, this station will be used and any latitude/longitude coordinates provided will be ignored. Station codes must be in the form of `AB/s0000123`, where `AB`is a provincial abbreviation and `s0000123` is a numeric station code. required: false type: string language: @@ -177,7 +177,7 @@ camera: - If no name is given, the camera entity will be named `camera._radar`. - The platform automatically determines which radar station to use based on the system's latitude/longitude settings. For greater precision, it is also possible to specify either: - - A specific station ID from [this table](https://en.wikipedia.org/wiki/Canadian_weather_radar_network#List_of_radars) (remove the leading `C`, e.g. `XFT` or `ASBV`), or + - A specific station ID from [this table](https://en.wikipedia.org/wiki/Canadian_weather_radar_network#List_of_radars). The code must be in the form `XXX` or `CXXXX`, i.e., remove the leading `C` only if the result forms a three-letter code, otherwise, include it. Valid values include `XFT` for Ottawa or `CASBV` for Montreal. - A specific latitude/longitude {% configuration %} @@ -190,7 +190,7 @@ longitude: required: inclusive type: float station: - description: The station code of a specific radar station to use. If provided, this station will be used and any latitude/longitude coordinates provided will be ignored. + description: The station code of a specific radar station to use. If provided, this station will be used and any latitude/longitude coordinates provided will be ignored. Must be in the form `XXX` or `CXXXX`. required: false type: string name: From d6a4d02e04dd5fd7980b835c26cb0c3aba581f11 Mon Sep 17 00:00:00 2001 From: Mick Dekkers Date: Wed, 21 Aug 2019 23:13:50 +0200 Subject: [PATCH 120/126] Update references to away mode in generic_thermostat documentation (#10171) * Update references to away mode in generic_thermostat documentation * :ambulance: Fix build error --- source/_components/generic_thermostat.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_components/generic_thermostat.markdown b/source/_components/generic_thermostat.markdown index ce18077f285..ded18e84a9b 100644 --- a/source/_components/generic_thermostat.markdown +++ b/source/_components/generic_thermostat.markdown @@ -77,7 +77,7 @@ initial_hvac_mode: required: false type: string away_temp: - description: Set the temperature used by "away_mode". If this is not specified, away_mode feature will not get activated. + description: "Set the temperature used by `preset_mode: away`. If this is not specified, the preset mode feature will not be available." required: false type: float precision: @@ -91,7 +91,7 @@ A full configuration example looks like the one below. `min_cycle_duration` and Currently the `generic_thermostat` climate platform supports 'heat', 'cool' and 'off' hvac modes. You can force your `generic_thermostat` to avoid starting by setting HVAC mode to 'off'. -Please note that changing Away Mode you will force a target temperature change as well that will get restored once the Away Mode is turned off. +Please note that when changing the preset mode to away, you will force a target temperature change as well that will get restored once the preset mode is set to none again. ```yaml # Full example configuration.yaml entry From f2ea677f073c8b451d80aa553a954d42b957205f Mon Sep 17 00:00:00 2001 From: Klaas Schoute Date: Wed, 21 Aug 2019 23:17:50 +0200 Subject: [PATCH 121/126] =?UTF-8?q?=E2=9C=A8=20Troubleshooting=20automatio?= =?UTF-8?q?n=20page=20back=20in=20menu=20(#10185)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- source/_includes/asides/docs_navigation.html | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_includes/asides/docs_navigation.html b/source/_includes/asides/docs_navigation.html index e1c2af85c22..054b60fbf2a 100644 --- a/source/_includes/asides/docs_navigation.html +++ b/source/_includes/asides/docs_navigation.html @@ -61,6 +61,7 @@
  • {% active_link /docs/automation/condition/ Conditions %}
  • {% active_link /docs/automation/action/ Actions %}
  • {% active_link /docs/automation/templating/ Templates %}
    • +
  • {% active_link /docs/automation/troubleshooting/ Troubleshooting %}
  • From 7bea0d9681546f0668bde77bc573aeffa27f4fa8 Mon Sep 17 00:00:00 2001 From: akasma74 Date: Wed, 21 Aug 2019 22:19:47 +0100 Subject: [PATCH 122/126] added Testing section (#9767) * added Testing section I saw no such thing in docs and it constantly causes topics like this - https://community.home-assistant.io/t/condition-problems/124222. Hope this addition is useful. * make it more readable * moving Testing section to this better place as discussed here https://github.com/home-assistant/home-assistant.io/pull/9767#issuecomment-511128560 * moving Testing bit to Troubleshooting as discussed here https://github.com/home-assistant/home-assistant.io/pull/9767#issuecomment-511128560 * :pencil2: Tweak * :ambulance: Removing linkable_title --- .../_docs/automation/troubleshooting.markdown | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/source/_docs/automation/troubleshooting.markdown b/source/_docs/automation/troubleshooting.markdown index 9dcc2f662b6..cbd02e978b6 100644 --- a/source/_docs/automation/troubleshooting.markdown +++ b/source/_docs/automation/troubleshooting.markdown @@ -18,3 +18,21 @@ The Logbook integration will show a line entry when an automation is triggered. ![Logbook example](/images/components/automation/logbook.png) [template]: /topics/templating/ + +### Testing your automation + +It is generally a difficult task to test an automation, especially if it includes several triggers and some conditions. + +Please note that if you click on **Trigger** of an automation in the frontend, **only the `action` part will be executed** by Home Assistant. That means you **can't** test your trigger or condition part that way. It also means that if your automation uses some data from triggers, it won't work properly as well just because `trigger` is not defined in this scenario. + +All this makes that Trigger feature pretty limited and nearly useless for debugging purposes so you need to find another way. +Make sure you check and adapt to your circumstances appropriate examples from Automation Trigger, Conditions and Actions. + +It is also useful to go to **Configuration** -> **Server Control** and click on **Check Config** button in Configuration validation section to make sure there are no syntax errors before restarting Home Assistant. + +If your automation uses templates in any part, you can do the following to make sure it works as expected: + +1. Go to **Developer tools** -> **Template** tab. +2. Create all variables (sources) required for your template as described at the end of [this](https://www.home-assistant.io/docs/configuration/templating/#processing-incoming-data) paragraph. +3. Copy your template code and paste it in Template editor straight after your variables. +4. If necessary, change your sources' value and check if the template works as you want and does not generate any errors. From 447f52b65a61f39187efac5f786905d0553f9269 Mon Sep 17 00:00:00 2001 From: Daniel Anner Date: Wed, 21 Aug 2019 17:21:14 -0400 Subject: [PATCH 123/126] Update nest.markdown (#9757) I added a warning alerting new users that Works With Nest Developer accounts can no longer be created, and they need a Works With Google account to setup a custom integration for Nest products. --- source/_components/nest.markdown | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/_components/nest.markdown b/source/_components/nest.markdown index 492d35d5906..e8186f0b3f2 100644 --- a/source/_components/nest.markdown +++ b/source/_components/nest.markdown @@ -28,6 +28,10 @@ There is currently support for the following device types within Home Assistant: ### Setting up developer account +

    + New users are not currently able to set up a Works With Nest Developer account due to the change announced by Google. We will reach out to Nest to see if we can become a partner so that users joining Home Assistant after August can still use Nest. In the future we will add documentation on how to setup a Works With Google account and configure your Nest integration. +

    + 1. Visit [Nest Developers](https://developers.nest.com/), and sign in. Create an account if you don't have one already. 2. Fill in account details: * The "Company Information" can be anything. We recommend using your name. From ef860a6255ea75a90c4ac8cdf7e36dee2778246d Mon Sep 17 00:00:00 2001 From: Steven Rollason <2099542+gadgetchnnel@users.noreply.github.com> Date: Wed, 21 Aug 2019 22:41:21 +0100 Subject: [PATCH 124/126] Updated documentation for template binary_sensor (#9106) * Updated documentation for template binary_sensor * Update binary_sensor.template.markdown * Updated section header --- .../binary_sensor.template.markdown | 38 +++++++++++++++++++ 1 file changed, 38 insertions(+) diff --git a/source/_components/binary_sensor.template.markdown b/source/_components/binary_sensor.template.markdown index 3eff2ecfb53..e59acefa2a4 100644 --- a/source/_components/binary_sensor.template.markdown +++ b/source/_components/binary_sensor.template.markdown @@ -66,6 +66,15 @@ sensors: description: Defines a template for the entity picture of the sensor. required: false type: template + attribute_templates: + description: Defines templates for attributes of the sensor. + required: false + type: map + keys: + "attribute: template": + description: The attribute and corresponding template. + required: true + type: template delay_on: description: The amount of time the template state must be ***met*** before this sensor will switch to `on`. required: false @@ -210,6 +219,35 @@ binary_sensor: ``` {% endraw %} +### Device Tracker sensor with Latitude and Longitude Attributes + +This example shows how to combine an non-GPS (e.g. NMAP) and GPS device tracker while still including latitude and longitude attributes + +{% raw %} +```yaml +binary_sensor: + - platform: template + sensors: + my_device: + value_template: >- + {{ is_state('device_tracker.my_device_nmap','home') or is_state('device_tracker.my_device_gps','home') }} + device_class: 'presence' + attribute_templates: + latitude: >- + {% if is_state('device_tracker.my_device_nmap','home') %} + {{ state_attr('zone.home','latitude') }} + {% else %} + {{ state_attr('device_tracker.my_device_gps','latitude') }} + {% endif %} + longitude: >- + {% if is_state('device_tracker.my_device_nmap','home') %} + {{ state_attr('zone.home','longitude') }} + {% else %} + {{ state_attr('device_tracker.my_device_gps','longitude') }} + {% endif %} +``` +{% endraw %} + ### Change the icon when state changes This example demonstrates how to use `icon_template` to change the entity's From 9a4c87e398625d6bcc88254bf0b42fdd8269e838 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Thomas=20Lov=C3=A9n?= Date: Wed, 21 Aug 2019 23:42:11 +0200 Subject: [PATCH 125/126] Documentation for home-assistant/home-assistant-polymer#3505 (#10200) * Documentation for home-assistant/home-assistant-polymer#3505 * Add raw tags --- source/_lovelace/markdown.markdown | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/source/_lovelace/markdown.markdown b/source/_lovelace/markdown.markdown index e9ef40c5b76..f8aafc15067 100644 --- a/source/_lovelace/markdown.markdown +++ b/source/_lovelace/markdown.markdown @@ -46,3 +46,27 @@ content: > Starting with Home Assistant 0.72, we're experimenting with a new way of defining your interface. We're calling it the **Lovelace UI**. ``` + +## Template variables + +A special template variable - `config` is set up for the `content` of the card. It contains the configuration of the card. + +E.g. +{% raw %} +```yaml +type: entity-filter +entities: + - light.bed_light + - light.ceiling_lights + - light.kitchen_lights +card: + type: markdown + content: | + The lights that are on are: + {% for l in config.entities %} + - {{ l.entity }} + {%- endfor %} + + And the door is {% if is_state('binary_sensor.door', 'on' %} open {% else %} closed {% endif %}. +``` +{% endraw %} From e9fa6a3c29a63c874ee723a69a89f24d0e7a3ec0 Mon Sep 17 00:00:00 2001 From: tiagofreire-pt <41837236+tiagofreire-pt@users.noreply.github.com> Date: Wed, 21 Aug 2019 23:28:50 +0100 Subject: [PATCH 126/126] Update commandline.markdown (#10201) * Update commandline.markdown On Hassio 0.97.2. * Update commandline.markdown --- source/hassio/commandline.markdown | 45 +++++++++++++++--------------- 1 file changed, 22 insertions(+), 23 deletions(-) diff --git a/source/hassio/commandline.markdown b/source/hassio/commandline.markdown index baf99c4bb62..8cd2c7bf925 100644 --- a/source/hassio/commandline.markdown +++ b/source/hassio/commandline.markdown @@ -57,33 +57,32 @@ Replace x.y.z with the desired version like `--version=0.74.2` You can get a better description of the CLI capabilities by typing `hassio help`: ```bash -NAME: - hassio - Commandline tool to allow interaction with hass.io +Usage: + hassio [command] -USAGE: - hassio [global options] command [command options] [arguments...] +Available Commands: + addons Install, update, remove and configure Hass.io add-ons + dns Get information, update or configure the Hass.io DNS server + hardware Provides hardware information about your system + hassos HassOS specific for updating, info and configuration imports + help Help about any command + homeassistant Provides control of Home Assistant running on Hass.io + host Control the host/system that Hass.io is running on + info Provides a general Hass.io information overview + snapshots Create, restore and remove snapshot backups + supervisor Monitor, control and configure the Hass.io Supervisor -VERSION: - 1.3.1 +Flags: + --api-token string Hass.io API token + --config string Optional config file (default is $HOME/.homeassistant.yaml) + --endpoint string Endpoint for Hass.io Supervisor ( default is 'hassio' ) + -h, --help help for hassio + --log-level string Log level (defaults to Warn) + --no-progress Disable the progress spinner + --raw-json Output raw JSON from the API -AUTHOR: - Home-Assistant +Use "hassio [command] --help" for more information about a command. -COMMANDS: - homeassistant, ha info, logs, check, restart, start, stop, update - supervisor, su info, logs, reload, update - host, ho reboot, shutdown, update - hardware, hw info, audio - network, ne info, options - snapshots, sn list, info, reload, new, restore, remove - addons, ad list, info, logo, changelog, logs, stats, - reload, start, stop, install, uninstall, update - help, h Shows a list of commands or help for one command - -GLOBAL OPTIONS: - --debug, -d Prints Debug information - --help, -h show help - --version, -v print the version ``` ## Console access