Schnittstellen Informationen - Liesmich
Inhalt
1.
KO-Gateway Schnittstelle
2.
Logikbaustein SDK
3.
Einige nützliche Links
4.
QuadClient SDK
5.
URL-Endpoints

## 1.KO-Gateway Schnittstelle

Über die KO-Gateway-Schnittstelle können Kommunikations-Objekte mit Gruppen-Adressen überwacht und gesetzt werden. Der im Experte ab v4.7 enthaltene HS-Monitor bietet diese Funktionalität.

## 2. Logikbaustein SDK

Seit der Firmware 2.1 besitzt der HS/FS die Möglichkeit, durch eigene Logikmodule die Logik-Funktionalität des HS/FS zu erweitern.
Dabei wird unterschieden zwischen HSL 1, HSL 2 und HSL 3.

### 2.1.HSL 1

Die Logikbausteine seit Firmware 2.1. Eine ausführliche Dokumentation zur Funktionsweise und Erstellung finden Sie unter `\HSL\HSL1`.

### 2.2.HSL 2 (abgekündigt)

Ab Firmware 4.5 bis einschließlich Firmware 4.13 können Logikbausteine auf Basis der Programmiersprache Python 2 erstellt werden. Zur Entwicklung werden einige Tools zur Verfügung gestellt. Außerdem gibt es neben einer ausführlichen Dokumentation zur Erstellung und zur Funktionsweise dieser Bausteine, ein Step-by-Step "How-To" zur Einrichtung einer eigenen Entwicklungsumgebung, die vollständige Dokumentation des Frameworks und die Quell-Codes einiger Beispiel-Bausteine (siehe `\HSL\HSL2`).

### 2.3.HSL 3

Ab Firmware 4.13 können Logikbausteine auf Basis der Programmiersprache Python 3 und dem HSL 3 Framework erstellt werden. Zu beachten ist, dass sich das Framework und die Version der Programmiersprache Python 3 sich in zukünftigen Versionen der Firmware ändern können. Außerdem gibt es neben einer ausführlichen Dokumentation zur Erstellung und zur Funktionsweise dieser Bausteine, ein Step-by-Step "How-To" zur Einrichtung einer eigenen Entwicklungsumgebung, die vollständige Dokumentation des Frameworks und die Quell-Codes einiger Beispiel-Bausteine (siehe `\HSL\HSL3`).

### 2.4.Logikbausteine an Seriennummer binden

Logikbausteine können an einen bestimmten HomeServer/FacilityServer (Seriennummer) gebunden werden, wodurch diese Bausteine nur noch auf dem Gerät mit dieser Seriennummer arbeiten.
Dazu stehen zwei Applikationen aus dem HS/FS Experte-Setup zur Verfügung.
Die Dokumentation dazu finden Sie unter `\HSL\AES_coding\`.

## 3.Einige nützliche Links

- KNX User Forum (https://knx-user-forum.de)
- KNX EIB Forum (https://knx-user-forum.de/forum/%C3%B6ffentlicher-bereich/knx-eib-forum)
- Entwicklerforum (https://www.entwicklerforum.gira.de/)

## 4.QuadClient SDK

### 4.1.Funktionsvorlagen

Funktionsvorlagen sind visuelle Anzeigeelemente für den QuadClient oder die HS/FS Apps. In einer Funktionsvorlage wird das Aussehen (Darstellung) und Verhalten einer Funktion definiert. Neben den bereits im Setup enthaltenen Funktionsvorlagen besteht auch die Möglichkeit individuelle Funktionsvorlagen zu erstellen.
Weitere Informationen finden Sie hier:

- Entwicklerforum (https://www.entwicklerforum.gira.de/)
- Die Beschreibung zur Erstellung von Funktionsvorlagen finden Sie unter `\Template SDK\`.

### 4.2.PlugIns

PlugIns sind selbstständig arbeitende Programme, die im QuadClient eingebettet werden können. Neben den bereits im Setup enthaltenen PlugIns besteht auch die Möglichkeit individuelle PlugIns zu erstellen.
Weitere Informationen finden Sie hier:

- Entwicklerforum (https://www.entwicklerforum.gira.de/)
- Die Beschreibung zur Erstellung von PlugIns finden Sie unter `\Plugin SDK\`.

## 5.URL-Endpoints

HomeServer-Objekte (wie z.B. Kommunikations-Objekte, Szenen, Sequenzen, u.a., siehe Dokumentation) können über eine URL per HTTPS-Aufruf abgerufen bzw. verändert werden.
Als Alternative zum Zugriff über HTTPS stehen die HS-Objekte ebenfalls über eine Verbindung per WebSocket (WS) zur Verfügung.

- URL-Endpoints Dokumentation und Hinweise zur Fehleranalyse bei der Entwicklung: siehe `\URL Endpoint\documentation\`.
- JavaScript API: siehe `\URL Endpoint\JS API\`.