4-2022

AppShop https://appshop.gira.com/de/
session oder im speziellen Bereich für
Gira-Logikbausteine im KNX User
Forum https://service.knx-user-forum.
de/?comm=downloadliste&key=1.
Bild 5: Schaltfläche „Formularsteuerelement“ einfügen
Die Schaltfläche kann an jedem beliebigen
Ort in der Excel-Tabelle platziert
und dem Makro GPA_Export zugewiesen
werden. Mit einem Klick auf die
Schaltfläche lässt sich der Dateispeicherort
auswählen und die GPA Projektimportdatei
exportieren.
GPA-Projektimportdatei im
GPA importieren
Die fertige GPA-Projektimportdatei
lässt sich nun in den GPA importieren.
Dafür muss dort im Hauptmenü
„Projekt importieren…“ angeklickt
und anschließend die Datei
ausgewählt werden, die im vorigen
Schritt exportiert wurde. Der Import
listet in einem Dialog „GPA Projektvorlage
Importergebnis“ nun einige
Warnungen auf, die an dieser Stelle
ignoriert werden können – sie rühren
daher, dass die Funktionen im vorliegenden
Beispiel nicht mit Datenpunkten
verknüpft wurden und sie
somit unvollständig sind. Die Erzeugung
der Datenpunkte und Verknüpfung
der Gruppenadressen würde
den Umfang dieses Artikels sprengen,
deshalb wurde hier bewusst
darauf verzichtet.
Wird der Hinweisdialog geschlossen,
ist in der Projektliste das neue
Projekt als „Mein erstes Projekt“ zu
sehen. Beim Öffnen des Projekts
erscheinen in der Ansicht „Gebäude
und Geräte“ die bereits festgelegten
Räume mit der angegebenen Anzahl
von dimmbaren Lichtern und schaltbaren
Steckdosen. Um das Projekt
abzuschließen, müssen nun noch
die nötigen Datenpunkte angelegt
und mit Gruppenadressen verknüpft
werden. Natürlich lässt sich das
Excel-Makro auch so erweitern,
dass es dem Inbetriebnehmer diese
Aufgaben abnimmt. Dann verfügt
er über ein Projekt, das ohne weitere
Arbeiten im GPA in Betrieb
genommen werden kann.
Weiterer Nutzen
Anhand dieses Minimalbeispiels sollte
sich eine Basis schaffen lassen, mit
der eigene Makros oder Tools erstellt
werden können – um auf der Grundlage
der in der Planung erzeugten
Dokumente ein GPA-Projekt zu generieren,
das dem Inbetriebnehmer im
Alltag so viel Projektierungsarbeit wie
möglich abnimmt.
Weiterhin können dadurch repetitive
Abläufe automatisiert werden, die
den Durchsatz des Projektgeschäftes
erhöhen oder Kapazitäten für
andere Arbeiten freisetzen. Für weitergehende
Informationen bietet Gira
die offizielle Dokumentation der GPA
Projektschnittstelle und ein ausführlicheres
Beispiel eines Excel-Makros
mit deutlich mehr Funktionalität an, das
sich als Grundlage oder Inspiration für
eigene Lösungen nutzen lässt. Weitere
Informationen finden sich unter:
https://partner.gira.de/service/software-tools/developer.html.
Anbindung über Gira IoT
REST API per HTTP
REST APIs (Application Programming
Interface) sind Programmierschnittstellen,
die auf Basis des geläufigsten
aller Protokolle realisiert wurden:
HTTP. Gemeint ist eine Vielzahl
von Befehlen, Funktionen und Protokollen,
die dazu dienen, mit externen
Systemen zu interagieren.
Der Gira X1 und der Gira HomeServer
haben beide eine Integrationsmöglichkeit
über die Gira IoT REST API,
eine leicht zu realisierende Schnittstelle
nach dem bekannten Prinzip der
REST API. Ihr großer Vorteil: Sie kann
von vielen Systemen und Tools angesprochen
werden, etwa von
• Kommandozeilentools wie „curl“
• Skriptsprachen wie Python, PowerShell
oder Excel-Makros
• Allrounder-Smart-Home-Zentralen
wie NodeRED, Home Assistant etc.
Automation und Integration
ohne Grenzen: die
Logikbausteine
Als weitere Schnittstelle bietet Gira die
sogenannten Logikbausteine – sie zu
„bauen“ ist sowohl für den Gira X1 als
auch für den Gira HomeServer bzw.
FacilityServer möglich. Mit ihnen lassen
sich nicht nur selbst die raffiniertesten
Automatikfunktionen realisieren,
sondern eben auch andere Systeme in
KNX einbinden. Wer nicht die Zeit hat,
einen Logikbaustein selbst zu entwickeln,
findet möglicherweise einen fertigen
und passenden Baustein im Gira
Bild 6: Plug-in SDK
Gira HomeServer:
Funktionsvorlage oder
Plug-in
Der Gira HomeServer als das Flaggschiff
der Gira Smart Home Steuerzentralen
bietet die Möglichkeit, die
Bedienoberfläche für den Nutzer
zu erweitern. Hierfür gibt es Funktionsvorlagen,
die eine relativ einfache
und schnelle Möglichkeit bieten,
eigene Anordnungen von Bedienelementen
im Gira QuadClient zu
realisieren. Wem die Optionen dieser
Funktionsvorlagen nicht ausreichen,
kann eigene Bedienmöglichkeiten auf
Basis des leistungsstarken, aber auch
anspruchsvollerem Plug-in SDK entwickeln.
Für ersteres reichen Erfahrung
mit Skriptsprachen aus, bei letzterem
ist Programmiererfahrung in C#
die Voraussetzung. Ein Gesamtüberblick
und ausführliche Dokumentationen
sowie Beispiele finden sich auf
developer.gira.de.
Link: https://partner.gira.de/service/software-tools/developer.html,
s. Bild 6. ◄
14 Haus und Elektronik 4/2022