Zum Hauptinhalt springen

Überblick aller Komponenten-Provider

Als eine Art Referenz und Erklärung zu den in NeuroomNet verfügbaren Providern werden in den folgenden Unterabschnitten alle derzeit in NeuroomNet verfügbaren Provider mit deren Einstellungsmöglichkeiten und Erklärungen aufgelistet. Dabei werden insbesondere folgende wichtige Informationen angegeben:

  • Klassifikation: Klassifikation des Providers in aktiv und passiv:
    • Aktive Provider (Komponenten): Aktive Provider korrespondieren zu aktiven Komponenten, d.h. Komponenten, die von sich aus den NeuroomNet-Server kontaktieren. Nach erster solcher Kontaktaufnahme legt NeuroomNet die Komponente an Modul Setup (z.B. anhand der MAC-Adresse der Komponente, worüber diese Komponente in Zukunft automatisch erkannt werden kann, selbst bei mittlerweile geänderter IP-Adresse).
    • Passive Provider (Komponenten): Passive Provider korrespondieren zu passiven Komponenten, d.h. welche i.d.R. manuell im Modul Setup des NeuroomNet Servers angelegt werden inkl. Kontaktinformationen (wie z.B. über die IP-Adresse der Komponente). Die entsprechenden Komponenten verbinden sich i.d.R. nicht selbstständig mit dem NeuroomNet-Server.
  • Netzwerk / Kommunikation: Beschreibt, wie Komponenten des Providers in NeuroomNet hinsichtlich Erreichbarkeit im Netzwerk konfiguriert werden können (betrifft vor allem passive Komponenten, weil hier NeuroomNet wissen muss, wie es die jeweiligen Komponenten erreichen kann).
  • Aktionen: Auflistung aller Provider-spezifischen (NeuroomNet-)Aktionen . Die Standard-Aktionen, die jede Komponente hat ("Enforce Warning Level" und "Reset Warning Level"), sind in dieser Auflistung nicht enthalten.
  • Ereignisse: Auflistung aller Provider-spezifischen (NeuroomNet-)Ereignisse. Das Standard-Ereignis, welches jede Komponente hat ("State has changed"), ist in dieser Auflistung nicht enthalten.

Allgemeine / Provider-unabhängige Felder​

Folgende Felder gibt es für Komponenten eines jeden Providers:

  • Typ: (Optionale) Angabe eines (benutzerdefinierten) Komponententyps, siehe Zusammenspiel Provider und Komponententypen
  • Beschreibung: (Optionale) textuelle Beschreibung der Komponente
  • Besondere Regeln für Warnungslevel: Optional: Abhängig von eingehenden Ereignissen können für Komponenten automatisch bestimmte Warnungslevel gesetzt werden, siehe Warnungslevel pflegen
  • Gerätespannung (in Volt):, Stromverbrauch (in Ampere), Leistung (in Watt): (Optionale) Angaben zur Gerätespannung, Stromverbrauch und Leistung des durch die Komponente repräsentierten Geräts. Es reicht hier eine Eingabe von entweder [Leistung] oder [Gerätespannung und Stromverbrauch] (die Leistung wird im letzteren Fall dann aus Gerätespannung multipliziert mit Stromverbrauch berechnet). Die Leistung (oder Gerätespannung * Stromverbrauch) des Geräts wird im Modul Status Historie verwendet zur Berechnung des tatsächlich aufgetretenen Stromverbrauchs und der resultierenden Stromkosten. Siehe hierzu Berechnung der Kilowattstunden und des Strompreises

Provider Heatmap (ehemals Camera)​

Mit Provider Heatmap (ehemals Camera) werden (Hardware-)Kameras des Herstellers Xovis angesprochen über ein proprietären Protokoll zur Zählung eingehender und ausgehender Menschen an Eingängen / Ausgängen.

  • Klassifikation: Passiv
  • Netzwerk / Kommunikation: IP-Adresse
  • Aktionen: Reset Counters
  • Ereignisse: Keine; die Kameras werden derzeit nur proprietär vom Heatmap-Modul angesprochen (und dort gepollt)

Provider Digital Signage Player​

Mit Provider Digital Signage Player werden Software-Digital-Signage-Player von inSynergie angesprochen, welche jeweils auf einem Rechner (Windows, Linux, Android) im Netzwerk installiert sind. Die Kommunikation erfolgt über ein proprietäres Protokoll von inSynergie. Detailliertere Dokumentation: Modul Digital Signage

  • Klassifikation: Aktiv
  • Netzwerk / Kommunikation: -
  • Aktionen:
    • Activate playlist
    • Activate schedule
    • Change display parameters
    • End blackout
    • Refresh schedule
    • Start blackout
  • Ereignisse: Request to switch signage input source

Provider DMX​

Mit Provider DMX werden DMX-Geräte angesprochen, welche per ArtNet oder DMX angesteuert werden können.

  • Klassifikation: Passiv
  • Netzwerk / Kommunikation: IP-Adresse
  • Aktionen:
    • WriteChannel
    • WriteChannels
    • Write
  • Ereignisse: -

Provider Email-Server​

Mit Provider Email-Server werden Email-Server über ein bestimmtes Protokoll angesprochen.

  • Klassifikation: Passiv
  • Netzwerk / Kommunikation:
    • Server URI
    • Authorization
  • Aktionen:
    • Send an E-Mail
  • Ereignisse: -

Provider Exhibit​

Mit Provider Exhibit wird Exponate-Software auf (überlicherweise Exponate-)PCs, die mittels der Exponate API von inSynergie fernsteuerbar ist, angesprochen (anstatt oder zusätzlich zur Steuerung mittels Provider / Software PC-Client).

  • Klassifikation: Aktiv
  • Netzwerk / Kommunikation: VendorId (= eindeutige Kennzeichnung des Exponats)
  • Aktionen:
    • Log User on or off
    • Reboot the Computer
    • Restart the Exhibit Software
    • Shutdown the computer
  • Ereignisse:
    • Animation for RFID-Readers
    • Day of Birth changed
    • New Gender selected
    • Preferred User Language changed
    • Status Report

Provider HTTP​

Mit Provider HTTP können beliebige Geräte, welche sich per HTTP-Messages (GET, POST, DELETE, PUT und ggf. zugehörige Nachricht als Zeichenkette) steuern lassen, angesprochen werden.

Anders als bei Komponenten mit Provider Network und Serial werden bei Komponenten mit Provider HTTP die zu sendenden Nachrichten nicht via Geräteprotokolle / PRT definiert, sondern über Aliase. Dazu legt man einen Komponententyp (im Reiter Komponententypen) an, welcher der entsprechenden Komponente zugewiesen ist, und im Komponententyp können dann für den Provider HTTP und "Send Request" die zu sendenden Textnachrichten definiert werden über Aliase. Diese Aliase können dann verwendet werden als Aktionen.

  • Klassifikation: Passiv
  • Netzwerk / Kommunikation:
    • Servernamen oder IP Adresse
    • HTTP Header (JSON): Optionale Angabe eines HTTP-Headers (i.d.R. lässt man dies leer)
    • HTTPS/SSL Verschlüsselung nutzen: Ja / nein
    • Typ: Bei Provider HTTP möchte man i.d.R. einen Komponententypen mit zugehörigen Aliasen verwenden
  • Aktionen:
    • [über Aliase definiert]
  • Ereignisse:
    • [es ist nicht möglich, über Provider HTTP Ereignisse zu verarbeiten]

Im Folgenden ein Beispiel der Definition von Aktionen für eine Komponente mit Provider HTTP durch zugehörigen Komponententyp und Aliasen:

Screenshot Konfiguration von Aktionen von speziellen IP-Steckdosen via Aliase (und Provider HTTP)

In diesem Fall handelt es sich um bestimmte, real existierende IP-Steckdosen, die z.B. auch via Webbrowser mit Kommandos wie folgt steuerbar sind: http://192.168.0.1/hidden.htm?M0:O1=On.

Provider KNX​

Mit Provider KNX werden (Hardware-)Geräte (Steckdosen oder Licht) über das Protokoll KNX angesprochen.

  • Klassifikation: Passiv
  • Netzwerk / Kommunikation:
    • Name der Komponente
    • KNX/IP Interface / Gateway (IP)
    • KNX Adresse
    • Datenpunkttyp
  • Aktionen:
    • Send Data to Actor
  • Ereignisse:
    • Data received from Sensor

Mit Provider Master Link werden isMaster über eine proprietäre Schnittstelle von inSynergie angesprochen.

  • Klassifikation: Passiv
  • Netzwerk / Kommunikation: Proxy-Adresse (= URL des isMaster)
  • Aktionen:
    • [Benutzerdefiniert in der isMaster Administration und im isMaster]
  • Ereignisse:
    • [Benutzerdefiniert in der isMaster Administration und im isMaster]

Provider Network​

Mit Provider Network können beliebige Geräte, welche sich per TCP, UDP oder Telnet und durch Zeichen- oder Bytefolgen (via PRT) steuern lassen, angesprochen.

Die konkreten Nachrichten (eingehend und ausgehend) sind in einer PRT-Datei definiert (siehe Reiter Geräteprotokolle).

Siehe Technische Dokumentation / Detail-Informationen zu TCP und UDP bei Provider Network für Details.

  • Klassifikation: Passiv
  • Netzwerk / Kommunikation:
    • IP-Adresse
    • TCP, UDP oder Telnet
    • Translation rule-set (PRT)
    • ID (wird derzeit nicht genutzt; für mögliche Verwendungen in der Zukunft soll hier eine eindeutige Zeichenfolge eingegeben werden)
  • Aktionen:
    • [wie im PRT definiert]
  • Ereignisse:
    • [wie im PRT definiert]

Provider PC-Client​

Mit Provider PC-Client werden PCs, auf welchen die PC-Client Software von inSynergie installiert ist, angesprochen.

  • Klassifikation: Aktiv
  • Netzwerk / Kommunikation: MAC-Adresse
  • Aktionen:
    • Reboot
    • Wake-On-LAN
    • Disable all serial ports
    • Enable all serial ports
    • Power Off
    • [und noch viele mehr]
  • Ereignisse: -

Mit Provider PJLINK werden Video-Projektoren oder Bildschirme über das PJLINK-Protokoll angesprochen.

  • Klassifikation: Passiv
  • Netzwerk / Kommunikation: IP-Adresse
  • Aktionen:
    • Choose input
    • Get lamp hours
    • Get error state
    • Power Off
    • Power On
    • Set mute
  • Ereignisse:
    • Current input line
    • Error states
    • Lamp hour information
    • Mute state
    • Power status

Provider RFID Reader​

Mit Provider RFID Reader werden (Hardware-)RFID-Reader IS-CC-RFID-2.0 von inSynergie über ein proprietäres Protokoll angesprochen.

Detailliertere Dokumentation: https://neuroom.net/rfid/

  • Klassifikation: Aktiv
  • Netzwerk / Kommunikation: Mac-Adresse
  • Aktionen:
    • Active Attraction
    • Deactivate Attraction
    • IDLE Animation
    • Switch all LEDs off
    • Reboot and update to latest Firmware
    • Restart RFID Unit
  • Ereignisse:
    • RFID detected
    • RFID input changed
    • RFID lost

Provider Serial​

Mit Provider Serial werden Geräte angesprochen, welche per RS-232 Kabel an einem per IP-Adresse konfigurierten PC angeschlossen sind und sich über Zeichen- oder Bytefolgen (via PRT) steuern lassen.

Die konkreten Nachrichten (eingehend und ausgehend) sind in einer PRT-Datei definiert (siehe Reiter Geräteprotokolle).

  • Klassifikation: Passiv
  • Netzwerk / Kommunikation:
    • IP-Adresse
    • Translation rule-set (PRT)
    • ID (wird derzeit nicht genutzt; für mögliche Verwendungen in der Zukunft soll hier eine eindeutige Zeichenfolge eingegeben werden)
  • Aktionen:
    • [wie im PRT definiert]
  • Ereignisse:
    • [wie im PRT definiert]

Provider SNMP​

Mit Provider SNMP werden Geräte angesprochen, welche per SNMP-Protokoll über eine IP-Adresse gesteuert werden können.

  • Klassifikation: Passiv

  • Netzwerk / Kommunikation: IP-Adresse

  • Aktionen:

    • [wie im PRT definiert]

  • Ereignisse:

    • [wie im PRT definiert]

Provider Software API​

Mit Provider Software API werden PCs oder Software angesprochen, welche über ein von Synergie entwickeltes Protokoll (die sog. Software API) ferngesteuert werden können.

Über diese Software API, welche eine Art von Verallgemeinerung der Exhibit API darstellt, kann der NeuroomNet-Server dynamisch über verfügbare Aktionen und Ereignisse auf dem jeweiligen PC oder Software informieren werden und kann entsprechend ferngesteuert werden.

  • Klassifikation: Passiv
  • Netzwerk / Kommunikation: IP-Adresse
  • Aktionen:
    • [über die Software API definiert]
  • Ereignisse:
    • [über die Software API definiert]