This page is part of archived documentation for openHAB 3.1. Go to the current stable version
# Jablotron Alarm Binding
This is the binding for Jablotron alarms. https://www.jablotron.com/en/jablotron-products/alarms/ (opens new window)
# Supported Things
thing | note |
---|---|
bridge | the bridge to your Jablonet cloud account |
JA-80 | the OASIS alarm |
JA-100 | with the thermometer support |
JA-100F | without the thermometer support |
# Discovery
This binding supports auto discovery. Just manually add a bridge thing and supply login & password to your Jablonet account.
# Binding Configuration
Binding itself doesn't require specific configuration.
# Thing Configuration
thing | config parameter name | description | type |
---|---|---|---|
bridge | login | the login to your Jablonet account | mandatory |
bridge | password | the password to your Jablonet account | mandatory |
bridge | refresh | the refresh time for all alarm warnings (ALARM, TAMPER triggers and SERVICE state) | optional, default=30s |
bridge | lang | the language of the alarm texts | optional, default=en |
JA-80/JA-100/JA-100F | refresh | the channels refresh period in seconds | optional, default=60s |
JA-80/JA-100/JA-100F | serviceId | the service ID which identifies the alarm | mandatory |
JA-100/JA-100F | code | the master code for controlling sections | optional |
# Channels
thing | channel name | item type | description |
---|---|---|---|
bridge | N/A | N/A | the bridge does not expose any channels |
JA-80 | statusA | Switch | the status of the A section |
JA-80 | statusB | Switch | the status of the AB/B section |
JA-80 | statusABC | Switch | the status of the ABC section |
JA-80 | statusPGX | Switch | the status of PGX |
JA-80 | statusPGY | Switch | the status of PGY |
JA-80 | command | String | the channel for sending keyboard codes to the OASIS alarm |
JA-80/JA-100/JA-100F | lastEvent | String | the description of the last event |
JA-80/JA-100/JA-100F | lastEventClass | String | the class of the last event - e.g. arm, disarm, ... |
JA-80/JA-100/JA-100F | lastEventInvoker | String | the invoker of the last event |
JA-80/JA-100/JA-100F | lastEventTime | DateTime | the time of the last event |
JA-80/JA-100/JA-100F | lastCheckTime | DateTime | the time of the last checking |
JA-80/JA-100/JA-100F | alarm | N/A | the alarm trigger, might fire ALARM or TAMPER events |
JA-100/JA-100F | lastEventSection | String | the section of the last event |
JA-100 | state_%nr% | String | the section %nr% status/control |
JA-100 | pgm_%nr% | Switch | the PG switch %nr% status/control |
JA-100 | thermometer_%nr% | Number:Temperature | the thermometer %nr% value |
JA-100 | thermostat_%nr% | Number:Temperature | the thermostat %nr% value |
JA-100F | sec-%nr% | String | the section %nr% status/control |
JA-100F | pg-%nr% | Switch | the PG switch %nr% status/control |
The state, pgm, thermometer, thermostat, sec and pg channels for the JA-100/JA-100F alarms are dynamically created according to your configuration.
- The sections are represented by String channels (with possible values "set", "unset", "partialSet" for JA-100 and possible values "ARM", "PARTIAL_ARM" and "DISARM" for JA100-F)
# Full Example
# items file for JA80
String HouseAlarm "Alarm [%s]" <alarm>
String JablotronCode { channel="jablotron:oasis:8c93a5ed:50139:command", autoupdate="false" }
Switch ArmSectionA "Garage arming" <jablotron> (Alarm) { channel="jablotron:oasis:8c93a5ed:50139:statusA" }
Switch ArmSectionAB "1st floor arming" <jablotron> (Alarm) { channel="jablotron:oasis:8c93a5ed:50139:statusB" }
Switch ArmSectionABC "2nd floor arming" <jablotron> (Alarm) { channel="jablotron:oasis:8c93a5ed:50139:statusABC" }
String LastEvent "Last event code [%s]" <jablotron> { channel="jablotron:oasis:8c93a5ed:50139:lastEvent" }
String LastEventClass "Last event class [%s]" <jablotron> { channel="jablotron:oasis:8c93a5ed:50139:lastEventClass" }
String LastEventInvoker "Last event class [%s]" <jablotron> { channel="jablotron:oasis:8c93a5ed:50139:lastEventInvoker" }
DateTime LastEventTime "Last event [%1$td.%1$tm.%1$tY %1$tR]" <clock> { channel="jablotron:oasis:8c93a5ed:50139:lastEventTime" }
DateTime LastCheckTime "Last check [%1$td.%1$tm.%1$tY %1$tR]" <clock> { channel="jablotron:oasis:8c93a5ed:50139:lastCheckTime" }
Switch ArmControlPGX "PGX" <jablotron> (Alarm) { channel="jablotron:oasis:8c93a5ed:50139:statusPGX" }
Switch ArmControlPGY "PGY" <jablotron> (Alarm) { channel="jablotron:oasis:8c93a5ed:50139:statusPGY" }
# sitemap example for JA80
Text item=HouseAlarm icon="alarm" {
Switch item=ArmSectionA
Switch item=ArmSectionAB
Switch item=ArmSectionABC
Text item=LastEvent
Text item=LastEventInvoker
Text item=LastEventClass
Text item=LastEventTime
Text item=LastCheckTime
Switch item=ArmControlPGX
Switch item=ArmControlPGY
Switch item=JablotronCode label="Arm" mappings=[1234=" A ", 2345=" B ", 3456="ABC"]
Switch item=JablotronCode label="Disarm" mappings=[9876="Disarm"]
}
# rule example for JA80
rule "Alarm"
when
Item ArmSectionA changed or Item ArmSectionAB changed or Item ArmSectionABC changed or
System started
then
if( ArmSectionA.state == ON || ArmSectionAB.state == ON || ArmSectionABC.state == ON)
{ postUpdate(HouseAlarm, "partial") }
if( ArmSectionA.state == OFF && ArmSectionAB.state == OFF && ArmSectionABC.state == OFF)
{ postUpdate(HouseAlarm, "disarmed") }
if( ArmSectionA.state == ON && ArmSectionAB.state == ON && ArmSectionABC.state == ON)
{ postUpdate(HouseAlarm, "armed") }
end
rule "Jablotron alarm trigger"
when
Channel "jablotron:oasis:8c93a5ed:50139:alarm" triggered
then
logInfo("default.rules", "Jablotron triggered " + receivedEvent.getEvent())
end
Caught a mistake or want to contribute to the documentation? Edit this page on GitHub (opens new window)