Alarm und FTUI

Ziel und Voraussetzungen

Auf dieser Seite wird erläutert, wie man das Modul Alarm mit Hilfe eines Keypads aus dem FTUI heraus steuert.

Ziel ist, das TabletUI mit einem Keypad zu schützen während der Alarm aktiv ist und darüber hinaus über Eingabe des korrekten Pins die Alarmanlage zu entschärfen.

• Das Modul Alarm muss installiert sein, das Alarmdevice wird im Folgenden AAA genannt (ansonsten muss der entsprechende Name in den nachfolgenden Beispielen geändert werden)
• Es muss eine laufende TabletUI-Instanz vorhanden sein

Anlegen eines Dummy

Im ersten Schritt muss ein Dummy angelegt werden, welcher den Status der Alarmanlage ebenso wie Daten aus dem Keypad erhält:

defmod AAA.key dummy
attr AAA.key alarmDevice Sensor
attr AAA.key alarmSettings alarm<alarmlevel>,|AAA.key:.unlocked|unlocked|off   # wird durch das Modul Alarm angelegt
attr AAA.key event-on-change-reading state,inputPin
attr AAA.key event-on-update-reading key
attr AAA.key readingList key inputPin fails unlockPin
attr AAA.key room Alarm
attr AAA.key setList unlockPin
attr AAA.key userReadings inputPin:key:.[0-9] { return ReadingsVal($NAME, "inputPin", "*") . ReadingsVal($NAME, "key", "0");; }, fails:key:.# { if (ReadingsVal($NAME, "inputPin", "0") ne ReadingsVal($NAME, "unlockPin", "0")) { return ReadingsVal($NAME, "fails", 0)+1;; } else { return 0;; } }, state:key:.# { if (ReadingsVal($NAME, "inputPin", "0") ne ReadingsVal($NAME, "unlockPin", "0")) { return "locked";; } else { return "unlocked";; } }, inputPin:key:.[\<] { my $inputVal = ReadingsVal($NAME, "inputPin", "0");; chop($inputVal);; return $inputVal;; },  inputPin:key:.# { return "";; }

Darin muss natürlich <alarmlevel> durch den gewünschten Level ersetzt werden (die Änderung dieses Attributes erfolgt automatisch durch das Alarm-Modul, bitte nicht manuell eingeben).

In diesem Dummy kann über den Befehl

set unlockPin <Wert>

der gültige Pincode gesetzt werden

Die userReadings füllen (je nach Änderung des Readings key) die folgenden Readings:

• fails (Anzahl ungültiger Versuche)
• inputPin (Eingabe Pin, als Aneinanderreihung der einzelnen Keys)
• state (locked/unlocked)

Anlegen eines Notify

Wenn der richtige Code eingegeben wurde, soll die Alarmanlage unscharf geschaltet werden:

defmod AAA.disarmed.N notify AAA.key:unlocked set AAA disarmed <alarmlevel>
attr AAA.disarmed.N room Alarm

Einbinden des Keypads in das FTUI

Dazu muss in die anzuzeigende Seite der folgende Code eingetragen werden:

<!-- Alarmanlage Keypad -->
<div data-type="popup" data-device="AAA.key" data-get-on="locked" data-get-off="unlocked" data-width="400px" data-height="500px" class="interlock">
   <div class="red bold top-space-2x"/>
   <div class="dialog">
       <header>Alarm deaktivieren</header>
       <div data-type="label" class="cell big top-space-2x wider">PIN-Code</div>
       <div class="inline big top-space">
           <div data-type="push" data-icon="" data-device="AAA.key" data-set="key" data-set-on="1" onclick="">1</div>
           <div data-type="push" data-icon="" data-device="AAA.key" data-set="key" data-set-on="4" onclick="">4</div>
           <div data-type="push" data-icon="" data-device="AAA.key" data-set="key" data-set-on="7" onclick="">7</div>
           <div data-type="push" data-icon="fa-long-arrow-left" data-device="AAA.key" data-set="key" data-set-on="&lt;" onclick=""/>
       </div>
       <div class="inline big">
           <div data-type="push" data-icon="" data-device="AAA.key" data-set="key" data-set-on="2" onclick="">2</div>
           <div data-type="push" data-icon="" data-device="AAA.key" data-set="key" data-set-on="5" onclick="">5</div>
           <div data-type="push" data-icon="" data-device="AAA.key" data-set="key" data-set-on="8" onclick="">8</div>
           <div data-type="push" data-icon="" data-device="AAA.key" data-set="key" data-set-on="0" onclick="">0</div>
       </div>
       <div class="inline big">
           <div data-type="push" data-icon="" data-device="AAA.key" data-set="key" data-set-on="3" onclick="">3</div>
           <div data-type="push" data-icon="" data-device="AAA.key" data-set="key" data-set-on="6" onclick="">6</div>
           <div data-type="push" data-icon="" data-device="AAA.key" data-set="key" data-set-on="9" onclick="">9</div>
           <div data-type="push" data-off-color="green" data-icon="fa-unlock" data-device="AAA.key" data-set="key" data-set-on="#" onclick=""/>
       </div>
       <div class="bg-lightgray border-white top-space centered" style="width:280px; height:50px;">
           <div data-type="label" data-device="AAA.key" data-get="inputPin" class="tall"/>
       </div>
   </div>
</div>

Dieser Code sorgt dafür, dass ein Keypad auf der TabletUI Seite immer dann angezeigt wird, wenn der State von AAA.key auf locked steht. Darüber hinaus wird bei jedem Klick auf einen der Buttons das key-Reading des Devices AAA.key gesetzt.

Optional: Aktivieren der Alarmanlage durch das Tablet-UI

Eine Aktivierung der Alarmanlage kann dadurch erfolgen, dass ein entsprechender Switch in die FTUI-Seite eingebaut wird:

<!-- Alarm -->
<li data-row="2" data-col="8" data-sizey="1" data-sizex="1">
   <header>Alarmanlage</header>
   <div data-type="switch"
       data-states='["armed","armwait","disarmed"]'
       data-icons='["fa-lock","fa-unlock","fa-unlock"]'
       data-background-colors='["red","red","green"]'
       data-device="AAA"
       data-get="level0"
       data-get-on='["armed","armwait"]'
       data-get-off="disarmed"
       data-set-on="armed 0"
       data-on-background-color="red"
       data-off-background-color="green"
       style="padding-top:20px">
   </div>
</li>