Konsolenbefehle
Aqua-Scope-Geräte bieten eine Text-Konsole für Diagnose, Setup und Wartung. Befehle können über mehrere Schnittstellen gleichberechtigt eingegeben werden – die Antworten erscheinen jeweils auf demselben Kanal.
Zugriffswege
| Schnittstelle | Voraussetzung | Hinweis |
|---|---|---|
| USB-C / Serial | Serielle Verbindung mit 115200 Bps, 8N1 | Vollständiger Zugriff inkl. lokaler Befehle |
| Bluetooth (BLE) | App im Setup-Modus oder BLE aktiv | Setup- und allgemeine Befehle |
| Lokaler Webserver | WLAN-Gerät mit aktiviertem Webserver | Eingabe über /shell, Ausgabe über /console (siehe Lokaler Webserver) |
Einige Befehle sind ausschließlich an der lokalen seriellen Konsole verfügbar und im Folgenden entsprechend gekennzeichnet.
Allgemeine Befehle
| Befehl | Argumente | Beschreibung |
|---|---|---|
status | — | Gibt das System-Status-Flag-Register als 16-Bit-Hexwert aus |
alarm | — | Gibt aktive Alarme und blockierte Alarme als Hexwerte aus |
heap | — | Aktuell verfügbarer Heap-Speicher in Byte |
echo | — | Testbefehl, antwortet mit echo ok |
consolelog | — | Gibt den gepufferten Konsolen-Log Zeile für Zeile aus |
beep | <code> | Aktiviert den Buzzer mit dem angegebenen Code |
valve | <wert> | Setzt das Ventil (gerätabhängig, z. B. 0/100 für zu/auf) |
mon | <intervall> | Setzt das Monitoring-Intervall in Sekunden |
resetc | — | Neustart in den Portal-Modus |
Konfiguration
| Befehl | Argumente | Beschreibung |
|---|---|---|
configlist | — | Listet alle Konfigurationsregister mit Wert auf |
configget | <nr> | Gibt Wert von Konfigurationsregister <nr> aus (hex und dezimal) |
configset | <nr> <wert> | Setzt Konfigurationsregister <nr> auf <wert> |
configreset | — | Setzt alle Konfigurationsregister auf Werkseinstellungen (nur lokale Konsole) |
factory | 2010 | Werksreset des Gerätes – die 2010 ist Sicherheitsbestätigung (nur lokale Konsole) |
hwversion | <wert> | Schreibt die Hardware-Version dauerhaft ins Dateisystem |
factory 2010 und configreset löschen Ihre individuellen Einstellungen unwiderruflich. Nutzen Sie diese Befehle nur, wenn das Gerät neu in Betrieb genommen werden soll.
WLAN- und Cloud-Setup
Diese Kurzbefehle werden vor allem im Portal-Modus und über Bluetooth zur Geräteinbetriebnahme genutzt. Werte werden mit einem Leerzeichen getrennt übergeben (z. B. sid MyWiFi).
| Befehl | Argument | Bedeutung |
|---|---|---|
sid | <ssid> | WLAN-SSID |
wpa | <passwort> | WLAN-Passwort (WPA2) |
mal | <email> | Registrierungs-E-Mail |
wce | <url> | Server-URL für JSON-Webhook |
wto | <token> | Sicherheitstoken |
mse | <server> | MQTT-Broker-Hostname |
mpo | <port> | MQTT-Broker-Port |
mus | <benutzer> | MQTT-Benutzername |
mpa | <passwort> | MQTT-Passwort |
sto | — | Speichert MQTT- und Web-Konfiguration und verbindet sich neu |
getdata | — | Gibt aktuelle WLAN- und Server-Konfiguration zurück (über BLE) |
Zusätzlich existieren die Kurzformen ws <ssid>, ww <wpa> und em <email> zur abwärtskompatiblen Eingabe.
Kommunikation und Schnittstellen
| Befehl | Argumente | Beschreibung |
|---|---|---|
comms | — | Zeigt MQTT- und JSON-Konfiguration (nur lokale Konsole) |
modbus | 1 | Schaltet die serielle Schnittstelle auf Modbus RTU mit 9600 Bps und startet das Gerät neu |
otw | — | Startet einen Firmware-Update per XMODEM über UART |
AQM (Ultraschall-Klemme)
Diese Befehle stehen auf den AQM-Geräten zur Verfügung und steuern den internen MSP430-Co-Prozessor:
| Befehl | Argumente | Beschreibung |
|---|---|---|
mspu | <befehl> | Sendet einen Befehl direkt an den MSP430 (Pass-Through) |
mspi | <befehl> | Verarbeitet einen MSP-Befehl intern |
mspuid | — | Liest die eindeutige Geräte-ID des MSP430 |
mspr | — | Führt einen Hardware-Reset des MSP430 aus |
mspe | <bsl-befehl> | Versetzt den MSP430 in den BSL-Modus zur Aktualisierung |
mspota | — | Startet die OTA-Programmierung des MSP430 |
mspbsl | — | Startet ein BSL-Firmware-Update des MSP430 über UART |
sleep | — | Versetzt das Gerät in den Schlafmodus |
LoRaWAN
| Befehl | Argumente | Beschreibung |
|---|---|---|
buffers | — | Gibt den Inhalt des LoRa-Sendepuffers aus |
sensors | — | Listet die intern erfassten Sensorwerte auf |
ULP / MC8 (Niedrigleistungsgeräte)
Diese Befehle stehen auf Geräten mit ULP-Co-Prozessor (z. B. AQS, AQX, MCL) zur Verfügung.
| Befehl | Argumente | Beschreibung |
|---|---|---|
appmenu | <option> | Wählt eine Anwendungsmenü-Option |
ulp_restart | — | Startet den ULP-Co-Prozessor neu |
ulpstatus | — | Gibt den Statuswert des ULP als Hexwert aus |
ulpmode | <mode> | Setzt den AQS-Algorithmus-Modus |
i2c_init | — | Initialisiert den I²C-Bus |
i2c_start | — | Liest den Drucksensor einmalig aus |
i2c_fix | — | Reaktiviert den I²C-Sensor nach Hängen |
ubilink | <port> <p2> <p3> <p4> <p5> | Sendet ein UBI-TX-Frame mit den angegebenen Bytes |
Beispiele
# Status und Alarme prüfen
status
alarm
# Konfigurationsregister 13 anzeigen und auf 60 setzen
configget 13
configset 13 60
# Firmware-Update starten
otw
# Werkseinstellungen wiederherstellen (lokale Konsole, mit Bestätigungswert)
factory 2010
Hinweise
- Befehle werden mit
\n(LF) oder\r\n(CRLF) abgeschlossen. - Numerische Argumente können dezimal oder hexadezimal (
0x…) eingegeben werden. - Die Konsole akzeptiert maximal 64 Zeichen pro Eingabezeile.
- Befehle, die mit „nur lokale Konsole" gekennzeichnet sind, werden über BLE oder den Webserver bewusst nicht ausgeführt.