<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<!--<link rel="shortcut icon" href="https://www.openhab.org/favicon.png"></link>-->
<title>TinkerForge - Bindings - openHAB 2 - Empowering the Smart Home</title>
<!-- CSS -->
<link type="text/css" rel="stylesheet" href="/v2.1/css/materialize.css" media="screen,projection" />
<link type="text/css" rel="stylesheet" href="/v2.1/css/pygments-jekyll-style.css" />
<link type="text/css" rel="stylesheet" href="/v2.1/css/styles.css" />
<link type="text/css" rel="stylesheet" href="/v2.1/css/openhab.css" />
<link type="text/css" rel="stylesheet" href="/v2.1/css/collapsible.css" />
<!-- Font -->
<link type="text/css" rel="stylesheet" href="https://fonts.googleapis.com/icon?family=Material+Icons" />
<link type="text/css" rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:300,400,700" />
<link rel="canonical" href="http://docs.openhab.org/addons/bindings/tinkerforge1/readme.html" />
<script type="text/javascript">var gaProperty = 'UA-47717934-3';var disableStr = 'ga-disable-' + gaProperty;if (document.cookie.indexOf(disableStr + '=true') > -1) {window[disableStr] = true;}</script>
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-47717934-3', 'auto');
ga('set', 'anonymizeIp', true);
ga('send', 'pageview');
</script>
</head>
<body class="documentation">
<div id="header" class="navbar-fixed">
<nav role="navigation">
<div class="container">
<div class="nav-wrapper">
<a href="/v2.1/index.html"><img id="logo" src="/images/logo.png" /></a>
<a href="#" data-activates="nav-mobile" class="button-collapse"><i class="material-icons">menu</i></a>
<ul class="right hide-on-med-and-down">
<li><a href="/tutorials/index.html">Tutorials</a></li>
<li><a href="/v2.1/introduction.html">User Manual</a></li>
<li><a href="/developers/index.html">Developer Guide</a></li>
<li><a target="_blank" href="https://community.openhab.org">Community Forum</a></li>
<li><a target="_blank" href="https://github.com/openhab">GitHub</a></li>
<li class="search"><i class="material-icons">search</i></li>
<li class="search">
<form method="GET" id="searchform" class="search-form" action="/search">
<input id="query" name="q" type="text" class="search-form-input" placeholder="search" />
</form>
</li>
</ul>
<ul id="nav-mobile" class="side-nav">
<li><a href="/v2.1/index.html">Home</a></li>
<li><a href="/tutorials/index.html">Tutorials</a></li>
<li><a href="/v2.1/introduction.html">User Manual</a></li>
<li><a href="/developers/index.html">Developer Guide</a></li>
<li><a target="_blank" href="https://community.openhab.org">Community Forum</a></li>
<li><a target="_blank" href="https://github.com/openhab">GitHub</a></li>
<li class="search">
<form method="GET" id="searchformmob" class="search-form" action="/search">
<input id="querymob" name="q" type="text" class="search-form-input" placeholder="search" />
</form>
</li>
</ul>
</div>
</div>
</nav>
</div>
<section id="documentation" class="text content-wrapper">
<div class="container">
<div class="side-nav-wrapper">
<ul class="nav">
<li><a href="/v2.1/introduction.html">Introduction</a></li>
<li><a href="/v2.1/concepts/index.html">Concepts</a>
<ul>
<li><a href="/v2.1/concepts/index.html">Overview</a></li>
<hr />
<li><a href="/v2.1/concepts/things.html">Things</a></li>
<li><a href="/v2.1/concepts/items.html">Items</a></li>
<li><a href="/v2.1/concepts/discovery.html">Inbox & Discovery</a></li>
<li><a href="/v2.1/concepts/audio.html">Audio & Voice</a></li>
</ul>
</li>
<li><a href="/v2.1/installation/index.html">Installation</a>
<ul>
<li><a href="/v2.1/installation/index.html">Overview</a></li>
<hr />
<li><a href="/v2.1/installation/linux.html">Linux</a></li>
<li><a href="/v2.1/installation/windows.html">Windows</a></li>
<li><a href="/v2.1/installation/macosx.html">Mac OS X</a></li>
<hr />
<li><a href="/v2.1/installation/openhabian.html">openHABian</a></li>
<li><a href="/v2.1/installation/docker.html">Docker</a></li>
<hr />
<li><a href="/v2.1/installation/rasppi.html">Raspberry Pi</a></li>
<li><a href="/v2.1/installation/pine.html">Pine A64</a></li>
<li><a href="/v2.1/installation/synology.html">Synology DiskStation</a></li>
<li><a href="/v2.1/installation/qnap.html">QNAP NAS</a></li>
<hr />
<li><a href="/v2.1/installation/designer.html">SmartHome Designer</a></li>
<li><a href="/v2.1/installation/security.html">Security & Remote Access</a></li>
<li><a href="http://www.myopenhab.org">myopenHAB</a></li>
</ul>
</li>
<li><a href="/v2.1/configuration/index.html">Configuration</a>
<ul>
<li><a href="/v2.1/configuration/index.html">Overview</a></li>
<hr />
<li><a href="/v2.1/configuration/things.html">Things</a></li>
<li><a href="/v2.1/configuration/items.html">Items</a></li>
<li><a href="/v2.1/configuration/sitemaps.html">Sitemaps</a></li>
<li><a href="/v2.1/configuration/transform.html">Transformations</a></li>
<li><a href="/v2.1/configuration/persistence.html">Persistence</a></li>
<li><a href="/v2.1/configuration/rules-dsl.html">Rules</a></li>
<li><a href="/v2.1/configuration/services.html">Services</a></li>
<hr />
<li><a href="/v2.1/configuration/packages.html">Initial Setup Packages</a></li>
<li><a href="/v2.1/configuration/paperui.html">Paper UI</a></li>
<li><a href="/v2.1/configuration/habmin.html">HABmin</a></li>
<li><a href="/v2.1/configuration/rules-ng.html">Rules (Experimental)</a></li>
<hr />
<li><a href="/v2.1/configuration/multimedia.html">Audio & Voice</a></li>
</ul>
</li>
<li><a href="/v2.1/addons/index.html">Add-ons</a>
<ul>
<li><a href="/v2.1/addons/index.html">Overview</a></li>
<hr />
<li><a href="/v2.1/addons/bindings.html">Bindings</a>
<ul>
<li><a href="/v2.1/addons/bindings.html">Overview</a></li>
<hr />
<li><a href="/v2.1/addons/bindings/airquality/readme.html">Air Quality</a></li>
<li><a href="/v2.1/addons/bindings/akm8681/readme.html">AKM868</a></li>
<li><a href="/v2.1/addons/bindings/alarmdecoder1/readme.html">Alarm Decoder</a></li>
<li><a href="/v2.1/addons/bindings/allplay/readme.html">AllPlay</a></li>
<li><a href="/v2.1/addons/bindings/amazondashbutton/readme.html">Amazon Dash Button</a></li>
<li><a href="/v2.1/addons/bindings/anel1/readme.html">Anel NET-PwrCtrl</a></li>
<li><a href="/v2.1/addons/bindings/asterisk1/readme.html">Asterisk</a></li>
<li><a href="/v2.1/addons/bindings/astro/readme.html">Astro</a></li>
<li><a href="/v2.1/addons/bindings/astro1/readme.html">Astro</a></li>
<li><a href="/v2.1/addons/bindings/atlona/readme.html">Atlona</a></li>
<li><a href="/v2.1/addons/bindings/autelis/readme.html">Autelis Pool Control</a></li>
<li><a href="/v2.1/addons/bindings/autelis1/readme.html">Autelis</a></li>
<li><a href="/v2.1/addons/bindings/avmfritz/readme.html">AVM FRITZ!</a></li>
<li><a href="/v2.1/addons/bindings/benqprojector1/readme.html">BenQ Projector</a></li>
<li><a href="/v2.1/addons/bindings/bigassfan/readme.html">BigAssFan</a></li>
<li><a href="/v2.1/addons/bindings/bluetooth1/readme.html">Bluetooth</a></li>
<li><a href="/v2.1/addons/bindings/boschindego/readme.html">Bosch Indego</a></li>
<li><a href="/v2.1/addons/bindings/bticino1/readme.html">Bticino</a></li>
<li><a href="/v2.1/addons/bindings/caldav-command1/readme.html">CalDAV Command</a></li>
<li><a href="/v2.1/addons/bindings/caldav-personal1/readme.html">CalDAV Personal</a></li>
<li><a href="/v2.1/addons/bindings/chromecast/readme.html">Chromecast</a></li>
<li><a href="/v2.1/addons/bindings/comfoair1/readme.html">ComfoAir</a></li>
<li><a href="/v2.1/addons/bindings/configadmin1/readme.html">ConfigAdmin</a></li>
<li><a href="/v2.1/addons/bindings/coolmasternet/readme.html">CoolMasterNet</a></li>
<li><a href="/v2.1/addons/bindings/cups1/readme.html">CUPS</a></li>
<li><a href="/v2.1/addons/bindings/daikin1/readme.html">Daikin</a></li>
<li><a href="/v2.1/addons/bindings/davis1/readme.html">Davis</a></li>
<li><a href="/v2.1/addons/bindings/ddwrt1/readme.html">DD-WRT</a></li>
<li><a href="/v2.1/addons/bindings/denon1/readme.html">Denon</a></li>
<li><a href="/v2.1/addons/bindings/digitalstrom/readme.html">digitalSTROM</a></li>
<li><a href="/v2.1/addons/bindings/digitalstrom1/readme.html">digitalSTROM</a></li>
<li><a href="/v2.1/addons/bindings/diyonxbee1/readme.html">DIYOnXBee</a></li>
<li><a href="/v2.1/addons/bindings/dlinksmarthome/readme.html">D-Link Smart Home</a></li>
<li><a href="/v2.1/addons/bindings/dmx1/readme.html">DMX</a></li>
<li><a href="/v2.1/addons/bindings/dscalarm/readme.html">DSC Alarm</a></li>
<li><a href="/v2.1/addons/bindings/dscalarm1/readme.html">DSC PowerSeries Alarm System</a></li>
<li><a href="/v2.1/addons/bindings/dsmr1/readme.html">DSMR</a></li>
<li><a href="/v2.1/addons/bindings/ebus1/readme.html">eBUS</a></li>
<li><a href="/v2.1/addons/bindings/ecobee1/readme.html">Ecobee</a></li>
<li><a href="/v2.1/addons/bindings/ecotouch1/readme.html">EcoTouch</a></li>
<li><a href="/v2.1/addons/bindings/ekey1/readme.html">ekey</a></li>
<li><a href="/v2.1/addons/bindings/energenie1/readme.html">Energenie</a></li>
<li><a href="/v2.1/addons/bindings/enocean1/readme.html">EnOcean</a></li>
<li><a href="/v2.1/addons/bindings/enphaseenergy1/readme.html">Enphase Energy</a></li>
<li><a href="/v2.1/addons/bindings/epsonprojector1/readme.html">Epson Projector</a></li>
<li><a href="/v2.1/addons/bindings/exec/readme.html">Exec</a></li>
<li><a href="/v2.1/addons/bindings/exec1/readme.html">Exec</a></li>
<li><a href="/v2.1/addons/bindings/expire1/readme.html">Expire</a></li>
<li><a href="/v2.1/addons/bindings/fatekplc1/readme.html">Fatek PLC</a></li>
<li><a href="/v2.1/addons/bindings/feed/readme.html">Feed</a></li>
<li><a href="/v2.1/addons/bindings/fht1/readme.html">FHT</a></li>
<li><a href="/v2.1/addons/bindings/folding/readme.html">Folding@home</a></li>
<li><a href="/v2.1/addons/bindings/freebox/readme.html">Freebox</a></li>
<li><a href="/v2.1/addons/bindings/freebox1/readme.html">Freebox</a></li>
<li><a href="/v2.1/addons/bindings/freeswitch1/readme.html">FreeSWITCH</a></li>
<li><a href="/v2.1/addons/bindings/fritzaha1/readme.html">Fritz AHA</a></li>
<li><a href="/v2.1/addons/bindings/fritzbox1/readme.html">Fritz!Box</a></li>
<li><a href="/v2.1/addons/bindings/fritzboxtr0641/readme.html">Fritzbox (using TR064 protocol)</a></li>
<li><a href="/v2.1/addons/bindings/frontiersiliconradio1/readme.html">Frontier Silicon Radio</a></li>
<li><a href="/v2.1/addons/bindings/fs201/readme.html">FS20</a></li>
<li><a href="/v2.1/addons/bindings/fsinternetradio/readme.html">FS Internet Radio</a></li>
<li><a href="/v2.1/addons/bindings/garadget1/readme.html">Garadget</a></li>
<li><a href="/v2.1/addons/bindings/gardena/readme.html">Gardena</a></li>
<li><a href="/v2.1/addons/bindings/gc100ir1/readme.html">Global Cache IR</a></li>
<li><a href="/v2.1/addons/bindings/globalcache/readme.html">GlobalCache</a></li>
<li><a href="/v2.1/addons/bindings/gpio1/readme.html">GPIO</a></li>
<li><a href="/v2.1/addons/bindings/harmonyhub/readme.html">Logitech Harmony Hub</a></li>
<li><a href="/v2.1/addons/bindings/harmonyhub1/readme.html">Harmony Hub</a></li>
<li><a href="/v2.1/addons/bindings/hdanywhere/readme.html">HDanywhere</a></li>
<li><a href="/v2.1/addons/bindings/hdanywhere1/readme.html">HDanywhere</a></li>
<li><a href="/v2.1/addons/bindings/hdpowerview/readme.html">Hunter Douglas PowerView</a></li>
<li><a href="/v2.1/addons/bindings/heatmiser1/readme.html">Heatmiser</a></li>
<li><a href="/v2.1/addons/bindings/hms1/readme.html">HMS</a></li>
<li><a href="/v2.1/addons/bindings/homematic/readme.html">Homematic</a></li>
<li><a href="/v2.1/addons/bindings/homematic1/readme.html">Homematic</a></li>
<li><a href="/v2.1/addons/bindings/horizon1/readme.html">Horizon mediabox</a></li>
<li><a href="/v2.1/addons/bindings/http1/readme.html">HTTP</a></li>
<li><a href="/v2.1/addons/bindings/hue/readme.html">Philips Hue</a></li>
<li><a href="/v2.1/addons/bindings/hue1/readme.html">Hue</a></li>
<li><a href="/v2.1/addons/bindings/iec6205621meter1/readme.html">IEC 62056-21 Meter</a></li>
<li><a href="/v2.1/addons/bindings/ihc1/readme.html">IHC / ELKO</a></li>
<li><a href="/v2.1/addons/bindings/insteonhub1/readme.html">Insteon Hub</a></li>
<li><a href="/v2.1/addons/bindings/insteonplm1/readme.html">Insteon PLM</a></li>
<li><a href="/v2.1/addons/bindings/intertechno1/readme.html">Intertechno</a></li>
<li><a href="/v2.1/addons/bindings/ipp/readme.html">IPP</a></li>
<li><a href="/v2.1/addons/bindings/ipx8001/readme.html">IPX800</a></li>
<li><a href="/v2.1/addons/bindings/irtrans1/readme.html">IRTrans</a></li>
<li><a href="/v2.1/addons/bindings/isy1/readme.html">Description</a></li>
<li><a href="/v2.1/addons/bindings/jointspace1/readme.html">jointSPACE</a></li>
<li><a href="/v2.1/addons/bindings/k80551/readme.html">Velleman k8055 USB IO Board</a></li>
<li><a href="/v2.1/addons/bindings/keba/readme.html">Keba</a></li>
<li><a href="/v2.1/addons/bindings/km2001/readme.html">KM200</a></li>
<li><a href="/v2.1/addons/bindings/knx1/readme.html">KNX</a></li>
<li><a href="/v2.1/addons/bindings/kodi/readme.html">Kodi</a></li>
<li><a href="/v2.1/addons/bindings/kostalinverter/readme.html">Kostal Inverter</a></li>
<li><a href="/v2.1/addons/bindings/koubachi1/readme.html">Koubachi</a></li>
<li><a href="/v2.1/addons/bindings/lcn1/readme.html">LCN</a></li>
<li><a href="/v2.1/addons/bindings/lgtv1/readme.html">LG TV</a></li>
<li><a href="/v2.1/addons/bindings/lgtvserial/readme.html">LG TV control using serial protocol</a></li>
<li><a href="/v2.1/addons/bindings/lifx/readme.html">LIFX</a></li>
<li><a href="/v2.1/addons/bindings/lightwaverf1/readme.html">LightwaveRF</a></li>
<li><a href="/v2.1/addons/bindings/lutron/readme.html">Lutron</a></li>
<li><a href="/v2.1/addons/bindings/mailcontrol1/readme.html">MailControl</a></li>
<li><a href="/v2.1/addons/bindings/max/readme.html">MAX!</a></li>
<li><a href="/v2.1/addons/bindings/maxcube1/readme.html">MAX!Cube</a></li>
<li><a href="/v2.1/addons/bindings/maxcul1/readme.html">MAX!CUL</a></li>
<li><a href="/v2.1/addons/bindings/mcp230171/readme.html">MCP23017</a></li>
<li><a href="/v2.1/addons/bindings/mcp34241/readme.html">MCP3424</a></li>
<li><a href="/v2.1/addons/bindings/meteostick/readme.html">Meteostick</a></li>
<li><a href="/v2.1/addons/bindings/miele/readme.html">Miele@home</a></li>
<li><a href="/v2.1/addons/bindings/mihome/readme.html">Xiaomi Mi Smart Home</a></li>
<li><a href="/v2.1/addons/bindings/milight/readme.html">Milight/Easybulb/Limitless</a></li>
<li><a href="/v2.1/addons/bindings/milight1/readme.html">Milight</a></li>
<li><a href="/v2.1/addons/bindings/minecraft/readme.html">Minecraft</a></li>
<li><a href="/v2.1/addons/bindings/mios1/readme.html">MiOS Bridge</a></li>
<li><a href="/v2.1/addons/bindings/mochadx101/readme.html">Mochad X10</a></li>
<li><a href="/v2.1/addons/bindings/modbus1/readme.html">Modbus</a></li>
<li><a href="/v2.1/addons/bindings/mpd1/readme.html">MPD</a></li>
<li><a href="/v2.1/addons/bindings/mqtt1/readme.html">MQTT</a></li>
<li><a href="/v2.1/addons/bindings/mqttitude1/readme.html">OwnTracks (formerly MQTTitude)</a></li>
<li><a href="/v2.1/addons/bindings/myq1/readme.html">Chamberlain MyQ</a></li>
<li><a href="/v2.1/addons/bindings/mystromecopower1/readme.html">Mystrom Eco Power</a></li>
<li><a href="/v2.1/addons/bindings/neohub1/readme.html">NeoHub</a></li>
<li><a href="/v2.1/addons/bindings/nest1/readme.html">Nest</a></li>
<li><a href="/v2.1/addons/bindings/netatmo/readme.html">Netatmo</a></li>
<li><a href="/v2.1/addons/bindings/netatmo1/readme.html">Netatmo</a></li>
<li><a href="/v2.1/addons/bindings/network/readme.html">Network</a></li>
<li><a href="/v2.1/addons/bindings/networkhealth1/readme.html">Network Health</a></li>
<li><a href="/v2.1/addons/bindings/networkupstools1/readme.html">Network UPS Tools</a></li>
<li><a href="/v2.1/addons/bindings/nibeheatpump1/readme.html">Nibe Heatpump</a></li>
<li><a href="/v2.1/addons/bindings/nikobus1/readme.html">Nikobus</a></li>
<li><a href="/v2.1/addons/bindings/nikohomecontrol/readme.html">Niko Home Control</a></li>
<li><a href="/v2.1/addons/bindings/novelanheatpump1/readme.html">Novelan/Luxtronic Heat Pump</a></li>
<li><a href="/v2.1/addons/bindings/ntp/readme.html">NTP</a></li>
<li><a href="/v2.1/addons/bindings/ntp1/readme.html">Network Time Protocol (NTP)</a></li>
<li><a href="/v2.1/addons/bindings/oceanic/readme.html">Oceanic</a></li>
<li><a href="/v2.1/addons/bindings/omnilink1/readme.html">HAI/Leviton Omni and Lumina</a></li>
<li><a href="/v2.1/addons/bindings/onebusaway/readme.html">OneBusAway</a></li>
<li><a href="/v2.1/addons/bindings/onewire1/readme.html">OneWire</a></li>
<li><a href="/v2.1/addons/bindings/onkyo/readme.html">Onkyo</a></li>
<li><a href="/v2.1/addons/bindings/onkyo1/readme.html">Onkyo AV Receiver</a></li>
<li><a href="/v2.1/addons/bindings/openenergymonitor1/readme.html">Open Energy Monitor</a></li>
<li><a href="/v2.1/addons/bindings/openpaths1/readme.html">OpenPaths</a></li>
<li><a href="/v2.1/addons/bindings/opensprinkler/readme.html">OpenSprinkler</a></li>
<li><a href="/v2.1/addons/bindings/opensprinkler1/readme.html">OpenSprinkler</a></li>
<li><a href="/v2.1/addons/bindings/orvibo/readme.html">Orvibo</a></li>
<li><a href="/v2.1/addons/bindings/owserver1/readme.html">OWServer</a></li>
<li><a href="/v2.1/addons/bindings/panasonictv1/readme.html">Panasonic TV</a></li>
<li><a href="/v2.1/addons/bindings/panstamp1/readme.html">panStamp</a></li>
<li><a href="/v2.1/addons/bindings/piface1/readme.html">Piface</a></li>
<li><a href="/v2.1/addons/bindings/pilight1/readme.html">pilight</a></li>
<li><a href="/v2.1/addons/bindings/pioneeravr/readme.html">PioneerAVR Configuration</a></li>
<li><a href="/v2.1/addons/bindings/pioneeravr1/readme.html">Pioneer AV Receiver (1.x)</a></li>
<li><a href="/v2.1/addons/bindings/plcbus1/readme.html">PLCBus</a></li>
<li><a href="/v2.1/addons/bindings/plclogo1/readme.html">PLCLogo</a></li>
<li><a href="/v2.1/addons/bindings/plex1/readme.html">Plex</a></li>
<li><a href="/v2.1/addons/bindings/plugwise1/readme.html">Plugwise</a></li>
<li><a href="/v2.1/addons/bindings/powerdoglocalapi1/readme.html">PowerDog Local API</a></li>
<li><a href="/v2.1/addons/bindings/powermax1/readme.html">Visonic Powermax</a></li>
<li><a href="/v2.1/addons/bindings/primare1/readme.html">Primare</a></li>
<li><a href="/v2.1/addons/bindings/pulseaudio/readme.html">Pulseaudio</a></li>
<li><a href="/v2.1/addons/bindings/pulseaudio1/readme.html">Pulseaudio</a></li>
<li><a href="/v2.1/addons/bindings/rfxcom/readme.html">RFXCOM</a></li>
<li><a href="/v2.1/addons/bindings/rfxcom1/readme.html">RFXCOM</a></li>
<li><a href="/v2.1/addons/bindings/rme/readme.html">RME</a></li>
<li><a href="/v2.1/addons/bindings/rpircswitch1/readme.html">Raspberry Pi RC Switch</a></li>
<li><a href="/v2.1/addons/bindings/russound/readme.html">Russound</a></li>
<li><a href="/v2.1/addons/bindings/rwesmarthome1/readme.html">RWE SmartHome</a></li>
<li><a href="/v2.1/addons/bindings/sagercaster1/readme.html">Sager Weathercaster</a></li>
<li><a href="/v2.1/addons/bindings/sallegra1/readme.html">Sallegra</a></li>
<li><a href="/v2.1/addons/bindings/samsungac1/readme.html">Samsung Air Conditioner</a></li>
<li><a href="/v2.1/addons/bindings/samsungtv/readme.html">Samsung TV</a></li>
<li><a href="/v2.1/addons/bindings/samsungtv1/readme.html">Samsung TV</a></li>
<li><a href="/v2.1/addons/bindings/sapp1/readme.html">Picnet Sapp</a></li>
<li><a href="/v2.1/addons/bindings/satel1/readme.html">Satel Integra Alarm System</a></li>
<li><a href="/v2.1/addons/bindings/sensebox/readme.html">senseBox</a></li>
<li><a href="/v2.1/addons/bindings/serial1/readme.html">Serial</a></li>
<li><a href="/v2.1/addons/bindings/silvercrestwifisocket/readme.html">Silvercrest Wifi Plug</a></li>
<li><a href="/v2.1/addons/bindings/sleepiq/readme.html">SleepIQ</a></li>
<li><a href="/v2.1/addons/bindings/smaenergymeter/readme.html">SMA Energy Meter</a></li>
<li><a href="/v2.1/addons/bindings/smarthomatic1/readme.html">Smarthomatic</a></li>
<li><a href="/v2.1/addons/bindings/snmp1/readme.html">SNMP</a></li>
<li><a href="/v2.1/addons/bindings/sonance1/readme.html">Sonance</a></li>
<li><a href="/v2.1/addons/bindings/sonos/readme.html">Sonos</a></li>
<li><a href="/v2.1/addons/bindings/sonos1/readme.html">Sonos</a></li>
<li><a href="/v2.1/addons/bindings/souliss1/readme.html">Souliss</a></li>
<li><a href="/v2.1/addons/bindings/squeezebox/readme.html">Logitech Squeezebox</a></li>
<li><a href="/v2.1/addons/bindings/squeezebox1/readme.html">Squeezebox</a></li>
<li><a href="/v2.1/addons/bindings/stiebelheatpump1/readme.html">Stiebel Eltron LWZ</a></li>
<li><a href="/v2.1/addons/bindings/swegonventilation1/readme.html">Swegon Ventilation</a></li>
<li><a href="/v2.1/addons/bindings/synopanalyzer/readme.html">Synop Analyzer</a></li>
<li><a href="/v2.1/addons/bindings/systeminfo/readme.html">Systeminfo</a></li>
<li><a href="/v2.1/addons/bindings/systeminfo1/readme.html">System Information</a></li>
<li><a href="/v2.1/addons/bindings/tacmi1/readme.html">TACmi</a></li>
<li><a href="/v2.1/addons/bindings/tankerkoenig/readme.html">Tankerkönig</a></li>
<li><a href="/v2.1/addons/bindings/tcp1/readme.html">TCP & UDP</a></li>
<li><a href="/v2.1/addons/bindings/tellstick/readme.html">Tellstick</a></li>
<li><a href="/v2.1/addons/bindings/tellstick1/readme.html">Tellstick</a></li>
<li><a href="/v2.1/addons/bindings/tesla/readme.html">Tesla</a></li>
<li><a href="/v2.1/addons/bindings/tinkerforge1/readme.html">TinkerForge</a></li>
<li><a href="/v2.1/addons/bindings/tivo1/readme.html">TiVo</a></li>
<li><a href="/v2.1/addons/bindings/toon/readme.html">Toon</a></li>
<li><a href="/v2.1/addons/bindings/tradfri/readme.html">Trådfri</a></li>
<li><a href="/v2.1/addons/bindings/ucprelayboard1/readme.html">UCProjects.eu Relay Board</a></li>
<li><a href="/v2.1/addons/bindings/upb1/readme.html">UPB</a></li>
<li><a href="/v2.1/addons/bindings/urtsi/readme.html">Somfy URTSI II</a></li>
<li><a href="/v2.1/addons/bindings/urtsi1/readme.html">Somfy URTSI II</a></li>
<li><a href="/v2.1/addons/bindings/vdr1/readme.html">Video Disk Recorder (VDR)</a></li>
<li><a href="/v2.1/addons/bindings/vitotronic/readme.html">Vitotronic</a></li>
<li><a href="/v2.1/addons/bindings/wago1/readme.html">WAGO</a></li>
<li><a href="/v2.1/addons/bindings/weather1/readme.html">Weather</a></li>
<li><a href="/v2.1/addons/bindings/wemo/readme.html">Belkin Wemo</a></li>
<li><a href="/v2.1/addons/bindings/wemo1/readme.html">Wemo</a></li>
<li><a href="/v2.1/addons/bindings/wifiled/readme.html">WiFi LED</a></li>
<li><a href="/v2.1/addons/bindings/windcentrale/readme.html">Windcentrale</a></li>
<li><a href="/v2.1/addons/bindings/withings1/readme.html">Withings</a></li>
<li><a href="/v2.1/addons/bindings/wol1/readme.html">Wake-on-LAN</a></li>
<li><a href="/v2.1/addons/bindings/wr32231/readme.html">WR3223 ventilation controller</a></li>
<li><a href="/v2.1/addons/bindings/xbmc1/readme.html">XBMC binding (for KODI) (1.x)</a></li>
<li><a href="/v2.1/addons/bindings/xpl1/readme.html">xPL</a></li>
<li><a href="/v2.1/addons/bindings/yahooweather/readme.html">YahooWeather</a></li>
<li><a href="/v2.1/addons/bindings/yamahareceiver/readme.html">Yamahareceiver</a></li>
<li><a href="/v2.1/addons/bindings/yamahareceiver1/readme.html">Yamaha Receiver (1.x)</a></li>
<li><a href="/v2.1/addons/bindings/zibase1/readme.html">Zibase</a></li>
<li><a href="/v2.1/addons/bindings/zigbee/readme.html">ZigBee</a></li>
<li><a href="/v2.1/addons/bindings/zoneminder/readme.html">Zoneminder</a></li>
<li><a href="/v2.1/addons/bindings/zwave/readme.html">ZWave</a></li>
<li><a href="/v2.1/addons/bindings/zwave1/readme.html">Z-Wave</a></li>
<li><a href="/v2.1/addons/bindings/zway/readme.html">Z-Way</a></li>
</ul>
</li>
<li><a href="/v2.1/addons/uis.html">User Interfaces</a>
<ul>
<li><a href="/v2.1/addons/uis.html">Overview</a></li>
<hr />
<li><a href="/v2.1/addons/uis/basic/readme.html">Basic UI</a></li>
<li><a href="/v2.1/addons/uis/classic/readme.html">Classic UI</a></li>
<li><a href="/v2.1/addons/uis/habmin/readme.html">HABmin</a></li>
<li><a href="/v2.1/addons/uis/habpanel/readme.html">HABPanel</a></li>
<li><a href="/v2.1/addons/uis/paper/readme.html">Paper UI</a></li>
<hr />
<li><a href="/v2.1/addons/uis/apps/android.html">Android openHAB App</a></li>
<li><a href="/v2.1/addons/uis/apps/ios.html">iOS openHAB App</a></li>
<li><a href="/v2.1/addons/uis/apps/windows.html">Windows 10 openHAB App</a></li>
<hr />
<li><a href="/v2.1/addons/iconsets/classic/readme.html">Iconset (classic)</a></li>
</ul>
</li>
<li><a href="/v2.1/addons/persistence.html">Persistence</a>
<ul>
<li><a href="/v2.1/addons/persistence.html">Overview</a></li>
<hr />
<li><a href="/v2.1/addons/persistence/caldav/readme.html">CalDAV</a></li>
<li><a href="/v2.1/addons/persistence/cosm/readme.html">Xively (formerly Cosm)</a></li>
<li><a href="/v2.1/addons/persistence/db4o/readme.html">db4o</a></li>
<li><a href="/v2.1/addons/persistence/dynamodb/readme.html">Amazon DynamoDB</a></li>
<li><a href="/v2.1/addons/persistence/exec/readme.html">Exec</a></li>
<li><a href="/v2.1/addons/persistence/influxdb/readme.html">InfluxDB (0.9 and newer)</a></li>
<li><a href="/v2.1/addons/persistence/influxdb08/readme.html">InfluxDB (up to 0.8.x)</a></li>
<li><a href="/v2.1/addons/persistence/jdbc/readme.html">JDBC</a></li>
<li><a href="/v2.1/addons/persistence/jpa/readme.html">Java Persistence API (JPA)</a></li>
<li><a href="/v2.1/addons/persistence/mapdb/readme.html">mapdb</a></li>
<li><a href="/v2.1/addons/persistence/mongodb/readme.html">MongoDB</a></li>
<li><a href="/v2.1/addons/persistence/mqtt/readme.html">MQTT</a></li>
<li><a href="/v2.1/addons/persistence/mysql/readme.html">MySQL</a></li>
<li><a href="/v2.1/addons/persistence/rrd4j/readme.html">rrd4j</a></li>
<li><a href="/v2.1/addons/persistence/sense/readme.html">Sen.Se</a></li>
<li><a href="/v2.1/addons/persistence/sitewhere/readme.html">SiteWhere</a></li>
</ul>
</li>
<li><a href="/v2.1/addons/actions.html">Actions</a>
<ul>
<li><a href="/v2.1/addons/actions.html">Overview</a></li>
<hr />
<li><a href="/v2.1/addons/actions/astro/readme.html">Astro</a></li>
<li><a href="/v2.1/addons/actions/ciscospark/readme.html">Cisco Spark</a></li>
<li><a href="/v2.1/addons/actions/dscalarm/readme.html">DSC Alarm</a></li>
<li><a href="/v2.1/addons/actions/ecobee/readme.html">Ecobee</a></li>
<li><a href="/v2.1/addons/actions/harmonyhub/readme.html">Logitech Harmony Hub</a></li>
<li><a href="/v2.1/addons/actions/homematic/readme.html">Homematic</a></li>
<li><a href="/v2.1/addons/actions/mail/readme.html">Mail</a></li>
<li><a href="/v2.1/addons/actions/mios/readme.html">MiOS</a></li>
<li><a href="/v2.1/addons/actions/mqtt/readme.html">MQTT</a></li>
<li><a href="/v2.1/addons/actions/nma/readme.html">NotifyMyAndroid</a></li>
<li><a href="/v2.1/addons/actions/openwebif/readme.html">OpenWebIf</a></li>
<li><a href="/v2.1/addons/actions/pebble/readme.html">Pebble</a></li>
<li><a href="/v2.1/addons/actions/prowl/readme.html">Prowl</a></li>
<li><a href="/v2.1/addons/actions/pushover/readme.html">Pushover</a></li>
<li><a href="/v2.1/addons/actions/pushsafer/readme.html">Pushsafer</a></li>
<li><a href="/v2.1/addons/actions/satel/readme.html">Satel</a></li>
<li><a href="/v2.1/addons/actions/squeezebox/readme.html">Squeezebox</a></li>
<li><a href="/v2.1/addons/actions/telegram/readme.html">Telegram</a></li>
<li><a href="/v2.1/addons/actions/tinkerforge/readme.html">TinkerForge</a></li>
<li><a href="/v2.1/addons/actions/twitter/readme.html">Twitter</a></li>
<li><a href="/v2.1/addons/actions/weather/readme.html">Weather</a></li>
<li><a href="/v2.1/addons/actions/xbmc/readme.html">XBMC</a></li>
<li><a href="/v2.1/addons/actions/xmpp/readme.html">XMPP</a></li>
<li><a href="/v2.1/addons/actions/xpl/readme.html">xPL</a></li>
</ul>
</li>
<li><a href="/v2.1/addons/transformations.html">Transformations</a>
<ul>
<li><a href="/v2.1/addons/transformations.html">Overview</a></li>
<hr />
<li><a href="/v2.1/addons/transformations/exec/readme.html">Exec</a></li>
<li><a href="/v2.1/addons/transformations/javascript/readme.html">JavaScript</a></li>
<li><a href="/v2.1/addons/transformations/jsonpath/readme.html">JsonPath</a></li>
<li><a href="/v2.1/addons/transformations/map/readme.html">Map</a></li>
<li><a href="/v2.1/addons/transformations/regex/readme.html">RegEx</a></li>
<li><a href="/v2.1/addons/transformations/scale/readme.html">Scale</a></li>
<li><a href="/v2.1/addons/transformations/xpath/readme.html">XPath</a></li>
<li><a href="/v2.1/addons/transformations/xslt/readme.html">XSLT</a></li>
</ul>
</li>
<li><a href="/v2.1/addons/voice.html">Voice Services</a>
<ul>
<li><a href="/v2.1/addons/voice.html">Overview</a></li>
<hr />
<li><a href="/v2.1/addons/voice/mactts/readme.html">MacOS Text-to-Speech</a></li>
<li><a href="/v2.1/addons/voice/marytts/readme.html">Mary Text-to-Speech</a></li>
<li><a href="/v2.1/addons/voice/voicerss/readme.html">VoiceRSS Text-to-Speech</a></li>
</ul>
</li>
<hr />
<li><a href="/v2.1/addons/io.html">3rd Party Integration</a>
<ul>
<li><a href="/v2.1/addons/io.html">Overview</a></li>
<hr />
<li><a href="/v2.1/addons/io/dropbox/readme.html">Dropbox Synchronization</a></li>
<li><a href="/v2.1/addons/io/gcal/readme.html">Google Calendar Scheduler</a></li>
<li><a href="/v2.1/addons/io/homekit/readme.html">HomeKit Add-on</a></li>
<li><a href="/v2.1/addons/io/hueemulation/readme.html">openHAB Hue Emulation</a></li>
<li><a href="/v2.1/addons/io/imperihome/readme.html">ImperiHome integration service</a></li>
<li><a href="/v2.1/addons/io/openhabcloud/readme.html">openHAB Cloud Connector</a></li>
<hr />
<li><a href="/v2.1/configuration/restdocs.html">REST API</a></li>
<li><a href="http://www.myopenhab.org/" target="_blank">IFTTT</a></li>
</ul>
</li>
</ul>
</li>
<li><a href="/v2.1/administration/index.html">Advanced Functionality</a>
<ul>
<li><a href="/v2.1/administration/index.html">Overview</a></li>
<hr />
<li><a href="/v2.1/administration/console.html">Console</a></li>
<li><a href="/v2.1/administration/runtime.html">Runtime Commands</a></li>
<li><a href="/v2.1/administration/bundles.html">Bundle Management</a></li>
<li><a href="/v2.1/administration/logging.html">Logging</a></li>
<hr />
<li><a href="/v2.1/administration/jsondb.html">JsonDB Storage</a></li>
</ul>
</li>
<li><a href="/v2.1/appendix/help.html">Community Guidance</a>
<ul>
<li><a href="/v2.1/appendix/help.html">Finding Help & FAQs</a></li>
<li><a href="/v2.1/appendix/contributing.html">Contributing</a></li>
</ul>
</li>
</ul>
</div>
<div id="versioning" class="row valign-wrapper">
<div class="col s12 right-align">
<ul id="dropdown-versioning" class="dropdown-content">
<li><a href="/v2.1/../addons/bindings/tinkerforge1/readme.html">latest version</a></li>
<li><a href="/v2.1/../v2.2/addons/bindings/tinkerforge1/readme.html">v2.2</a></li>
<li><a href="/v2.1/addons/bindings/tinkerforge1/readme.html">v2.1<i class="tiny material-icons right">lens</i></a></li>
</ul>
<a class="btn dropdown-button grey lighten-1" href="#!" data-activates="dropdown-versioning" title="Select which version of this openHAB documentation article you want to read.">
Switch Article Version<i class="material-icons right">arrow_drop_down</i>
</a>
</div>
</div>
<div class="content">
<!-- Attention authors: Do not edit directly. Please add your changes to the appropriate source repository -->
<h1 id="tinkerforge-binding">TinkerForge Binding</h1>
<p><a href="http://www.tinkerforge.com">TinkerForge</a> is a system of open source hardware building blocks that allows you to combine sensor and actuator blocks by plug and play. You can create your individual hardware system by choosing the necessary building blocks for your project and combine it with other home automation products.</p>
<p>There are many blocks available e.g for temperature, humidity or air pressure
measurement as well as for I/O, LCDs and motor control. You will find a complete List of available
blocks <a href="http://www.tinkerforge.com/en/doc/Product_Overview.html">here</a>.</p>
<p>This binding connects the <a href="http://tinkerforge.com">TinkerForge</a> devices to the openHAB event bus.
Sensor values from devices are made available to openHAB and actions on devices can be triggered by
openHAB.</p>
<p>The binding supports the connection to several brickd instances.
The TinkerForge auto reconnect feature is supported. Furthermore even if the initial connect failed the binding will make retries to get connected to the brickd.</p>
<h2 id="table-of-contents">Table of Contents</h2>
<ul>
<li><a href="#generic-item-binding-configuration">Generic Item Binding Configuration</a>
<ul>
<li><a href="#basic-configuration">Basic Configuration</a></li>
<li><a href="#advanced-configuration">Advanced Configuration</a></li>
</ul>
</li>
<li><a href="#supported-devices">Supported Devices</a>
<ul>
<li>Bricks
<ul>
<li><a href="#dc-brick">DC Brick</a></li>
<li><a href="#servo-brick">Servo Brick</a></li>
</ul>
</li>
<li>Bricklets
<ul>
<li><a href="#accelerometer-bricklet">Accelerometer Bricklet</a></li>
<li><a href="#ambient-light-bricklet">Ambient Light Bricklet</a></li>
<li><a href="#ambient-light-bricklet-v2">Ambient Light Bricklet V2</a></li>
<li><a href="#analog-in-bricklet">Analog In Bricklet</a></li>
<li><a href="#analog-in-bricklet-20">Analog In Bricklet 2.0</a></li>
<li><a href="#analog-out-bricklet-20">Analog Out Bricklet 2.0</a></li>
<li><a href="#barometer-bricklet">Barometer Bricklet</a></li>
<li><a href="#co2-bricklet">CO2 Bricklet</a></li>
<li><a href="#color-bricklet">Color Bricklet</a></li>
<li><a href="#distance-ir-bricklet">Distance IR Bricklet</a></li>
<li><a href="#distance-us-bricklet">Distance US Bricklet</a></li>
<li><a href="#dual-button-bricklet">Dual Button Bricklet</a></li>
<li><a href="#dual-relay-bricklet">Dual Relay Bricklet</a></li>
<li><a href="#dust-detector-bricklet">Dust Detector Bricklet</a></li>
<li><a href="#hall-effect-bricklet">Hall Effect Bricklet</a></li>
<li><a href="#humidity-bricklet">Humidity Bricklet</a></li>
<li><a href="#industrial-digital-in-4-bricklet">Industrial Digital IN 4 Bricklet</a></li>
<li><a href="#industrial-digital-out-4-bricklet">Industrial Digital Out 4 Bricklet</a></li>
<li><a href="#industrial-dual-0-20ma-bricklet">Industrial Dual 0-20mA Bricklet</a></li>
<li><a href="#industrial-dual-analog-in-bricklet">Industrial Dual Analog In Bricklet</a></li>
<li><a href="#industrial-quad-relay-bricklet">Industrial Quad Relay Bricklet</a></li>
<li><a href="#io4-bricklet">IO4 Bricklet</a></li>
<li><a href="#io-16-bricklet">IO 16 Bricklet</a></li>
<li><a href="#joystick-bricklet">Joystick Bricklet</a></li>
<li><a href="#laser-range-finder-bricklet">Laser Range Finder Bricklet</a></li>
<li><a href="#lcd-20x4-display-bricklet">LCD 20x4 Display Bricklet</a></li>
<li><a href="#led-strip-bricklet">LED Strip Bricklet</a></li>
<li><a href="#linear-poti-bricklet">Linear Poti Bricklet</a></li>
<li><a href="#load-cell-bricklet">Load Cell Bricklet</a></li>
<li><a href="#motion-detector-bricklet">Motion Detector Bricklet</a></li>
<li><a href="#multi-touch-bricklet">Multi Touch Bricklet</a></li>
<li><a href="#moisture-bricklet">Moisture Bricklet</a></li>
<li><a href="#piezo-speaker-bricklet">Piezo Speaker Bricklet</a></li>
<li><a href="#ptc-bricklet">PTC Bricklet</a></li>
<li><a href="#remote-switch-bricklet">Remote Switch Bricklet</a></li>
<li><a href="#rotary-encoder-bricklet">Rotary Encoder Bricklet</a></li>
<li><a href="#segment-display-4x7-bricklet">Segment Display 4x7 Bricklet</a></li>
<li><a href="#solid-state-relay-bricklet">Solid State Relay Bricklet</a></li>
<li><a href="#sound-intensity-bricklet">Sound Intensity Bricklet</a></li>
<li><a href="#temperature-bricklet">Temperature Bricklet</a></li>
<li><a href="#temperature-ir-bricklet">Temperature IR Bricklet</a></li>
<li><a href="#tilt-bricklet">Tilt Bricklet</a></li>
<li><a href="#thermocouple-bricklet">Thermocouple Bricklet</a></li>
<li><a href="#uv-light-bricklet">UV Light Bricklet</a></li>
<li><a href="#voltagecurrent-bricklet">Voltage/Current Bricklet</a></li>
</ul>
</li>
<li>Kits
<ul>
<li><a href="#weatherstation-kit">Weatherstation Kit</a></li>
</ul>
</li>
<li>Deamon
<ul>
<li><a href="#brick-daemon">Brick Daemon</a></li>
</ul>
</li>
</ul>
</li>
<li><a href="#red-brick">Red Brick</a></li>
<li><a href="#developer-notes">Developer Notes</a></li>
</ul>
<hr />
<h2 id="generic-item-binding-configuration">Generic Item Binding Configuration</h2>
<h3 id="basic-configuration">Basic Configuration</h3>
<p>In order to connect openHAB to TinkerForge devices you need to define all the brickd hosts and ports in the services/tinkerforge.cfg file.
The following properties must be configured to define a brickd connection:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>hosts=<IP address>[:port][:<secret>] ...
</code></pre></div></div>
<p>The properties indicated by ‘<…>’ need to be replaced with an actual value. Properties surrounded
by square brackets are optional. Several brickd configurations are delimited by a space.</p>
<p><em>port</em> and secret are optional values. You must specify the port if your brickd doesn’t use the default port 4223.
<em>secret</em> must be specified if you use a brickd connection <strong>with authentication</strong>: (see also <a href="http://www.tinkerforge.com/en/doc/Software/Brickd.html#brickd-authentication">Tinkerforge Website</a>)</p>
<table>
<thead>
<tr>
<th><b>Property</b></th>
<th><b>Description</b></th>
</tr>
</thead>
<tbody>
<tr>
<td>IP address</td>
<td>IP address of the brickd</td>
</tr>
<tr>
<td>port</td>
<td>The listening port of of the brickd (optional, default 4223)</td>
</tr>
<tr>
<td>secret</td>
<td>password used for authentication</td>
</tr>
</tbody>
</table>
<h4 id="example-configuration">Example configuration</h4>
<p>Authenticate with password 1234 and default port</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>hosts=127.0.0.1::1234
</code></pre></div></div>
<p>Authenticate with password 1234 and individual port 4224</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>hosts=127.0.0.1:4224:1234
</code></pre></div></div>
<p>You may also configure several different hosts.
For connecting several brickds, use multiple <IP address> statements delimited by a space.</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>hosts=127.0.0.1:4224:1234 192.168.1.100::secret
</code></pre></div></div>
<h4 id="item-binding-configuration">Item Binding Configuration</h4>
<p>In order to bind an item to a device, you need to provide configuration settings. The easiest way
to do so is to add binding information in your item file.
For location of the item file on a Linux based system see <a href="http://docs.openhab.org/installation/linux.html#file-locations">File locations</a></p>
<p>The configuration of the TinkerForge binding item looks like this:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>tinkerforge="(uid=<your_id> [, subid=<your_subid>] | name=<your_name>)"
</code></pre></div></div>
<p>The configuration is quite simple. You either have to set a value for the uid and optionally for the
subid of the device, or - if the device is configured in services/tinkerforge.cfg - the “symbolic name” of the device.</p>
<table>
<thead>
<tr>
<th>Property</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>TinkerForge uid of the device (Use the Brick Viewer to get this value)</td>
</tr>
<tr>
<td>subid</td>
<td>optional subid of the device</td>
</tr>
<tr>
<td>name</td>
<td><em>symbolic name</em> of the device. The name is only available if there is some configuration for the device in services/tinkerforge.cfg.</td>
</tr>
</tbody>
</table>
<p>For additional configuration options see the appropriate device section.</p>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="advanced-configuration">Advanced Configuration</h3>
<p>There are several configuration parameters to control the behavior of the devices. The available
parameters depend on the device type.</p>
<h4 id="overview">Overview</h4>
<p>For most of the devices <strong>no configuration</strong> is needed in services/tinkerforge.cfg, they can be used with reasonable defaults.</p>
<p><a id="sym_name"></a>
If you want to get rid of <em>uid</em> and <em>subid</em> statements in the items or rule file, you can use tinkerforge.cfg to get a <em>symbolic name</em>.</p>
<p>A configuration line for a TinkerForge Device looks like this in services/tinkerforge.cfg:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code><symbolic name>.<property>=<value>
</code></pre></div></div>
<p>The <em>symbolic name</em> string can be used in the items configuration as an alternative for the uid and subid values.</p>
<p>The following table lists the general available properties.</p>
<table>
<thead>
<tr>
<th><b>Property</b></th>
<th><b>Description</b></th>
<th><b>Device</b></th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>TinkerForge uid of the device (use the Brick Viewer to get this value)</td>
<td>mandatory for all devices</td>
</tr>
<tr>
<td>type</td>
<td>the device type</td>
<td>mandatory for all devices</td>
</tr>
<tr>
<td>subid</td>
<td>subid of the device, subid’s are used if a brick/bricklet houses more then one device (e.g. the Dual Relay Bricklet)</td>
<td>mandatory for sub devices</td>
</tr>
</tbody>
</table>
<p>The following table shows the TinkerForge device, its device type, its subid and if callback is supported.</p>
<table>
<thead>
<tr>
<th><b>device</b></th>
<th><b>type name</b></th>
<th><b>subid(s)</b></th>
<th><b>Callback</b></th>
</tr>
</thead>
<tbody>
<tr>
<td>DC Brick</td>
<td>brick_dc</td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>Servo Brick sub devices</td>
<td>servo</td>
<td>servo[0-6]</td>
<td> </td>
</tr>
<tr>
<td>Accelerometer Bricklet</td>
<td>bricklet_accelerometer</td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>Accelerometer Bricklet subdevice</td>
<td>accelerometer_direction</td>
<td>x</td>
<td>x</td>
</tr>
<tr>
<td>Accelerometer Bricklet subdevice</td>
<td>accelerometer_direction</td>
<td>y</td>
<td>x</td>
</tr>
<tr>
<td>Accelerometer Bricklet subdevice</td>
<td>accelerometer_direction</td>
<td>z</td>
<td>x</td>
</tr>
<tr>
<td>Accelerometer Bricklet subdevice</td>
<td>accelerometer_temperature</td>
<td>temperature</td>
<td> </td>
</tr>
<tr>
<td>Accelerometer Bricklet subdevice</td>
<td>accelerometer_led</td>
<td>led</td>
<td> </td>
</tr>
<tr>
<td>Ambient Light Bricklet</td>
<td>bricklet_ambient_light</td>
<td> </td>
<td>x</td>
</tr>
<tr>
<td>Ambient Light Bricklet 2.0</td>
<td>bricklet_ambient_lightv2</td>
<td> </td>
<td>x</td>
</tr>
<tr>
<td>Analog In Bricklet</td>
<td>bricklet_analogin</td>
<td> </td>
<td>x</td>
</tr>
<tr>
<td>Analog In Bricklet 2.0</td>
<td>bricklet_analoginv2</td>
<td> </td>
<td>x</td>
</tr>
<tr>
<td>Analog Out Bricklet 2.0</td>
<td>bricklet_analog_out_v2</td>
<td> </td>
<td>x</td>
</tr>
<tr>
<td>Barometer Bricklet</td>
<td>bricklet_barometer</td>
<td> </td>
<td>x</td>
</tr>
<tr>
<td>Barometer Bricklet temperature sensor sub device</td>
<td>barometer_temperature</td>
<td>temperature</td>
<td> </td>
</tr>
<tr>
<td>CO2 Bricklet</td>
<td>bricklet_co2</td>
<td> </td>
<td>x</td>
</tr>
<tr>
<td>Color Bricklet</td>
<td>bricklet_color</td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>Color Bricklet subdevice</td>
<td>color</td>
<td>color-color</td>
<td>x</td>
</tr>
<tr>
<td>Color Bricklet subdevice</td>
<td>temperature</td>
<td>color_temperature</td>
<td>x</td>
</tr>
<tr>
<td>Color Bricklet subdevice</td>
<td>illuminance</td>
<td>color_illuminance</td>
<td>x</td>
</tr>
<tr>
<td>Distance IR Bricklet</td>
<td>bricklet_distance_ir</td>
<td> </td>
<td>x</td>
</tr>
<tr>
<td>Dual Button Bricklet</td>
<td> </td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>Dual Button Bricklet subdevice</td>
<td> </td>
<td>dualbutton_leftled</td>
<td>x</td>
</tr>
<tr>
<td>Dual Button Bricklet subdevice</td>
<td> </td>
<td>dualbutton_rightled</td>
<td>x</td>
</tr>
<tr>
<td>Dual Button Bricklet subdevice</td>
<td> </td>
<td>dualbutton_leftbutton</td>
<td>x</td>
</tr>
<tr>
<td>Dual Button Bricklet subdevice</td>
<td> </td>
<td>dualbutton_rightbutton</td>
<td>x</td>
</tr>
<tr>
<td>Dual Relay Bricklet sub devices</td>
<td>dual_relay</td>
<td>relay[1-2]</td>
<td> </td>
</tr>
<tr>
<td>Dust Detector Bricklet</td>
<td>bricklet_dustdetector</td>
<td> </td>
<td>x</td>
</tr>
<tr>
<td>Hall Effect Bricklet</td>
<td>bricklet_halleffect</td>
<td> </td>
<td>x</td>
</tr>
<tr>
<td>Humidity Bricklet</td>
<td>bricklet_humidity</td>
<td> </td>
<td>x</td>
</tr>
<tr>
<td>Industrial Digital In 4 Bricklet</td>
<td>bricklet_industrial_digital_4in</td>
<td>in[0-3]</td>
<td>x</td>
</tr>
<tr>
<td>Industrial Digital Out 4 Bricklet sub devices</td>
<td>bricklet_industrial_digital_4out</td>
<td>out[0-3]</td>
<td> </td>
</tr>
<tr>
<td>Industrial Dual 0-20mA Bricklet</td>
<td>bricklet_industrialdual020ma</td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>Industrial Dual 0-20mA Bricklet subdevice</td>
<td>industrial020ma_sensor</td>
<td>sensor[0-1]</td>
<td>x</td>
</tr>
<tr>
<td>Industrial Dual Analog In Bricklet</td>
<td>bricklet_industrial_dual_analogin</td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>Industrial Dual Analog In Bricklet subdevice</td>
<td>industrial_dual_analogin_channel</td>
<td>channel[0-1]</td>
<td>x</td>
</tr>
<tr>
<td>Industrial Quad Relay Bricklet</td>
<td>industrial_quad_relay</td>
<td>relay[0-3]</td>
<td> </td>
</tr>
<tr>
<td>IO-4 Bricklet</td>
<td>bricklet_io4</td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>IO-4 Bricklet sub devices, which should be used as input ports</td>
<td>io4sensor</td>
<td>in[0-3]</td>
<td>x</td>
</tr>
<tr>
<td>IO-4 Bricklet sub devices, which should be used as output ports</td>
<td>io4_actuator</td>
<td>out[0-3]</td>
<td> </td>
</tr>
<tr>
<td>IO-16 Bricklet</td>
<td>bricklet_io16</td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>IO-16 Bricklet sub devices, which should be used as input ports</td>
<td>iosensor</td>
<td>in[ab][0-7]</td>
<td>x</td>
</tr>
<tr>
<td>IO-16 Bricklet sub devices, which should be used as output ports</td>
<td>io_actuator</td>
<td>out[ab][0-7]</td>
<td> </td>
</tr>
<tr>
<td>Joystick Bricklet</td>
<td>bricklet_joystick</td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>Joystick Bricklet subdevice</td>
<td> </td>
<td>joystick_xposition</td>
<td>x</td>
</tr>
<tr>
<td>Joystick Bricklet subdevice</td>
<td> </td>
<td>joystick_yposition</td>
<td>x</td>
</tr>
<tr>
<td>Joystick Bricklet subdevice</td>
<td> </td>
<td>joystick_button</td>
<td>x</td>
</tr>
<tr>
<td>Laser Range Finder Bricklet</td>
<td> </td>
<td>bricklet_laser_range_finder</td>
<td> </td>
</tr>
<tr>
<td>Laser Range Finder Bricklet subdevice</td>
<td>laser_range_finder_distance</td>
<td>distance</td>
<td>x</td>
</tr>
<tr>
<td>Laser Range Finder Bricklet subdevice</td>
<td>laser_range_finder_velocity</td>
<td>velocity</td>
<td>x</td>
</tr>
<tr>
<td>Laser Range Finder Bricklet subdevice</td>
<td>laser_range_finder_laser</td>
<td>laser</td>
<td> </td>
</tr>
<tr>
<td>LCD20x4 Bricklet</td>
<td>bricklet_LCD20x4</td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>LCD20x4 backlight</td>
<td>backlight</td>
<td>backlight</td>
<td> </td>
</tr>
<tr>
<td>LCD20x4 Bricklet button sub devices</td>
<td>lcd_button</td>
<td>button[0-3]</td>
<td>interrupt</td>
</tr>
<tr>
<td>LED Strip Bricklet</td>
<td>bricklet_ledstrip</td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>LED Strip Bricklet subdevice</td>
<td>ledgroup</td>
<td>ledgroup[1-x]</td>
<td>x</td>
</tr>
<tr>
<td>Linear Poti Bricklet</td>
<td>bricklet_linear_poti</td>
<td> </td>
<td>x</td>
</tr>
<tr>
<td>Load Cell Bricklet</td>
<td>bricklet_loadcell</td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>Load Cell Bricklet subdevice</td>
<td>weight</td>
<td>loadcell_weight</td>
<td>x</td>
</tr>
<tr>
<td>Load Cell Bricklet subdevice</td>
<td>led</td>
<td>loadcell_led</td>
<td>x</td>
</tr>
<tr>
<td>Motion Detector Bricklet</td>
<td>motion_detector</td>
<td> </td>
<td>x</td>
</tr>
<tr>
<td>Multi Touch Bricklet</td>
<td>bricklet_multitouch</td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>Multi Touch Bricklet electrodes</td>
<td>electrode</td>
<td>electrode[0-11]</td>
<td>x</td>
</tr>
<tr>
<td>Moisture Bricklet</td>
<td>bricklet_moisture</td>
<td> </td>
<td>x</td>
</tr>
<tr>
<td>Pieco Speaker Bricklet</td>
<td> </td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>PTC Bricklet</td>
<td>bricklet_ptc</td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>PTC Bricklet subdevice</td>
<td> </td>
<td>ptc_temperature</td>
<td>x</td>
</tr>
<tr>
<td>PTC Bricklet subdevice</td>
<td> </td>
<td>ptc_connected</td>
<td>x</td>
</tr>
<tr>
<td>PTC Bricklet subdevice</td>
<td> </td>
<td>ptc_resistance</td>
<td>x</td>
</tr>
<tr>
<td>Remote Switch Bricklet</td>
<td>bricklet_remote_switch</td>
<td>configurable</td>
<td> </td>
</tr>
<tr>
<td>Remote Switch Bricklet sub devices</td>
<td>remote_switch_a or remote_switch_b or remote_switch_c</td>
<td>from configuration</td>
<td> </td>
</tr>
<tr>
<td>Rotary Encoder Bricklet</td>
<td> </td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>Rotary Encoder Bricklet subdevice</td>
<td>encoder</td>
<td>rotary_encoder</td>
<td>x</td>
</tr>
<tr>
<td>Rotary Encoder Bricklet subdevice</td>
<td>button</td>
<td>rotary_encoder_button</td>
<td>x</td>
</tr>
<tr>
<td>Segment Display 4x7 Bricklet</td>
<td> </td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>Solid State Relay Bricklet</td>
<td> </td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>Sound Intensity Bricklet</td>
<td>bricklet_soundintensity</td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>Temperature Bricklet</td>
<td>bricklet_temperature</td>
<td> </td>
<td>x</td>
</tr>
<tr>
<td>TemperatureIR Bricklet</td>
<td>bricklet_temperatureIR</td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>TemperatureIR Bricklet sub device object temperature</td>
<td>object_temperature</td>
<td> </td>
<td>x</td>
</tr>
<tr>
<td>TemperatureIR Bricklet sub device ambient temperature</td>
<td>ambient_temperature</td>
<td> </td>
<td>x</td>
</tr>
<tr>
<td>Tilt Bricklet</td>
<td>bricklet_tilt</td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>Thermocouple Bricklet</td>
<td>thermocouple</td>
<td> </td>
<td>x</td>
</tr>
<tr>
<td>UV Light Bricklet</td>
<td>bricklet_uv_light</td>
<td> </td>
<td>x</td>
</tr>
<tr>
<td>Voltage Current Bricklet</td>
<td>bricklet_voltageCurrent</td>
<td> </td>
<td> </td>
</tr>
</tbody>
</table>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h4 id="callback-and-threshold">Callback and Threshold</h4>
<p>The TinkerForge CallbackListeners - if available - are used to observe the sensor values of the
devices. These listeners are configured to update sensor values at a given time period
(callbackPeriod). The default configuration sets the <strong>callbackPeriod</strong> to 1 second. This value can
be changed in services/tinkerforge.cfg. The values must be given in milliseconds.</p>
<p>The callbackPeriod controls the amount of traffic from the TF hardware to the binding.</p>
<p>In addition to the Callback a <strong>threshold value</strong> can be configured. This threshold means that even
if the listener reports a changed value, the value is only send to the openHAB eventbus if: the
difference between the last value and the current value is bigger than the threshold value. You can
think of it as a kind of hysteresis, it dampens the oscillation of openHAB item values.</p>
<p>The threshold controls the amount of traffic from the binding to the openHAB eventbus.
Threshold values have the same unit as sensor values, no conversion is needed.</p>
<hr />
<h4 id="refresh-of-sensor-values">Refresh of Sensor Values</h4>
<p>Devices which do not support callbacks will be polled with a configurable interval, the default
is 60000 milliseconds. This value can be changed in services/tinkerforge.cfg:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>refresh=<value in milliseconds>
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h2 id="supported-devices">Supported Devices</h2>
<h3 id="dc-brick">DC Brick</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricks/DC_Brick.html#dc-brick">Tinkerforge Website</a></p>
<h4 id="binding-properties">Binding properties:</h4>
<p>The device supports Dimmer, Rollershutter and Number items. Besides that the speed
can be set using a percent value.
The number items show the current velocity. The values are reported using the VelocityListener.
“<a href="#callback-and-threshold">callbackPeriod</a>” and “<a href="#callback-and-threshold">threshold</a>” for the listener can be configured in services/tinkerforge.cfg.</p>
<ul>
<li>callbackPeriod: milliseconds</li>
<li>threshold: numeric value</li>
</ul>
<p>The item configuration options are:</p>
<ul>
<li>speed: the target speed (Switch)</li>
<li>max: the maximum speed (Dimmer, Rollershutter)</li>
<li>min: the minimum speed (Dimmer, Rollershutter)</li>
<li>step: the step value for increasing decreasing speed (Dimmer)</li>
<li>leftspeed: the speed when the left rollershutter controller is pressed or command “DOWN” was send</li>
<li>rightspeed: the speed when the right rollershutter controller is pressed or command “UP” was send</li>
<li>acceleration: acceleration overrides value from tinkerforge.cfg</li>
<li>drivemode: drivemode overrides value from tinkerforge.cfg</li>
</ul>
<h5 id="tinkerforgecfg">tinkerforge.cfg:</h5>
<p>Values for acceleration and drivmode are default values and may be overridden by item definition.</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>dc_garage.uid=<your_uid>
dc_garage.type=brick_dc
dc_garage.pwmFrequency=15000
dc_garage.driveMode=break
dc_garage.acceleration=10000
dc_garage.callbackPeriod=100
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Dimmer DCDIMMER "Dimmer" {tinkerforge="uid=<your_uid>, max=20000, min=-15000, acceleration=10000, drivemode=brake, step=2500"}
Dimmer DIMMERPERCENT "Dimmerpercent" {tinkerforge="uid=<your_uid>, max=20000, min=0, acceleration=10000, drivemode=brake, step=2500"}
Rollershutter TF_ROLLER "Roller" {tinkerforge="uid=<your_uid>, leftspeed=10000, rightspeed=-10000, acceleration=10000, drivemode=brake"}
Switch DCSWITCH "DC Switch" {tinkerforge="uid=<your_uid>, speed=14000"}
Number DCSPEED "DC Speed [%.0f]" {tinkerforge="uid=<your_uid>, max=20000, min=-15000, step=1000, leftspeed=10000, rightspeed=-10000, acceleration=10000, drivemode=brake"}
Dimmer RULEDIMMER "RuleDimmer"
Switch DCMOVE "Action Move"
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf_weather label="Brick DC"
{
Frame {
Switch item=TF_ROLLER
Switch item=DCSWITCH
Slider item=DCDIMMER
Text item=DCSPEED
Setpoint item=DCSPEED minValue=-1500 maxValue=25000 step=1000
Slider item=RULEDIMMER
}
}
</code></pre></div></div>
<h5 id="rules-file-eg-tinkerforgerules">Rules file (e.g. tinkerforge.rules):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>import org.openhab.core.library.types.*
rule "percentdimmer"
when
Item RULEDIMMER received command INCREASE
then
sendCommand(DIMMERPERCENT, new PercentType(100))
end
rule "percentdimmerdecrease"
when
Item RULEDIMMER received command DECREASE
then
sendCommand(DIMMERPERCENT, new PercentType(25))
end
rule "move motor"
when
Item DCMOVE received command ON
then
var Integer acceleration = 10000
var Short speed = 15000
tfDCMotorSetspeed("<your_uid>", speed, acceleration, "break")
Thread::sleep(1000)
tfDCMotorSetspeed("<your_uid>", speed, acceleration, "break")
Thread::sleep(1000)
tfDCMotorSetspeed("<your_uid>", speed, acceleration, "break")
Thread::sleep(1000)
tfDCMotorSetspeed("<your_uid>", speed, acceleration, "break")
end
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="servo-brick">Servo Brick</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricks/Servo_Brick.html#servo-brick">Tinkerforge Website</a></p>
<h4 id="binding-properties-1">Binding properties:</h4>
<p>The device supports Dimmer, Rollershuter and Number items. Besides that the speed
can be set using a percent value.</p>
<p>Number items will show the current position.</p>
<p>The item configuration options are:</p>
<ul>
<li>velocity: the velocity used to reach the new position</li>
<li>max: the maximum position (Dimmer, Rollershutter)</li>
<li>min: the minimum position (Dimmer, Rollershutter)</li>
<li>step: the step value for increasing decreasing position (Dimmer)</li>
<li>leftposition: the target position to reach when the left rollershutter controller is pressed or command “DOWN” was send</li>
<li>rightposition: the target position to reach when the right rollershutter controller is pressed or command “UP” was send</li>
<li>acceleration: the acceleration</li>
</ul>
<h5 id="tinkerforge-action">TinkerForge Action</h5>
<p>The openHAB action <a href="#tinkerforge-actions">TinkerforgeAction</a> comes up with the action tfServoSetposition.
tfServoSetposition(uid, num, position, velocity, acceleration) can be used to control the servo.</p>
<h6 id="example">Example</h6>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>tfServoSetposition("<your_uid>", "servo0", "-9000", "65535", "65535")
</code></pre></div></div>
<h5 id="brick">Brick:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>brick_servo</td>
</tr>
</tbody>
</table>
<h5 id="servo-sub-devices">Servo sub devices:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>same as brick</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>servo0, servo1, servo2, servo3, servo4, servo5, servo6</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>servo</td>
</tr>
<tr>
<td>velocity</td>
<td> </td>
<td>default=30000</td>
</tr>
<tr>
<td>acceleration</td>
<td> </td>
<td>default=30000</td>
</tr>
<tr>
<td>servoVoltage</td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>pulseWidthMin</td>
<td> </td>
<td>default=1000</td>
</tr>
<tr>
<td>pulseWidthMax</td>
<td> </td>
<td>default=2000</td>
</tr>
<tr>
<td>period</td>
<td> </td>
<td>default=19500</td>
</tr>
<tr>
<td>outputVoltage</td>
<td>output voltage can only be set once (will be used for all servos)</td>
<td>default=5000</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-1">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>servo0.uid=<your_uid>
servo0.type=servo
servo0.subid=servo0
servo0.velocity=65530
servo0.acceleration=65530
servo0.uid=<your_uid>
servo1.type=servo
servo1.subid=servo1
servo1.velocity=65530
servo1.acceleration=65530
servo0.uid=<your_uid>
servo2.type=servo
servo2.subid=servo2
servo2.velocity=65530
servo2.acceleration=65530
servo0.uid=<your_uid>
servo3.type=servo
servo3.subid=servo3
servo3.velocity=65530
servo3.acceleration=65530
servo0.uid=<your_uid>
servo4.type=servo
servo4.subid=servo4
servo4.velocity=65530
servo4.acceleration=65530
servo0.uid=<your_uid>
servo5.type=servo
servo5.subid=servo5
servo5.velocity=65530
servo5.acceleration=65530
servo0.uid=<your_uid>
servo6.type=servo
servo6.subid=servo6
servo6.velocity=65530
servo6.acceleration=65530
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-1">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Dimmer Servo0 "Servo0" { tinkerforge="uid=<your_uid>, subid=servo0, max=9000, min=-9000, step=500, acceleration=3000, velocity=3000" }
Dimmer Servo0Percent "Servo0Percent" { tinkerforge="uid=<your_uid>, subid=servo0, max=9000, min=-9000, step=500, acceleration=3000, velocity=3000" }
Rollershutter Servo0Rollershutter "Servo0Rollershutter" { tinkerforge="uid=<your_uid>, subid=servo0, max=9000, min=-9000, leftposition=3000, rightposition=-3000, acceleration=3000, velocity=3000" }
Switch Servo0Switch "Servo0Switch" { tinkerforge="uid=<your_uid>, subid=servo0, max=9000, min=-9000, position=3000, acceleration=3000, velocity=3000" }
Number Servo0Postion "Servo0Postion [%.0f]" { tinkerforge="uid=<your_uid>, subid=servo0, max=9000, min=-9000, step=500, acceleration=3000, velocity=3000" }
Dimmer Servo0Rule "Servo0Rule"
Switch Servo1 "Servo1" { tinkerforge="uid=<your_uid>, subid=servo1" }
Switch Servo2 "Servo2" { tinkerforge="uid=<your_uid>, subid=servo2" }
Switch Servo3 "Servo3" { tinkerforge="uid=<your_uid>, subid=servo3" }
Switch Servo4 "Servo4" { tinkerforge="uid=<your_uid>, subid=servo4" }
Switch Servo5 "Servo5" { tinkerforge="uid=<your_uid>, subid=servo5" }
Switch Servo6 "Servo6" { tinkerforge="uid=<your_uid>, subid=servo6" }
Switch ClearLCD "ClearLCD"
Switch MoveServo "MoveServo" {autoupdate="false"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-1">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf_weather label="Brick Servo"
{
Frame {
Slider item=Servo0
Switch item=Servo0Rollershutter
Switch item=Servo0Switch
Text item=Servo0Postion
Setpoint item=Servo0Postion minValue=-9000 maxValue=6000 step=2000
Slider item=Servo0Rule
Switch item=ClearLCD
Switch item=MoveServo
Switch item=Servo1
Switch item=Servo2
Switch item=Servo3
Switch item=Servo4
Switch item=Servo5
Switch item=Servo6
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="accelerometer-bricklet">Accelerometer Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Accelerometer.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-2">Binding properties:</h4>
<p>The bricklet returns the acceleration in x, y and z direction. The values are given in g/1000 (1g = 9.80665m/s²).<br />
Bricklet temperature can be measured in degrees Celsius, LED can be turned on to indicate a specific acceleration was reached.<br />
Decreasing data rate or full scale range will also decrease the noise on the data.</p>
<h5 id="bricklet">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_accelerometer</td>
</tr>
<tr>
<td>dataRate</td>
<td>sets the data rate, default=6 (100Hz)</td>
<td>0: off, 1: 3hz, 2: 6hz, 3: 12hz, 4: 25hz, 5: 50hz, 6: 100hz, 7: 400hz, 8: 800hz, 9: 1600hz</td>
</tr>
<tr>
<td>fullScale</td>
<td>sets the scale rate, default=1 (-4g to +4g)</td>
<td>0: 2g, 1: 4g, 2: 6g, 3: 8g, 4: 16g</td>
</tr>
<tr>
<td>filterBandwidth</td>
<td>sets the filter bandwidth, default=2 (200Hz)</td>
<td>0: 800hz, 1: 400hz, 2: 200hz, 3: 50hz</td>
</tr>
</tbody>
</table>
<h5 id="accelerometer-bricklet-sub-devices">Accelerometer Bricklet sub devices:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>x, y, z, temperature, led</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>accelerometer_direction, accelerometer_temperature, accelerometer_led</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<p>Note: Subdevices accelerometer_temperature and accelerometer_led don’t support callbackPeriod!</p>
<h5 id="tinkerforgecfg-2">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>accelerometer.uid=<your_uid>
accelerometer.type=bricklet_accelerometer
accelerometer.dataRate=6
accelerometer.fullScale=1
accelerometer.filterBandwidth=2
ax.uid=<your_uid>
ax.subid=x
ax.type=accelerometer_direction
ax.callbackPeriod=10
ax.threshold=0
ay.uid=<your_uid>
ay.subid=y
ay.type=accelerometer_direction
ay.callbackPeriod=10
ay.threshold=0
az.uid=<your_uid>
az.subid=z
az.type=accelerometer_direction
az.callbackPeriod=10
az.threshold=0
a_temperature.uid=<your_uid>
a_temperature.subid=temperature
a_temperature.type=accelerometer_temperature
a_led.uid=<your_uid>
a_led.subid=led
a_led.type=accelerometer_led
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-2">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number X "X [%.3f]" {tinkerforge="uid=<your_uid>, subid=x"}
Number Y "Y [%.3f]" {tinkerforge="uid=<your_uid>, subid=y"}
Number Z "Z [%.3f]" {tinkerforge="uid=<your_uid>, subid=z"}
Number temperature "Temperature [%.2f °C]" {tinkerforge="uid=<your_uid>, subid=temperature"}
Switch led "Led" {tinkerforge="uid=<your_uid>, subid=led"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-2">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf label="Accelerometer"
{
Frame label="Accelerometer" {
Text item=X
Text item=Y
Text item=Z
Text item=temperature
Switch item=led
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="ambient-light-bricklet">Ambient Light Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Ambient_Light.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-3">Binding properties:</h4>
<p>An entry in services/tinkerforge.cfg is only needed if you want to adjust <a href="#callback-and-threshold">threshold and / or callbackPeriod</a>.</p>
<h5 id="bricklet-1">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>descripition</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_ambient_light</td>
</tr>
<tr>
<td>threshold</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-3">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ambientlight.uid=<your_uid>
ambientlight.type=bricklet_ambient_light
ambientlight.callbackPeriod=10
ambientlight.threshold=0
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-3">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number TF_AmbientLight "Luminance [%.1f Lux]" { tinkerforge="uid=<your_uid>" }
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-3">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf label="TinkerForge AmbientLight"
{
Frame label="AmbientLight" {
Text item=TF_AmbientLight
}
}
</code></pre></div></div>
<hr />
<h3 id="ambient-light-bricklet-v2">Ambient Light Bricklet V2</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Ambient_Light_V2.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-4">Binding properties:</h4>
<p>An entry in services/tinkerforge.cfg is only needed if you want to adjust <a href="#callback-and-threshold">threshold and / or callbackPeriod</a> or if you want to use a <a href="#sym_name"><em>symbolic name</em></a>.</p>
<h5 id="bricklet-2">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_ambient_lightv2</td>
</tr>
<tr>
<td>illuminanceRange</td>
<td>sets the illuminance range, default=8000lux</td>
<td>0=64000lux, 1=32000lux, 2=16000lux, 3=8000lux, 4=1300lux, 5=600lux, 6=unlimited range</td>
</tr>
<tr>
<td>integrationTime</td>
<td>sets the integration time, default=200ms</td>
<td>0=50ms, 1=100ms, 2=150ms, 3=200ms, 4=250ms, 5=300ms, 6=350ms, 7=400ms</td>
</tr>
<tr>
<td>threshold</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-4">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ambientlightv2.uid=<your_uid>
ambientlightv2.type=bricklet_ambient_lightv2
ambientlightv2.illuminanceRange=3
ambientlightv2.integrationTime=3
ambientlightv2.callbackPeriod=10
ambientlightv2.threshold=0
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-4">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number illuminance "Illuminance [%.2f]" {tinkerforge="uid=<your_uid>"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-4">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf label="TinkerForge AmbientLightV2"
{
Frame label="AmbientLightV2" {
Text item=illuminance
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="analog-in-bricklet">Analog In Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Analog_In.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-5">Binding properties:</h4>
<p>If property $range is set to 0, the device switches between the measurement ranges automatically. Set $range to 1-5 to manually switch between measurement ranges.</p>
<h4 id="bricklet-3">Bricklet:</h4>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_analogin</td>
</tr>
<tr>
<td>range</td>
<td>sets the measurement range, default=0 (automatically switched)</td>
<td>1: 0V - 6.05V, 2: 0V - 10.32V, 3: 0V - 36.30V, 4: 0V - 45.00V, 5: 0V - 3.3V with ~0.81mV resolution</td>
</tr>
<tr>
<td>threshold</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-5">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ain.uid=<your_uid>
ain.type=bricklet_analogin
ain.range=0
ain.callbackPeriod=1000
ain.threshold=0
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-5">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number voltage "Voltage [%.0f mV]" {tinkerforge="uid=<your_uid>"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-5">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf label="Analog In"
{
Frame label="Analog In" {
Text item=voltage
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="analog-in-bricklet-20">Analog In Bricklet 2.0</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Analog_In_V2.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-6">Binding properties:</h4>
<p>Moving average is a calculation to analyze data points by creating series of averages of different subsets of the full data set.
Property $movingAverage sets the length of a moving averaging for the measured voltage, default is 50, $movingAverage=1 turns averaging off. With less averaging, there is more noise on the data.</p>
<h5 id="bricklet-4">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_analoginv2</td>
</tr>
<tr>
<td>movingAverage</td>
<td>sets the length of a moving averaging, default=50</td>
<td>1: averaging off, 2-50: averaging is 2-50</td>
</tr>
<tr>
<td>threshold</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-6">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ainv2.uid=<your_uid>
ainv2.type=bricklet_analoginv2
ainv2.movingAverage=50
ainv2.callbackPeriod=1000
ainv2.threshold=0
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-6">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number voltage "Voltage [%.0f mV]" {tinkerforge="uid=<your_uid>"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-6">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf label="Analog In V2"
{
Frame label="Analog In V2" {
Text item=voltage
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="analog-out-bricklet-20">Analog Out Bricklet 2.0</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Analog_Out_V2.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-7">Binding properties:</h4>
<p>The device supports Dimmer and Setpoint Items. For Dimmer you have to add a “step=” in your items definition.</p>
<h5 id="bricklet-5">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>descripition</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_analog_out_v2</td>
</tr>
<tr>
<td>minValue</td>
<td>0-12000</td>
<td>0V - 12V in 1mV steps, 12bit resolution</td>
</tr>
<tr>
<td>maxValue</td>
<td>0-12000</td>
<td>0V - 12V in 1mV steps, 12bit resolution</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-7">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>aout.uid=<your_uid>
aout.type=bricklet_analog_out_v2
aout.minValue=0
aout.maxValue=12000
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-7">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Dimmer ADIMMER "Dimmer" {tinkerforge="uid=<your_uid>, step=1000"}
Dimmer ADIMMERPERCENT "Dimmerpercent" {tinkerforge="uid=<your_uid"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-7">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap aout label="AnalogOutV2"
{
Frame {
Slider item=ADIMMER
Setpoint item=ADIMMERPERCENT step=10
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="barometer-bricklet">Barometer Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Barometer.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-8">Binding properties:</h4>
<p>Bricklet measures air pressure in range of 10 to 1200mbar with a resolution of 0.012mbar.<br />
An entry in services/tinkerforge.cfg is only needed if you want to adjust <a href="#callback-and-threshold">threshold and / or callbackPeriod</a> or if you want to use a <a href="#sym_name"><em>symbolic name</em></a>.</p>
<h5 id="bricklet-6">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_barometer</td>
</tr>
<tr>
<td>threshold</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<h5 id="temperature-sub-device">Temperature sub device:</h5>
<p>Subdevice property $barometer_temperature returns the temperature of the air pressure sensor which is internally used for temperature compensation of the air pressure measurement.
The temperature sub device does not support callbackPeriod, it will be polled. The polling interval can be configured using refresh property.</p>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>temperature</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>barometer_temperature</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-8">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>barometer_balcony.uid=<your_uid>
barometer_balcony.type=bricklet_barometer
barometer_balcony.callbackPeriod=10000
barometer_balcony.threshold=1000
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-8">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number Barometer "Air Pressure [%.1f hPa]" { tinkerforge="uid=<your_uid>" }
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-8">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Text item=Barometer
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="co2-bricklet">CO2 Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/CO2.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-9">Binding properties:</h4>
<p>An entry in services/tinkerforge.cfg is only needed if you want to adjust <a href="#callback-and-threshold">threshold and / or callbackPeriod</a>.</p>
<h5 id="bricklet-7">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>descripition</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_co2</td>
</tr>
<tr>
<td>threshold</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-9">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>co2.uid=<your_uid>
co2.type=bricklet_co2
co2.callbackPeriod=10
co2.threshold=0
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-9">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number C02 "C02 Concentration [%.1f]" { tinkerforge="uid=<your_uid>" }
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-9">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap co2 label="C02"
{
Frame {
Text item=C02
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="color-bricklet">Color Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Color.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-10">Binding properties:</h4>
<p>Increasing the gain enables the sensor to detect a color from a higher distance.
The integration time provides a trade-off between conversion time and accuracy. With a longer integration time the values read will be more accurate but it will take longer time to get the conversion results.</p>
<h5 id="bricklet-8">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_color</td>
</tr>
<tr>
<td>gain</td>
<td>sets the gain, derault=60x</td>
<td>0: 1x gain, 1: 4x gain, 2: 16x gain, 3: 60x gain</td>
</tr>
<tr>
<td>integrationTime</td>
<td>sets the integration time, default=154ms</td>
<td>0: 2.4ms, 1: 24ms, 2: 101ms, 3: 154ms, 4: 700ms</td>
</tr>
</tbody>
</table>
<h5 id="color-bricklet-sub-device">Color Bricklet sub device:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>same as bricklet</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>color, temperature, illuminance</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>color_color, color_temperature, color_illuminance</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<p>Note: It is not possible to set the property $threshold for the Color Bricklet subdevices!</p>
<h5 id="tinkerforgecfg-10">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>brickletcolor.uid=<your_uid>
brickletcolor.type=bricklet_color
brickletcolor.gain=3
brickletcolor.integrationTime=3
color_color.uid=<your_uid>
color_color.subid=color
color_color.type=color_color
color_color.callbackPeriod=1000
color_temperature.uid=<your_uid>
color_temperature.subid=temperature
color_temperature.type=color_temperature
color_temperature.callbackPeriod=1000
color_illuminance.uid=<your_uid>
color_illuminance.subid=illuminance
color_illuminance.type=color_illuminance
color_illuminance.callbackPeriod=1000
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-10">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Color color "Color" {tinkerforge="uid=<your_uid>, subid=color"}
Number temperature "ColorTemperature [%.2f]" {tinkerforge="uid=<your_uid>, subid=temperature"}
Number illuminance "ColorIlluminance [%.0f]" {tinkerforge="uid=<your_uid>, subid=illuminance"}
Switch led "Color Led" {tinkerforge="uid=<your_uid>, subid=led"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-10">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf label="Color"
{
Frame label="Color" {
Colorpicker item=color
Text item=temperature
Text item=illuminance
Switch item=led
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="distance-ir-bricklet">Distance IR Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Distance_US.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-11">Binding properties:</h4>
<p>An entry in services/tinkerforge.cfg is only needed if you want to adjust <a href="#callback-and-threshold">threshold and / or callbackPeriod</a> or if you want to use a <a href="#sym_name"><em>symbolic name</em></a>.</p>
<h5 id="bricklet-9">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_distance_ir</td>
</tr>
<tr>
<td>threshold</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-11">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>distance_door.uid=<your_uid>
distance_door.type=bricklet_distance_ir
distance_door.threshold=1
distance_door.callbackPeriod=10
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-11">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number Distance "Distance [%.1f mm]" { tinkerforge="uid=<your_uid>" }
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-11">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Text item=Distance
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="distance-us-bricklet">Distance US Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Industrial_Quad_Relay.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-12">Binding properties:</h4>
<p>An entry in services/tinkerforge.cfg is only needed if you want to adjust <a href="#callback-and-threshold">threshold and / or callbackPeriod</a> or if you want to use a <a href="#sym_name"><em>symbolic name</em></a>.</p>
<p>Distance is reported as unitless value, not in mm.</p>
<p>Moving average is a calculation to analyze data points by creating series of averages of different subsets of the full data set.</p>
<h5 id="bricklet-10">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_distanceUS</td>
</tr>
<tr>
<td>threshold</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>movingAverage</td>
<td>sets the moving average, default=20</td>
<td>0-100</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-12">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>distanceUS.uid=<your_uid>
distanceUS.type=bricklet_distanceUS
distanceUS.threshold=0
distanceUS.callbackPeriod=100
distanceUS.movingAverage=20
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-12">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number DistanceUS "DistanceUS [%.1f]" { tinkerforge="uid=<your_uid>" }
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-12">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Text item=DistanceUS
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="dual-button-bricklet">Dual Button Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Dual_Button.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-13">Binding properties:</h4>
<p>The Dual Button Bricklet has four sub devices: two leds and two buttons.
The subids are:</p>
<ul>
<li>dualbutton_leftled</li>
<li>dualbutton_rightled</li>
<li>dualbutton_leftbutton</li>
<li>dualbutton_rightbutton</li>
</ul>
<h5 id="leds">Leds</h5>
<p>There are two operating modes for the leds: with the autotoggle=True the leds are
automatically toggled whenever the corresponding button is pressed. With the autotoggle=False
mode the leds are fully controlled with openHAB UIs or rules. The default autotoggle mode is
autotoggle=False. The autotoggle mode can be configured using tinkerforge.cfg.</p>
<h5 id="buttons">Buttons</h5>
<p>There are also two operating modes for the buttons. The buttons can behave like a switch or
like a tactile switch.</p>
<ul>
<li>Switch mode</li>
</ul>
<p>The switch mode operates like this: pressing the button toggles the
switch state, if state was ON it goes to OFF and vice versa. Releasing the button doesn’t
change anything, only the next button press will change the state.</p>
<ul>
<li>Tactile switch mode</li>
</ul>
<p>Pressing the button changes the switch state to ON and releasing the button changes the
state back to OFF again.</p>
<h5 id="dual-button-bricklet-sub-devices">Dual Button Bricklet sub devices:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>same as bricklet</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>dualbutton_leftled, dualbutton_rightled, dualbutton_leftbutton, dualbutton_rightbutton</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>dualbutton_led, dualbutton_button</td>
</tr>
<tr>
<td>autotoggle</td>
<td>sets button autotoggle mode</td>
<td>True, False</td>
</tr>
<tr>
<td>tactile</td>
<td>sets switch mode</td>
<td>True, False</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-13">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>led1.uid=<your_uid>
led1.subid=dualbutton_leftled
led1.type=dualbutton_led
led1.autotoggle=True
led2.uid=<your_uid>
led2.subid=dualbutton_rightled
led2.type=dualbutton_led
led2.autotoggle=False
button1.uid=<your_uid>
button1.subid=dualbutton_leftbutton
button1.type=dualbutton_button
button1.tactile=False
button2.uid=<your_uid>
button2.subid=dualbutton_rightbutton
button2.type=dualbutton_button
button2.tactile=True
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-13">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Contact LeftButton "LeftButton" { tinkerforge="uid=<your_uid>, subid=dualbutton_leftbutton"}
Contact RightButton "RightButton" { tinkerforge="uid=<your_uid>, subid=dualbutton_rightbutton"}
Switch LeftLed "LeftLed" { tinkerforge="uid=<your_uid>, subid=dualbutton_leftled"}
Switch RightLed "RightLed" { tinkerforge="uid=<your_uid>, subid=dualbutton_rightled"}
</code></pre></div></div>
<h5 id="rules-eg-tinkerforgerules">Rules (e.g. tinkerforge.rules):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>import org.openhab.core.library.types.*
rule "toggleright"
when
Item RightButton changed
then
logDebug("dualbutton", "{}", RightButton.state)
if (RightButton.state == OPEN)
sendCommand(RightLed, ON)
else
sendCommand(RightLed, OFF)
end
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-13">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf label="DualButton"
{
Frame {
Text item=LeftButton
Text item=RightButton
Switch item=LeftLed
Switch item=RightLed
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="dual-relay-bricklet">Dual Relay Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Dual_Relay.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-14">Binding properties:</h4>
<p>An entry in services/tinkerforge.cfg is only needed if you want to adjust <a href="#callback-and-threshold">threshold and / or callbackPeriod</a> or if you want to use a <a href="#sym_name"><em>symbolic name</em></a>.</p>
<h5 id="bricklet-11">Bricklet:</h5>
<p>The Dual Relay Bricklet has two sub devices.
The subids are:</p>
<ul>
<li>relay1</li>
<li>relay2</li>
</ul>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_dual_relay</td>
</tr>
</tbody>
</table>
<h5 id="relay-sub-devices">Relay sub devices:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>same as bricklet</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>relay1, relay2</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>dual_relay</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-14">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>relay_coffee_machine.uid=<your_uid>
relay_coffee_machine.type=dual_relay
relay_coffee_machine.subid=relay1
relay_garage_door.uid=<your_uid>
relay_garage_door.type=dual_relay
relay_garage_door.subid=relay2
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-14">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Switch DualRelay1 "DualRelay1" { tinkerforge="name=relay_coffee_machine" }
Switch DualRelay2 "DualRelay2" { tinkerforge="uid=<your_uid>, subid=relay2" }
Switch Garage "Garage" <garagedoor> // creates a virtual switch with no bonded hardware
</code></pre></div></div>
<h5 id="rules-eg-tinkerforgerules-1">Rules (e.g. tinkerforge.rules):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>import org.openhab.core.library.types.*
rule "open or close garage door"
when
Item Garage received command ON // rule is triggered when virtual switch Garage receives ON command
then
DualRelay2.sendCommand(ON) // contacts of subdevice relay2 are closed
Thread::sleep(500) // delays execution of next command for 500 ms
DualRelay2.sendCommand(OFF) // contacts of subdevice relay2 are opened
end
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-14">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf label="DualRelay"
{
Frame {
Switch item=DualRelay1
Switch item=Garage mappings=[ON="Garage open/close"] // displays the virtual switch with the given text
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="dust-detector-bricklet">Dust Detector Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Dust_Detector.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-15">Binding properties:</h4>
<p>The measured dust density can be read out in µg/m³</p>
<h5 id="bricklet-12">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_dustdetector</td>
</tr>
<tr>
<td>threshold</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-15">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>dust.uid=<your_uid>
dust.type=bricklet_dustdetector
dust.callbackPeriod=10
dust.threshold=0
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-15">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number Dust "Dust [%.0f]" { tinkerforge="uid=<your_uid>"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-15">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf label="Dust Detector"
{
Frame {
Text item=Dust
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="hall-effect-bricklet">Hall Effect Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Hall_Effect.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-16">Binding properties:</h4>
<p>Bricklet can detect the presence of magnetic fields. It counts the (dis-)appearances of magnetic fields.</p>
<h5 id="bricklet-13">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_halleffect</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-16">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code># really optional settings
hall.uid=<your_uid>
hall.type=bricklet_halleffect
hall.callbackPeriod=1000
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-16">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Contact HallEffect "Hall" { tinkerforge="uid=<your_uid>"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-16">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf label="TinkerForge Halleffect"
{
Frame label="HallEffect" {
Text item=HallEffect
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="humidity-bricklet">Humidity Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Humidity.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-17">Binding properties:</h4>
<p>An entry in services/tinkerforge.cfg is only needed if you want to adjust <a href="#callback-and-threshold">threshold and / or callbackPeriod</a> or if you want to use a <a href="#sym_name"><em>symbolic name</em></a>.</p>
<p>The measured humidity can be read out directly in percent, no conversions are necessary.</p>
<h5 id="bricklet-14">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_humidity</td>
</tr>
<tr>
<td>threshold</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-17">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>humidity_balcony.uid=<your_uid>
humidity_balcony.type=bricklet_humidity
humidity_balcony.threshold=1
humidity_balcony.callbackPeriod=10
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-17">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>
Number Humidity "Humidity [%.1f %%]" { tinkerforge="uid=<your_uid>" }
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-17">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Text item=Humidity
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="industrial-digital-in-4-bricklet">Industrial Digital IN 4 Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Industrial_Digital_In_4.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-18">Binding properties:</h4>
<p>If you set the property $debouncePeriod to 100, you will get the interrupt maximal every 100ms. This is necessary if something that bounces is connected to the Digital In 4 Bricklet, such as a button.</p>
<h5 id="bricklet-15">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>in0, in2, in3, in4</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_industrial_digital_4in</td>
</tr>
<tr>
<td>debouncePeriod</td>
<td>debounce time in ms</td>
<td>default=100</td>
</tr>
</tbody>
</table>
<h5 id="input-port-sub-devices">Input port sub devices:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>same as bricklet</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>in0, in2, in3, in4</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td> </td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-18">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>inddi4.uid=<your_uid>
inddi4.type=bricklet_industrial_digital_4in
inddi4.debouncePeriod=100
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-18">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Contact ID1 "ID1 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=in0"}
Contact ID2 "ID2 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=in1"}
Contact ID3 "ID3 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=in2"}
Contact ID4 "ID4 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=in3"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-18">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Text item=ID1
Text item=ID2
Text item=ID3
Text item=ID4
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="industrial-digital-out-4-bricklet">Industrial Digital Out 4 Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Industrial_Digital_Out_4.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-19">Binding properties:</h4>
<h5 id="output-port-sub-devices">Output port sub devices:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>same as bricklet</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>out0, out2, out3, out4</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td> </td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-19">tinkerforge.cfg:</h5>
<p>no configuration needed</p>
<h5 id="items-file-entry-eg-tinkerforgeitems-19">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Switch di4out0 {tinkerforge="uid=<your_uid>, subid=out0"}
Switch di4out1 {tinkerforge="uid=<your_uid>, subid=out1"}
Switch di4out2 {tinkerforge="uid=<your_uid>, subid=out2"}
Switch di4out3 {tinkerforge="uid=<your_uid>, subid=out3"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-19">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Switch item=di4out0
Switch item=di4out1
Switch item=di4out2
Switch item=di4out3
</code></pre></div></div>
<hr />
<h3 id="industrial-dual-0-20ma-bricklet">Industrial Dual 0-20mA Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Industrial_Dual_020mA.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-20">Binding properties:</h4>
<ul>
<li>two sub devices: sensor0 and sensor1</li>
<li>device type bricklet: bricklet_industrialdual020ma</li>
<li>device type sensors: industrial020ma_sensor</li>
<li>sensor values are reported as milli ampere</li>
</ul>
<h5 id="tinkerforgecfg-configuration-options-for-the-bricklet">tinkerforge.cfg configuration options for the Bricklet</h5>
<p>sampleRate: possible values 0, 1, 2, 3. Setting the sample rate is optional
it defaults to 3 (4 samples per second).</p>
<ul>
<li>0 means: 240 samples per second</li>
<li>1 means: 60 samples per second</li>
<li>2 means: 15 samples per second</li>
<li>3 means: 4 samples per second</li>
</ul>
<h5 id="tinkerforgecfg-configuration-options-for-the-sensors">tinkerforge.cfg configuration options for the sensors</h5>
<p>callbackPeriod: Setting the callback period is optional, the default is 1000 milli seconds.</p>
<h5 id="tinkerforgecfg-20">tinkerforge.cfg</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>brickletid020ma.uid=<your_uid>
brickletid020ma.type=bricklet_industrialdual020ma
temperature0.uid=<your_uid>
temperature0.subid=sensor0
temperature0.type=industrial020ma_sensor
temperature0.callbackPeriod=100
temperature1.uid=<your_uid>
temperature1.subid=sensor1
temperature1.type=industrial020ma_sensor
temperature1.callbackPeriod=1000
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-20">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number temperature0 "Temperature0 [%.2f]" {tinkerforge="uid=<your_uid>, subid=sensor0"}
Number temperature1 "Temperature1 [%.2f]" {tinkerforge="uid=<your_uid>, subid=sensor1"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-20">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf label="TinkerForge 020"
{
Frame label="PTC" {
Text item=temperature0
Text item=temperature1
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="industrial-dual-analog-in-bricklet">Industrial Dual Analog In Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Industrial_Dual_Analog_In.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-21">Binding properties:</h4>
<p>The property $sampleRate can be between 1 sample per second (SPS) and 976 samples per second. Decreasing the sample rate will also decrease the noise on the data.</p>
<h5 id="bricklet-16">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_industrial_dual_analogin</td>
</tr>
<tr>
<td>sampleRate</td>
<td>sets the sample rate, default=6 (2 samples per second)</td>
<td>0=976 SPS, 1=488 SPS, 2=244 SPS, 3=122 SPS, 4=61 SPS, 5=4 SPS, 6=2 SPS, 7=1 SPS</td>
</tr>
</tbody>
</table>
<h5 id="dual-analog-in-sub-devices">Dual Analog In sub devices:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>same as bricklet</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>channel0, channel1</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>industrial_dual_analogin_channel</td>
</tr>
<tr>
<td>threshold</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-21">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>diai.uid=<your_uid>
diai.type=bricklet_industrial_dual_analogin
diai.sampleRate=6
channel0.uid=<your_uid>
channel0.subid=channel0
channel0.type=industrial_dual_analogin_channel
channel0.callbackPeriod=1000
channel0.threshold=0
channel1.uid=<your_uid>
channel1.subid=channel1
channel1.type=industrial_dual_analogin_channel
channel1.callbackPeriod=1000
channel1.threshold=0
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-21">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number channel0 "Channel0 [%.0f mV]" {tinkerforge="uid=<your_uid>, subid=channel0"}
Number channel1 "Channel1 [%.0f mV]" {tinkerforge="uid=<your_uid>, subid=channel1"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-21">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf label="Industrial Dual Analog In"
{
Frame label="Industrial Dual Analog In" {
Text item=channel0
Text item=channel1
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="industrial-quad-relay-bricklet">Industrial Quad Relay Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Industrial_Quad_Relay.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-22">Binding properties:</h4>
<p>The Quad Relay Bricklet has four sub devices.
The subids are:</p>
<ul>
<li>relay0</li>
<li>relay1</li>
<li>relay2</li>
<li>relay3</li>
</ul>
<h5 id="bricklet-17">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_industrial_quad_relay</td>
</tr>
</tbody>
</table>
<h5 id="relay-sub-devices-1">Relay sub devices:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>same as bricklet</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>relay0, relay2, relay3, relay4</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>industrial_quad_relay</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-22">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>relay0.uid=<your_uid>
relay0.type=quad_relay
relay0.subid=relay0
relay1.uid=<your_uid>
relay1.type=quad_relay
relay1.subid=relay1
relay2.uid=<your_uid>
relay2.type=quad_relay
relay2.subid=relay2
relay3.uid=<your_uid>
relay3.type=quad_relay
relay3.subid=relay3
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-22">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Switch QR1 "QR1" {tinkerforge="uid=<your_uid>, subid=relay0"}
Switch QR2 "QR2" {tinkerforge="uid=<your_uid>, subid=relay1"}
Switch QR3 "QR3" {tinkerforge="uid=<your_uid>, subid=relay2"}
Switch QR4 "QR4" {tinkerforge="uid=<your_uid>, subid=relay3"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-22">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf label="QuadRelay"
{
Frame {
Switch item=QR1
Switch item=QR2
Switch item=QR3
Switch item=QR4
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="io4-bricklet">IO4 Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/IO4.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-23">Binding properties:</h4>
<p>If you set the property $debouncePeriod to 100, you will get the interrupt maximal every 100ms. This is necessary if something that bounces is connected to the IO-4 Bricklet, such as a button.</p>
<h5 id="bricklet-18">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>descripition</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_io4</td>
</tr>
<tr>
<td>debouncePeriod</td>
<td>debounce time in ms</td>
<td>default=100</td>
</tr>
</tbody>
</table>
<h5 id="io-sensor-sub-device">IO-Sensor sub device:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>same as bricklet</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>in1</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>io4sensor</td>
</tr>
<tr>
<td>pullUpResistorEnabled</td>
<td>enable the pull-up resistor</td>
<td>true, false</td>
</tr>
</tbody>
</table>
<h5 id="io-actor-sub-device">IO-Actor sub device:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>same as bricklet</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>out0</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>io4_actuator</td>
</tr>
<tr>
<td>defaultState</td>
<td>default state of the port, true = HIGH, false=LOW</td>
<td>true, false</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-23">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>io4.uid=<your_uid>
io4.type=bricklet_io4
io4.debouncePeriod=200
io0.uid=<your_uid>
io0.type=io4_actuator
io0.subid=out0
io0.defaultState=true
io1.uid=<your_uid>
io1.type=io4sensor
io1.subid=in1
io1.pullUpResistorEnabled=true
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-23">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Switch out0 "out0 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=out0"}
Contact in1 "in1 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=in1"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-23">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap io4 label="IO4"
{
Frame {
Switch item=out0
Text item=in1
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="io-16-bricklet">IO 16 Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/IO16.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-24">Binding properties:</h4>
<p>If you set the property $debouncePeriod to 100, you will get the interrupt maximal every 100ms. This is necessary if something that bounces is connected to the IO-16 Bricklet, such as a button.</p>
<h5 id="bricklet-19">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_io16</td>
</tr>
<tr>
<td>debouncePeriod</td>
<td>debounce time in ms</td>
<td>default=100</td>
</tr>
</tbody>
</table>
<h5 id="io-sensor-sub-device-1">IO-Sensor sub device:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>same as bricklet</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>ina0, ina1, ina2, ina3, ina4, ina5, ina6, ina7, inb0, inb1, inb2, inb3, inb4, inb5, inb6, inb7</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>iosensor</td>
</tr>
<tr>
<td>pullUpResistorEnabled</td>
<td>enable the pull-up resistor</td>
<td>true, false</td>
</tr>
</tbody>
</table>
<h5 id="io-actor-sub-device-1">IO-Actor sub device:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>same as bricklet</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>outa0, outa1, outa2, outa3, outa4, outa5, outa6, outa7, outb1, outb2, outb3, outb4, outb5, outb6, outb7</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>io_actuator</td>
</tr>
<tr>
<td>defaultState</td>
<td>default state of the port, true = HIGH, false=LOW</td>
<td>true, false</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-24">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>io16.uid=<your_uid>
io16.type=bricklet_io16
io16.debouncePeriod=100
io16ina0.uid=<your_uid>
io16ina0.subid=ina0
io16ina0.type=iosensor
io16ina0.pullUpResistorEnabled=true
io16ina1.uid=<your_uid>
io16ina1.subid=ina1
io16ina1.type=iosensor
io16ina1.pullUpResistorEnabled=true
io16outa2.uid=<your_uid>
io16outa2.subid=outa2
io16outa2.type=io_actuator
io16outa3.uid=<your_uid>
io16outa3.subid=outa3
io16outa3.type=io_actuator
io16ina4.uid=<your_uid>
io16ina4.subid=ina4
io16ina4.type=iosensor
io16ina4.pullUpResistorEnabled=true
io16ina5.uid=<your_uid>
io16ina5.subid=ina5
io16ina5.type=iosensor
io16ina5.pullUpResistorEnabled=true
io16ina6.uid=<your_uid>
io16ina6.subid=ina6
io16ina6.type=iosensor
io16ina6.pullUpResistorEnabled=true
io16ina7.uid=<your_uid>
io16ina7.subid=ina7
io16ina7.type=iosensor
io16ina7.pullUpResistorEnabled=true
#### port b
io16outb0.uid=<your_uid>
io16outb0.subid=outb0
io16outb0.type=io_actuator
io16inb1.uid=<your_uid>
io16inb1.subid=inb1
io16inb1.type=iosensor
io16inb1.pullUpResistorEnabled=true
io16inb2.uid=<your_uid>
io16inb2.subid=inb2
io16inb2.type=iosensor
io16inb2.pullUpResistorEnabled=true
io16inb3.uid=<your_uid>
io16inb3.subid=inb3
io16inb3.type=iosensor
io16inb3.pullUpResistorEnabled=true
io16inb4.uid=<your_uid>
io16inb4.subid=inb4
io16inb4.type=iosensor
io16inb4.pullUpResistorEnabled=true
io16inb5.uid=<your_uid>
io16inb5.subid=inb5
io16inb5.type=iosensor
io16inb5.pullUpResistorEnabled=true
io16inb6.uid=<your_uid>
io16inb6.subid=inb6
io16inb6.type=iosensor
io16inb6.pullUpResistorEnabled=true
io16inb7.uid=<your_uid>
io16inb7.subid=inb7
io16inb7.type=iosensor
io16inb7.pullUpResistorEnabled=true
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-24">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Contact ina0 "ina0 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=ina0"}
Contact ina1 "ina1 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=ina1"}
Switch outa2 "outa2" {tinkerforge="uid=<your_uid>, subid=outa2"}
Switch outa3 "outa3" {tinkerforge="uid=<your_uid>, subid=outa3"}
Contact ina4 "ina4 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=ina4"}
Contact ina5 "ina5 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=ina5"}
Contact ina6 "ina6 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=ina6"}
Contact ina7 "ina7 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=ina7"}
Switch outb0 "outb0" {tinkerforge="uid=<your_uid>, subid=outb0"}
Contact inb1 "inb1 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=inb1"}
Contact inb2 "inb2 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=inb2"}
Contact inb3 "inb3 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=inb3"}
Contact inb4 "inb4 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=inb4"}
Contact inb5 "inb5 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=inb5"}
Contact inb6 "inb6 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=inb6"}
Contact inb7 "inb7 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=inb7"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-24">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap io16 label="Main Menu"
{
Frame {
Text item=ina0
Text item=ina1
Switch item=outa2
Switch item=outa3
Text item=ina4
Text item=ina5
Text item=ina6
Text item=ina7
Switch item=outb0
Text item=inb1
Text item=inb2
Text item=inb3
Text item=inb4
Text item=inb5
Text item=inb6
Text item=inb7
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="joystick-bricklet">Joystick Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Joystick.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-25">Binding properties:</h4>
<p>There are three sub devices: joystick_xposition, joystick_yposition and joystick_button.
Callback period for xy position defaults to 10 milli seconds. CallbackPeriod must be configured
on bricklet_joystick device, because x and y position can not have
different callback periods.</p>
<h5 id="button">Button</h5>
<p>Two operating modes for the button. The button can behave like a switch or
like a tactile switch.</p>
<ul>
<li>Switch mode</li>
</ul>
<p>The switch mode operates like this: pressing the button toggles the
switch state, if state was ON it goes to OFF and vice versa. Releasing the button doesn’t
change anything, only the next button press will change the state.</p>
<ul>
<li>Tactile switch mode</li>
</ul>
<p>Pressing the button changes the switch state to ON and releasing the button changes the
state back to OFF again.</p>
<p>Switch Mode is the default mode you can change the mode to tactile by adding a line like this
to your tinkerforge.cfg:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>joystickbutton.tactile=True
</code></pre></div></div>
<h5 id="tinkerforgecfg-25">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>joystick.uid=<your_uid>
joystick.type=bricklet_joystick
joystick.callbackPeriod=1000
joystickbutton.uid=<your_uid>
joystickbutton.subid=joystick_button
joystickbutton.type=joystick_button
joystickbutton.tactile=True
yposition.uid=<your_uid>
yposition.subid=joystick_yposition
yposition.type=joystick_yposition
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-25">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number XPostion "XPostion [%.0f]" { tinkerforge="uid=<your_uid>, subid=joystick_xposition"}
Number YPostion "YPostion [%.0f]" { tinkerforge="name=yposition"}
Contact JoystickButton "Button" { tinkerforge="uid=<your_uid>, subid=joystick_button"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-25">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf_weather label="Joystick"
{
Frame {
Text item=XPostion
Text item=YPostion
Text item=JoystickButton
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="laser-range-finder-bricklet">Laser Range Finder Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Laser_Range_Finder.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-26">Binding properties:</h4>
<p>The laser will be enabled by default on system start. This can be changed by
setting enableLaserOnStartup to false on the bricklet_laser_range_finder type in services/tinkerforge.cfg.
If the laser is already enabled it will never be disabled on openHAB startup.</p>
<p>Moving average is a calculation to analyze data points by creating series of averages of different subsets of the full data set.</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>lrf.uid=<your_uid>
lrf.type=bricklet_laser_range_finder
lrf.enableLaserOnStartup=false
</code></pre></div></div>
<p>Properties $distanceAverageLength and $velocityAverageLength set the length of a moving averaging for the distance and velocity. Setting the property to 0 will turn the averaging completely off. With less averaging, there is more noise on the data. The range for the averaging is 0-30, default value is 10.</p>
<p>Property $mode sets the mode for measurements, five modes are available, one mode for distance measurements and four modes for velocity measurements with different ranges and resolutions.</p>
<h5 id="bricklet-20">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_laser_range_finder</td>
</tr>
<tr>
<td>distanceAverageLength</td>
<td>sets the length of a moving averaging for the distance, default=10</td>
<td>0-30</td>
</tr>
<tr>
<td>velocityAverageLength</td>
<td>sets the length of a moving averaging for the velocity, default=10</td>
<td>0-30</td>
</tr>
<tr>
<td>mode</td>
<td>sets the mode for measurements, default=0</td>
<td>0: Distance is measured with resolution 1.0 cm and range 0-400 cm</td>
</tr>
<tr>
<td>mode</td>
<td>sets the mode for measurements, default=0</td>
<td>1: Velocity is measured with resolution 0.1 m/s and range is 0-12.7 m/s</td>
</tr>
<tr>
<td>mode</td>
<td>sets the mode for measurements, default=0</td>
<td>2: Velocity is measured with resolution 0.25 m/s and range is 0-31.75 m/s</td>
</tr>
<tr>
<td>mode</td>
<td>sets the mode for measurements, default=0</td>
<td>3: Velocity is measured with resolution 0.5 m/s and range is 0-63.5 m/s</td>
</tr>
<tr>
<td>mode</td>
<td>sets the mode for measurements, default=0</td>
<td>4: Velocity is measured with resolution 1.0 m/s and range is 0-127 m/s</td>
</tr>
<tr>
<td>enableLaserOnStartup</td>
<td>enables or disables laser on startup, default=true</td>
<td>true, false</td>
</tr>
</tbody>
</table>
<h5 id="laser-range-finder-sub-devices">Laser Range Finder sub devices:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>same as bricklet</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>distance, velocity, laser</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>laser_range_finder_distance, laser_range_finder_velocity, laser_range_finder_laser</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>threshold</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-26">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>lrf.uid=<your_uid>
lrf.type=bricklet_laser_range_finder
lrf.distanceAverageLength=10
lrf.velocityAverageLength=10
lrf.mode=1
lrf.enableLaserOnStartup=True
distance.uid=<your_uid>
distance.subid=distance
distance.type=laser_range_finder_distance
distance.callbackPeriod=10
distance.threshold=0
velocity.uid=<your_uid>
velocity.subid=velocity
velocity.type=laser_range_finder_velocity
velocity.callbackPeriod=10
velocity.threshold=0
laser.uid=<your_uid>
laser.subid=laser
laser.type=laser_range_finder_laser
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-26">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number distance "Distance [%.0f]" {tinkerforge="uid=<your_uid>, subid=distance"}
Number velocity "Velocity [%.4f]" {tinkerforge="uid=<your_uid>, subid=velocity"}
Switch laser "Enable Laser" {tinkerforge="uid=<your_uid>, subid=laser"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-26">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf label="Laser Range Finder"
{
Frame label="Laser Range Finder" {
Text item=distance
Text item=velocity
Switch item=laser
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="lcd-20x4-display-bricklet">LCD 20x4 Display Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/LCD_20x4.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-27">Binding properties:</h4>
<p>The LCD20x4 is a bit special as it acts as actuator which can receive text messages. To
achieve this, you have to configure the device as String item.</p>
<p>What’s the meaning of this magic string?</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sendCommand(TF_LCD, String::format("TFNUM<213>%4s"Barometer.state.format("%d")))
</code></pre></div></div>
<p>TFNUM is just a flag to signal the binding that some position information is passed. The first
number is the line number, starting from 0. The second and third number are interpreted as the
position in the line, starting from 0.</p>
<p>The above example would write the current value of the barometer bricklet to line 3 starting from
position 14, with a fixed width of 4 (this is because of %4s).</p>
<h5 id="bricklet-21">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_LCD20x4</td>
</tr>
</tbody>
</table>
<h5 id="backlight-sub-device">Backlight sub device:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>same as bricklet</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>backlight</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>backlight</td>
</tr>
</tbody>
</table>
<h5 id="button-sub-devices">Button sub devices:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>same as bricklet</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>button0, button1, button2, button3</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>lcd_button</td>
</tr>
</tbody>
</table>
<h5 id="items-file-entry-eg-tinkerforgeitems-27">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>String LCD "LCD" { tinkerforge="uid=<your_uid>"}
Switch LCDBacklight "LCDBacklight" { tinkerforge="uid=<your_uid>, subid=backlight"}
Switch Button0 "Button0" { tinkerforge="uid=<your_uid>, subid=button0"}
Switch Button1 "Button1" { tinkerforge="uid=<your_uid>, subid=button1"}
Switch Button2 "Button2" { tinkerforge="uid=<your_uid>, subid=button2"}
Switch Button3 "Button3" { tinkerforge="uid=<your_uid>, subid=button3"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-27">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Switch item=LCDBacklight
</code></pre></div></div>
<h5 id="rules-file-eg-tinkerforgerules-1">Rules file (e.g. tinkerforge.rules):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>import org.openhab.core.library.types.*
var Number initialSleepTime = 10
rule "Weatherstation LCD init from Backlight"
when
Item TF_LCDBacklight changed from UNDEF or
System started
then
createTimer(now.plusSeconds(initialSleepTime)) [|
sendCommand(TF_LCD, "TFNUM<00>Temperature: C")
sendCommand(TF_LCD, "TFNUM<10>Humidity : %")
sendCommand(TF_LCD, "TFNUM<20>Pressure : hPa")
sendCommand(TF_LCD, "TFNUM<30>Luminance : Lux")
sendCommand(TF_LCDBacklight, ON)
sendCommand(TF_LCD, String::format("TFNUM<013>%4s",
TF_Barometer_Temperature.state.format("%.1f")))
sendCommand(TF_LCD, String::format("TFNUM<113>%4s",
TF_Humdity.state.format("%.1f")))
sendCommand(TF_LCD, String::format("TFNUM<213>%4s",
TF_Barometer.state.format("%.0f")))
sendCommand(TF_LCD, String::format("TFNUM<313>%4s",
TF_AmbientLight.state.format("%.0f")))
]
end
rule Goodbye
when
System shuts down
then
sendCommand(TF_LCDBacklight, OFF)
end
rule "Weatherstation LCD Backlight"
when
Item TF_Button0 received update
then
if (TF_Button0.state == ON)
sendCommand(TF_LCDBacklight, ON)
else
sendCommand(TF_LCDBacklight, OFF)
end
rule "Weatherstation LCD update temperature"
when
Item TF_Barometer_Temperature received update
then
sendCommand(TF_LCD, String::format("TFNUM<013>%4s",
TF_Barometer_Temperature.state.format("%.1f")
))
end
rule "Weatherstation LCD update humidity"
when
Item TF_Humdity received update
then
sendCommand(TF_LCD, String::format("TFNUM<113>%4s",
TF_Humdity.state.format("%.1f")
))
end
rule "Weatherstation LCD update airpressure"
when
Item TF_Barometer received update
then
sendCommand(TF_LCD, String::format("TFNUM<213>%4s",
TF_Barometer.state.format("%.0f")
))
end
rule "Weatherstation LCD update ambientLight"
when
Item TF_AmbientLight received update
then
sendCommand(TF_LCD, String::format("TFNUM<313>%4s",
TF_AmbientLight.state.format("%.0f")
))
end
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="led-strip-bricklet">LED Strip Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/LED_Strip.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-28">Binding properties:</h4>
<p>Supported chip types are WS2801, WS2811, WS2812/SK6812 (NeoPixel RGB), SK6812RGBW (NeoPixel RGBW), LPD8806 or APA102 (DotStar) LED driver.
An entry in services/tinkerforge.cfg is <em>mandatory</em>. $type, $frameduration, $chiptype, $clockfrequency and $colorMapping have to be set. The available configuration variables depend on the chip type of the LED strip.<br />
All LEDs can be switched independently. A subdevice $ledgroup can be set to group LED’s together.<br />
The colormapping of the LED chip types are not standardized, therefore the sequence of the letters “rgb” can be changed individually to match the the color of your LED Strip.</p>
<h5 id="bricklet-22">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_ledstrip</td>
</tr>
<tr>
<td>framduration</td>
<td>sets the frame duration in ms, default: 100ms (10 fps)</td>
<td> </td>
</tr>
<tr>
<td>chiptype</td>
<td>sets the strip chip type</td>
<td>ws2801, ws2811, ws2812</td>
</tr>
<tr>
<td>clockfrequency</td>
<td>sets the frequency of the clock in Hz</td>
<td>10000Hz (10kHz) up to 2000000Hz (2MHz)</td>
</tr>
<tr>
<td>colorMapping</td>
<td>sets the colormapping</td>
<td>rbg or any other letter sequence of “r”, “g” and “b”</td>
</tr>
<tr>
<td>subDevices</td>
<td>configures a group of led</td>
<td>f.e. ledgroup1 ledgroup2</td>
</tr>
</tbody>
</table>
<h5 id="led-strip-sub-device-optional">LED Strip sub device (optional):</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>same as bricklet</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>ledgroup1</td>
</tr>
<tr>
<td>leds</td>
<td>configures a group of led’s</td>
<td>depends on the number of led’s used</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-27">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ledstrip.uid=<your_uid>
ledstrip.type=bricklet_ledstrip
ledstrip.frameduration=100
ledstrip.chiptype=ws2801
ledstrip.clockfrequency=1000000
#ledstrip.colorMapping=rbg
ledstrip.colorMapping=brg
ledstrip.subDevices=ledgroup1 ledgroup2
ledgroup1.uid=<your_uid>
ledgroup1.subid=ledgroup1
ledgroup1.type=ledgroup
ledgroup1.leds=0|1-6
ledgroup2.uid=<your_uid>
ledgroup2.subid=ledgroup2
ledgroup2.type=ledgroup
ledgroup2.leds=0|7-14
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-28">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Color tfled1 <slider> {tinkerforge="uid=<your_uid>, subid=ledgroup1"}
Color tfled2 <slider> {tinkerforge="uid=<your_uid>, subid=ledgroup2"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-28">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf label="TinkerForge LED"
{
Frame label="LED Strip" {
Colorpicker item=tfled1 icon="slider"
Colorpicker item=tfled2 icon="slider"
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="linear-poti-bricklet">Linear Poti Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Linear_Poti.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-29">Binding properties:</h4>
<p>You can expect values from 0 - 100 %.
The default callback period is 10 millis, you can change this within services/tinkerforge.cfg.</p>
<h5 id="bricklet-23">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_linear_poti</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-28">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>linearpoti.uid=<your_uid>
linearpoti.type=bricklet_linear_poti
linearpoti.callbackPeriod=1000
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-29">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number Poti "Poti [%.0f]" { tinkerforge="uid=<your_uid>"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-29">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tflabel="Linear Poti"
{
Frame {
Text item=Poti
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="load-cell-bricklet">Load Cell Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Load_Cell.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-30">Binding properties:</h4>
<p>Returns the currently measured weight in grams. An LED can be turned on to inidicate that a weight measurement is in range.</p>
<p>Moving average is a calculation to analyze data points by creating series of averages of different subsets of the full data set.</p>
<h5 id="tinkerforge-action-1">TinkerForge Action</h5>
<p>The openHAB action <a href="#tinkerforge-actions">TinkerforgeAction</a> comes up with the action tfLoadCellTare.
tfLoadCellTare(String uid) sets tare on the load cell bricklet with the given uid.</p>
<p>Example:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>rule "Tare"
when
Item Tare changed to ON
then
postUpdate(TareValue, Weight.state)
tfLoadCellTare("<your_uid>")
end
</code></pre></div></div>
<h5 id="bricklet-24">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_loadcell</td>
</tr>
</tbody>
</table>
<h5 id="load-cell-sub-device">Load Cell sub device:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>same as bricklet</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>weight, led</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>loadcell_weight, loadcell_led</td>
</tr>
<tr>
<td>movingAverage</td>
<td>sets the value for moving average, default=4</td>
<td>1-40</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-29">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>loadcell.uid=<your_uid>
loadcell.type=bricklet_loadcell
weight.uid=<your_uid>
weight.subid=weight
weight.type=loadcell_weight
weight.callbackPeriod=100
weight.movingAverage=4
led.uid=<your_uid>
led.subid=led
led.type=loadcell_led
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-30">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number Weight "Weight [%.0f]" { tinkerforge="uid=<your_uid>, subid=weight"}
Switch Led "Led" {tinkerforge="uid=<your_uid>, subid=led"}
Switch Tare "Tare"
Number TareValue "Tare Value [%.0f]"
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-30">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf label="Load Cell"
{
Frame {
Text item=Weight
Switch item=Led
Switch item=Tare
Text item=TareValue
}
}
</code></pre></div></div>
<h5 id="rules-eg-tinkerforgerules-2">Rules (e.g tinkerforge.rules):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>import org.openhab.core.library.types.*
rule "Tare"
when
Item Tare changed to ON
then
postUpdate(TareValue, Weight.state)
tfLoadCellTare("<your_uid>")
end
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="motion-detector-bricklet">Motion Detector Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Motion_Detector.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-31">Binding properties:</h4>
<p>Senses movement of people and animals with a detection range of 3m to 7m and a sensing angle of 100°.</p>
<p>An entry in services/tinkerforge.cfg is only needed if you want to use a <a href="#sym_name"><em>symbolic name</em></a>.</p>
<h5 id="bricklet-25">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>motion_detector</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-30">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>motion.uid=<your_uid>
motion.type=motion_detector
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-31">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Contact motion "motion [MAP(en.map):MOTION%s]" {tinkerforge="uid=<your_uid>"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-31">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Text item=motion
</code></pre></div></div>
<h5 id="enmap-file">en.map file:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>MOTIONCLOSED=no motion
MOTIONOPEN=montion detected
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="multi-touch-bricklet">Multi Touch Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Multi_Touch.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-32">Binding properties:</h4>
<p>An entry in services/tinkerforge.cfg is only needed if you want to adjust sensitivity, recalibrate, disable
electrodes or use a <a href="#sym_name"><em>symbolic name</em></a>.</p>
<h5 id="bricklet-26">Bricklet:</h5>
<h5 id="device-configuration">Device configuration:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_multitouch</td>
</tr>
<tr>
<td>sensitivity</td>
<td>sets the electrodes sensitivity, default=181</td>
<td>5-201</td>
</tr>
<tr>
<td>recalibrate</td>
<td>recalibrate the sensor</td>
<td>true or false</td>
</tr>
</tbody>
</table>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>touch.uid=<your_uid>
touch.type=bricklet_multitouch
touch.sensitivity=181
touch.recalibrate=true
</code></pre></div></div>
<h5 id="electrode-sub-device-configuration">Electrode sub device configuration:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>electrode0 electrode1 electrode2 electrode3 electrode4 electrode5 electrode6 electrode7 electrode8 electrode9 electrode10 electrode11</td>
</tr>
<tr>
<td>disableElectrode</td>
<td>disables the electrode</td>
<td>true or false</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-for-electrodes">tinkerforge.cfg for electrodes:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>e1.uid=<your_uid>
e1.type=electrode
e1.subid=electrode1
e1.disableElectrode=true
</code></pre></div></div>
<h5 id="proximity-sub-device-configuration">Proximity sub device configuration:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>proximity</td>
</tr>
<tr>
<td>disableElectrode</td>
<td>disables the proximity detection</td>
<td>true or false</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-for-proximity">tinkerforge.cfg for proximity:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>prox.uid=<your_uid>
prox.type=proximity
prox.subid=proximity
prox.disableElectrode=true
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-32">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Contact electrode0 "electrode0 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=electrode0"}
Contact electrode1 "electrode1 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=electrode1"}
Contact electrode2 "electrode2 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=electrode2"}
Contact electrode3 "electrode3 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=electrode3"}
Contact electrode4 "electrode4 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=electrode4"}
Contact electrode5 "electrode5 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=electrode5"}
Contact electrode6 "electrode6 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=electrode6"}
Contact electrode7 "electrode7 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=electrode7"}
Contact electrode8 "electrode8 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=electrode8"}
Contact electrode9 "electrode9 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=electrode9"}
Contact electrode10 "electrode10 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=electrode10"}
Contact electrode11 "electrode11 [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=electrode11"}
Contact proximity "proximity [MAP(en.map):%s]" {tinkerforge="uid=<your_uid>, subid=proximity"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-32">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Text item=electrode0
Text item=electrode1
Text item=electrode2
Text item=electrode3
Text item=electrode4
Text item=electrode5
Text item=electrode6
Text item=electrode7
Text item=electrode8
Text item=electrode9
Text item=electrode10
Text item=electrode11
Text item=proximity
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="moisture-bricklet">Moisture Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Moisture.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-33">Binding properties:</h4>
<p>An entry in services/tinkerforge.cfg is only needed if you want to adjust <a href="#callback-and-threshold">threshold and / or callbackPeriod</a> or if you want to use a <a href="#sym_name"><em>symbolic name</em></a>.</p>
<p>Moving average is a calculation to analyze data points by creating series of averages of different subsets of the full data set.</p>
<h5 id="tinkerforgecfg-31">tinkerforge.cfg:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_moisture</td>
</tr>
<tr>
<td>threshold</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>movingAverage</td>
<td>sets the value for moving average, default=100</td>
<td>0-100</td>
</tr>
</tbody>
</table>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>moisture.uid=<your_uid>
moisture.type=bricklet_moisture
moisture.threshold=0
moisture.callbackPeriod=5000
moisture.movingAverage=90
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-33">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number Moisture "Moisture [%.1f]" { tinkerforge="uid=<your_uid>" }
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-33">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Text item=Moisture
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="piezo-speaker-bricklet">Piezo Speaker Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Piezo_Speaker.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-34">Binding properties:</h4>
<p>The Piezo Speaker Bricklet supports two modes:</p>
<ul>
<li>sending morse codes with configurable frequency</li>
<li>sending tones with configurable duration and frequency</li>
</ul>
<p>Configuration is done through item definition. In order to use different tone sequences you need to use one item per tone sequence.</p>
<p>Example:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Switch Beep "Beep" { autoupdate="false", tinkerforge="uid=<your_uid>, mode=beep, durations=500|100, frequencies=10|10000, repeat=2" }
Switch Morse "Morse" { autoupdate="false", tinkerforge="uid=<your_uid>, mode=morse, morsecodes=...---...|---, frequencies=10|10000, repeat=2" }
</code></pre></div></div>
<p>With the <em>repeat</em> statement the tone sequence is repeated with the given number.</p>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="ptc-bricklet">PTC Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/PTC.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-35">Binding properties:</h4>
<p>Wire mode of the sensor has to be set. Possible values are 2, 3 and 4 which correspond to 2-, 3- and 4-wire sensors. The value has to match the jumper configuration on the Bricklet.</p>
<h5 id="bricklet-27">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_ptc</td>
</tr>
<tr>
<td>wiremode</td>
<td>sets the wire mode of the sensor, default=2</td>
<td>2, 3, 4</td>
</tr>
</tbody>
</table>
<h5 id="ptc-sub-device">PTC sub device:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>same as bricklet</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>ptc_temperature</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>ptc_temperature</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-32">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>brickletptc.uid=<your_uid>
brickletptc.type=bricklet_ptc
brickletptc.wiremode=2
ptctemperature.uid=<your_uid>
ptctemperature.subid=ptc_temperature
ptctemperature.type=ptc_temperature
ptctemperature.callbackPeriod=1000
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-34">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Contact connected {tinkerforge="uid=<your_uid>, subid=ptc_connected"}
Number temperature "Temperature [%.2f]" {tinkerforge="uid=<your_uid>, subid=ptc_temperature"}
Number resistance "Resistance [%.0f]" {tinkerforge="uid=<your_uid>, subid=ptc_resistance"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-34">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf label="TinkerForge PTC"
{
Frame label="PTC" {
Text item=temperature
Text item=resistance
Text item=connected
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="remote-switch-bricklet">Remote Switch Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Remote_Switch.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-36">Binding properties:</h4>
<p>An entry in services/tinkerforge.cfg is <em>mandatory</em>. You have to set sub device names $subdevice for your devices in the appropriate
type$typeDevices variable as space separated list. $type depends on the device hardware type of your switching device.
You must also add configuration for the $subdevice device. The available configuration variables depend
on the device type.</p>
<h5 id="tinkerforgecfg-33">tinkerforge.cfg:</h5>
<ul>
<li>Device configuration</li>
</ul>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_remote_switch</td>
</tr>
<tr>
<td>typeADevices</td>
<td>sub device names of type A devices</td>
<td>choose a reasonable string, e.g. “kitchen” or “floor”</td>
</tr>
<tr>
<td>typeBDevices</td>
<td>sub device names of type B devices</td>
<td>choose a reasonable string</td>
</tr>
<tr>
<td>typeCDevices</td>
<td>sub device names of type C devices</td>
<td>choose a reasonable string</td>
</tr>
</tbody>
</table>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>rs1.uid=<your_uid>
rs1.type=bricklet_remote_switch
rs1.typeADevices=rslr1 rslr2
rs1.typeBDevices=kitchen
rs1.typeCDevices=floor
</code></pre></div></div>
<ul>
<li>Sub device type A configuration:</li>
</ul>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>subid</td>
<td>must correspond to the device(A,B,C)Devices setting</td>
<td>e.b. kitchen</td>
</tr>
<tr>
<td>houseCode</td>
<td>the house code of the switching device</td>
<td>e.g. 31</td>
</tr>
<tr>
<td>receiverCode</td>
<td>the receiver code of the switching device</td>
<td>e.g. 8</td>
</tr>
<tr>
<td>repeats</td>
<td>the number of times the code is send</td>
<td>e.g. 5</td>
</tr>
</tbody>
</table>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>rs_living_room.uid=<your_uid>
rs_living_room.subid=rslr1
rs_living_room.type=remote_switch_a
rs_living_room.houseCode=31
rs_living_room.receiverCode=8
rs_living_room2.uid=<your_uid>
rs_living_room2.subid=rslr2
rs_living_room2.type=remote_switch_a
rs_living_room2.houseCode=31
rs_living_room2.receiverCode=9
</code></pre></div></div>
<ul>
<li>Sub device type B configuration:</li>
</ul>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>subid</td>
<td>must correspond to the device(A,B,C)Devices setting</td>
<td>e.b. kitchen</td>
</tr>
<tr>
<td>address</td>
<td>the address of the switching device</td>
<td>e.g. 344</td>
</tr>
<tr>
<td>unit</td>
<td>the unit value of the switching device</td>
<td>e.g. 9</td>
</tr>
<tr>
<td>repeats</td>
<td>the number of times the code is send</td>
<td>e.g. 5</td>
</tr>
</tbody>
</table>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>rs_kitchen.uid=<your_uid>
rs_kitchen.subid=kitchen
rs_kitchen.type=remote_switch_b
rs_kitchen.address=344
rs_kitchen.unit=9
</code></pre></div></div>
<ul>
<li>Sub device type C configuration:</li>
</ul>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>subid</td>
<td>must correspond to the device(A,B,C)Devices setting</td>
<td>e.b. kitchen</td>
</tr>
<tr>
<td>systemCode</td>
<td>the system code of the switching device</td>
<td>e.g. A</td>
</tr>
<tr>
<td>deviceCode</td>
<td>the device code of the switching device</td>
<td>e.g. 8</td>
</tr>
<tr>
<td>repeats</td>
<td>the number of times the code is send</td>
<td>e.g. 5</td>
</tr>
</tbody>
</table>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>rs_floor.uid=<your_uid>
rs_floor.subid=floor
rs_floor.type=remote_switch_c
rs_floor.systemCode=A
rs_floor.deviceCode=8
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-35">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Dimmer dimmb "dimmb [%d %%]" <slider> {tinkerforge="uid=<your_uid>, subid=kitchen"}
Switch r0 "r0" <socket> (Lights) {tinkerforge="uid=<your_uid>, subid=rslr1"}
Switch r1 "r1" <socket> (Lights) {tinkerforge="uid=<your_uid>, subid=rslr2"}
Switch rb "rb" <socket> (Lights) {tinkerforge="uid=<your_uid>, subid=kitchen"}
Switch rc "rc" <socket> (Lights) {tinkerforge="uid=<your_uid>, subid=floor"}
Group:Switch:OR(ON,OFF) Lights "All Lights [(%d)]"
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-35">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf label="RemoteSwitch"
{
Frame label="Group" {
Text label="Group Demo" icon="1stfloor" {
Switch item=Lights mappings=[OFF="All Off",ON="All On"]
}
}
Frame label="Remote" {
Switch item=r0
Switch item=r1
Switch item=rb
Slider item=dimmb switchSupport
Switch item=rc
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="rotary-encoder-bricklet">Rotary Encoder Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Rotary_Encoder.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-37">Binding properties:</h4>
<p>There are two sub devices: encoder and button.
Callback period for encoder defaults to 10 milli seconds. CallbackPeriod can be configured
for the encoder sub device.</p>
<h5 id="tinkerforge-action-2">TinkerForge Action</h5>
<p>The openHAB action <a href="#tinkerforge-actions">TinkerforgeAction</a> comes up with the action tfRotaryEncoderClear.
tfRotaryEncoderClear(String uid) clears the rotary encoder counter with the given uid.</p>
<p>Example:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>rule "Clear"
when Item Clear changed
then
tfRotaryEncoderClear("<your_uid>")
end
</code></pre></div></div>
<h5 id="button-1">Button</h5>
<p>Two operating modes for the button. The button can behave like a switch or
like a tactile switch.</p>
<ul>
<li>Switch mode</li>
</ul>
<p>The switch mode operates like this: pressing the button toggles the
switch state, if state was ON it goes to OFF and vice versa. Releasing the button doesn’t
change anything, only the next button press will change the state.</p>
<ul>
<li>Tactile switch mode</li>
</ul>
<p>Pressing the button changes the switch state to ON and releasing the button changes the
state back to OFF again.</p>
<p>Switch Mode is the default mode you can change the mode to tactile by adding a line like this to your tinkerforge.cfg:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>button.tactile=True
</code></pre></div></div>
<h5 id="tinkerforgecfg-34">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>encoder.uid=<your_uid>
encoder.subid=encoder
encoder.type=rotary_encoder
encoder.callbackPeriod=1
button.uid=<your_uid>
button.subid=button
button.type=rotary_encoder_button
button.tactile=False
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-36">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number Counter "Counter [%d]" { tinkerforge="uid=<your_uid>, subid=encoder"}
Contact Button "Button" { tinkerforge="uid=<your_uid>, subid=button"}
Switch Clear "Clear"
</code></pre></div></div>
<h5 id="rules-eg-tinkerforgerules-3">Rules (e.g tinkerforge.rules):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>import org.openhab.core.library.types.*
rule "Clear"
when Item Clear changed
then
tfRotaryEncoderClear("<your_id>")
end
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-36">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf label="RotaryEncoder"
{
Frame {
Text item=Counter
Text item=Button
Switch item=Clear
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="segment-display-4x7-bricklet">Segment Display 4x7 Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Segment_Display_4x7.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-38">Binding properties:</h4>
<p>The Segment Display 4x7 is a bit special as it acts as actuator which can receive number messages. To
achieve this, you have to configure the device as Number item.</p>
<p>An entry in services/tinkerforge.cfg is only needed if you want to use a <a href="#sym_name"><em>symbolic name</em></a>.</p>
<h5 id="items-file-entry-eg-tinkerforgeitems-37">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number Segment7 "Segment7" { tinkerforge="uid=<your_uid>"}
</code></pre></div></div>
<h5 id="rules-file-eg-tinkerforgerules-2">Rules file (e.g. tinkerforge.rules):</h5>
<p>If you want to display the object temperature from a temperatureIr Item called ObjectTemperature this
rule would do the trick for you.</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>rule "Weatherstation Segment update ObjectTemperature"
when
Item ObjectTemperature received update
then
sendCommand(Segment7, ObjectTemperature.state))
end
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="solid-state-relay-bricklet">Solid State Relay Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Solid_State_Relay.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-39">Binding properties:</h4>
<ul>
<li>no sub devices</li>
<li>no configuration needed for tinkerforge.cfg</li>
</ul>
<h5 id="items-file-entry-eg-tinkerforgeitems-38">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Switch relay "Relay" {tinkerforge="uid=<your_uid>"}
Contact relaystatus "Relay Status"
</code></pre></div></div>
<h5 id="rules-file-eg-tinkerforgerules-3">Rules file (e.g. tinkerforge.rules):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>import org.openhab.core.library.types.*
rule "change every 5 seconds"
when
Time cron "0/1 * * * * ?"
then
if(relay.state == ON)
sendCommand(relay, OFF)
else
sendCommand(relay, ON)
end
rule "Relay Status"
when
Item relay changed
then
if (relay.state == ON)
postUpdate(relaystatus, CLOSED)
else
postUpdate(relaystatus, OPEN)
end
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-37">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf label="TinkerForge SolidStateRelay"
{
Frame label="Relay" {
Switch item=relay
Text item=relaystatus
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="sound-intensity-bricklet">Sound Intensity Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Sound_Intensity.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-40">Binding properties:</h4>
<p>An entry in services/tinkerforge.cfg is only needed if you want to adjust <a href="#callback-and-threshold">threshold and / or callbackPeriod</a> or if you want to use a <a href="#sym_name"><em>symbolic name</em></a>.</p>
<h5 id="bricklet-28">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_soundintensity</td>
</tr>
<tr>
<td>threshold</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-35">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sound.uid=<your_uid>
sound.type=bricklet_soundintensity
sound.threshold=1
sound.callbackPeriod=5000
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-39">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number SoundIntensity "Sound [%.1f]" { tinkerforge="uid=<your_uid>" }
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-38">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Text item=SoundIntensity
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="temperature-bricklet">Temperature Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Temperature.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-41">Binding properties:</h4>
<p>An entry in services/tinkerforge.cfg is only needed if you want to adjust <a href="#callback-and-threshold">threshold and / or callbackPeriod</a> or if you want to use a <a href="#sym_name"><em>symbolic name</em></a>.</p>
<p>Since OH 1.8 there is a new option slowI2C which could be set to “True” or “False”,
the default value is “False”. More information on this setting can be found <a href="http://www.tinkerforge.com/en/doc/Software/Bricklets/Temperature_Bricklet_Java.html#BrickletTemperature::setI2CMode__short-">here</a>.</p>
<h5 id="bricklet-29">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_temperature</td>
</tr>
<tr>
<td>threshold</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-36">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>temperature.uid=<your_uid>
temperature.type=bricklet_temperature
temperature.slowI2C=False
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-40">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number temperature "Temperature [%.2f]" {tinkerforge="uid=<your_uid>"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-39">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf label="TinkerForge Temperature"
{
Frame label="Temperature" {
Text item=temperature
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="temperature-ir-bricklet">Temperature IR Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Temperature_IR.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-42">Binding properties:</h4>
<p>An entry in services/tinkerforge.cfg is only needed if you want to adjust <a href="#callback-and-threshold">threshold and / or callbackPeriod</a>,
if you want to use a <a href="#sym_name"><em>symbolic name</em></a> or adjust the emissivity of the object temperature device.</p>
<h5 id="bricklet-30">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_temperatureIR</td>
</tr>
</tbody>
</table>
<h5 id="object-temperature-sub-device">Object temperature sub device:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>object_temperature</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>object_temperature</td>
</tr>
<tr>
<td>emissivity</td>
<td>emissivity that is used to calculate the surface temperature</td>
<td>a factor of 65535 e.g. 6553</td>
</tr>
<tr>
<td>threshold</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-37">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>objIR.uid=<your_uid>
objIR.subid=object_temperature
objIR.type=object_temperature
objIR.emissivity=65535
objIR.threshold=0
</code></pre></div></div>
<h5 id="ambient-temperature-sub-device">Ambient temperature sub device:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>ambient_temperature</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>ambient_temperature</td>
</tr>
<tr>
<td>threshold</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-38">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ambIR.uid=<your_uid>
ambIR.subid=ambient_temperature
ambIR.type=ambient_temperature
ambIR.threshold=0
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-41">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number AmbientTemperature "AmbientTemperature [%.1f C]" { tinkerforge="uid=<your_uid>, subid=ambient_temperature" }
Number ObjectTemperature "ObjectTemperature [%.1f C]" { tinkerforge="uid=<your_uid>, subid=object_temperature" }
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-40">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Text item=AmbientTemperature
Text item=ObjectTemperature
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="tilt-bricklet">Tilt Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Tilt.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-43">Binding properties:</h4>
<p>You can use a contact, number or switch item.</p>
<p>An entry in services/tinkerforge.cfg is only needed if you want to use a <a href="#sym_name"><em>symbolic name</em></a>.</p>
<h5 id="bricklet-31">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_tilt</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-39">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>tilt.uid=<your_uid>
tilt.type=bricklet_tilt
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-42">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Contact tiltContact "tilt [MAP(en.map):%s]" { tinkerforge="uid=<your_uid>" }
Number tiltSensor "tilt [MAP(en.map):%s]" { tinkerforge="uid=<your_uid>" }
Switch tiltSwitch "tilt" { tinkerforge="uid=<your_uid>" }
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-41">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Text item=tiltContact
Text item=tiltSensor
Switch item=tiltSwitch
</code></pre></div></div>
<h5 id="enmap-file-entry-optional">en.map file entry (optional):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>0=closed
1=open
2=vibrating
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="thermocouple-bricklet">Thermocouple Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Thermocouple.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-44">Binding properties:</h4>
<p>The supported thermocouple types are B, E, J, K, N, R, S and T.</p>
<h5 id="bricklet-32">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>descripition</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_thermocouple</td>
</tr>
<tr>
<td>threshold</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>averaging</td>
<td>averaging sizes, default=16</td>
<td>1, 2, 4, 8 and 16 samples</td>
</tr>
<tr>
<td>thermocoupleType</td>
<td>type of sensor used, default=K</td>
<td>B, E, J, K, N, R, S and T</td>
</tr>
<tr>
<td>filter</td>
<td>frequency filter, 50Hz or 60Hz, default=50Hz</td>
<td>0 (=50Hz), 1 (=60Hz)</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-40">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>thermocouple.uid=<your_uid>
thermocouple.type=bricklet_thermocouple
thermocouple.callbackPeriod=10
thermocouple.threshold=0
thermocouple:averaging=16
thermocouple:thermocoupleType=K
thermocouple:filter=0
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-43">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number Temp "Temperature (Thermocouple) [%.1f]" { tinkerforge="uid=<your_uid>" }
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-42">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap thermocouple label="Thermocouple"
{
Frame {
Text item=Temp
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="uv-light-bricklet">UV Light Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/UV_Light.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-45">Binding properties:</h4>
<p>An entry in services/tinkerforge.cfg is only needed if you want to adjust <a href="#callback-and-threshold">threshold and / or callbackPeriod</a>.</p>
<h5 id="bricklet-33">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>descripition</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_uv_light</td>
</tr>
<tr>
<td>threshold</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-41">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>uv.uid=<your_uid>
uv.type=bricklet_uv_light
uv.callbackPeriod=10
uv.threshold=0
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-44">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number UV "UV Light [%.1f]" { tinkerforge="uid=<your_uid>" }
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-43">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap uv label="UV Light"
{
Frame {
Text item=UV
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="voltagecurrent-bricklet">Voltage/Current Bricklet</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Voltage_Current.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-46">Binding properties:</h4>
<p>An entry in services/tinkerforge.cfg is only needed if you want to adjust <a href="#callback-and-threshold">threshold and / or callbackPeriod</a>,
if you want to use a <a href="#sym_name"><em>symbolic name</em></a> or adjust the averaging, voltage conversion time,
current conversion time of the device.</p>
<h5 id="bricklet-34">Bricklet:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>bricklet_voltageCurrent</td>
</tr>
<tr>
<td>averaging</td>
<td>number of averages</td>
<td>0-7</td>
</tr>
<tr>
<td>voltageConversionTime</td>
<td>voltage conversion time</td>
<td>0-7</td>
</tr>
<tr>
<td>currentConversionTime</td>
<td>current conversion time</td>
<td>0-7</td>
</tr>
</tbody>
</table>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>voltageCurrent.uid=<your_uid>
voltageCurrent.type=bricklet_voltageCurrent
voltageCurrent.averaging=3
voltageCurrent.voltageConversionTime=4
voltageCurrent.currentConversionTime=4
</code></pre></div></div>
<h5 id="voltage-sub-device">Voltage sub device:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>voltageCurrent_voltage</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>voltageCurrent_voltage</td>
</tr>
<tr>
<td>threshold</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-42">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>vc_voltage.uid=<your_uid>
vc_voltage.subid=voltageCurrent_voltage
vc_voltage.type=voltageCurrent_voltage
vc_voltage.threshold=20
vc_voltage.callbackPeriod=100
</code></pre></div></div>
<h5 id="current-sub-device">Current sub device:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>voltageCurrent_current</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>voltageCurrent_current</td>
</tr>
<tr>
<td>threshold</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-43">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>vc_current.uid=<your_uid>
vc_current.subid=voltageCurrent_current
vc_current.type=voltageCurrent_current
vc_current.threshold=10
vc_current.callbackPeriod=100
</code></pre></div></div>
<h5 id="power-sub-device">Power sub device:</h5>
<table>
<thead>
<tr>
<th>property</th>
<th>description</th>
<th>values</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>tinkerforge uid</td>
<td>get value from brickv</td>
</tr>
<tr>
<td>subid</td>
<td>openHAB subid of the device</td>
<td>voltageCurrent_power</td>
</tr>
<tr>
<td>type</td>
<td>openHAB type name</td>
<td>voltageCurrent_power</td>
</tr>
<tr>
<td>threshold</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
<tr>
<td>callbackPeriod</td>
<td> </td>
<td>see “Callback and Threshold”</td>
</tr>
</tbody>
</table>
<h5 id="tinkerforgecfg-44">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>vc_power.uid=<your_uid>
vc_power.subid=voltageCurrent_power
vc_power.type=voltageCurrent_power
vc_power.threshold=10
vc_power.callbackPeriod=100
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-45">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number Voltage "Voltage [%d mV]" { tinkerforge="uid=<your_uid>, subid=voltageCurrent_voltage" }
Number Current "Current [%d mA]" { tinkerforge="uid=<your_uid>, subid=voltageCurrent_current" }
Number Power "Power [%d mW]" { tinkerforge="uid=<your_uid>, subid=voltageCurrent_power" }
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-44">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Text item=Voltage
Text item=Current
Text item=Power
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="weatherstation-kit">Weatherstation Kit</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Kits/WeatherStation/WeatherStation.html#starter-kit-weather-station">Tinkerforge Website</a></p>
<p>This hardware and config example makes use of Humidity, Pressure, Temperature, Ambient Light and LCD 20x4 Display Bricklets.</p>
<h4 id="configuration-examples">Configuration examples:</h4>
<h5 id="tinkerforgecfg-45">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>lcdbutton2.uid=<your_uid>
lcdbutton2.subid=button2
lcdbutton2.type=lcd_button
lcdbutton2.tactile=True
lcdbutton3.uid=<your_uid>
lcdbutton3.subid=button3
lcdbutton3.type=lcd_button
lcdbutton3.tactile=True
</code></pre></div></div>
<h5 id="items-file-entry-eg-tinkerforgeitems-46">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Number TF_Humdity "Humidity [%.1f %%]" { tinkerforge="uid=<your_uid>" }
Number TF_Barometer "Pressure [%.1f mBar]" { tinkerforge="uid=<your_uid>" }
Number TF_Barometer_Temperature "Temperature [%.1f °C]" { tinkerforge="uid=<your_uid>, subid=temperature" }
Number TF_AmbientLight "Luminance [%.1f Lux]" { tinkerforge="uid=<your_uid>" }
String TF_LCD "LCD" { tinkerforge="uid=<your_uid>"}
Switch TF_LCDBacklight "LCDBacklight" { tinkerforge="uid=<your_uid>, subid=backlight"}
Switch TF_Button0 "Button0" { tinkerforge="uid=<your_uid>, subid=button0"}
Switch TF_Button1 "Button1" { tinkerforge="uid=<your_uid>, subid=button1"}
Switch TF_Button2 "Button2" { tinkerforge="uid=<your_uid>, subid=button2"}
Switch TF_Button3 "Button3" { tinkerforge="uid=<your_uid>, subid=button3"}
Contact ConnectionStatus "ConnectionStatus [%]" {tinkerforge="uid=<your_server_ip>:<your_port>, subid=isconnected"}
Number Reconnects "Reconnects [%]" {tinkerforge="uid=<your_server_ip>:<your_port>, subid=connected_counter"}
</code></pre></div></div>
<h5 id="rules-eg-tinkerforgerules-4">Rules (e.g tinkerforge.rules):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>import org.openhab.core.library.types.*
var Integer initialSleepTime = 10
rule "Weatherstation LCD init from Backlight"
when
Item TF_LCDBacklight changed or System started
then
createTimer(now.plusSeconds(initialSleepTime)) [|
sendCommand(TF_LCD, "TFNUM<00>Temperature:")
sendCommand(TF_LCD, "TFNUM<019>C")
sendCommand(TF_LCD, "TFNUM<10>Humidity :")
sendCommand(TF_LCD, "TFNUM<119>%")
sendCommand(TF_LCD, "TFNUM<20>Pressure :")
sendCommand(TF_LCD, "TFNUM<217>hPa")
sendCommand(TF_LCD, "TFNUM<30>Luminance :")
sendCommand(TF_LCD, "TFNUM<317>Lux")
sendCommand(TF_LCD, String::format("TFNUM<013>%4s",
TF_Barometer_Temperature.state.format("%.1f")))
sendCommand(TF_LCD, String::format("TFNUM<113>%4s",
TF_Humdity.state.format("%.1f")))
sendCommand(TF_LCD, String::format("TFNUM<213>%4s",
TF_Barometer.state.format("%.0f")))
sendCommand(TF_LCD, String::format("TFNUM<313>%4s",
TF_AmbientLight.state.format("%.0f")))
]
end
rule "Goodbye"
when
System shuts down
then
sendCommand(TF_LCDBacklight, OFF)
end
rule "Weatherstation LCD Backlight"
when
Item TF_Button0 changed
then
if (TF_LCDBacklight.state == ON)
sendCommand(TF_LCDBacklight, OFF)
else
sendCommand(TF_LCDBacklight, ON)
end
rule "Weatherstation LCD update temperature"
when
Item TF_Barometer_Temperature received update
then
sendCommand(TF_LCD, String::format("TFNUM<013>%4s",
TF_Barometer_Temperature.state.format("%.1f")))
end
rule "Weatherstation LCD update humidity"
when
Item TF_Humdity received update
then
sendCommand(TF_LCD, String::format("TFNUM<113>%4s",
TF_Humdity.state.format("%.1f")))
end
rule "Weatherstation LCD update airpressure"
when
Item TF_Barometer received update
then
sendCommand(TF_LCD, String::format("TFNUM<213>%4s",
TF_Barometer.state.format("%.0f")))
end
rule "Weatherstation LCD update ambientLight"
when
Item TF_AmbientLight received update
then
sendCommand(TF_LCD, String::format("TFNUM<313>%4s",
TF_AmbientLight.state.format("%.0f")))
end
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-45">Sitemap file entry (e.g tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf_weather label="Tinkerforge Weather Station"
{
Frame {
Text item=TF_Humdity
Text item=TF_Barometer
Text item=TF_Barometer_Temperature
Text item=TF_AmbientLight
Switch item=TF_LCDBacklight
Switch item=TF_Button0
Switch item=TF_Button1
Switch item=TF_Button2
Switch item=TF_Button3
Text item=ConnectionStatus
Text item=Reconnects
}
}
</code></pre></div></div>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h3 id="brick-daemon">Brick Daemon</h3>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricklets/Industrial_Quad_Relay.html">Tinkerforge Website</a></p>
<h4 id="binding-properties-47">Binding properties:</h4>
<h5 id="items-file-entry-eg-tinkerforgeitems-47">Items file entry (e.g. tinkerforge.items):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Contact brickd1connected {tinkerforge="<uid=<your_ip>:<your_port>, subid=connected"}
Number brickd1counter "Brickd1 [%d]" {tinkerforge="uid=<your_ip>:<your_port>, subid=connected_counter"}
</code></pre></div></div>
<h5 id="sitemap-file-entry-eg-tinkerforgesitemap-46">Sitemap file entry (e.g. tinkerforge.sitemap):</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sitemap tf label="TinkerForge Brickd"
{
Frame label="Brickd" {
Text item=brickd1connected
Text item=brickd1counter
}
}
</code></pre></div></div>
<h5 id="tinkerforgecfg-46">tinkerforge.cfg:</h5>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>hosts=<your_ip>:<your_port>
refresh=1000
</code></pre></div></div>
<hr />
<h2 id="red-brick">Red Brick</h2>
<p>Technical description see <a href="http://www.tinkerforge.com/en/doc/Hardware/Bricks/RED_Brick.html#red-brick">Tinkerforge Website</a></p>
<p>openHAB is preinstalled on the RED Brick image and can be configured with the TinkerForge BrickViewer.</p>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
<h2 id="developer-notes">Developer Notes</h2>
<h3 id="171">1.7.1</h3>
<h4 id="new-devices">New Devices</h4>
<ul>
<li><a href="#accelerometer-bricklet">Accelerometer Bricklet</a></li>
<li><a href="#ambient-light-bricklet-v2">Ambient Light Bricklet 2.0</a></li>
<li><a href="#analog-in-bricklet">Analog In Bricklet</a></li>
<li><a href="#analog-in-bricklet-20">Analog In Bricklet 2.0</a></li>
<li><a href="#color-bricklet">Color Bricklet</a></li>
<li><a href="#dust-detector-bricklet">Dust Detector Bricklet</a></li>
<li><a href="#hall-effect-bricklet">Hall Effect Bricklet</a></li>
<li><a href="#industrial-dual-analog-in-bricklet">Industrial Dual Analog In Bricklet</a></li>
<li><a href="#laser-range-finder-bricklet">Laser Range Finder Bricklet</a></li>
<li><a href="#load-cell-bricklet">Load Cell Bricklet</a></li>
<li><a href="#piezo-speaker-bricklet">Piezo Speaker Bricklet</a></li>
<li><a href="#rotary-encoder-bricklet">Rotary Encoder Bricklet</a></li>
</ul>
<h3 id="170">1.7.0</h3>
<h4 id="new-devices-1">New Devices</h4>
<ul>
<li><a href="#joystick-bricklet">Joystick Bricklet</a></li>
<li><a href="#linear-poti-bricklet">Linear Poti Bricklet</a></li>
<li><a href="#dual-button-bricklet">Dual Button Bricklet</a></li>
<li><a href="#ptc-bricklet">PTC Bricklet</a></li>
<li><a href="#industrial-dual-0-20ma-bricklet">Industrial Dual 0-20mA Bricklet</a></li>
<li><a href="#solid-state-relay-bricklet">Solid State Relay Bricklet</a></li>
<li><a href="#remote-switch-bricklet">Remote Switch dimmer</a></li>
</ul>
<h4 id="new-features">New Features</h4>
<ul>
<li>Tinkerforge Action Addon</li>
<li><a href="#dc-brick">Brick DC</a> fully supported</li>
<li><a href="#servo-brick">Brick Servo</a> fully supported</li>
<li>Authentication support for brickd</li>
<li>Tactile feature for <a href="#dual-button-bricklet">Dualbutton</a>, <a href="#lcd-20x4-display-bricklet">LCD Buttons</a>, <a href="#joystick-bricklet">Joystick Button</a></li>
<li><a href="#led-strip-bricklet">LED Strip</a>: sub devices and switching capabilities, configurable Frameduration, ChipType and Clockfrequency</li>
</ul>
<h4 id="other-changes">Other changes</h4>
<ul>
<li>updated Tinkerforge API to 2.1.4</li>
</ul>
<h4 id="bugfixes">Bugfixes</h4>
<ul>
<li>Fix for configuration handling of device aliases</li>
</ul>
<h4 id="brick-dc">Brick DC</h4>
<h3 id="incompatible-changes">Incompatible changes</h3>
<ul>
<li>DriveMode now is one of “brake” or “coast” instead of “0” or “1”</li>
</ul>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>dc_garage.driveMode=brake
</code></pre></div></div>
<ul>
<li>switchOnVelocity in services/tinkerforge.cfg is no longer needed and has gone.
It is replaced by per item configuration:
With the benefit that you can have serveral switch items with different speeds.
<del>dc_garage.switchOnVelocity=10000</del></li>
</ul>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Switch DCSWITCH "DC Switch" {tinkerforge="uid=<your_uid>, speed=14000"}
</code></pre></div></div>
<h5 id="whats-new">Whats new?</h5>
<p>Support for Dimmer, Rollershuter and Number items. Besides that the speed
can be set using a percent value.</p>
<p>The number items show the current velocity. The values are reported using the VelocityListener.
“callbackPeriod” and “threshold” for the listener can be configured in services/tinkerforge.cfg. There is more
documentation about callback listeners at the official openHAB TinkerForgeBindig wiki page.</p>
<ul>
<li>callbackPeriod: milliseconds</li>
<li>threshold: numeric value</li>
</ul>
<h5 id="new-item-configuration-options">New item configuration options</h5>
<ul>
<li>speed: the target speed (Switch)</li>
<li>max: the maximum speed (Dimmer, Rollershutter)</li>
<li>min: the minimum speed (Dimmer, Rollershutter)</li>
<li>step: the step value for increasing decreasing speed (Dimmer)</li>
<li>leftspeed: the speed when the left rollershutter controller is pressed or command “DOWN” was send</li>
<li>rightspeed: the speed when the right rollershutter controller is pressed or command “UP” was send</li>
<li>acceleration: acceleration overrides value from services/tinkerforge.cfg</li>
<li>drivemode: drivemode overrides value from services/tinkerforge.cfg</li>
</ul>
<h4 id="brick-servo">Brick Servo</h4>
<h5 id="whats-new-1">Whats new?</h5>
<p>Support for Dimmer, Rollershuter and Number items. Besides that the speed
can be set using a percent value.</p>
<p>Number items will show the current position.</p>
<h5 id="new-item-configuration-options-1">New item configuration options</h5>
<ul>
<li>velocity: the velocity used to reach the new position</li>
<li>max: the maximum position (Dimmer, Rollershutter)</li>
<li>min: the minimum position (Dimmer, Rollershutter)</li>
<li>step: the step value for increasing decreasing position (Dimmer)</li>
<li>leftposition: the target position to reach when the left rollershutter controller is pressed or command “DOWN” was send</li>
<li>rightposition: the target position to reach when the right rollershutter controller is pressed or command “UP” was send</li>
<li>acceleration: the acceleration</li>
</ul>
<h5 id="tinkerforge-action-3">TinkerForge Action</h5>
<p>The new openHAB action TinkerForgeAction comes up with the action tfServoSetposition.
tfServoSetposition(uid, num, position, velocity, acceleration) can be used to control the servo.</p>
<h4 id="example-1">Example</h4>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>tfServoSetposition("6Crt5W", "servo0", "-9000", "65535", "65535")
</code></pre></div></div>
<h4 id="tinkerforge-action-addon">Tinkerforge Action Addon</h4>
<ul>
<li>tfServoSetposition as explained above</li>
<li>tfClearLCD(uid) uid is the uid of the LCD display. A call of tfClearLCD will clear the LCD display.</li>
</ul>
<h3 id="150">1.5.0</h3>
<h4 id="bugfixes-1">Bugfixes</h4>
<ul>
<li>Reconnect support for IO16 Bricklet</li>
<li>polled values now are only send once to the eventbus</li>
</ul>
<h4 id="new-devices-2">New Devices</h4>
<ul>
<li><a href="#remote-switch-bricklet">Remote Switch Bricklet</a></li>
<li><a href="#motion-detector-bricklet">Motion Detector Bricklet</a></li>
<li><a href="#multi-touch-bricklet">Multi Touch Bricklet</a></li>
<li><a href="#temperature-ir-bricklet">Temperature IR Bricklet</a></li>
<li><a href="#sound-intensity-bricklet">Sound Intensity Bricklet</a></li>
<li><a href="#moisture-bricklet">Moisture Bricklet</a></li>
<li><a href="#distance-us-bricklet">Distance US Bricklet</a></li>
<li><a href="#voltagecurrent-bricklet">Voltage/Current Bricklet</a></li>
<li><a href="#tilt-bricklet">Tilt Bricklet</a></li>
</ul>
<h4 id="other-changes-1">Other changes</h4>
<ul>
<li>updated Tinkerforge API to 2.1.0</li>
<li>Threshold values now have the unit as the sensor value (incompatible change, you have to update your services/tinkerforge.cfg)</li>
<li>polling is only done for devices which don’t support CallbackListeners / InterruptListeners</li>
</ul>
<h3 id="140">1.4.0</h3>
<h4 id="bugfixes-2">Bugfixes</h4>
<ul>
<li>Missing updates of Items if a Tinkerforge Device is referenced in several Items</li>
</ul>
<h4 id="incompatible-changes-1">Incompatible Changes</h4>
<ul>
<li>LCDBacklight is a sub device of LCD20x4 Bricklet (items file must be changed)</li>
<li>LCD20x4Button posts an update not a command anymore (rules must be changed)</li>
<li>IndustrialQuadRelay sub id numbering now starts from zero (items file must be changed)</li>
</ul>
<h4 id="new-devices-3">New Devices</h4>
<ul>
<li><a href="#industrial-quad-relay-bricklet">Industrial Quad Relay Bricklet</a></li>
<li><a href="#industrial-digital-in-4-bricklet">Industrial Digital In 4 Bricklet</a></li>
<li><a href="#io-16-bricklet">IO 16 Bricklet</a></li>
</ul>
<h4 id="other-changes-2">Other changes</h4>
<ul>
<li>updated Tinkerforge API to 2.0.12</li>
<li>support for serveral Item types
<ul>
<li>NumberItem</li>
<li>SwitchItem</li>
<li>ContactItem</li>
</ul>
</li>
<li>handle disconnected brickds
<ul>
<li>on binding startup make retries every second</li>
<li>when binding is running use the Tinkerforge autoreconnect feature</li>
</ul>
</li>
</ul>
<hr />
<p><a href="#table-of-contents">Table of Contents</a></p>
</div>
</div>
</section>
<footer>
<div class="container">
<div class="row">
<div class="col s12 m7">
Copyright © 2017 by the <a href="https://github.com/openhab">openHAB Community</a> and the <a href="http://www.openhabfoundation.org/">openHAB Foundation e.V.</a>
</div>
<div class="col s12 m5">
<ul class="list-inline right-align">
<li><a href="/imprint.html">Imprint</a></li>
<li><a href="/privacy.html">Privacy Policy</a></li>
<li><a href="http://www.openhab.org">openHAB Website</a></li>
</ul>
</div>
</div>
</div>
</footer>
<script src="/v2.1/js/jquery.min.js"></script>
<script src="/v2.1/js/jquery.scrollme.min.js"></script>
<script src="/v2.1/js/jquery.sticky.js"></script>
<script src="/v2.1/js/materialize.min.js"></script>
<script src="/v2.1/js/init.js"></script>
<script>
$(document).ready(function () {
$('#oh2-checkbox').change(function () {
if (this.checked) $('.since-2x').show('slow');
else $('.source-oh2').hide('slow');
});
$('#oh1-checkbox').change(function () {
if (this.checked) $('.since-1x').show('slow');
else $('.source-oh1').hide('slow');
});
$('#legacy-checkbox').change(function () {
if (this.checked) $('.install-legacy').show('slow');
else $('.install-legacy').hide('slow');
});
$('#manual-checkbox').change(function () {
if (this.checked) $('.install-manual').show('slow');
else $('.install-manual').hide('slow');
});
});
</script>
</body>
</html>
0965e5ec24