From ccbfba3e2a194b1aa4b4a85065cb4d552f1daeda Mon Sep 17 00:00:00 2001 From: Ziv <16467659+ziv1234@users.noreply.github.com> Date: Mon, 2 Mar 2020 01:39:51 +0200 Subject: [PATCH 1/7] Update dynalite.markdown --- source/_integrations/dynalite.markdown | 93 +++++++++++++++++++++----- 1 file changed, 77 insertions(+), 16 deletions(-) diff --git a/source/_integrations/dynalite.markdown b/source/_integrations/dynalite.markdown index 22b5e1c78bc7..561e10869b89 100755 --- a/source/_integrations/dynalite.markdown +++ b/source/_integrations/dynalite.markdown @@ -1,28 +1,27 @@ --- -title: Philips Dynalite -description: Instructions on setting up Philips Dynalite within Home Assistant. +title: "Philips Dynalite" +description: "Instructions on setting up Philips Dynalite within Home Assistant." logo: dynalite.png ha_category: - Hub - Light + - Switch ha_iot_class: Local Push ha_release: 0.106 -ha_codeowners: - - '@ziv1234' -ha_config_flow: true --- -Philips Dynalite support is integrated into Home Assistant as a hub that can drive the light platforms. +Philips Dynalite support is integrated into Home Assistant as a hub that can drive the light and switch platforms. There is currently support for the following device types within Home Assistant: - Lights +- Switches A Philips Dynalite hub connects to the Dynet network, which is composed of areas, channels, and preset. A Dynalite area typically (although not necessarily) defines some physical area, such as a room. -Each area can have one or more channels that correspond to the different devices they control. A channel can relate to a dimmable light, or other devices, such as a cover. +Each area can have one or more channels that correspond to the different devices they control. A channel can relate to a dimmable light, or other devices. Additionally, each area can have one or more presets that determine the behavior of all the channels, and sometimes trigger additional actions. Typically, preset 1 in an area means 'on', and preset '4' means off. Additional presets could be used for scenes and dimming. @@ -53,17 +52,17 @@ name: type: string default: dynalite active: - description: Actively query network. When starting, it will query all devices for their current status, and also will send queries when some changes are in progress (e.g., lights dimming or covers moving). Better experience but creates more load on the Dynalite network. + description: Actively query network. When starting, it will query all devices for their current status, and also will send queries when some changes are in progress (e.g. lights dimming or covers moving). Better experience but creates more load on the Dynalite network. Value can be 'on', 'off', our 'init', where 'init' will only send queries during the initial init of Home Assistant required: false - type: boolean + type: [boolean, string] default: false polltimer: - description: Polling interval for devices in transition. Value in seconds. When devices are in transition (e.g., a light fading), it will ask for a new state every X seconds until it is at the target level. Only relevant when active is set. + description: Polling interval for devices in transition. Value in seconds. When devices are in transition (e.g., a light fading), it will ask for a new state every X seconds until it is at the target level. Only relevant when active is set to 'on'. required: false type: float default: 1.0 autodiscover: - description: Enable auto-discover. As Dynalite does not support autodiscovery, this tracks event on your network, so if you turn on a light, it will be added to Home Assistant. + description: Enable auto-discover. As Dynalite does not support native autodiscovery, this tracks events on your network, so if you turn on a light, it will be added to Home Assistant. required: false type: boolean default: false @@ -81,7 +80,7 @@ area: required: true type: map keys: - 'AREA_NUMBER': + AREA_NUMBER: description: The Dynalite area number, 1-255. required: true type: map @@ -95,12 +94,37 @@ area: required: false type: float default: 2.0 + preset: + description: Specific presets for the area. + required: false + type: map + keys: + PRESET_NUMBER: + description: The Dynalite preset number in the area. + required: true + type: map + keys: + name: + description: Name of the preset. + required: false + type: string + default: AREA_NAME Preset PRESET_NUMBER + fade: + description: Fade time for the preset, in seconds. + required: false + type: float + default: 2.0 + nodefault: + description: Do not use the default presets defined globally, but only the specific ones defined for this area. + required: false + type: boolean + default: false channel: description: Map of the channels in this area. required: false type: map keys: - 'CHANNEL_NUMBER': + CHANNEL_NUMBER: description: The Dynalite channel number in the area, 1-255. required: true type: map @@ -109,12 +133,37 @@ area: description: Name of the channel. required: false type: string - default: \"AREA_NAME Channel CHANNEL_NUMBER\" + default: AREA_NAME Channel CHANNEL_NUMBER + type: + description: Type of entity this should appear as. Can be either 'light' or if this is a device that is not a light (e.g. water heater), can be 'switch' + require: false + type: string + default: light fade: description: Fade time for the channel, in seconds. required: false type: float default: 2.0 +preset: + description: Default presets for any area without the **nodefault** option + required: false + type: map + keys: + PRESET_NUMBER: + description: The Dynalite preset number in the area. + required: true + type: map + keys: + name: + description: Name of the preset. When used in an area, it will be 'AREA_NAME name'. For example, if a room's name is "Kitchen" and preset 4 is defined with name "Off", it will appear in HA as **Kitchen Off** + required: false + type: string + default: AREA_NAME Preset PRESET_NUMBER + fade: + description: Fade time for the preset, in seconds. + required: false + type: float + default: 2.0 {% endconfiguration %} ## Examples @@ -127,17 +176,29 @@ dynalite: port: 12345 autodiscover: true polltimer: 1 - areacreate: auto - log_level: debug area: + '1': + name: Office '2': name: Living Room + nodefault: true channel: '2': name: Entrance Spot fade: 10.0 '3': name: Dining Table + preset: + '5': + name: Blinking Lights + '6': + name: All Off + fade: 3.0 + preset: + '1': + name: 'On' + '4': + name: 'Off' ``` ## Initial configuration and discovery From e263fded0e13c4d0828003dc122b038297a58bec Mon Sep 17 00:00:00 2001 From: Ziv <16467659+ziv1234@users.noreply.github.com> Date: Mon, 2 Mar 2020 18:19:44 +0000 Subject: [PATCH 2/7] removed tab --- source/_integrations/dynalite.markdown | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/source/_integrations/dynalite.markdown b/source/_integrations/dynalite.markdown index 561e10869b89..d658a1162981 100755 --- a/source/_integrations/dynalite.markdown +++ b/source/_integrations/dynalite.markdown @@ -188,12 +188,12 @@ dynalite: fade: 10.0 '3': name: Dining Table - preset: - '5': - name: Blinking Lights - '6': - name: All Off - fade: 3.0 + preset: + '5': + name: Blinking Lights + '6': + name: All Off + fade: 3.0 preset: '1': name: 'On' From 6f7a71188315dce036d4283749ef46dba61fb8fa Mon Sep 17 00:00:00 2001 From: Ziv <16467659+ziv1234@users.noreply.github.com> Date: Mon, 2 Mar 2020 13:21:31 -0500 Subject: [PATCH 3/7] Update source/_integrations/dynalite.markdown Co-Authored-By: Franck Nijhof --- source/_integrations/dynalite.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/dynalite.markdown b/source/_integrations/dynalite.markdown index d658a1162981..3391d50526e5 100755 --- a/source/_integrations/dynalite.markdown +++ b/source/_integrations/dynalite.markdown @@ -52,7 +52,7 @@ name: type: string default: dynalite active: - description: Actively query network. When starting, it will query all devices for their current status, and also will send queries when some changes are in progress (e.g. lights dimming or covers moving). Better experience but creates more load on the Dynalite network. Value can be 'on', 'off', our 'init', where 'init' will only send queries during the initial init of Home Assistant + description: "Actively query network. When starting, it will query all devices for their current status, and also will send queries when some changes are in progress (e.g., lights dimming or covers moving). Better experience but creates more load on the Dynalite network. Value can be `on`, `off`, our `init`, where `init` will only send queries during the initial init of Home Assistant." required: false type: [boolean, string] default: false From 8a29ccfa67f5a74a22cbf193c9c398ded64e1436 Mon Sep 17 00:00:00 2001 From: Ziv <16467659+ziv1234@users.noreply.github.com> Date: Mon, 2 Mar 2020 13:21:51 -0500 Subject: [PATCH 4/7] Update source/_integrations/dynalite.markdown Co-Authored-By: Franck Nijhof --- source/_integrations/dynalite.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/dynalite.markdown b/source/_integrations/dynalite.markdown index 3391d50526e5..853a7a9a2b54 100755 --- a/source/_integrations/dynalite.markdown +++ b/source/_integrations/dynalite.markdown @@ -57,7 +57,7 @@ active: type: [boolean, string] default: false polltimer: - description: Polling interval for devices in transition. Value in seconds. When devices are in transition (e.g., a light fading), it will ask for a new state every X seconds until it is at the target level. Only relevant when active is set to 'on'. + description: "Polling interval for devices in transition. Value in seconds. When devices are in transition (e.g., a light fading), it will ask for a new state every X seconds until it is at the target level. Only relevant when active is set to `on`." required: false type: float default: 1.0 From 5d271fd97d47ad535e1551d3145cb9e7ca0f9319 Mon Sep 17 00:00:00 2001 From: Ziv <16467659+ziv1234@users.noreply.github.com> Date: Mon, 2 Mar 2020 13:22:06 -0500 Subject: [PATCH 5/7] Update source/_integrations/dynalite.markdown Co-Authored-By: Franck Nijhof --- source/_integrations/dynalite.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/dynalite.markdown b/source/_integrations/dynalite.markdown index 853a7a9a2b54..d09ceb6e9907 100755 --- a/source/_integrations/dynalite.markdown +++ b/source/_integrations/dynalite.markdown @@ -135,7 +135,7 @@ area: type: string default: AREA_NAME Channel CHANNEL_NUMBER type: - description: Type of entity this should appear as. Can be either 'light' or if this is a device that is not a light (e.g. water heater), can be 'switch' + description: "Type of entity this should appear as. Can be either `light` or if this is a device that is not a light (e.g., water heater), can be `switch`." require: false type: string default: light From 72fb07bb5c5d609663c9770d341dd8ffeee5dfde Mon Sep 17 00:00:00 2001 From: Ziv <16467659+ziv1234@users.noreply.github.com> Date: Mon, 2 Mar 2020 13:22:15 -0500 Subject: [PATCH 6/7] Update source/_integrations/dynalite.markdown Co-Authored-By: Franck Nijhof --- source/_integrations/dynalite.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/dynalite.markdown b/source/_integrations/dynalite.markdown index d09ceb6e9907..2c3a16e86f39 100755 --- a/source/_integrations/dynalite.markdown +++ b/source/_integrations/dynalite.markdown @@ -145,7 +145,7 @@ area: type: float default: 2.0 preset: - description: Default presets for any area without the **nodefault** option + description: "Default presets for any area without the `nodefault` option." required: false type: map keys: From b47ef2d0e4b6bfa011bbf76d0bac7511bd3a364d Mon Sep 17 00:00:00 2001 From: Ziv <16467659+ziv1234@users.noreply.github.com> Date: Mon, 2 Mar 2020 13:22:31 -0500 Subject: [PATCH 7/7] Update source/_integrations/dynalite.markdown Co-Authored-By: Franck Nijhof --- source/_integrations/dynalite.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/dynalite.markdown b/source/_integrations/dynalite.markdown index 2c3a16e86f39..57debdf688e9 100755 --- a/source/_integrations/dynalite.markdown +++ b/source/_integrations/dynalite.markdown @@ -155,7 +155,7 @@ preset: type: map keys: name: - description: Name of the preset. When used in an area, it will be 'AREA_NAME name'. For example, if a room's name is "Kitchen" and preset 4 is defined with name "Off", it will appear in HA as **Kitchen Off** + description: "Name of the preset. When used in an area, it will be 'AREA_NAME name'. For example, if a room's name is 'Kitchen' and preset 4 is defined with the name `Off`, it will appear in HA as 'Kitchen Off'." required: false type: string default: AREA_NAME Preset PRESET_NUMBER