Dynalite - addition of switch platform (home-assistant#12227)

* Update dynalite.markdown * removed tab * Update source/_integrations/dynalite.markdown Co-Authored-By: Franck Nijhof <[email protected]> * Update source/_integrations/dynalite.markdown Co-Authored-By: Franck Nijhof <[email protected]> * Update source/_integrations/dynalite.markdown Co-Authored-By: Franck Nijhof <[email protected]> * Update source/_integrations/dynalite.markdown Co-Authored-By: Franck Nijhof <[email protected]> * Update source/_integrations/dynalite.markdown Co-Authored-By: Franck Nijhof <[email protected]> Co-authored-by: Franck Nijhof <[email protected]>
Thrilleratplay · Mar 5, 2020 · 4fd1b85 · 4fd1b85
1 parent 28e2c78
commit 4fd1b85
Showing 1 changed file with 77 additions and 16 deletions.
diff --git 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