home-assistant.io/source/_components/light.switch.markdown
2019-03-10 04:45:59 -07:00

1.2 KiB

layout, title, description, date, sidebar, comments, sharing, footer, ha_category, ha_release, ha_iot_class, logo, ha_qa_scale
layout title description date sidebar comments sharing footer ha_category ha_release ha_iot_class logo ha_qa_scale
page Light Switch Instructions on how to set up a light switch within Home Assistant. 2018-11-18 19:59 true false true true Light 0.83 Local Push home-assistant.png internal

The light switch platform lets you control an existing switch, allowing you to use a switch like a light in Home Assistant.

In Home Assistant's world, a wall plug is a switch. This platform allows you to expose this switch as a light source, allowing you to add, e.g., the wall plug controlling your Christmas Tree, to be part of a light group.

To enable this platform in your installation, add the following to your configuration.yaml file:

light:
  - platform: switch
    name: Christmas Tree Lights
    entity_id: switch.christmas_tree_lights

{% configuration %} name: description: The name of the light switch. required: false type: string default: Light Switch entity_id: description: "The entity_id of a switch entity to control as a light source." required: true type: string {% endconfiguration %}

A light switch only supports turning on/off a light.