home-assistant.github.io/source/_components/light.x10.markdown
Rob Cranfill cfc789687c Clarification of hardware interfaces (#1580)
Clarification of which hardware interfaces the code will work with. The CM17A does not work - it does not, for example, support the "heyu info" command that this code relies on.
2016-12-10 23:16:37 +01:00

35 lines
902 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
- id: a3
name: Bedroom Lamp
```
Configuration variables:
- **id** (*Required*): Device identifier. Composed of house code und unit id.
- **name** (*Optional*): A friendly name for the device. By default *id* from the device is used.