Samples Item Definitions

Samples of Item definitions

• How to use homematic door contact sensors
• How to use homematic window contact sensors
• How to read Homematic heater valve state
• How to configure Homematic light switch
• How to configure Homematic temperature and humidity sensor
• How to configure Homematic motion and brightness sensors
• How to configure a switch to be a pushbutton
• How to control a homematic roller shutter with an EnOcean Rocker
• How to control a homematic dimmer with an EnOcean Rocker (OnOff Profile)
• How to set up voice control for use with HABDroid

How to use homematic door contact sensors

/* OLD Configuration */
Contact corFrontDoor "Front Door [%s]" <frontdoor> (gRCor, gLock) { homematic="HEQ0358465:1#STATE" }
/* New Configuration */
Contact corFrontDoor "Front Door [%s]" <frontdoor> (gRCor, gLock) {homematic="address=HEQ0358465, channel=1, parameter=STATE" }
Text item=corFrontDoor

How to use homematic window contact sensors

Number lrWindowRight "Window Right [MAP(contact.map):%d]" <contact> (gRLvng) { homematic="IEQ0203214:1#STATE" }
Text item=lrWindowRight

transform/contact.map:

0=CLOSED
1=TILTED
2=OPEN
-=UNKNOWN

How to read Homematic heater valve state

Dimmer lrHeaterRight "Heater Right [%d %%]" <heating> (gRLvng)  { homematic="IEQ0537568:1#VALVE_STATE" }
Text item=lrHeaterRight

How to use Homematic temperature regulator

Number lrTempSet "Target Temperature [%d °C]" <temperature> (gRLvng, gRBed) { homematic="IEQ0053616:2#SETPOINT" }
Setpoint item=lrTempSet step=0.5 minValue=15 maxValue=30

How to get special characters like "%" in a label text

Number Humidity "Humidity [%.1f %%]"

How to configure Homematic light switch

Switch brLightCeil "Ceiling" (gRBed, gLight) { homematic="IEQ0001542:1#STATE" }
Switch item=brLightCeil

How to configure Homematic temperature and humidity sensor

Number lrTemp "Current Temp [%.1f °C]" <temperature> (gRLvng, gWthrDta) { homematic="IEQ0053616:1#TEMPERATURE" }
Number lrHumid "Humidity [%d %%]" <waterdrop> (gRLvng, gWthrDta) { homematic="IEQ0053616:1#HUMIDITY" }

Text item=lrTemp
Text item=lrHumid

How to configure Homematic motion and brightness sensors

/* OLD Configuration */
Switch corMotion "Motion Detected" (gRCor) { homematic="GEQ0128171:1#MOTION" }
Number corBright "Brightness [%.1f %%]" (gRCor) { homematic="GEQ0128171:1#BRIGHTNESS" }

/* New Configuration */
Switch corMotion "Motion Detected" (gRCor) {homematic="address=GEQ0128171, channel=1, parameter=MOTION" }
Number corBright "Brightness [%.1f %%]" (gRCor) {homematic="address=GEQ0128171, channel=1, parameter=BRIGHTNESS" }

Switch item=corMotion
Text item=corBright

I don't like that the motion switch is "writeable". Maybe someone can post a proper rendering object for the motion detector.

How to configure a switch to be a pushbutton:

German Thread

Item:

Switch Garage_Gate { binding="xxx", autoupdate="false"}

Sitemap:

Switch item=Garage_Gate label="Garage" mappings=[ON="Go!"]

The magic happens with autoupdate="false" which keeps the state even an ON command has been received. This way, it's always off unless you explicitly post an update to this item.

How to control a homematic roller shutter with an EnOcean Rocker

Item:

Rollershutter Blinds_Left <rollershutter> (Shutters) {homematic="id=JEQXXXXXX, channel=1, parameter=LEVEL", enocean="{id=00:00:00:00, eep=F6:02:01}"}

How to control a homematic dimmer with an EnOcean Rocker (OnOff Profile)

Item:

Dimmer Lights_Left <lights> (Lights) {homematic="id=GEQXXXXXX, channel=2, parameter=LEVEL", enocean="{id=00:00:00:00, channel=A, eep=F6:02:01}"}}

How to set up voice control for use with HABDroid

The following example shows an item called test_item being turned on by issuing the voice command in HABDroid

Item:

String VoiceCommand

Rule:

rule "test example rule name"
when
                Item VoiceCommand received command test
        then
                test_item.sendCommand(ON)
end