Sensor-Server und MessPC Software 1. Einleitung Sensor-Server ist ein Webservice, der es ermöglicht, numerische Messwerte wie z.B. vom MessPC System graphisch darzustellen. Er basiert auf den RRDTools von T.Oetiker und ermöglicht dem Anwender eine einfache Konfiguration seiner Datenquellen. Die aus den Messwerten generierten Grafiken stehen auf Wunsch auch als dynamisch erzeugte GIF-Dateien zum Einbinden in eigenen Webseiten zur Verfügung. Die Messwerte werden zusätzlich in einer SQL-Datenbank gespeichert und stehen damit als externe Sicherung zur Verfügung. 2. Vorausssetzungen Der Versand der Daten zum sensor-server erfolgt über das Internet und das HTTP-Protokoll. Die Verbindung kann auch über einen Proxy oder eine Firewall erfolgen (siehe 4.1). Für die Nutzung des Dienstes ist ein Account erforderlich, die Anmeldung kann über http://www.sensor-server.de/register.php erfolgen. Momentan läuft eine mehrmonatige kostenlose Testphase. Im Anschluß daran werden die Kosten für 1 Paket (2 Datenquellen + 1 Kombi-Ansicht) voraussichtlich um 5,- Euro im Monat liegen. 3. Konfiguration Sensorserver 3.1. Anmeldung: http://www.sensor-server.de/login/index.php im Browser öffnen erhaltenen Benutzernamen und Kennwort eintragen 3.2. Allgemeine Einstellungen: in der Navigation den Bereich "Einstellungen" wählen - E-Mail: für Meldungen vom sensor-server - Key: Key, mit dem sich Ihre Sensoren authentifizieren (sensor.php) !!! Wichtig: Dieser Key wird später in der MessPC Software eingetragen !!! - Kennwort: Kennwort für die Anmeldung an der Verwaltungsoberfläche ändern 3.3. Neuen Sensor einrichten: in der Navigation den Bereich "Quellen" und "new" wählen - Name: eindeutiger Name des Sensors (zB. "temp1") Der Name wird zum Einliefern der Daten benötigt (sensor.php) - Beschreibung: Beschreibung des Sensors (zB. "Temperatur, aussen") - Einheit: Maßeinheit (zB. "°C" oder "%") - öffentlich: aktivieren Sie das Feld, wenn Sie den Sensor in Ihre eigenen Web-Seiten integrieren wollen - IP: wird hier eine IP-Adresse eingetragen, werden nur von dieser Adresse Daten angenommen - step: Einlieferungsintervall (default: 300) - DST: Data Source Type - min/max: gültiger Wertebereich. 3.4. Sensor in eigene Webseiten integrieren: Wenn Sie das Feld "öffentlich" aktiviert haben, können Sie die Grafiken zu Ihren Sensoren mit einem Image-Tag in Ihre eigenen Webseiten integrieren: - s = Sensor-ID - t = Anzeigebereich d: Tag w: Woche m: Monat y: Jahr Eine Beispiel-URL mit der entsprechenden Sensor-ID finden Sie auf der Übersichtsseite jedes Sensors. 4. Konfiguration MessPC Software (Version 3.20 oder höher) 4.1 Internetzugang über Proxy In diesem Fall muss der Proxy unter 'Einstellungen' 'Allgemein' 'Proxy' eingetragen werden. 4.2 Eintrag in Datei pcmeasure.cfg In der Sektion [sensorserver] wird der Benutzername (xxxxxx) und der Sensorkey (yyyyyy) aus Abschnitt 3.2 eingetragen. Achtung:hier nicht das Passwort für die Benutzeroberfläche des Sensorserver eintragen! Prüfen Sie bitte auch folgenden Eintrag: url=http://www.sensor-server.de/sensor.php [sensorserver] active=1 url=http://www.sensor-server.de/sensor.php login=xxxxxxx key=yyyyyyy interval=300 timeout=1500 Interval=300 bestimmt, dass alle 5 Minuten ein Messwert übertragen wird. Timeout=1500 (Millisekunden) kann bei Verbindungsproblemen erhöht werden. Im allgemeinen ist das aber nicht notwendig. 4.3 Eintrag für Sensorserver in den Displays Um die Messwerte einer bestimmten Anzeige (Display) der MessPC Software zum Sensorserver zu übertragen, wird dort der Name des Sensors vom Sensorserver eingetragen. Dazu mit der rechten Maustaste auf das Display klicken, 'Einstellungen' 'Sensorserver' anwählen und hier den Namen des Sensors (siehe Abschnitt 3.3) eintragen. Dazu 'active' einschalten und mit 'OK' bestätigen. Ab diesem Zeitpunkt werden die Daten zum Sensorserver übertragen. Der Aufbau der ersten Diagramme dauert einige Minuten. Zur Kontrolle können Sie, wie unter 3.4. beschrieben, den Eingang der letzten Daten in der Benutzeroberfläche des Sensorservers auslesen. 4.4. Anzeige der Diagramme Sie können die erstellten Grafiken in der Benutzeroberfläche des Sensorservers betrachten oder allgemein im Web bereitstellen. Siehe dazu 3.4 Mit Fragen, Kritik und Problemen wenden Sie sich bitte an support@messpc.de