From 4fd1b85289917b09986463484c3848426c89ae15 Mon Sep 17 00:00:00 2001 From: Franck Nijhof Date: Thu, 5 Mar 2020 11:30:47 +0100 Subject: [PATCH] Dynalite - addition of switch platform (#12227) * Update dynalite.markdown * removed tab * Update source/_integrations/dynalite.markdown Co-Authored-By: Franck Nijhof * Update source/_integrations/dynalite.markdown Co-Authored-By: Franck Nijhof * Update source/_integrations/dynalite.markdown Co-Authored-By: Franck Nijhof * Update source/_integrations/dynalite.markdown Co-Authored-By: Franck Nijhof * Update source/_integrations/dynalite.markdown Co-Authored-By: Franck Nijhof Co-authored-by: Franck Nijhof --- 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..57debdf688e9 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 the 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