Comandos

Defina comandos personalizados de dispositivo y de software para un dispositivo GPS en Navixy y envíelos a demanda desde el widget Objeto.

El Comandos bloque le permite definir comandos personalizados para un dispositivo en Navixy y enviarlos a demanda desde el widget de Objeto o la aplicación X-GPS Mobile Use esta función para enviar una instrucción de nivel de firmware directamente a un dispositivo, como enviar un comando CAN o activar una salida, o para llamar a cualquier sistema externo que acepte solicitudes HTTP, como un canal de Slack, un servicio de notificaciones, un CRM o un punto de conexión de API personalizado. Una vez configurados, los comandos se pueden enviar con un solo clic.

El bloque Comandos admite dos tipos de comandos:

• Comando del dispositivo envía una cadena de instrucciones de nivel de protocolo directamente al dispositivo, por ejemplo, para enviar un comando CAN o activar una salida.

• Comando de software envía una solicitud HTTP POST con un cuerpo JSON a cualquier URL, e incluye opcionalmente datos actuales del dispositivo, como ubicación, velocidad o ID del dispositivo, en la carga útil.

Los comandos se guardan por dispositivo y permanecen disponibles para su uso repetido.

Cuándo usar Comandos en lugar de IoT Logic

Comandos está diseñado para acciones manuales y ad hoc dirigidas a un único dispositivo. Úselo cuando necesite enviar un comando puntual sin configurar un flujo de automatización.

Para el envío automatizado de comandos basado en reglas, como activar una acción del dispositivo o un Webhook cuando se supera un umbral de sensor, o enviar el mismo comando a varios dispositivos, use IoT Logic. Los nodos Acción del dispositivo y Webhook en IoT Logic proporcionan las mismas capacidades subyacentes con automatización completa de flujos y selección de múltiples dispositivos.

Configuración

Para configurar Comandos para un dispositivo, siga estos pasos:

1. Vaya a Dispositivos en la barra lateral izquierda.

2. Seleccione el dispositivo que desea configurar.

3. Localice y expanda el bloque Comandos .

Puede añadir varios comandos de cada tipo. Cada comando se guarda por separado.

Comandos del dispositivo

Un comando del dispositivo envía una cadena de instrucciones de nivel de protocolo directamente al dispositivo a través de su canal de comunicación.

Para añadir un comando del dispositivo, haga clic en Añadir comando del dispositivo en la parte inferior del bloque. Configure los siguientes campos:

1. Nombre del comando: una etiqueta para el comando tal como aparece en el widget de Objeto, por ejemplo, reinicio del dispositivo. Elija un nombre que describa claramente lo que hace el comando.

2. Cadena de comando: la cadena de instrucciones exacta que se envía al dispositivo, por ejemplo, cpureset.

Las cadenas de comandos válidas son específicas de cada dispositivo y las define el fabricante del dispositivo. Consulte siempre la documentación oficial de su modelo de dispositivo para encontrar las cadenas de comandos correctas. Introducir valores incorrectos puede tener efectos no deseados en el dispositivo.

Haga clic en Guardar para guardar el comando. Haga clic en Eliminar para eliminarlo.

Comandos de software

Un comando de software envía una solicitud HTTP POST con un cuerpo JSON a una URL que usted especifique. Puede ser un punto de conexión de servicio externo, como Slack, un receptor de webhook personalizado o cualquier API REST, o un punto de conexión de API de Navixy.

El cuerpo de la solicitud es JSON y debe estructurarse según lo que espera el punto de conexión de destino. Puede incluir atributos de datos del dispositivo en el cuerpo mediante la sintaxis {{attribute_name}} .

Los comandos de software se configuran en dos pestañas: General y Cuerpo.

Para añadir un comando de software, haga clic en Añadir comando de software en la parte inferior del bloque.

Pestaña General

Configure lo siguiente:

1. Título: una etiqueta para el comando tal como aparece en el widget de Objeto.

2. URL: la URL completa del punto de conexión al que se envía la solicitud POST, por ejemplo, https://hooks.slack.com/services/... o https://api.eu.navixy.com/v2/....

3. Encabezados: pares clave-valor enviados como encabezados de solicitud HTTP. Añada encabezados según sea necesario para el punto de conexión de destino. Haga clic en Añadir encabezado para insertar una nueva fila.

   • Use el encabezado Authorization para la autenticación basada en tokens, por ejemplo, Authorization establecido en Bearer your_token.

   • También se pueden usar otros métodos de autenticación admitidos por el destino, como Llaves API pasadas como parámetros de consulta en la URL.

Pestaña Cuerpo

El Cuerpo es donde compone la carga útil JSON. Escriba un JSON válido que coincida con el formato esperado por el punto de conexión de destino.

Para incluir datos del dispositivo en tiempo real en la carga útil, use la {{attribute_name}} sintaxis. Haga clic en el botón del selector de atributos en la esquina superior derecha del campo de cuerpo para abrir una lista con función de búsqueda de los atributos disponibles para el dispositivo. Al seleccionar un atributo se inserta el marcador de posición correspondiente {{attribute_name}} en el cuerpo en la posición del cursor.

Los atributos disponibles dependen del dispositivo específico y de los datos que transmite a la plataforma Navixy. Solo aparecen en la lista los atributos que el dispositivo envía realmente. Use el selector para evitar errores tipográficos o nombres de atributos incorrectos.

Haga clic en Guardar para guardar el comando. Haga clic en Eliminar para eliminarlo.

Ejemplo: enviar una notificación de Slack

Slack admite la recepción de mensajes de servicios externos mediante webhooks entrantes. Una vez que haya configurado un webhook en su espacio de trabajo de Slack y obtenido la URL del webhook (consulte la guía de webhooks entrantes de Slack), cree un comando de software con la siguiente configuración.

Pestaña General:

• Título: Notificar a Slack

• URL: su URL de Webhook entrante de Slack, por ejemplo, https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXX

• Encabezados: no se requieren encabezados

Pestaña Cuerpo:

{
  "text": "Dispositivo {{device_id}}: velocidad {{speed}} km/h en {{latitude}}, {{longitude}}"
}

Slack espera un objeto JSON con un campo text . Los marcadores de posición {{device_id}}, {{speed}}, {{latitude}}, y {{longitude}} se sustituyen por los valores actuales del dispositivo en el momento en que se envía el comando. Cuando se activa desde el widget de Objeto, el mensaje aparece en el canal de Slack configurado para su webhook.

Valores dinámicos de comandos

Una cadena de comando o el cuerpo de un comando de software pueden incluir un único <> marcador de posición para solicitar un valor cada vez que envíe el comando, en lugar de codificar un valor fijo.

• En un comando del dispositivo, añada <> dentro del campo Cadena de comando , por ejemplo, relay,<> para enviar un estado de relé diferente en cada envío.

• En un comando de software, añada <> dentro del campo Cuerpo , por ejemplo, {"value": "<>"}.

Solo se permite un <> marcador de posición por comando. Al guardar un comando con más de un marcador de posición, se muestra el error "Only one value is allowed per command. Remove the extra < >."

Cuando envía un comando que contiene <> desde el widget de Objeto, un cuadro de diálogo solicita el valor antes del envío. Consulte Enviar comandos desde el widget de Objeto para conocer el flujo completo.

Haga clic en el icono de ayuda del bloque Comandos para abrir Cómo funcionan los valores de comando, un resumen del <> .

Enviar comandos desde el widget de Objeto

Una vez guardados los comandos, aparecen en el bloque Comandos del widget de Objeto en el módulo Seguimiento.

Haga clic en el botón enviar situado junto al nombre de un comando para enviarlo. El bloque Comandos muestra todos los comandos del dispositivo y los comandos de software configurados para ese dispositivo.

• Si el comando no contiene un marcador de posición de valor dinámico, Navixy lo envía de inmediato. No hay cuadro de diálogo de confirmación.

• Si el comando contiene <>, se abre un cuadro de diálogo que le solicita introducir un valor. Introduzca un valor de hasta 500 caracteres y haga clic en Enviar para enviar el comando con el valor sustituido por <>. Los nodos Enviar El botón permanece deshabilitado hasta que introduzca un valor, y no se aceptan valores vacíos ni compuestos solo por espacios en blanco.

Después de que se ejecute el comando, Navixy muestra una notificación con el resultado:

• Comandos del dispositivo muestran únicamente si el comando se ejecutó correctamente, como { "success": true } o { "success": false }.

• Comandos de software muestran el nombre del comando y la respuesta sin procesar del punto de conexión de destino, como {status, body}. Las respuestas largas se desplazan dentro de la notificación.

Los comandos enviados también aparecen en el bloque Eventos recientes del widget de Objeto, con su resultado disponible en una vista expandible. Si el comando incluía un marcador de posición de valor dinámico, el título de la entrada también muestra el valor que se envió, por ejemplo, Actualizar estado <online>.

Los comandos son por dispositivo. Los comandos configurados para un dispositivo no aparecen en los widgets de Objeto de otros dispositivos. Para enviar comandos a varios dispositivos según reglas o condiciones, use IoT Logic.