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

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