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

ikea

These receivers is not sold by Ikea anymore. There is both dimmers and non dimmers. One thing that differs this protocol against all other is that it can control up to ten receivers with just one device. It uses the parameters system, units and fade:

system can be 1 to 16.

units is a comma-separeted list of receivers to address (1 to 10).

fade is either true or false and tells a dimmer if is should fade smooth or instand between values.

Example:

parameters {
  system = "5"
  units = "2,6"
  fade = "true"
}

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

sartano

This is a very common protocol used by a lot of receivers. It has 10 dip-switches to configure the adress-code. Brands:

• Sartano
• Alpha
• Elro

It uses the parameter code and consists of ten ones and zeros. Example:

parameters {
  code = "0010010100"
}

upm

Uses parameters house (0 to 4095) and code (1 to 4). Each receiver can only remember one code at a time so using both a normal remote and TellStick is not possible. Example:

parameters {
  house = "123"
  unit = "1"
}

waveman

Very similar to arctech/codeswitch but the protocol differs just slightly. Brands:

• Waveman

Example:

parameters {
  house = "A"
  unit = "1"
}

x10

This protocol is experimental and might not work as expected!

This protocol uses the same configuration as arctech/codeswitch. Example:

parameters {
  house = "A"
  unit = "1"
}