# Glutz

Glutz ist ein Hersteller von Tür- und Sicherheitssystemen mit Hauptsitz in der Schweiz. Es zeichnet sich durch innovative Technologien aus. Das Produktsortiment umfasst eine breite Palette von Türbeschlägen, elektronischen Zutrittssystemen, Schließsystemen und Sicherheitslösungen für private und gewerbliche Anwendungen.

## Installation

Die Installation der Glutz App erfolgt über den App Store in Eliona.

## Assets

Die Glutz App erstellt automatisch alle notwendigen Asset Templates und Glutz Zugangspunkte ([CAC](https://docs.buildings.ability.abb/collection/german-14.2-freezed/apps/apps/broken-reference)), die über die konfigurierten Endpunkte zugänglich sind. Folgende Asset Templates werden angelegt:

* **Glutz Device**: Ein Zugangspunkt (Türschloss) dessen Parameter ausgelesen werden können und der geöffnet werden kann

Folgende Attribute sind definiert:

<table><thead><tr><th width="240">Name</th><th>Beschreibung</th></tr></thead><tbody><tr><td><code>battery_level</code></td><td>Batteriestand</td></tr><tr><td><code>openings</code></td><td>Öffnungen</td></tr><tr><td><code>building</code></td><td>Gebäude</td></tr><tr><td><code>room</code></td><td>Zimmer</td></tr><tr><td><code>access_point</code></td><td>Zugang</td></tr><tr><td><code>operating_mode</code></td><td>Operationsmodus</td></tr><tr><td><code>firmware</code></td><td>Firmware</td></tr><tr><td><code>open</code> (schreibend)</td><td>Öffnen von Eliona<br><code>1</code> = Zugangspunkt öffnen, Zeit einstellbar in Konfiguration</td></tr><tr><td><code>openable</code></td><td>Zustand des Zugangspunktes<br><code>0</code> = Geschlossen<br><code>1</code> = Offen<br><code>2</code> = Fehler</td></tr></tbody></table>

## Dashboards

Die Glutz App bietet ein Dashboard mit allen automatisch erstellten Zugangspunkten an. Dieses kann über das Eliona Frontend `Copy Dashboard > Glutz` automatisch erstellt und anschließend beliebig angepasst werden.

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/5vxODMEE4ksWrfPdtb1A/FD96DAD2-B2A8-47BC-8FF7-12044E982675.png" alt=""><figcaption></figcaption></figure>

## Konfiguration

{% hint style="info" %}
Mehr Informationen zur Konfiguration von Apps finden Sie [↗ hier](https://doc.eliona.io/collection/dokumentation/einstellungen/apps).
{% endhint %}

### Allgemein

Die Glutz App wird konfiguriert, indem man einen oder mehrere Glutz Server Endpunkte definiert. Jeder Endpunkt erfordert folgende Daten:

<table><thead><tr><th width="279">Attribut</th><th>Beschreibung</th></tr></thead><tbody><tr><td><code>username</code></td><td>Benutzername für die Anmeldung</td></tr><tr><td><code>password</code></td><td>Passwort für die Anmeldung</td></tr><tr><td><code>url</code></td><td>URL für den Glutz-Endpunkt</td></tr><tr><td><code>enable</code></td><td>Flag zum Aktivieren oder Deaktivieren des Endpunkts</td></tr><tr><td><code>requestTimeout</code></td><td>Timeout in Sekunden für den Server</td></tr><tr><td><code>refreshInterval</code></td><td>Intervall in Sekunden zum Sammeln von Daten vom Endpunkt</td></tr><tr><td><code>defaultOpenableDuration</code></td><td>Intervall in Sekunden, wie lang ein Zugangspunkt geöffnet werden kann. Diese Option kann pro Zugangspunktes mit der Glutz Eigenschaft <code>Eliona/Openable Duration [s]</code> überschrieben werden.</td></tr><tr><td><code>projIds</code></td><td>Liste mit Projekt-IDs, für die automatisch Zugangspunkt-Assets angelegt werden (<a href="broken-reference">CAC</a>)</td></tr></tbody></table>

Die Konfiguration erfolgt über eine entsprechende JSON-Struktur. Beispielhaft kann folgende JSON-Struktur verwendet werden, um einen Endpunkt zu definieren.

```json
{
  "username": "Benutzername",
  "password": "Passwort",
  "url": "https://example.com/glutz",
  "enable": true,
  "requestTimeout": 120,
  "refreshInterval": 60,
  "defaultOpenableDuration": 10,
  "projIds": ["1"]
}
```

Endpunkte können mittels dieser Struktur in Eliona unter `Apps > Glutz > Setting` angelegt werden. Dazu ist der Endpunkt `/configs` mit der Methode `PUT` auszuwählen.

### Zeit zum Öffnen

Über das Asset-Attribut `open` kann in Eliona ein Zugangspunkt geöffnet werden. Dazu wird das Türschloss für eine bestimmte Zeit in den Zustand versetzt, den Zugangspunkt öffnen zu können. Diese Standardzeit kann allgemein in der Endpunkt-Konfiguration `defaultOpenableDuration` festgelegt werden.

Für Zugangspunkte kann diese Zeit überschrieben werden. Dazu ist die Eigenschaft `Eliona/Openable Duration [s]` für Zugangspunkte in der Glutz-Konfiguration anzulegen.&#x20;

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/lxqEGxAloOHfxdgtbKtj/image.png" alt=""><figcaption></figcaption></figure>

Ist für einen Zugangspunkt diese Eigenschaft gesetzt, überschreibt sie die Standardzeit.

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/EXdqYzp7Mu8GWxj6A6ww/image.png" alt=""><figcaption></figcaption></figure>