= tellstick.conf =

The file {{{/etc/tellstick.conf}}} is the file where all devices used by TellStick is configured under Linux. Each device is configured in its own block with the parameter as name/value-pairs:
{{{
device {
  foo = "bar"
}
}}}
A device has at least four values and another block names {{{parameters}}}. A typical device can look like this:
{{{
device {
  id = 1
  name = "Device 1"
  protocol = "arctech"
  model = "codeswitch"
  parameters {
    house = "A"
    unit = "1"
  }
}
}}}

 id::
  This is a number and must be unique for each device.

 name::
  A name for easy identification of the device.

 protocol::
  This is the protocol the device uses. More on the different protocols later down.

 model::
  The parameter model is only used by some protocols where there exists different types of devices using the same protocol. This can be dimmers versus non-dimmers, codeswitch versus selflearning etc.

 parameters::
  This block depends on the protocol specified and is explained under each protocol.

== Protocols ==

=== arctech ===
This protocol is used by a lot of devices. Some of them includes:
 * Nexa
 * Proove
 * Intertechno
 * HomeEasy
 * KlikAanKlikUit
 * Byebye Standby

It has three different models:

 codeswitch::
  This types of devices uses dials on the receiver and remote to address them. The parameter {{{house}}} can be A to P and the {{{unit}}} 1 to 16. A typical parameters-block can look like:
{{{
parameters {
  house = "A"
  unit = "1"
}
}}}

 selflearning-switch::
  The newer ones where the code is learned by the remote/TellStick. Instead of housecodes A to P this is now 1 to 67108863. The unitcode is still 1 to 16. Example:
{{{
parameters {
  house = "953934"
  unit = "1"
}
}}}

 selflearning-dimmer::
  This is the same as {{{selflearning-switch}}} only these devices supports dimming-commands