Integración TCP/UDP

Integración TCP/UDP

El protocolo TCP/UDP está pensado para dispositivos que utilizan un lenguaje de comandos sencillo directamente sobre un socket de red, sin API web ni modelo de registros: reproductores y matrices de audio profesionales (AUDAC XMP44 y módulos SourceCon), proyectores (PJLink), pantallas y amplificadores detrás de pasarelas RS-232 a IP, y placas de microcontroladores personalizadas. Usted define las tramas de comandos que HyperVisu envía al cambiar un valor, los patrones que extraen valores de las tramas de respuesta que devuelve el equipo y las tramas de consulta opcionales para el sondeo. Toda la lógica específica del equipo se gestiona en la configuración, sin requerir adaptaciones en el servidor.

Cada conexión corresponde a un dispositivo, ya sea mediante TCP (una única conexión persistente, mantenida abierta y reconectada automáticamente) o UDP (datagramas). En TCP, todos los objetos del dispositivo comparten ese único socket, lo cual es imprescindible para equipos que solo admiten un cliente simultáneo (como el XMP44).

Requisitos previos: la dirección IP y el puerto del dispositivo, su manual de comandos (sintaxis de tramas, delimitador, comandos y respuestas de estado) y determinar si envía cambios de estado de forma autónoma o requiere sondeo.

Conexiones. TCP/UDP admite múltiples conexiones: una conexión por dispositivo (consulte «Conexiones»). Campos:

La ventana Añadir conexión solicita el Nombre de la instancia, la Dirección del dispositivo, el Puerto, el Intervalo de sondeo (segundos), el Transporte y el Delimitador de trama (valores predeterminados 30, TCP · conexión persistente y \r\n). El resto de campos se encuentra en Tramas y temporización dentro de la conexión guardada: seleccione la nueva conexión, ajuste los parámetros y haga clic en Guardar conexión.

El botón Probar en la ventana Añadir conexión abre un socket hacia la dirección introducida. Esto confirma que el dispositivo es accesible, no que entienda la sintaxis de las tramas. En una conexión ya guardada, mientras el servicio mantiene abierta la única conexión del dispositivo, Probar informa del estado en tiempo real y del recuento de tramas entrantes y salientes sin abrir un segundo socket.

Vinculación de un objeto (consulte «Vinculación TCP/UDP» más abajo). Para cada objeto se define una Clave (Key): un texto breve que contienen todas las respuestas asociadas a este valor. Solo las tramas entrantes que contengan dicha clave se evaluarán con el patrón de coincidencia del objeto (en AUDAC, el identificador de respuesta: OG1, FREQ2). La comprobación distingue mayúsculas de minúsculas y la clave no puede contener :. Dos objetos pueden compartir la misma clave, por ejemplo un objeto de comando y su objeto de estado. La interfaz almacena <conexión>:<clave>. El resto corresponde a la cadena de tipo de datos del objeto, generada a partir de los campos del editor:

Las plantillas admiten ${value}, así como ${value:d} para redondear un valor escalado a un número entero (un control deslizante de 0–100 % en un dispositivo que requiere enteros), ${value:02d} para rellenar con ceros a la izquierda y ${value:1f} para un número fijo de decimales; en modo HEX se dispone de ${value:u8}, ${value:u16be}, ${value:u16le}, ${value:u32be} y ${value:u32le} para bytes de longitud fija. \r, \n, \t y \xNN son secuencias de escape de bytes. En modo ASCII, si una plantilla no incluye el delimitador, este se añade automáticamente.

Los patrones de coincidencia utilizan los siguientes identificadores; cualquier otro carácter se evalúa de forma literal:

El editor muestra la Trama enviada visualizando los caracteres de control (# | D001 | hv | SOG1 | 28 | U | <CR><LF>), junto con la cadena resultante guardada. La Trama enviada es una vista previa de prueba, no un registro de tráfico: cualquier ${value…} se sustituye por el valor de muestra 28, sin aplicar el formato ni el escalado, y en objetos con comandos ON/OFF independientes solo se muestra el comando ON. Tampoco incluye el delimitador que el servidor añade automáticamente en modo ASCII. Compruebe siempre el formato real con el dispositivo.

Comportamiento del sistema

• Dirección. Los objetos de Entrada procesan patrones (y realizan sondeo si tienen plantilla de consulta); los de Salida envían tramas; los de Entrada/Salida realizan ambas funciones (la respuesta de confirmación del dispositivo actualiza el estado, de forma análoga a los objetos de estado en KNX).
• Una trama para múltiples objetos. Cada trama recibida se comprueba con todos los objetos de entrada de la conexión que contengan su clave, lo que permite actualizar varios objetos con una sola trama. Las plantillas de consulta idénticas se envían una única vez por ciclo de sondeo.
• TCP. Tras un error de comunicación, la reconexión se realiza con intervalos crecientes; al restablecer la conexión, se relanzan las consultas si Leer todo al conectar está activo. Las tramas salientes se gestionan mediante una cola respetando el Retardo entre comandos.
• UDP. Cada datagrama equivale a una trama. Los envíos no solicitados requieren configurar el Puerto de escucha.
• Los comandos enviados mientras el dispositivo no está disponible fallan sin bloquear el sistema; la aplicación mantiene el último estado registrado.

Ejemplo práctico: reproductor multimedia AUDAC XMP44

El XMP44 escucha en el puerto TCP 5001, admite un solo cliente y utiliza tramas con la estructura # | D001 | <origen> | <comando> | <argumento> | <checksum> | <CR><LF> (se acepta el carácter literal U como suma de control). El ajuste de ganancia se realiza mediante SOG1 | <arg> con arg = 8 − dB; el equipo responde con una trama de estado … | OG1 | <arg> | …, que también emite automáticamente al modificar la ganancia desde el panel frontal. La reproducción y parada emplean dos comandos independientes (SPPLAY1, SPSTOP1).

1. Cree una conexión TCP/UDP (consulte «Conexiones»): dirección 192.168.1.60, puerto 5001, transporte TCP, delimitador \r\n, intervalo de sondeo 30. Haga clic en Probar y después en Crear conexión. Seleccione la conexión creada y, en Tramas y temporización, mantenga activado Leer todo al conectar y configure la trama de latido # | D001 | hv | GTPS | 0 | U | \r\n cada 120 s. Haga clic en Guardar conexión.

2. En Dispositivos, añada un widget de Audio «Reproductor XMP44» y seleccione esta conexión en Protocolo.

3. En el objeto volumen (Entrada/Salida): clave OG1, plantilla de comando # | D001 | hv | SOG1 | ${value:d} | U | \r\n, plantilla de consulta # | D001 | hv | GOG1 | 0 | U | \r\n, patrón de coincidencia \i | OG1 | \i\v, escala -1, offset 8 (de este modo, −20 dB se envía como 28 y un valor recibido de 28 se interpreta como −20 dB).

4. En el objeto reproducción (Salida, booleano): clave PLAY1, active Comandos distintos para ON y OFF: ON # | D001 | hv | SPPLAY1 | 0 | U | \r\n, OFF # | D001 | hv | SPSTOP1 | 0 | U | \r\n.

5. En el objeto título de pista (Entrada, texto): clave SON1, consulta # | D001 | hv | GSON1 | 0 | U | \r\n, patrón \i | SON1 | \i\a | .

6. Haga clic en Guardar objeto en cada uno de ellos, pulse Aplicar cambios en la barra lateral y confirme. Al mover el regulador de volumen se envía SOG1, la respuesta OG1 confirma el nivel en la interfaz y cualquier cambio físico en el panel frontal se actualiza en la aplicación.

💡 Consejo: Mantenga a mano la tabla de comandos del dispositivo: la clave corresponde al identificador de respuesta (OG1), que en AUDAC difiere del comando de control (SOG1).

Vinculación TCP/UDP

Los objetos TCP/UDP se configuran en el diálogo de ajustes del objeto (consulte «Ajustes de objetos, registro y notificaciones»). Secciones disponibles:

Direccionamiento de trama

Comandos enviados (objetos de salida)

Valores leídos (objetos de entrada)

Debajo de las secciones, Trama enviada muestra la trama resultante de prueba con los caracteres de control visibles (… | 28 | U | <CR><LF>), y Almacenado como detalla la cadena de configuración guardada. Las reglas de sintaxis de patrones, plantillas y el ejemplo práctico de AUDAC se detallan en la sección superior.