Además del inglés sencillo, el asistente SharKNX acepta comandos exactos que comienzan con sharknx. Una orden exacta se analiza, nunca se interpreta: hace exactamente lo que dice o se rechaza con el motivo. Nunca adivina un comando, un objetivo o un valor.
Escriba sharknx help en el asistente para ver la lista de comandos, o sharknx help <command> para usar un comando. La pestaña Comandos en la Ayuda del asistente muestra la misma lista.
Normas
sharknxse puede escribir en cualquier caso; Las palabras de comando deben ser exactas.- Los destinos son direcciones literales: direcciones de grupo como
main/middle/sub(1/2/3), dispositivos comoarea.line.device(1.1.5), líneas comoarea.line(1.1), puertas de enlace como una dirección IPv4 omulticast. Los nombres y alias de los proyectos no se utilizan en comandos exactos. - Un comando mal escrito puede recibir una sugerencia, pero la sugerencia solo se ejecuta si la envías.
- La confirmación, las comprobaciones de conexión y los límites del plan se aplican como para cualquier otra solicitud.
Comandos
| Dominio | Hace |
|---|---|
sharknx help [<command>] |
Muestra todos los comandos o el uso de un comando. |
sharknx connect [<ip>|multicast] |
Se conecta a la puerta de enlace seleccionada, o a la dirección IP dada o al enrutamiento de multidifusión |
sharknx disconnect |
Desconecta la puerta de enlace |
sharknx discover |
Busca puertas de enlace en la red |
sharknx write <ga> <value> [--dpt <main.sub>] |
Escribe un valor - ver Values |
sharknx write [<ga>,...] [<value>,...] |
Escribe una lista de valores en una lista de direcciones de grupo, en orden; ambas listas tienen la misma longitud |
sharknx read <ga> |
Lee una dirección de grupo y muestra la respuesta. |
sharknx monitor start|stop|restart|status |
Controla o comprueba el monitor de grupo. |
sharknx ping <ia> |
Comprueba que un dispositivo responde |
sharknx restart <ia> |
Reinicia un dispositivo |
sharknx progmode <ia> [on|off] |
Cambia el modo de programación de un dispositivo: lo activa o desactiva. |
sharknx scan <area.line> |
Escanea una línea en busca de dispositivos |
sharknx progscan |
Encuentra dispositivos en modo de programación |
sharknx project |
Muestra los detalles del proyecto cargado. |
sharknx ip |
Muestra la dirección IP de este dispositivo |
sharknx run <script> [-y] |
Ejecuta un script guardado: sharknx <script> hace lo mismo |
Los scripts se guardan con Cómo usar alias y scripts del asistente. Un nombre de comando integrado siempre prevalece sobre un nombre de script.
Valores
write toma el valor en una de estas formas:
| Forma | Ejemplo | Medio |
|---|---|---|
| Número | 50, 21.5, -10 |
El valor en la unidad del tipo de punto de datos (para DPT 5.001, 50 es 50 %). Escríbalo sin %. |
| Palabra | on, off, comfort |
Un nombre de valor para el tipo de punto de datos. on y off funcionan sin proyecto. |
| Valor cotizado | "14:30", "255,0,0" |
Un valor formado por varias partes, como la hora, la fecha o el color. |
| Maleficio | 0x0AFF |
Bytes sin procesar, los más significativos primero, enviados tal como están |
El tipo de punto de datos proviene del proyecto ETS cargado. Sin proyecto, o para utilizar uno diferente, agregue --dpt, por ejemplo --dpt 9.001. Un valor cotizado siempre necesita un tipo de punto de datos conocido.
Algunos tipos de puntos de datos utilizan un valor de dos palabras:
| DPT | Valores |
|---|---|
| Control de interruptor 2.001 | control on, control off |
| 3.007 / 3.008 atenuación, persianas | up 1... up 7, down 1... down 7, stop |
| Control de escena 18.001 | recall 0… recall 63, save 0… save 63 |
Ejemplos
| DPT | Dominio |
|---|---|
| Interruptor 1.001 | sharknx write 1/2/3 on |
| atenuación 3.007 | sharknx write 1/2/3 up 3 --dpt 3.007 |
| Porcentaje 5.001 | sharknx write 1/2/3 50 --dpt 5.001 |
| Temperatura 9.001 | sharknx write 1/2/3 21.5 --dpt 9.001 |
| 10.001 hora del día | sharknx write 1/2/3 "14:30:00" --dpt 10.001 |
| Fecha 11.001 | sharknx write 1/2/3 "2026-07-10" --dpt 11.001 |
| Texto 16.000 | sharknx write 1/2/3 "hello" --dpt 16.000 |
| Número de escena 17.001 | sharknx write 1/2/3 5 --dpt 17.001 |
| Control de escena 18.001 | sharknx write 1/2/3 recall 5 --dpt 18.001 |
| Modo de climatización 20.102 | sharknx write 1/2/3 comfort --dpt 20.102 |
| Color RGB 232.600 | sharknx write 1/2/3 "255,0,0" --dpt 232.600 |
| Color RGBW 251.600 | sharknx write 1/2/3 "255,0,128,64" --dpt 251.600 |
Omita --dpt cuando el proyecto ya proporcione a la dirección del grupo ese tipo de punto de datos. Los tipos de puntos de datos admitidos se enumeran en Tipos de Datapoints Compatibles (DPTs).
Encadenamiento de comandos
Combine comandos en un mensaje para crear un plan:
| Conector | Ejecuta el siguiente comando |
|---|---|
; |
Después de que este termine, sea cual sea el resultado. |
&& |
Sólo si este tiene éxito |
|| |
Sólo si este falla |
| |
Si éste tiene éxito, transmitir tu resultado |
sharknx connect && monitor start
sharknx connect && write 1/2/3 21.5 ; write 1/2/4 22.0
sharknx se escribe una vez, al principio. Si connect falla, nada después de ejecutarse. sharknx monitor restart es lo mismo que monitor stop && monitor start.
Pasar un valor a
Sólo read pasa un valor. El comando después de | es un write sin valor; escribe el valor leído:
sharknx read 1/2/3 | write 4/5/6
Condiciones
Después de |, se puede ejecutar un paso solo si el valor leído cumple una condición: if <op> <value> : <command>, donde <op> es ==, !=, >, <, >= 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
El segundo ejemplo activa 0/0/9 cuando 0/0/1 lee arriba de 22.5 y lo desactiva en caso contrario.
Saltar confirmaciones
-y (o --yes) omite las confirmaciones ordinarias en un plan o guión:
- al principio -
sharknx -y connect && write 1/2/3 on- se aplica a todo el plan; - después de un paso -
sharknx connect && write 1/2/3 on -y- se aplica únicamente a ese paso.
No funciona con un solo comando y nunca omite una confirmación sólida: esos pasos se confirman juntos antes de que comience el plan.
Relacionado
- Cómo usar el asistente - solicitudes en inglés sencillo
- Cómo usar alias y scripts del asistente - guarda secuencias de comandos como scripts
- Formato de archivo de alias y scripts - sintaxis de script en archivos
- Límites - límites de plan y solicitud
