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