home-assistant.github.io/source/_components/light.x10.markdown
Brendon Baumgartner ca1f2868e0 Update light.x10.markdown (#4312)
name is not optional.
2018-01-03 21:04:45 +01:00

36 lines
886 B
Markdown

---
layout: page
title: "X10"
description: "Instructions how to setup X10 devices within Home Assistant."
date: 2016-07-27
sidebar: true
comments: false
sharing: true
footer: true
logo: x10.gif
ha_category: Light
ha_iot_class: "Local Polling"
ha_release: 0.25
---
The `x10` light platform allows you to control your X10 based lights with Home Assistant.
Requires [Heyu x10](http://www.heyu.org) and a CM11A interface; the CM17A "FireCracker" interface is not supported.
To enable those lights, add the following lines to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
light:
- platform: x10
devices:
- id: a2
name: Guest Room
- id: a3
name: Bedroom Lamp
```
Configuration variables:
- **id** (*Required*): Device identifier. Composed of house code and unit id.
- **name** (*Required*): A friendly name for the device.