Add Light Examples

Author: AzonInc

docs/firmware/additions.md

@@ -188,4 +188,44 @@ binary_sensor: // [!code ++] // [!code focus]
               # Use the previously defined new event type here // [!code ++] // [!code focus]
               event_type: apartment_special // [!code ++] // [!code focus]
 ```
+:::
+
+::: details Turn on the light when someone rings at the entrance doorbell
+You can turn on the light when someone ringts the entrance doorbell.
+```yaml
+<!--@include: minimal.example.yaml-->
+
+binary_sensor: // [!code ++] // [!code focus]
+  - id: !extend entrance_doorbell // [!code ++] // [!code focus]
+    on_press: // [!code ++] // [!code focus]
+      - tcs_intercom.send: // [!code ++] // [!code focus]
+          command: !lambda "return id(turn_on_light_command);" // [!code ++] // [!code focus]
+```
+
+If you would like to take care about the sun elevation you can adjust it.
+```yaml
+<!--@include: minimal.example.yaml-->
+
+# Import the Home Assistant sun elevation sensor // [!code ++] // [!code focus]
+sensor: // [!code ++] // [!code focus]
+  - platform: homeassistant // [!code ++] // [!code focus]
+    id: sun_elevation // [!code ++] // [!code focus]
+    entity_id: sun.sun // [!code ++] // [!code focus]
+    attribute: elevation // [!code ++] // [!code focus]
+
+# Extend the entrance doorbell sensor // [!code ++] // [!code focus]
+binary_sensor: // [!code ++] // [!code focus]
+  - id: !extend entrance_doorbell // [!code ++] // [!code focus]
+    on_press: // [!code ++] // [!code focus]
+      # Sun elevation is <= 0 (dark) // [!code ++] // [!code focus]
+      - if: // [!code ++] // [!code focus]
+          condition: // [!code ++] // [!code focus]
+            sensor.in_range: // [!code ++] // [!code focus]
+              id: sun_elevation // [!code ++] // [!code focus]
+              below: 1 // [!code ++] // [!code focus]
+          then: // [!code ++] // [!code focus]
+            # Turn on the light // [!code ++] // [!code focus]
+            - tcs_intercom.send: // [!code ++] // [!code focus]
+                command: !lambda "return id(turn_on_light_command);" // [!code ++] // [!code focus]
+```
 :::

docs/firmware/nuki-bridge-firmware.md

@@ -72,6 +72,8 @@ Your Nuki Lock is now unpaired. The pairing mode will time out after 30 seconds.
 - Apartment Doorbell `apartment_doorbell`
 - Pick up phone `pick_up_phone` <Badge type="info" text="Disabled by default" />
 - Hang up phone `hang_up_phone` <Badge type="info" text="Disabled by default" />
+- Ring To Open: Toggle `ring_to_open_toggle` <Badge type="info" text="Internal" />
+- Turn on light: Trigger `turn_on_light_trigger` <Badge type="info" text="Internal" />
 - External Button `doorman_external_button` <Badge type="info" text="Disabled by default" />
 - Nuki Connected `nuki_connected`
 - Nuki Paired `nuki_paired`

docs/firmware/stock-firmware.md

@@ -52,6 +52,8 @@ This is the minimal ESPHome configuration yaml file, make sure to change the API
 - Apartment Doorbell `apartment_doorbell`
 - Pick up phone `pick_up_phone` <Badge type="info" text="Disabled by default" />
 - Hang up phone `hang_up_phone` <Badge type="info" text="Disabled by default" />
+- Ring To Open: Toggle `ring_to_open_toggle` <Badge type="info" text="Internal" />
+- Turn on light: Trigger `turn_on_light_trigger` <Badge type="info" text="Internal" />
 - External Button `doorman_external_button` <Badge type="info" text="Disabled by default" />
 
 ### Switches

firmware/base.yaml

@@ -483,6 +483,15 @@ binary_sensor:
     entity_category: DIAGNOSTIC
     disabled_by_default: true
 
+  - platform: tcs_intercom
+    id: "turn_on_light_trigger"
+    name: "Turn on light: Trigger"
+    internal: true
+    lambda: !lambda "return id(turn_on_light_command);"
+    auto_off: 0.2s
+    entity_category: DIAGNOSTIC
+    disabled_by_default: true
+
   - platform: gpio
     id: doorman_external_button
     name: External Button