Outre l'anglais simple, l'assistant SharKNX accepte les commandes exactes commençant par sharknx. Une commande exacte est analysée, jamais interprétée : elle fait exactement ce qu'elle dit, ou elle est refusée avec la raison. Il ne devine jamais une commande, une cible ou une valeur.
Tapez sharknx help dans l'assistant pour la liste des commandes, ou sharknx help <command> pour l'utilisation d'une commande. L'onglet Commandes de l'aide de l'assistant affiche la même liste.
Règles
sharknxpeut s'écrire dans tous les cas ; les mots de commande doivent être exacts.- Les cibles sont des adresses littérales : adresses de groupe sous la forme
main/middle/sub(1/2/3), appareils sous la formearea.line.device(1.1.5), lignes sous la formearea.line(1.1), passerelles sous la forme d'une adresse IPv4 oumulticast. Les noms et alias de projet ne sont pas utilisés dans les commandes exactes. - Une commande mal saisie peut générer une suggestion, mais la suggestion ne s'exécute que si vous l'envoyez.
- La confirmation, les vérifications de connexion et les limites du forfait s'appliquent comme pour toute autre demande.
Commandes
| Commande | Fait |
|---|---|
sharknx help [<command>] |
Affiche toutes les commandes ou l'utilisation d'une commande |
sharknx connect [<ip>|multicast] |
Se connecte à la passerelle sélectionnée, ou à l'adresse IP ou au routage multicast donné |
sharknx disconnect |
Déconnecte la passerelle |
sharknx discover |
Recherche les passerelles sur le réseau |
sharknx write <ga> <value> [--dpt <main.sub>] |
Écrit une valeur - voir Values |
sharknx write [<ga>,...] [<value>,...] |
Écrit une liste de valeurs dans une liste d'adresses de groupe, dans l'ordre - les deux listes ont la même longueur |
sharknx read <ga> |
Lit une adresse de groupe et affiche la réponse |
sharknx monitor start|stop|restart|status |
Contrôle ou vérifie le moniteur de groupe |
sharknx ping <ia> |
Vérifie qu'un appareil répond |
sharknx restart <ia> |
Redémarre un appareil |
sharknx progmode <ia> [on|off] |
Commute le mode de programmation d'un appareil - le bascule ou l'active ou le désactive |
sharknx scan <area.line> |
Analyse une ligne à la recherche d'appareils |
sharknx progscan |
Recherche les appareils en mode programmation |
sharknx project |
Affiche les détails du projet chargé |
sharknx ip |
Affiche l'adresse IP de cet appareil |
sharknx run <script> [-y] |
Exécute un script enregistré - sharknx <script> fait de même |
Les scripts sont enregistrés avec Comment utiliser les alias et scripts de l'assistant. Un nom de commande intégré l'emporte toujours sur un nom de script.
Valeurs
write prend la valeur sous l'une de ces formes :
| Formulaire | Exemple | Moyens |
|---|---|---|
| Nombre | 50, 21.5, -10 |
La valeur dans l'unité du type de point de données - pour DPT 5.001, 50 est 50 %. Écrivez-le sans %. |
| Mot | on, off, comfort |
Un nom de valeur pour le type de point de données. on et off fonctionnent sans projet. |
| Valeur cotée | "14:30", "255,0,0" |
Une valeur composée de plusieurs parties, comme une heure, une date ou une couleur |
| Hex | 0x0AFF |
Octets bruts, de poids fort en premier, envoyés tels quels |
Le type de point de données provient du projet ETS chargé. Sans projet, ou pour en utiliser un autre, ajoutez --dpt, par exemple --dpt 9.001. Une valeur citée nécessite toujours un type de point de données connu.
Quelques types de points de données utilisent une valeur de deux mots :
| TPD | Valeurs |
|---|---|
| Commande de commutateur 2.001 | control on, control off |
| 3.007 / 3.008 gradation, stores | up 1 … up 7, down 1 … down 7, stop |
| Contrôle de scène 18.001 | recall 0 … recall 63, save 0 … save 63 |
Exemples
| TPD | Commande |
|---|---|
| Commutateur 1.001 | sharknx write 1/2/3 on |
| Gradation 3.007 | sharknx write 1/2/3 up 3 --dpt 3.007 |
| Pourcentage 5.001 | sharknx write 1/2/3 50 --dpt 5.001 |
| Température 9.001 | sharknx write 1/2/3 21.5 --dpt 9.001 |
| 10.001 heure du jour | sharknx write 1/2/3 "14:30:00" --dpt 10.001 |
| date 11.001 | sharknx write 1/2/3 "2026-07-10" --dpt 11.001 |
| Texte 16.000 | sharknx write 1/2/3 "hello" --dpt 16.000 |
| Numéro de scène 17.001 | sharknx write 1/2/3 5 --dpt 17.001 |
| Contrôle de scène 18.001 | sharknx write 1/2/3 recall 5 --dpt 18.001 |
| Mode CVC 20.102 | sharknx write 1/2/3 comfort --dpt 20.102 |
| Couleur RVB 232.600 | sharknx write 1/2/3 "255,0,0" --dpt 232.600 |
| Couleur 251.600 RVBB | sharknx write 1/2/3 "255,0,128,64" --dpt 251.600 |
Laissez de côté --dpt lorsque le projet donne déjà à l'adresse de groupe ce type de point de données. Les types de points de données pris en charge sont répertoriés dans Types de points de données (DPT) pris en charge.
Chaînage des commandes
Rejoignez les commandes dans un seul message pour créer un plan :
| Connecteur | Exécute la commande suivante |
|---|---|
; |
Une fois celui-ci terminé, quel que soit le résultat |
&& |
Seulement si celui-ci réussit |
|| |
Seulement si celui-ci échoue |
| |
Si celui-ci réussit, transmettre son résultat |
sharknx connect && monitor start
sharknx connect && write 1/2/3 21.5 ; write 1/2/4 22.0
sharknx est écrit une seule fois, au début. Si connect échoue, rien après son exécution. sharknx monitor restart est identique à monitor stop && monitor start.
Transmettre une valeur
Seul read transmet une valeur. La commande après | est un write sans valeur - elle écrit la valeur qui a été lue :
sharknx read 1/2/3 | write 4/5/6
Conditions
Après |, une étape ne peut s'exécuter que si la valeur lue répond à une condition - if <op> <value> : <command>, où <op> est ==, !=, >, <, >= ou <= :
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
Le deuxième exemple active 0/0/9 lorsque 0/0/1 lit au-dessus de 22.5, et le désactive dans le cas contraire.
Sauter les confirmations
-y (ou --yes) ignore les confirmations ordinaires dans un plan ou un script :
- au départ -
sharknx -y connect && write 1/2/3 on- il s'applique à l'ensemble du plan ; - après une étape -
sharknx connect && write 1/2/3 on -y- cela s'applique uniquement à cette étape.
Il ne fonctionne pas sur une seule commande et ne saute jamais une confirmation forte : ces étapes sont confirmées ensemble avant le démarrage du plan.
En rapport
- Comment utiliser l'assistant - requêtes en anglais simple
- Comment utiliser les alias et scripts de l'assistant - enregistre les séquences de commandes sous forme de scripts
- Format de fichier des alias et scripts - syntaxe de script dans les fichiers
- Limites - limites de plan et de demande
