57 lines
3.0 KiB
Markdown
57 lines
3.0 KiB
Markdown
---
|
|
id: mochadx10
|
|
label: Mochad X10
|
|
title: Mochad X10 - Bindings
|
|
type: binding
|
|
description: "This binding makes it possible to control X10 devices via a server running the [Mochad X10 daemon by mmauka](http://sourceforge.net/projects/mochad/). Mochad is a Linux TCP gateway daemon for the X10 CM15A RF (radio frequency) and PL (power line) controller and the CM19A RF controller."
|
|
source: https://github.com/openhab/openhab1-addons/blob/master/bundles/binding/org.openhab.binding.mochadx10/README.md
|
|
since: 1x
|
|
install: auto
|
|
---
|
|
|
|
<!-- Attention authors: Do not edit directly. Please add your changes to the appropriate source repository -->
|
|
|
|
{% include base.html %}
|
|
|
|
# Mochad X10 Binding
|
|
|
|
This binding makes it possible to control X10 devices via a server running the [Mochad X10 daemon by mmauka](http://sourceforge.net/projects/mochad/). Mochad is a Linux TCP gateway daemon for the X10 CM15A RF (radio frequency) and PL (power line) controller and the CM19A RF controller.
|
|
|
|
With the current version of the binding items of type Switch, Dimmer, and Rollershutter can be controlled. The binding only uses one-way communication so no status reading (yet).
|
|
|
|
## Binding Configuration
|
|
|
|
This binding can be configured in the file `services/mochadx10.cfg`.
|
|
|
|
| Property | Default | Required | Description |
|
|
|----------|---------|:--------:|-------------|
|
|
| hostIp | | Yes | the IP address of the server on which the Mochad X10 daemon is running. |
|
|
| hostPort | 1099 | No | the port number on which the Mochad X10 daemon is communicating. |
|
|
|
|
## Item configuration
|
|
|
|
The format of the binding configuration is simple and looks like this:
|
|
|
|
```
|
|
mochadx10="<houseCode><unitCode>[:<transmitMethod>][:<dimMethod>]"
|
|
```
|
|
|
|
where parts in `[brackets]` indicate optional components.
|
|
|
|
Addressing of X10 devices is done using a so called house code and a unit code. The house code is specified by characters 'a' to 'p'. The unit code is a number from 1 to 16. This way a number of 255 X10 devices can be controlled by one X10 controller.
|
|
|
|
X10 devices can be controlled by sending commands over the power-line or by sending RF commands. To explicitly specify the `transmitMethod` a value of `pl` for power-line or `rf` for radio frequency can be used. If `transmitMethod` is not specified it defaults to `pl`.
|
|
|
|
X10 dimmer devices can use one the `dim/bright` commands or the `xdim` command to set the level of lighting. To explicitly specify the `dimMethod` of an X10 device, set it to `dim` for using the 'dim/bright' commands, or to `xdim` for using the `xdim` command. If `dimMethod` is not specified it defaults to `xdim`
|
|
|
|
## Examples
|
|
|
|
Here are some examples of valid binding configuration strings, as defined in the items configuration file:
|
|
|
|
```
|
|
Dimmer Light_Corridor_Dimmer "Hallway Dimmer [%d %%]" (GF_Corridor) {mochadx10="a1"}
|
|
Dimmer Light_Living_Dimmer "Living Dimmer [%d %%]" (GF_Living) {mochadx10="a2:pl:dim"}
|
|
Switch Mech_Vent "Mechanical ventilation" (GF_Kitchen) {mochadx10="b12"}
|
|
Rollershutter "Bedroom" (FF_Bedroom) {mochadx10="m3:rf"}
|
|
```
|