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"
}
}
idThis is a number and must be unique for each device.nameA name for easy identification of the device.protocolThis is the protocol the device uses. More on the different protocols later down.modelThe 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. If the devices are configured from TelldusCenter, this string will also be followed by a brand name, to allow for TelldusCenter to show the correct device brand. E.g., the string will be appended by: “:proove”.parametersThis 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:
- Byebye Standby
- Chacon
- CoCo Technologies
- HomeEasy
- Intertechno
- Kappa
- KlikAanKlikUit
- Nexa
- Proove
- Rusta
It has four different models:codeswitchThis 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"
}
bellThis 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-switchRequires TellStick batch >= 5, TellStick Duo or TellStick Net
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-dimmerRequires TellStick batch >= 5, TellStick Duo or TellStick Net
This is the same as selflearning-switch only these devices supports dimming-commands
brateck
Requires TellStick batch >= 5, TellStick Duo (sending only) or TellStick Net (sending only)
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 “-“. A real world example can be found here: http://www.telldus.se/forum/viewtopic.php?t=416
Example:
parameters {
house = "101-1011"
}
everflourish
Requires TellStick batch >= 5, TellStick Duo (sending only) or TellStick Net (sending only)
Added to telldus-core in 2.0.2.
This is the selflearning protocol. For the codeswitch, take a look at risingsun.
Brands:
- Clas Ohlson
- GAO
The protocol uses house (0 to 16383) and unit (1 to 4). Example:
parameters {
house = "117"
unit = "2"
}
fuhaote
Requires TellStick batch >= 5, TellStick Duo (sending only) or TellStick Net (sending only)
Added to telldus-core in 2.0.3.
The configuration of these devices is very similar to sartano but they are not compatible with each other.
Brands:
- HQ
- Rusta
It uses the parameter code and consists of ten ones and zeros. Example:
parameters {
code = "0010010100"
}
hasta
TellStick Duo and TellStick Net can only send, not receive this protocol
Blinds
Uses house (1 to 65536) and unit (1 to 15). Example:
parameters {
house = "1"
unit = "1"
}
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"
}
kangtai
Only TellStick Net compatible. TellStick Net can only send, not receive this protocol
Known brands:
- Clas Ohlson, 36-8836
risingsun
TellStick Duo and TellStick Net can only send, not receive this protocol
Often small codeswitch receivers. Known brands:
- Conrad (selflearning)
- Clas Ohlson (codeswitch)
- GAO (codeswitch)
- Kjell & Company (codeswitch)
- Otio (selflearning)
Two models, codeswitch or selflearning:codeswitchUses house (1 to 4) and unit (1 to 4). Example:
parameters {
house = "1"
unit = "1"
}
selflearningUses house (1 to 33554432) and unit (1 to 16). Example:
parameters {
house = "5679"
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
- Brennenstuhl
- Elro
It uses the parameter code and consists of ten ones and zeros. Example:
parameters {
code = "0010010100"
}
silvanchip
TellStick Duo and TellStick Net can only send, not receive this protocol
Brands:
- Ecosavers
- KingPin – KP100
Two models, ecosavers and kp100ecosaversUses house (1 to 1048575) and unit (1 to 4). Example:
parameters {
house = "1"
unit = "1"
}
kp100Uses house (1 to 1048575). Example:
parameters {
house = "1"
}
upm
TellStick Duo and TellStick Net can only send, not receive this protocol
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
Requires TellStick batch >= 9, TellStick Duo or TellStick Net
This protocol uses the same configuration as arctech/codeswitch. Example:
parameters {
house = "A"
unit = "1"
}
yidong
Added to telldus-core in 2.0.4. Brands:
- Goobay
Uses unit (1 to 4). Example:
parameters {
unit = "1"
}