Neben einfachem Englisch akzeptiert der SharKNX-Assistent exakte Befehle, die mit sharknx beginnen. Ein exakter Befehl wird analysiert und nie interpretiert: Er macht genau das, was er sagt, oder er wird mit der Begründung abgelehnt. Es errät niemals einen Befehl, ein Ziel oder einen Wert.
Geben Sie im Assistenten sharknx help für die Liste der Befehle oder sharknx help <command> für die Verwendung eines Befehls ein. Die Registerkarte Befehle in der Hilfe des Assistenten zeigt dieselbe Liste.
Regeln
sharknxkann in jedem Fall geschrieben werden; Befehlswörter müssen genau sein.- Ziele sind literale Adressen – Gruppenadressen als
main/middle/sub(1/2/3), Geräte alsarea.line.device(1.1.5), Leitungen alsarea.line(1.1), Gateways als IPv4-Adresse odermulticast. Projektnamen und Aliase werden in exakten Befehlen nicht verwendet. - Ein falsch eingegebener Befehl erhält möglicherweise einen Vorschlag, der jedoch nur ausgeführt wird, wenn Sie ihn senden.
- Bestätigung, Verbindungsprüfungen und Planbeschränkungen gelten wie für jede andere Anfrage.
Befehle
| Befehl | Tut |
|---|---|
sharknx help [<command>] |
Zeigt alle Befehle oder die Verwendung eines Befehls an |
sharknx connect [<ip>|multicast] |
Stellt eine Verbindung zum ausgewählten Gateway oder zur angegebenen IP-Adresse oder zum Multicast-Routing her |
sharknx disconnect |
Trennt das Gateway |
sharknx discover |
Durchsucht das Netzwerk nach Gateways |
sharknx write <ga> <value> [--dpt <main.sub>] |
Schreibt einen Wert – siehe Values |
sharknx write [<ga>,...] [<value>,...] |
Schreibt eine Werteliste in der Reihenfolge in eine Liste von Gruppenadressen – beide Listen haben die gleiche Länge |
sharknx read <ga> |
Liest eine Gruppenadresse und zeigt die Antwort an |
sharknx monitor start|stop|restart|status |
Steuert oder überprüft den Gruppenmonitor |
sharknx ping <ia> |
Überprüft, ob ein Gerät antwortet |
sharknx restart <ia> |
Startet ein Gerät neu |
sharknx progmode <ia> [on|off] |
Schaltet den Programmiermodus eines Geräts um – schaltet ihn um oder schaltet ihn ein oder aus |
sharknx scan <area.line> |
Durchsucht eine Zeile nach Geräten |
sharknx progscan |
Findet Geräte im Programmiermodus |
sharknx project |
Zeigt die Details des geladenen Projekts an |
sharknx ip |
Zeigt die IP-Adresse dieses Geräts an |
sharknx run <script> [-y] |
Führt ein gespeichertes Skript aus – sharknx <script> macht dasselbe |
Skripte werden mit Aliase und Skripte des Assistenten verwenden gespeichert. Ein integrierter Befehlsname gewinnt immer gegenüber einem Skriptnamen.
Werte
write nimmt den Wert in einer dieser Formen an:
| Bilden | Beispiel | Bedeutet |
|---|---|---|
| Nummer | 50, 21.5, -10 |
Der Wert in der Einheit des Datenpunkttyps – für DPT 5.001 ist 50 50 %. Schreiben Sie es ohne %. |
| Wort | on, off, comfort |
Ein Wertname für den Datenpunkttyp. on und off funktionieren ohne Projekt. |
| Angegebener Wert | "14:30", "255,0,0" |
Ein Wert, der aus mehreren Teilen besteht, beispielsweise einer Uhrzeit, einem Datum oder einer Farbe |
| Verhexen | 0x0AFF |
Rohbytes, die wichtigsten zuerst, werden so gesendet, wie sie sind |
Der Datenpunkttyp stammt aus dem geladenen ETS-Projekt. Ohne ein Projekt oder um ein anderes zu verwenden, fügen Sie --dpt hinzu, zum Beispiel --dpt 9.001. Ein in Anführungszeichen gesetzter Wert erfordert immer einen bekannten Datenpunkttyp.
Einige Datenpunkttypen verwenden einen Zwei-Wort-Wert:
| DPT | Werte |
|---|---|
| 2.001 Schaltersteuerung | control on, control off |
| 3.007 / 3.008 Dimmen, Jalousien | up 1 … up 7, down 1 … down 7, stop |
| 18.001 Szenensteuerung | recall 0 … recall 63, save 0 … save 63 |
Beispiele
| DPT | Befehl |
|---|---|
| 1.001-Schalter | sharknx write 1/2/3 on |
| 3.007 Dimmen | sharknx write 1/2/3 up 3 --dpt 3.007 |
| 5.001 Prozentsatz | sharknx write 1/2/3 50 --dpt 5.001 |
| 9.001 Temperatur | sharknx write 1/2/3 21.5 --dpt 9.001 |
| 10.001 Tageszeit | sharknx write 1/2/3 "14:30:00" --dpt 10.001 |
| 11.001 Datum | sharknx write 1/2/3 "2026-07-10" --dpt 11.001 |
| 16.000-Text | sharknx write 1/2/3 "hello" --dpt 16.000 |
| 17.001 Szenennummer | sharknx write 1/2/3 5 --dpt 17.001 |
| 18.001 Szenensteuerung | sharknx write 1/2/3 recall 5 --dpt 18.001 |
| 20.102 HVAC-Modus | sharknx write 1/2/3 comfort --dpt 20.102 |
| 232.600 RGB-Farbe | sharknx write 1/2/3 "255,0,0" --dpt 232.600 |
| 251.600 RGBW-Farbe | sharknx write 1/2/3 "255,0,128,64" --dpt 251.600 |
Lassen Sie --dpt weg, wenn das Projekt der Gruppenadresse bereits diesen Datenpunkttyp zuweist. Unterstützte Datenpunkttypen sind in Unterstützte Datapoint Types (DPTs) aufgeführt.
Befehle verketten
Kombinieren Sie Befehle in einer Nachricht, um einen Plan zu erstellen:
| Stecker | Führt den nächsten Befehl aus |
|---|---|
; |
Nachdem dies beendet ist, unabhängig vom Ergebnis |
&& |
Nur wenn dies gelingt |
|| |
Nur wenn dieser scheitert |
| |
Wenn dies gelingt, wird das Ergebnis weitergegeben |
sharknx connect && monitor start
sharknx connect && write 1/2/3 21.5 ; write 1/2/4 22.0
sharknx wird einmal am Anfang geschrieben. Wenn connect fehlschlägt, erfolgt nach der Ausführung nichts. sharknx monitor restart ist dasselbe wie monitor stop && monitor start.
Einen Wert weitergeben
Nur read übergibt einen Wert. Der Befehl nach | ist ein write ohne Wert – er schreibt den gelesenen Wert:
sharknx read 1/2/3 | write 4/5/6
Bedingungen
Nach | kann ein Schritt nur ausgeführt werden, wenn der gelesene Wert eine Bedingung erfüllt – if <op> <value> : <command>, wobei <op> ==, !=, >, <, >= oder <= ist:
sharknx read 1/2/3 | if == on : write 4/5/6 off
sharknx read 0/0/1 | if > 22.5 : write 0/0/9 1 || write 0/0/9 0
Das zweite Beispiel schaltet 0/0/9 ein, wenn 0/0/1 über 22.5 liest, und andernfalls aus.
Bestätigungen überspringen
-y (oder --yes) überspringt gewöhnliche Bestätigungen in einem Plan oder Skript:
- am Anfang -
sharknx -y connect && write 1/2/3 on- es gilt für den gesamten Plan; - nach einem Schritt -
sharknx connect && write 1/2/3 on -y- gilt nur für diesen Schritt.
Es funktioniert nicht mit einem einzelnen Befehl und es wird niemals eine starke Bestätigung übersprungen: Diese Schritte werden gemeinsam bestätigt, bevor der Plan beginnt.
Verwandt
- Den Assistenten verwenden – Anfragen in Klartext
- Aliase und Skripte des Assistenten verwenden – Befehlssequenzen als Skripte speichern
- Dateiformat für Aliase und Skripte – Skriptsyntax in Dateien
- Grenzwerte – Plan- und Anforderungslimits
