= 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 four 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"
}
}}}

 bell::
  This is bells of the codeswitch type. It only uses {{{house}}} and just as model {{{codeswitch}}} it is A to P. Example:
{{{
parameters {
  house = "C"
}
}}}

 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

=== brateck ===
This protocol is used by some projector screens. Example:
 * Roxcore

The only parameter used in this protocol is {{{house}}}. The code is 8 tri-state values soldered into the pcb. The state can be "1", "0" or "-".
Example:
{{{
parameters {
  house = "101-1011"
}
}}}

=== everflourish ===
Added to telldus-core in 2.0.2.
 This is the selflearning protocol. For the codeswitch, take a look at {{{risingsun}}}.

Brands:
 * GAO

The protocol uses {{{house}}} (0 to 16383) and {{{unit}}} (1 to 4). Example:
{{{
parameters {
  house = "117"
  unit = "2"
}
}}}

=== risingsun ===
Often small codeswitch receivers. Known brands:
 * GAO
 * Kjell & Company

Uses {{{house}}} (1 to 4) and {{{unit}}} (1 to 4). Example:
{{{
parameters {
  house = "1"
  unit = "1"
}
}}}

=== waveman ===
Very similar to arctech/codeswitch but the protocol differs just slightly. Brands:
 * Waveman
Example:
{{{
parameters {
  house = "A"
  unit = "1"
}
}}}