Hinweise zum Client-Programm
Inhalt

1.Einführung

1.1.Allgemeine Hinweise zur Bedienungsanleitung / Produktunterstützung

Die in diesen Unterlagen enthaltenen Angaben, Daten, Werte usw. können ohne vorherige Ankündigung geändert werden. Ebenso sind die Abbildungen unverbindlich. Technische Änderungen vorbehalten!
Hinweis
Aktuelle Informationen auf der Gira Internetseite.

Da die Software für das von Ihnen erworbene Gerät ständig weiter entwickelt und aktualisiert wird, können Angaben in diesem Handbuch gegebenenfalls nicht mehr dem aktuellen Stand entsprechen.

Die jeweils neuesten Produktinformationen erhalten Sie über die Gira Internetseite:

http://www.gira.de
Aktuelle Software-Updates und Dokumentationen zu Ihrem Produkt stehen Ihnen unter

http://www.download.gira.de

zur Verfügung.

1.2.Programmbeschreibung

Während des Betriebs kann der Benutzer über verschiedene Arten auf den HS/FS zugreifen.

Eine Möglichkeit des Zugriffs bietet die Nutzung eines herkömmlichen Internet-Browsers, der sich normalerweise auf jedem PC befindet. Im Browser wird die Benutzeroberfläche des HS/FS dargestellt, so dass Parameter überprüft und geändert werden können.

Eine weitere Möglichkeit des Zugriffs bietet das im Lieferumfang enthaltene Client-Programm. Es besitzt einen Funktionsumfang, der speziell auf die Anforderungen von Home- und FacilityServer abgestimmt wurde.

Das Programm kann beim ersten Zugriff auf den HomeServer/FacilityServer alle Grafikdateien lokal speichern. Bei weiteren und zukünftigen Zugriffen nutzt es die lokal gespeicherten Grafiken. Die notwendige Bandbreite für den Zugriff im Netzwerk oder über das Internet ist sehr gering. Es werden nur die Zustände oder Zustandsänderungen übertragen.

Die Kommunikation mit dem Client-Programm über eine gesicherte Verbindung (HTTPS) wird unterstützt. Es wird eine Passwort-Authentifizierung durchgeführt. Das Programm erlaubt den Zugriff über das Internet. Der HomeServer/FacilityServer kann dann permanent mit dem Internet verbunden sein. Eine PIN-Abfrage kann entfallen. Das Client-Programm speichert Einstellungen (Zugriffsprofile) von bis zu 200 Home- bzw. FacilityServern. Für einen Zugriff ist dann der gewünschte HomeServer/FacilityServer aus einer Liste auszuwählen.

Um das Client-Programm zu nutzen, muss es lokal auf dem PC installiert sein, von dem der Benutzer-Zugriff auf den HomeServer/FacilityServer erfolgen soll. Sie können das Client-Programm auch auf Ihrem Inbetriebnahme-PC installieren, um Funktionstests im Rahmen der Programmierung durchzuführen.

1.3.Systemvoraussetzungen

Das Client-Programm kann auf einem handelsüblichen PC (oder Laptop) mit einem Betriebssystem ab Windows® 7 betrieben werden.

1.4.Anwendungsbereich

Das Client-Programm ist eine Software-Oberfläche, die speziell zur Bedienung des Home- bzw. FacilityServers entwickelt wurde. Eine anderweitige Nutzung des Programms, z. B. als Internet-Browser, ist nicht möglich und auch nicht zulässig.

Für Probleme, die aus einer bestimmungswidrigen Nutzung des Client-Programms entstehen, übernimmt Gira weder eine juristische Verantwortung noch irgendeine Gewähr.

2.Client-Programm

2.1.Client-Programm installieren

Das Client-Programm steht im Internet unter www.download.gira.de zur Verfügung. Sie laden es mit dem Gesamt-Softwarepaket für den Home- bzw. FacilityServer herunter.

Bei dem Sofwarepaket handelt es sich um eine zip-Datei, die Sie nach dem Download auf Ihren Rechner entpacken (extrahieren) müssen. Das HS/FS Client-Programm wird im Rahmen der Installation der HomeServer Experten-Software mitinstalliert.

So installieren Sie das Client-Programm:
  1. Laden Sie sich das Softwarepaket zum Home- oder FacilityServer aus dem Downloadbereich von der Gira Internetseite herunter.
  2. Entpacken (extrahieren) Sie die heruntergeladene zip-Datei.
  3. Starten Sie das Setup-Programm und folgen Sie den Anweisungen. Das Client-Programm wird zusammen mit der Experten-Software auf Ihrem Rechner installiert.
  4. Über Start/Alle Programme/GIRA-SOFTWARE/HS+FS/HS+FS Experte [Versions-Nr]/HS Client können Sie das Client-Programm aufrufen.

2.2.Mit dem Client-Programm auf das Musterprojekt zugreifen

Um die Funktionsfähigkeit des Client-Programms zu überprüfen, können Sie ohne größere Vorbereitungen auf die Benutzeroberfläche des Musterprojektes zugreifen, welches im HomeServer/FacilityServer voreingestellt ist.

Voraussetzung ist aber, dass Sie den HomeServer/FacilityServer gemäß den Angaben in der Broschüre Hinweise zur Inbetriebnahme angeschlossen, sowie das Client-Programm auf Ihrem Rechner installiert haben.
So greifen Sie mit dem Client-Programm auf die Benutzeroberfläche des Musterprojektes zu (gilt für HomeServer und FacilityServer gleichermaßen):
  1. Starten Sie auf Ihrem Rechner (z. B. Inbetriebnahme PC) die Datei hsclient.exe. Es erscheint eine Login-Maske.

    Screenshot Login-Maske, Button
    Bild 2.1: Login-Maske des Client-Programms

     
  2. Wählen Sie Server. Das Fenster HS/FS-Liste öffnet sich.

    Screenshot der Maske HomeServer-Liste
    Bild 2.2: Auswahl im Fenster HS/FS-Liste

     
  3. Markieren Sie die Zeile Muster/Sample [HSMUSTER] und klicken Sie auf den Button Neu/New.
  4. Es erscheint die Maske HS/FS. Hier können Sie verschiedene Einstellungen vornehmen, damit das Client-Programm auf Ihren HS/FS zugreifen kann.

    Screenshot: Einstellungs-Maske
    Bild 2.3: Einstellungen im Fenster HS/FS

     
  5. Nehmen Sie alle Einstellungen gemäß Bild 2.3 vor. Beachten Sie dabei, dass in der Zeile HS/FS die IP-Adresse des HomeServers anzugeben ist.
    Haben Sie die IP-Adresse im Musterprojekt geändert, müssen Sie hier die geänderte Adresse eintragen.
  6. Bestätigen Sie Ihre Eingaben mit OK. Die Daten werden gespeichert und es öffnet sich wieder das Fenster HS/FS-Liste (Bild 2.2).
  7. Klicken Sie auf Beenden. Sie gelangen zurück zur Login-Maske.

    Screenshot: Login-Maske, Button
    Bild 2.4: Angaben in der Login-Maske

     
  8. Nehmen Sie die Einstellungen wie in Bild 2.4 vor. Der Standard-Benutzer im Musterprojekt heißt admin. Sie können aber auch selbst definierte Benutzer verwenden, die Sie vor der Übertragung des Musterprojekts auf dem HS/FS angelegt haben.
  9. Klicken Sie auf Login. Das Client-Programm wird gestartet und die Benutzerobefläche des HomeServers angezeigt.

    Screenshot: Start-Bildschirm der Visu
    Bild 2.5: Visualisierung des Musterprojektes im Client-Programm

     

2.3.Hinweise zu den Einstellungen in der Login-Maske

Beim Start des Client-Programms erscheint eine Login-Maske.

Screenshot: Leere Login-Maske
Bild 2.6: Login-Maske des Client-Programms

 
Bedeutung der Felder und Bedienelemente in der Login-Maske:
Feld / BedienelementBedeutung
HS/FSListe aller angelegten Home- und FacilityServer.

Wählen Sie hier den HomeServer/FacilityServer aus, auf den Sie zugreifen wollen. In der Liste werden alle HomeServer/FacilityServer angezeigt, die über Server angelegt wurden.
Benutzername / UserBenutzername, unter dem Sie sich im HomeServer/FacilityServer anmelden.

Beachten Sie, dass Sie jedem Benutzer in der Experten-Software Zugriffsrechte unter Client einrichten müssen.
Passwort / PasswordPasswort, welches in der Experten-Software für den jeweiligen User hinterlegt wurde.
Angaben speichern / Save settingsSpeichert die Einstellungen, die in der Login-Maske vorgenommen wurden.

Die gespeicherten Einstellungen werden beim nächsten Start des Client- Programms vorgeschlagen.
LoginStartet den Login-Vorgang. Dabei werden Benutzername und Passwort für das ausgewählte Profil gespeichert.
Abbruch / CancelAbbruch bzw. Verlassen des Client-Programms.
ServerÖffnet ein Fenster, in dem Sie die Einstellungen für alle HomeServer/ FacilityServer vornehmen können, auf die Sie zugreifen möchten.

2.4.Hinweise zu den Einstellungen in der HS/FS-Liste

In der Login-Maske des Client-Programms öffnen Sie durch einen Mausklick auf Server das Fenster HS/FS-Liste (gilt für Home- und FacilityServer gleichermaßen).

Screenshot der Maske HomeServer-Liste
Bild 2.7: Fenster HS/FS-Liste

 
Bedeutung der Felder und Bedienelemente im Fenster HS/FS-Liste:
Feld / BedienelementBedeutung
Neu / NewÖffnet das Fenster HS/FS, um ein neues HomeServer-Profil anzulegen (siehe Bild 2.8).

Im Fenster HS/FS weisen Sie dem Client-Programm einen neuen HomeServer zu, auf den Sie zugreifen wollen. Alle für das Client- Programm angelegten HomeServer werden anschließend in der Liste angezeigt.
Ändern / EditÖffnet das Fenster HS/FS (siehe Bild 2.8), nachdem Sie einen HomeServer-Namen in der nebenstehenden Listenansicht ausgewählt haben.

Im Fenster HS/FS werden Ihnen dann die Daten für den ausgewählten HomeServer angezeigt. Sie können die Daten dort ändern.
Löschen / DeleteLöscht die Daten für den in der Liste markierten HomeServer.
Beenden / ExitSpeichert die Einstellungen und schließt das Fenster HS/FS-Liste.

Rückkehr zur Login-Maske.

2.5.Hinweise zu den Einstellungen für einen HS/FS

Screenshot: Einstellungs-Maske
Bild 2.8: Fenster HS/FS
Bedeutung der Felder und Bedienelemente im Fenster HS/FS:
Feld / BedienelementBedeutung
IDSchlüssel für das aktuelle HomeServer-Profil.

Dient als Parameter für den Start des Programms mit Parameterübergabe.
Bezeichnung / NameName des HomeServers.

Unter diesem Namen steht der HomeServer in der Auswahlliste der Login-Maske zur Verfügung.
HS/FSHier sind folgende Angaben möglich:
  • IP-Adresse des HomeServers (z. B. 192.168.0.150)
  • URL des HomeServers bei www.dyndns.org (z.B. hs4711.dyndns.org)
  • URL des HomeServers im Gira-Portal (z.B. hs4711.giradns.com)
DesignSchlüssel des Designs, das verwendet werden soll.

Hier tragen Sie den Schlüssel ein, der in der Inbetriebnahme-Software HomeServer Experte unter Projekt/Design für das Design des HomeServers vergeben wurde (z. B. D1024V). Beachten Sie die Groß- und Kleinschreibung.

(Siehe Hinweise zu den Design-Einstellungen)
RefreshBildwiederholungsrate.

Sie müssen hier einen Schlüssel eintragen, dessen Code Sie aus der Inbetriebnahme-Software HomeServer Experte unter Projekt/Zeiten übernehmen, z. B. R3. (Siehe Hinweise zu den Design-Einstellungen)
Hinweis
Testen Sie beim Zugriff über das Internet zunächst das Verhalten mit langen Bildwiederholraten.
Icons und Bilder lokal cachen / Local caching for icons and picturesAktiviert: Bei einem ersten Zugriff mit hier angelegten Profil werden alle Grafikdateien lokal in einem Unterverzeichnis des Client-Programms abgespeichert. Bei weiteren Zugriffen nutzt das Programm die hier abgelegten Grafikdaten. Dadurch wird die zu übertragende Datenmenge reduziert.

Haben sich Grafikdateien auf dem HomeServer verändert, wird dies vom Client-Programm wahrgenommen. Geänderte Daten werden automatisch übernommen und lokal abgespeichert. Die alten Daten werden dabei überschrieben.
Kamera und Diagramme synchron laden / Synchronous loading cameras and diagramsAktiviert: Auf der Visualisierungsseite werden Kamerabild und Diagramme synchron geladen, d.h. die Visualisierungsseite wird erst dargestellt, nachdem Diagramme und Kamerabilder geladen wurden.

Deaktiviert: Die Visualisierungsseite wird sofort dargestellt, die Darstellung von Diagrammen und Kamerabildern erfolgt aber erst, nachdem sie geladen wurden.
OKSpeichern des HomeServer-Profils. Rückkehr zum Fenster HS/FS-Liste.

Der Name des HomeServers, dessen Profil Sie hier angelegt haben, wird der Liste hinzugefügt.
Abbruch/CancelAbbruch der Profileingabe.

Alle eingegebenen Daten werden verworfen.

2.6.Hinweise zu den Design-Einstellungen

Im Fenster HS/FS des Client-Programms müssen Sie unter Design den Schlüssel des Designs eintragen. Um den Schlüssel für das Design zu erfahren, öffnen Sie das zum Home-Server gehörende Projekt in der Experten-Software (gilt für HomeServer und FacilityServer gleichermaßen). Wählen Sie Projekteinstellungen/Oberfläche/Designs (siehe Bild 2.9).

Screenshot: Teil der Experte-Projekteinstellungs-Maske, Designs

Bild 2.9: Schlüssel des Designs

Ferner müssen Sie im Fenster HS/FS des Client-Programms unter Refresh einen Schlüssel für die Bildwiederholungsrate eintragen. Um den Schlüssel zu erfahren, öffnen Sie das zum HomeServer gehörende Projekt in der Experten-Software. Wählen Sie Projekteinstellungen/Oberfläche/Refresh-Zeiten (siehe Bild 2.10).

Screenshot: Teil der Experte-Projekteinstellungs-Maske, Refresh-Zeiten

Bild 2.10: Schlüssel für die Bildwiederholungsrate

Durch einen Doppelklick in die Liste (siehe Bild 2.10) öffnen Sie das Fenster Bearbeiten/Hinzufügen (siehe Bild 2.11).

Screenshot: Teil der Experte-Maske

Bild 2.11: Aktivierung des Zugriffs mit dem Client-Programm

Aktivieren Sie die Option In Client-Prg. verwenden, damit ein Zugriff auf den HomeServer mit dem Client-Programm möglich ist.

2.7.Programmstart durch Parameterübergabe

Das Client-Programm lässt sich auch durch Parameterübergabe starten. Damit kann der Programmstart über die Login-Maske entfallen.
Hinweis: Unterschiedliches Masken-Layout.
Beachten Sie, dass das Layout der nachfolgend dargestellten Bildschirmmasken abhängig vom Windows-Betriebssystem leicht abweichen kann. Die dargestellten Masken wurden unter Windows 7 Ultimate erstellt.
Um das Client-Programm durch Parameterübergabe zu starten, legen Sie zunächst eine entsprechende Verknüpfung auf dem Desktop an. Gehen Sie dabei folgendermaßen vor:
  1. Führen Sie den Mauszeiger an eine freie Stelle auf Ihrem Windows-Bildschirm (Desktop).
  2. Öffnen Sie das Kontext-Menü (Klick mit der rechten Maustaste).
  3. Wählen Sie Neu/Verknüpfung erstellen. Das Fenster Verknüpfung erstellen (1) öffnet sich (siehe Bild 2.12). Hier müssen Sie den Dateipfad angeben.

    Screenshot: Fenster

    Bild 2.12: Erstellen einer Verknüpfung

     
  4. Klicken Sie auf Durchsuchen und wählen Sie die Datei hsclient.exe aus. Bitte entnehmen Sie der der Experte-Software beiliegenden "Liesmich"-Datei (Eine Verknüpfung dazu ist im Startmenü vorhanden) den genauen Ablageort der Datei.
  5. Klicken Sie auf Weiter. Das Fenster Verknüpfung erstellen (2) öffnet sich (siehe Bild 2.13). Hier müssen Sie einen Namen für die Verknüpfung angeben.

    Screenshot: Fenster

    Bild 2.13: Bezeichnung der Programmverknüpfung

     
  6. Geben Sie eine Bezeichnung für die Verknüpfung vor.
    Sie sollten hier einen "sprechenden Namen" für die Verknüpfung wählen. (z. B. HS-Client starten)
  7. Klicken Sie auf Fertig stellen. Das Verknüpfungssymbol erscheint auf Ihrem Desktop. Mit einem Doppelklick auf das Symbol starten Sie das Client-Programm.
Um das Client-Programm mit Parameterübergabe zu starten, gehen Sie so vor:
  1. Führen Sie den Mauszeiger auf das Verknüpfungssymbol für das Client-Programm.
  2. Öffnen Sie das Kontext-Menü über einen rechten Mausklick.
  3. Wählen Sie Eigenschaften. Das Fenster Eigenschaften von HS-Client starten öffnet sich. Wählen Sie die Registerkarte Verknüpfung (siehe Bild 2.14).

    Screenshot: Fenster

    Bild 2.14: Eigenschaften der Programmverknüpfung

     
  4. Die Pfadangabe einschließlich des Programmnamens in der Zeile Ziel ist automatisch in Hochkommata eingeschlossen, z. B. "C:\Prog\hsclient.exe". Sollte das nicht der Fall sein, ändern Sie dies bitte entsprechend ab.
    Geben Sie hinter diesem Ausdruck, also außerhalb der Anführungszeichen, die Parameter getrennt durch Leerzeichen ein, mit denen das Client-Programm gestartet werden soll. Eine Liste der Parameter finden Sie unter Liste der möglichen Parameter.
  5. Klicken Sie auf Übernehmen. Die neuen Einstellungen werden gespeichert.
  6. Klicken Sie auf OK. Das Fenster schließt sich.
Hinweis: Mehrere Verknüpfungen auf dem Desktop.
Sie können für Ihr Client-Programm eine beliebige Anzahl von Verknüpfungen erstellen.
Dadurch lässt sich in Verbindung mit der Parameterübergabe schnell zwischen verschiedenen Designs, Refreshraten, Home- bzw. FacilityServern und Benutzern umstellen.
Beim nächsten Start des Client-Programms über die Verknüpfung auf Ihrem Desktop werden die von Ihnen vorgegebenen Parameter berücksichtigt.

2.7.1.Liste der möglichen Parameter

Nachfolgend erhalten Sie eine Übersicht über die möglichen Parameter.
Achtung
Es müssen immer mindestens die Parameter 1-4 angegeben werden, damit das Einloggen nur mit Parameter-Übergabe ohne Anzeige der Login-Maske funktioniert!
Achtung
Die Reihenfolge der Parameter ist einzuhalten!
Parameter-NrParameterBeschreibung
1[Rahmen, Position, im Vordergrund]Positionierung des Clients auf dem Bildschirm.

Positionen müssen immer 4-stellig sein. Freie Stellen sind also mit führenden Nullen aufzufüllen. Werden alle Optionen des ersten Parameters genutzt, ergibt sich ein 10 Zeichen langer Parameter.
  • 0 für "rahmenlos"
  • 1 für "mit Rahmen"
  • 10 für "mit Rahmen, Fenster wird normal angezeigt"
  • 11 für "mit Rahmen, Fenster immer im Vordergrund"
  • 0000000000 für "rahmenlos, nicht immer im Vordergrund, Position x0y0"
  • 1100550055 für "mit Rahmen, immer im Vordergrund, Position x55y55
Wird Parameter 1 ganz, oder teilweise nicht gesetzt, gelten folgende Standard-Werte:
  • Rahmen: Ja
  • Immer im Vordergrund: Nein
  • Position: zentriert
2[Key]Schlüssel für den ausgewählten HS.

Der Key entspricht der ID in den Einstellungen für einen HS/FS (siehe Bild 2.8).
3[Benutzername]Anmeldename des Benutzers.

Der Benutzername, wie er in der Login-Maske (siehe Bild 2.6) eingegeben werden muss.
4[Passwort]Passwort des Benutzers.

Das Passwort für den o.a. Benutzer, wie es in der Login-Maske (siehe Bild 2.6) eingegeben werden muss.
5"validatecert" [".pem"-Datei]Zertifikats-Prüfung.

Das im HS/FS hinterlegte Zertifikat wird geprüft. Ist es gültig, findet der Login statt.
Ist es nicht gültig, findet kein Login statt!

Optional kann eine ".pem"-Datei angegeben werden. Diese wird beim Prüfen des Zertifikats des HS/FS als Root-Zertifikat verwendet.
Beispiele für Parameter:
AngabenBeispielKommentar
Parameter 1-4"c:\[Pfad zum HS-Client-Verzeichnis]\hsclient.exe" 1100550077 HSEXAMPLE admin adminDarstellung des HS-Client erfolgt mit Rahmen und immer im Vordergrund, 55 Pixel vom linken und 77 Pixel vom oberen Bildschirmrand entfernt.
Sofern die Login-Daten stimmen, erscheint hier keine Login-Maske; es erscheint direkt der Start-Bildschirm des Projekts.
Parameter "validatecert""c:\[Pfad zum HS-Client-Verzeichnis]\hsclient.exe" validatecertEs erscheint auf jeden Fall zuerst die Login-Maske.
Hat der in der Login-Maske ausgewählte HS ein gültiges Zertifikat, erscheint der Start-Bildschirm des Projekts. Ansonsten kann auch nach Eingabe der korrekten Login-Daten das Projekt nicht gestartet werden.
Parameter "validatecert" mit Angabe einer ".pem"-Datei"c:\[Pfad zum HS-Client-Verzeichnis]\hsclient.exe" validatecert my_cert.pemEs erscheint auf jeden Fall zuerst die Login-Maske.
Damit die Startmaske erscheint, müssen alle Login-Daten korrekt angegeben werden und es muss ein gültiges Zertifikat auf dem HS/FS, signiert durch "my_cert.pem", installiert sein!
Hinweis
Liegt die Datei "my_cert.pem" nicht im Verzeichnis vom HS Client, müssen Sie den kompletten Pfad mit angeben.
Achtung
Ein Einloggen nur mit Parameterübergabe setzt mindestens die Angabe der Parameter 1-4 voraus! Ansonsten erscheint die Login-Maske!

2.8.Verlassen des laufenden Client-Programms

Um das Client-Programm wieder zu verlassen, müssen Sie bei Verwendung der Darstellung "ohne Rahmen" die Tastenkombination ALT+F4 verwenden.

Bei einer Darstellung "mit Rahmen" haben Sie zusätzlich die Möglichkeit, das Client-Programm durch Klicken auf das Schließen-Symbol des Fensters in der Ecke rechts oben (siehe Bild 2.15) zu beenden.

Screenshot: HomeServer Visu, gekennzeichnetes

Bild 2.15: Verlassen des Client-Programms über das Schließen-Symbol