Oltre all'inglese semplice, l'assistente SharKNX accetta comandi esatti che iniziano con sharknx. Un comando esatto viene analizzato, mai interpretato: fa esattamente quello che dice, oppure viene rifiutato con la motivazione. Non indovina mai un comando, un obiettivo o un valore.
Digita sharknx help nell'assistente per l'elenco dei comandi o sharknx help <command> per l'utilizzo di un comando. La scheda Comandi nella Guida dell'assistente mostra lo stesso elenco.
Regole
sharknxpuò essere scritto comunque; le parole di comando devono essere esatte.- Le destinazioni sono indirizzi letterali: indirizzi di gruppo come
main/middle/sub(1/2/3), dispositivi comearea.line.device(1.1.5), linee comearea.line(1.1), gateway come indirizzo IPv4 omulticast. I nomi e gli alias del progetto non vengono utilizzati nei comandi esatti. - Un comando digitato in modo errato può ricevere un suggerimento, ma il suggerimento viene eseguito solo se lo invii.
- Conferme, verifiche di connessione e limiti del piano valgono come per qualsiasi altra richiesta.
Comandi
| Comando | Fa |
|---|---|
sharknx help [<command>] |
Mostra tutti i comandi o l'utilizzo di un comando |
sharknx connect [<ip>|multicast] |
Si connette al gateway selezionato o all'indirizzo IP specificato o al routing multicast |
sharknx disconnect |
Disconnette il gateway |
sharknx discover |
Cerca nella rete i gateway |
sharknx write <ga> <value> [--dpt <main.sub>] |
Scrive un valore - vedere Values |
sharknx write [<ga>,...] [<value>,...] |
Scrive un elenco di valori in un elenco di indirizzi di gruppo, in ordine: entrambi gli elenchi hanno la stessa lunghezza |
sharknx read <ga> |
Legge un indirizzo di gruppo e mostra la risposta |
sharknx monitor start|stop|restart|status |
Controlla o verifica il monitor del gruppo |
sharknx ping <ia> |
Verifica che un dispositivo risponda |
sharknx restart <ia> |
Riavvia un dispositivo |
sharknx progmode <ia> [on|off] |
Cambia la modalità di programmazione di un dispositivo: la attiva o disattiva |
sharknx scan <area.line> |
Esegue la scansione di una linea per i dispositivi |
sharknx progscan |
Trova i dispositivi in modalità di programmazione |
sharknx project |
Mostra i dettagli del progetto caricato |
sharknx ip |
Mostra l'indirizzo IP di questo dispositivo |
sharknx run <script> [-y] |
Esegue uno script salvato: sharknx <script> fa lo stesso |
Gli script vengono salvati con Come Usare Alias e Script dell'Assistente. Un nome di comando integrato prevale sempre su un nome di script.
Valori
write assume il valore in una di queste forme:
| Modulo | Esempio | Significa |
|---|---|---|
| Numero | 50, 21.5, -10 |
Il valore nell'unità del tipo di punto dati: per DPT 5.001, 50 è 50 %. Scrivilo senza %. |
| Parola | on, off, comfort |
Un nome di valore per il tipo di punto dati. on e off funzionano senza progetto. |
| Valore quotato | "14:30", "255,0,0" |
Un valore composto da più parti, ad esempio ora, data o colore |
| Esadecimale | 0x0AFF |
Byte grezzi, prima i più significativi, inviati così come sono |
Il tipo di punto dati proviene dal progetto ETS caricato. Senza un progetto, o per usarne uno diverso, aggiungere --dpt, ad esempio --dpt 9.001. Un valore tra virgolette richiede sempre un tipo di punto dati noto.
Alcuni tipi di punti dati utilizzano un valore di due parole:
| DPT | Valori |
|---|---|
| Comando interruttore 2.001 | control on, control off |
| 3.007 / 3.008 oscuramento, tende | up 1…up 7, down 1…down 7, stop |
| 18.001 controllo scena | recall 0…recall 63, save 0…save 63 |
Esempi
| DPT | Comando |
|---|---|
| Interruttore 1.001 | sharknx write 1/2/3 on |
| 3.007 dimmerabile | sharknx write 1/2/3 up 3 --dpt 3.007 |
| Percentuale 5.001 | sharknx write 1/2/3 50 --dpt 5.001 |
| 9.001 temperatura | sharknx write 1/2/3 21.5 --dpt 9.001 |
| 10.001 ora del giorno | sharknx write 1/2/3 "14:30:00" --dpt 10.001 |
| Data 11.001 | sharknx write 1/2/3 "2026-07-10" --dpt 11.001 |
| Testo 16.000 | sharknx write 1/2/3 "hello" --dpt 16.000 |
| 17.001 numero di scena | sharknx write 1/2/3 5 --dpt 17.001 |
| 18.001 controllo scena | sharknx write 1/2/3 recall 5 --dpt 18.001 |
| 20.102 Modalità HVAC | sharknx write 1/2/3 comfort --dpt 20.102 |
| 232.600 Colore RGB | sharknx write 1/2/3 "255,0,0" --dpt 232.600 |
| 251.600 Colore RGBW | sharknx write 1/2/3 "255,0,128,64" --dpt 251.600 |
Tralascia --dpt quando il progetto fornisce già all'indirizzo di gruppo quel tipo di punto dati. I tipi di punti dati supportati sono elencati in Tipi di Datapoint Supportati (DPT).
Concatenamento di comandi
Unisci i comandi in un unico messaggio per creare un piano:
| Connettore | Esegue il comando successivo |
|---|---|
; |
Dopo che questo finirà, qualunque sia il risultato |
&& |
Solo se questo riesce |
|| |
Solo se questo fallisce |
| |
Se questo ha successo, trasmette il suo risultato |
sharknx connect && monitor start
sharknx connect && write 1/2/3 21.5 ; write 1/2/4 22.0
sharknx viene scritto una volta, all'inizio. Se connect fallisce, nulla dopo l'esecuzione. sharknx monitor restart è uguale a monitor stop && monitor start.
Passare un valore
Solo read trasmette un valore. Il comando dopo | è write senza valore: scrive il valore letto:
sharknx read 1/2/3 | write 4/5/6
Condizioni
Dopo |, un passaggio può essere eseguito solo se il valore letto soddisfa una condizione: if <op> <value> : <command>, dove <op> è ==, !=, >, <, >= o <=:
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
Il secondo esempio attiva 0/0/9 quando 0/0/1 legge sopra 22.5 e disattiva altrimenti.
Saltare le conferme
-y (o --yes) salta le conferme ordinarie in un piano o script:
- all'inizio -
sharknx -y connect && write 1/2/3 on- vale per tutto il piano; - dopo un passo -
sharknx connect && write 1/2/3 on -y- si applica solo a quel passo.
Non funziona su un singolo comando e non salta mai una conferma forte: questi passaggi vengono confermati insieme prima dell'inizio del piano.
Imparentato
- Come Usare l'Assistente - richieste in inglese semplice
- Come Usare Alias e Script dell'Assistente: salva le sequenze di comandi come script
- Formato File di Alias e Script - sintassi dello script nei file
- Limiti - limiti di pianificazione e richiesta
