Lokaler Webserver
Aqua-Scope WLAN-Geräte mit Netzteilbetrieb verfügen über einen integrierten HTTP-Webserver, der direkt im lokalen Netzwerk erreichbar ist. Darüber können Sensordaten abgefragt, Konfigurationen geändert, Ventile gesteuert und Diagnosen durchgeführt werden – ohne Cloud, ohne App, direkt per Browser oder HTTP-Client.
Voraussetzungen
- WLAN-Gerät mit Netzteilbetrieb (nicht im Batteriebetrieb verfügbar)
- Gerät und Client im selben lokalen Netzwerk
Webserver aktivieren
Im Auslieferungszustand
Der Webserver ist im Factory Default immer aktiv. Beim ersten Setup kann er über die Konfigurationsseite dauerhaft aktiviert bleiben.
Nachträglich über die App
- Öffnen Sie die Aqua-Scope App
- Wählen Sie das Gerät aus
- Navigieren Sie zu Konfiguration → Kommunikationsoptionen
- Aktivieren Sie Lokaler Webserver
Zugriff
Der Webserver ist über die lokale IP-Adresse des Gerätes oder per mDNS erreichbar:
http://<IP-Adresse>(z.B.http://192.168.1.42)http://scope.local(per mDNS, wenn nur ein Gerät im Netz)
Seiten und Endpunkte
Weboberfläche (Browser)
| URL | Beschreibung |
|---|---|
/ | Startseite – zeigt die Home-Seite (wenn WLAN konfiguriert) oder die Setup-Seite (im Auslieferungszustand) |
/home | Home-Seite mit Geräteübersicht und Sensordaten |
/setup | WLAN-Konfigurationsseite (SSID, Passwort, E-Mail, Kommunikationsoptionen) |
/command | Shell-Konsole zur Gerätediagnose |
Daten-API (JSON)
| URL | Methode | Beschreibung |
|---|---|---|
/data | GET | Alle aktuellen Sensorwerte als JSON inkl. Geräte-ID (eid) |
/json | GET | Sensordaten im JSON-Format |
/cdata.js | GET | Sensordaten als JavaScript-Objekt (für Weboberfläche) |
/conn | GET | Verbindungsstatus als JSON |
Beispiel: Sensordaten abrufen
curl http://192.168.1.42/data
{
"temperature": "22.5",
"pressure": "3200",
"uptime": "86400",
"battery": "3.3",
"eid": "12345678"
}
Die verfügbaren Felder variieren je nach Gerätetyp.
Ventilsteuerung
| URL | Methode | Beschreibung |
|---|---|---|
/control?valve=<wert>&token=<token> | GET | Ventil steuern |
Parameter:
| Parameter | Beschreibung |
|---|---|
valve | 0 oder off = schließen, 100 oder on = öffnen |
token | Sicherheitstoken (muss mit dem in der Konfiguration hinterlegten Token übereinstimmen) |
Beispiele:
# Ventil schließen
curl "http://192.168.1.42/control?valve=off&token=mein-token"
# Ventil öffnen
curl "http://192.168.1.42/control?valve=on&token=mein-token"
# Ventil mit numerischem Wert öffnen
curl "http://192.168.1.42/control?valve=100&token=mein-token"
Die Ventilsteuerung erfordert einen gültigen Token. Ohne korrekten Token wird der Befehl abgelehnt. Der Token wird bei der Webhook-Konfiguration festgelegt (siehe JSON Webhook).
Konfiguration
| URL | Methode | Beschreibung |
|---|---|---|
/config | GET/POST | Geräte-Konfiguration lesen und ändern |
Über diesen Endpunkt können folgende Einstellungen geändert werden:
| Parameter | Feld | Beschreibung |
|---|---|---|
ssi | WLAN SSID | Name des WLAN-Netzwerks |
wpa | WLAN Passwort | WPA2-Schlüssel |
ema | Registrierungs-E-Mail | |
mqt | MQTT | MQTT-Dienst aktivieren |
mse | MQTT Server | Broker-Hostname |
mpo | MQTT Port | Broker-Port |
mus | MQTT Login | Benutzername |
mpa | MQTT Passwort | Passwort |
mdi | MQTT Discovery | Home Assistant Auto-Discovery aktivieren |
mtl | MQTT TLS | TLS-Verschlüsselung aktivieren |
jen | JSON Webhook | Webhook-Dienst aktivieren |
jur | JSON URL | Webhook-Ziel-URL |
jto | JSON Token | Sicherheitstoken |
jex | JSON XXTEA | XXTEA-Verschlüsselung aktivieren |
jra | JSON Raw | Rohdatenübertragung aktivieren |
lws | Lokaler Webserver | Webserver aktiviert halten |
ble | Bluetooth | Bluetooth aktivieren |
mbi | Modbus IP | Modbus TCP/IP aktivieren |
fac | Factory Reset | Auf 1 setzen für Werksreset |
Shell / Diagnose
| URL | Methode | Beschreibung |
|---|---|---|
/shell | POST | Shell-Befehl ausführen (Feld: shell) |
/console | GET | Konsolen-Log abrufen |
Die Shell akzeptiert AT-Befehle und Diagnosebefehle über HTTP POST.
# Firmware-Version abfragen
curl -X POST -d "shell=AT+VER=?" http://192.168.1.42/shell
# Konsolen-Log abrufen
curl http://192.168.1.42/console
Integration in Automatisierung
Der lokale Webserver eignet sich für die direkte Integration in Smart-Home-Systeme ohne Cloud-Abhängigkeit:
- Home Assistant: Über die REST-Integration können
/dataund/controlangebunden werden - Node-RED: HTTP-Request-Nodes für Sensorabfrage und Ventilsteuerung
- Shell-Skripte: Einfache Abfrage und Steuerung per
curl
Unterstützte Geräte
Der lokale Webserver ist bei allen WLAN-Geräten mit Netzteilbetrieb verfügbar: