Connector

La página Connector: la columna Comunicación, su árbol con la carpeta Controladores (los controladores añadidos a la estación, con sus líneas, brókeres, carpetas, dispositivos y tags) y la carpeta Servidores (el servidor OPC UA, el servidor Modbus y el bróker MQTT), el menú Nuevo… que recorre ese árbol, las dos identidades que lleva cada tag, y los permisos y bloqueos que gobiernan la edición.

Ver como Markdown

El Connector es donde un equipo de campo se convierte en datos que el resto de la aplicación puede leer. Es la página Connector de la barra de navegación, y se abre para cualquier rol que tenga Ver Connector. La página combina la columna Comunicación a la izquierda, un árbol de todo aquello con lo que habla el Connector, con un panel de detalle a la derecha que edita aquí mismo el nodo seleccionado; como dice la descripción de la propia página, "Seleccione un nodo para editarlo aquí mismo. Los cambios se guardan automáticamente."

La columna Comunicación

La columna se titula Comunicación y lleva, de arriba abajo: un cuadro de búsqueda con cuatro fichas de estado, el árbol y un pie con los comandos de la columna. El árbol tiene en su nivel superior dos carpetas del mismo tipo, la carpeta Controladores y la carpeta Servidores, y las dos están abiertas cuando se abre la página.

La carpeta Controladores

La primera carpeta lleva los controladores añadidos a la estación, listados planos y por orden alfabético, tengan algo debajo o no. La fila de la carpeta dice Controladores, luego cuántos dispositivos tienen los controladores de debajo ("3 dispositivos") y luego un punto de estado de salud que resume esos controladores. Seleccionarla abre el catálogo de todos los controladores que lleva esta estación, primero los añadidos, bajo En esta estación, y luego los demás agrupados por los equipos que alcanzan, donde un controlador se añade y se quita; los dos verbos están descritos en La lista de controladores y la página de un controlador.

Situación	Lo que queda bajo Controladores
Una estación nueva	Ningún controlador. La columna se abre con la carpeta Controladores seleccionada, así que el catálogo es lo primero que se ve.
Una estación actualizada desde una versión anterior	Los controladores que ya usaba: todo controlador que tiene un dispositivo, una línea serie, un bróker o una carpeta.
Un controlador añadido (Añadir controlador en su fila del catálogo, o Nuevo… > Añadir controlador)	El controlador, sin nada debajo, resaltado en el catálogo bajo En esta estación (la carpeta Controladores sigue en pantalla): su fila dice "0 dispositivos" ("0 líneas · 0 dispositivos" en Modbus RTU, "0 brókeres · 0 dispositivos" en MQTT).
Se elimina el último dispositivo, la última línea serie, el último bróker o la última carpeta de un controlador	El controlador se queda, de vuelta en "0 dispositivos".
Un controlador quitado (Quitar el controlador en su fila del catálogo, en su barra o en su menú del clic derecho)	Nada: el controlador sale del árbol y su fila del catálogo vuelve a su categoría. Quitar no elimina nada, así que se rechaza mientras el controlador tiene un dispositivo, una línea serie, un bróker o una carpeta, y un controlador que tiene alguno de ellos siempre está añadido.
Un controlador que este paquete no lleva, nombrado por un dispositivo guardado	El controlador y sus dispositivos, mientras exista alguno de ellos.

La carpeta Servidores

La segunda carpeta lleva lo que la estación abre en la red, a lo que se conectan otros sistemas y dispositivos: el Servidor OPC UA, que publica los dispositivos y sus tags para los clientes OPC UA, el Servidor Modbus, del que los PLC, las HMI y los sistemas de edificio leen los tags y las variables de Logic de la estación, y el Bróker MQTT, que recibe los mensajes que publican los dispositivos de la red. Las tres filas están siempre ahí, en ese orden. El acceso remoto, que abre los propios paneles de control de la estación en un navegador de otro dispositivo, no está aquí: tiene una página propia en la barra de navegación, Acceso remoto. Ninguna es un controlador ni tiene hijos; cada una muestra su propio estado ("Apagado" en toda estación nueva) junto a un punto, verde mientras escucha y rojo cuando está encendida pero no se alcanza, y ninguno de los puntos se suma a la carpeta Controladores ni a la barra de estado. Seleccionar una abre su panel; las tres se describen en Servidores. La fila de la propia carpeta no lleva recuento ni punto, y seleccionarla no abre ningún panel, solo la frase "Seleccione un servidor para ver su estado y su configuración."

La búsqueda y las fichas de estado

Control	Qué hace
Cuadro de búsqueda ("Buscar controlador o tag")	Reduce el árbol a las filas cuyo nombre contiene el texto, sin distinguir mayúsculas. Una coincidencia en un controlador, en una línea serie, en un bróker o en una carpeta conserva todo lo que hay debajo, y también una coincidencia en el nombre de una de las dos carpetas superiores: "Controladores" conserva todos los controladores añadidos, "Servidores" sus tres filas. Una línea serie coincide además por su tupla física (puerto, velocidad, formato, tiempo de espera), un bróker por su dirección y un servidor por su nombre. Las ramas que coinciden se despliegan según se escribe.
Todos	Sin reducción por estado.
Correctos	Los dispositivos, las líneas y los brókeres habilitados y en línea, o aún sin nada que juzgar, incluido un dispositivo cuyo host aún no se ha indicado, con sus tags habilitados; los tags habilitados que están leyendo ahora mismo una medida dentro de sus límites; un servidor encendido que no ha fallado al iniciarse.
Con problemas	Los dispositivos, las líneas y los brókeres habilitados pero Sin conexión o Parcialmente en línea; los tags habilitados que no tienen ningún valor (salvo si quedan fuera del estado de salud del dispositivo porque su primer valor desde que el dispositivo se conectó aún no ha llegado), que tienen un valor sustituto, un valor fuera de sus límites o una lectura que enmudeció, en un dispositivo que la estación está leyendo; un servidor encendido que no se pudo iniciar (el servidor Modbus también cuando otro programa ocupa su puerto).
Apagado	Los dispositivos, las líneas, los brókeres y los tags deshabilitados, y todos los tags de un dispositivo deshabilitado. Un dispositivo bajo una línea serie o un bróker deshabilitados cuenta como apagado, y sus tags también. Un servidor apagado cuenta como apagado.

Una ficha y el texto de búsqueda se combinan. El nodo seleccionado siempre queda visible, así que el panel nunca edita una fila que no puede verse. Un controlador sin nada debajo o solo con una carpeta vacía, y la carpeta Controladores mientras no lleva ningún controlador, solo aparecen bajo Todos, o cuando la búsqueda coincide con su propio nombre.

El árbol

Las formas, decididas por controlador:

Todos los controladores menos Modbus RTU y MQTT: Controlador > Carpeta (hasta dos niveles) > Dispositivo > Tag. Las carpetas van primero, por orden de nombre, y luego los dispositivos archivados en el nivel del propio controlador.
Modbus RTU: Controlador > Línea > Dispositivo > Tag. Los dispositivos cuelgan de la línea física que comparten y no llevan carpeta.
Generic serial and TCP: las dos a la vez. Sus líneas serie van primero, cada una como Controlador > Línea > Dispositivo > Tag, y después sus carpetas y sus dispositivos de red, como en cualquier otro controlador.
SCPI instruments: lo mismo, primero sus líneas serie y después sus carpetas y los dispositivos alcanzados por TCP o VISA.
Omron: lo mismo, primero sus líneas serie y después sus carpetas y los autómatas alcanzados por la red.
MQTT: Controlador > Bróker > Dispositivo > Tag. Los dispositivos cuelgan del bróker cuya conexión comparten y no llevan carpeta.

Bajo la carpeta Controladores, los controladores se listan planos, por orden alfabético, sin grupos por categoría. Los tags de un dispositivo también se listan por nombre, sin importar mayúsculas o minúsculas, en el árbol y dentro de cada grupo de tipo de la rejilla del dispositivo; un tag añadido o renombrado ocupa su lugar en el acto. Un controlador está en el árbol desde que se añade hasta que se quita, tenga lo que tenga debajo. Cada fila resume lo que hay debajo:

Fila	Muestra
Controlador	El nombre, "3 dispositivos" (Modbus RTU, y Generic serial and TCP, SCPI instruments u Omron en cuanto tiene una línea: "1 línea · 2 dispositivos"; MQTT: "1 bróker · 2 dispositivos") y el punto de salud.
Línea serie	El nombre, una marca de error cuando el puerto falló, el texto de estado y el recuento de dispositivos ("En línea · 2 dispositivos") y el punto de salud.
Bróker	El nombre, una marca de error cuando no se puede alcanzar el bróker, el texto de estado y el recuento de dispositivos ("En línea · 2 dispositivos") y el punto de salud. Véase MQTT.
Carpeta	El nombre, "2 dispositivos" o "vacío", y el punto de salud resumido de todos los dispositivos que contiene, subcarpetas incluidas.
Dispositivo	El nombre, una marca de error que lleva el último error como información emergente, luego "4 tags configurados", o "Esperando la aprobación del certificado", o "Host aún sin indicar" ("Dispositivo NI-DAQmx aún sin indicar" en un dispositivo NI-DAQmx, "Carpeta aún sin indicar" en un dispositivo File, "Servidor aún sin indicar" en un dispositivo Database, "DevEUI aún sin indicar" o "EUI de la estación aún sin indicar" en un dispositivo LoRaWAN), o "Este paquete no incluye el controlador.", y luego el punto de salud.
Tag	Un glifo del tipo de dato (numérico, booleano, fecha, texto), el nombre, una marca de error cuando falló la última lectura y un punto en vivo: ámbar cuando el valor es un sustituto, cuando la etapa Límites levantó una falta o cuando la lectura enmudeció, verde mientras el tag tiene un valor, gris en los demás casos, y gris, muestre lo que haya mostrado por última vez, en un tag que la estación no lee: uno deshabilitado, o uno cuyo dispositivo está deshabilitado, cuelga de una línea deshabilitada o aún no tiene host indicado.

Los colores de los puntos y los textos se explican en Habilitación y estado de salud. Hacer clic derecho en una fila la selecciona y abre un menú que refleja la barra de comandos de ese nodo; una fila en la que el rol no puede hacer nada no abre menú. El separador entre la columna y el panel se arrastra para cambiar el tamaño.

Comando	Qué hace	Gris cuando (situación)	No se dibuja cuando (rol)
Nuevo…	Abre el menú de la columna, el mismo sea cual sea la fila seleccionada: Añadir controlador y luego una entrada por cada controlador añadido, que recorre el árbol hasta el Nuevo tag de un dispositivo (vea El menú Nuevo…).	Un ensayo retiene la estación o el runtime está detenido (la información emergente lleva el motivo), o hay una exploración de descubrimiento o un emparejamiento Matter en curso ("Termine la exploración o el emparejamiento en curso antes de añadir nada.").	Sin Configurar Connector.
Expandir todo / Contraer todo	Abre o cierra todas las ramas, las dos carpetas superiores y los grupos de controladores incluidos. Contraer todo deja la columna en sus dos carpetas, Controladores y Servidores.	Nunca: la carpeta Servidores siempre tiene sus tres filas que abrir.	Nunca.

El menú lee el árbol, nunca la selección. Se abre con Añadir controlador y luego, tras un separador, una entrada por cada controlador añadido, en el orden del árbol. La entrada de un controlador lista primero lo que puede crearse bajo él y luego, tras un separador, las filas propias del controlador, cada una a su vez un submenú de lo que admite y de lo que lleva, hasta un dispositivo y su Nuevo tag. Ningún elemento nombra dónde aterriza: lo dice el camino que llevó hasta él.

Entrada	Lo que lista	Lo que hacen sus elementos
Añadir controlador	Los controladores que lleva este paquete y que aún no están añadidos, por su nombre, bajo el nombre de su categoría en el orden del catálogo Controladores.	Añade el controlador como el Añadir controlador del catálogo: la pantalla va a la carpeta Controladores, cuyo catálogo resalta la fila del controlador, con el controlador bajo la carpeta en el árbol. Cuando todos los controladores están añadidos, la entrada sigue ahí, en gris: "Todos los controladores que incluye esta estación ya están añadidos."
Un controlador	En este orden, lo que el controlador admite: Nuevo dispositivo (todo controlador cuyos dispositivos cuelgan directamente de él, es decir, no Modbus RTU, MQTT ni Matter), Nueva línea serie (Modbus RTU, Generic serial and TCP, SCPI instruments, Omron), Nuevo bróker (MQTT), Emparejar dispositivo (Matter) y Nueva carpeta (todo controlador cuyos dispositivos admiten carpetas, es decir, no Modbus RTU ni MQTT); luego sus líneas serie, brókeres, carpetas y dispositivos, como los dibuja el árbol.	Cada uno hace lo que hace el mismo verbo en la página del controlador. Emparejar dispositivo abre el formulario de emparejamiento en la página de Matter, y sigue en gris con "Añada primero la red a la que se va a unir el dispositivo." mientras ninguna red de la tarjeta Redes sirve.
Una línea serie o un bróker	Nuevo dispositivo, luego sus dispositivos.	Crea un dispositivo en esa línea o en ese bróker.
Una carpeta	Nuevo dispositivo (bajo Matter abre el formulario de emparejamiento, y el dispositivo emparejado se archiva en esa carpeta) y Nueva subcarpeta (solo en una carpeta del primer nivel), luego sus subcarpetas y sus dispositivos.	Crea el dispositivo, o la subcarpeta, dentro de esa carpeta.
Un dispositivo	Nuevo tag.	Añade un tag al dispositivo, como su Añadir tag: la pantalla va a la página del dispositivo, con el tag resaltado en su rejilla de tags.

Ninguna creación abre lo que creó: la pantalla va a la página de su padre (la carpeta Controladores, el controlador, la línea, el bróker, la carpeta o el dispositivo), el árbol selecciona ese padre y lo despliega, y la fila nueva queda resaltada en la tabla del padre y desplazada hasta quedar a la vista. El resaltado se mantiene hasta que elija otra cosa; el Abrir de la fila, o su fila en el árbol, abre el elemento. Bajo un controlador que este paquete no lleva, todo elemento salvo Nuevo tag sigue en gris con "Este paquete no incluye el controlador." El menú no crea servidores, porque la carpeta Servidores lleva las tres filas que tiene la estación, y no lista tags. Cada nombre ocupa una sola línea y una lista larga se desplaza. Un submenú sigue abierto mientras el puntero cruza otras filas camino de él: se pliega, o deja paso a otro, solo cuando el puntero ha reposado cerca de un tercio de segundo en otro sitio, y un clic cambia en el acto. Mover a una carpeta un dispositivo que ya existe es un comando del dispositivo, descrito en Carpetas de dispositivos.

El panel de detalle

Sin nada seleccionado, el panel dice "Seleccione un controlador, una línea serie, un dispositivo o un tag en el árbol para inspeccionarlo y editarlo. Los cambios se guardan automáticamente." La carpeta Controladores abre el catálogo, la carpeta Servidores dice "Seleccione un servidor para ver su estado y su configuración.", y cualquier otro nodo abre el panel documentado en su propia página, más abajo.

Las ediciones se guardan solas: un campo de texto o de número se guarda al salir de él (o al pulsar Entrar), un conmutador o una casilla al cambiarlo, un desplegable al elegir. Las ediciones rápidas sobre un mismo dispositivo se agrupan en un único guardado, medio segundo después de la última. Un guardado que la estación rechaza se devuelve a lo que tiene la base de datos y el motivo aparece en el registro de acciones, al pie de la ventana; una edición que dejaría el dispositivo inservible (un nombre en blanco) no se guarda, y el panel dice qué falta. Mientras la página está abierta, los valores del árbol y de los paneles se refrescan una vez por segundo.

Clave de bus y dirección: las dos identidades de un tag

Cada tag lleva dos nombres, y la diferencia decide lo que cuesta un cambio.

La clave de bus es <Controlador>.<Dispositivo>:<Tag>, por ejemplo ModbusTcp.Furnace:Temperature. Es lo que el Connector sondea y el servidor OPC UA integrado publica, aquello a lo que se vincula un canal de Process y el nombre que ven los clientes OPC UA externos. La parte del dispositivo es la clase del controlador más el nombre del dispositivo con cada carácter que no es letra ni dígito sustituido por un guion bajo. La clave de bus ignora las carpetas: archivar un dispositivo en otro sitio no cambia nada en el bus.

La dirección es Connector.<Controlador>.<Carpetas…>.<Dispositivo>.<Tag>, por ejemplo Connector.Simulated.Air.CompressedAir.HeaderPressure. Es la ruta que muestra el árbol, con cada segmento higienizado de la misma forma (un dígito inicial recibe un guion bajo delante), y es lo que escriben las expresiones de Logic, los scripts, las condiciones de alarma y los vínculos de los paneles de control. Renombrar un dispositivo o un tag, archivar un dispositivo en una carpeta, y renombrar o quitar una carpeta son todos cambios de dirección, y la aplicación reescribe en la misma operación todos los consumidores de la dirección antigua; los campos de nombre muestran de antemano cuántas referencias van detrás. El espacio de direcciones de Logic lee esas mismas direcciones.

Los nombres de dispositivo solo tienen que ser únicos dentro de su controlador, sin distinguir mayúsculas: un dispositivo Modbus TCP y un dispositivo OPC UA pueden llamarse los dos Furnace, porque sus identidades de bus son ModbusTcp.Furnace y OpcUa.Furnace. Dos dispositivos habilitados bajo un mismo controlador cuyos nombres se normalizan al mismo segmento técnico (Line A y Line-A) chocan, y los dos quedan fuera del sondeo en vez de ganar uno; sus filas no leen ningún valor hasta que uno se renombra o se deshabilita. Una identidad técnica de dispositivo está limitada a 128 caracteres. Bajo un mismo controlador, una carpeta y un dispositivo del mismo nivel tampoco pueden higienizarse al mismo segmento, porque una dirección no puede ser a la vez una rama que se despliega y un punto que se lee.

No hay importación ni exportación aparte del árbol del Connector: la configuración viaja con las copias de seguridad de la aplicación.

Los límites de ingeniería

El Connector nunca deja de ser una superficie de lectura en vivo, pero su configuración se rechaza en dos situaciones, y la página dice cuál:

Un ensayo de Process retiene la estación. Un aviso titulado "Ingeniería bloqueada" explica que hay una operación de unidad activa y que la configuración sigue siendo de solo lectura hasta que terminen todas las unidades, mientras los mandos del ensayo y las demás acciones del operador siguen disponibles. Todos los verbos que modifican siguen dibujados y en gris con el motivo "La configuración está bloqueada mientras una unidad está en marcha."
El runtime está detenido. Un aviso titulado "Runtime detenido" dice que la adquisición, la lógica y la grabación están en pausa y que todos los cambios se rechazan hasta que se reinicie el runtime, con la configuración y los ensayos grabados intactos. Los mismos verbos se ponen en gris con el motivo "Runtime detenido", y los valores del árbol se convierten en huecos al pararse la comunicación.

Leer, buscar, seleccionar, las acciones de fila Abrir y Copiar el valor de un tag siguen disponibles en las dos situaciones.

Permisos

Tres bits del Connector, listados enteros en Permisos, deciden lo que dibuja la página:

Permiso	Qué abre
Ver Connector	La página, el árbol y todos los paneles en solo lectura. Los editores quedan inertes con una nota encima: "Cambiar Connector requiere el permiso “Configurar Connector”." Los verbos que el rol no podrá usar nunca no se dibujan en absoluto: Nuevo…, Añadir controlador y Quitar el controlador, Añadir y Emparejar, Habilitar y Deshabilitar, Reconectar, Copiar el dispositivo, el grupo Eliminar, los grupos de acciones de fila más allá de Abrir, Añadir tag, Descubrir tags, las casillas de edición masiva, el campo de escritura y el aparato de Sustituir. Actualizar, Abrir y Copiar el valor se quedan.
Calibrar tags	Todo lo que da Ver, más la etapa de Calibración de un tag: su casilla, sus dos campos y su asistente de dos puntos. Nada más pasa a ser editable; véase Calibración.
Configurar Connector	La página entera: añadir y quitar controladores, crear, cambiar, habilitar, deshabilitar y eliminar líneas serie, brókeres, carpetas, dispositivos y tags, el descubrimiento, el emparejamiento, las escrituras, la sustitución de referencias, el servidor OPC UA con su configuración y su acceso de clientes, el servidor Modbus con su mapa de registros, y el bróker MQTT con su autenticación.

Cada comando vuelve a leer el permiso cuando se ejecuta, así que un verbo dibujado para un rol que ha cambiado desde entonces se rechaza con el mismo mensaje en lugar de ejecutarse.

En esta área

Página	Cubre
La lista de controladores y la página de un controlador	El catálogo de todos los controladores de la estación en la carpeta Controladores, la página de un controlador con su tabla de dispositivos y sus verbos, y el estado "Controlador no incluido en este paquete".
Servidores	El servidor OPC UA, el servidor Modbus y el bróker MQTT: encender y apagar cada uno, la configuración y el acceso de clientes del servidor OPC UA, el puerto, los clientes y el mapa de registros del servidor Modbus, y el puerto, los clientes y la autenticación del bróker MQTT.
Líneas serie	La línea serie de Modbus RTU, del controlador Generic serial and TCP, del controlador SCPI instruments y del controlador Omron: su tupla física, sus tiempos, sus estados, la exploración de ID de unidad y los dispositivos archivados debajo.
Carpetas de dispositivos	Crear, renombrar, quitar y mover dispositivos entre carpetas, y cómo una carpeta compone la dirección.
Dispositivos	La página del dispositivo: cabecera y verbos, las tarjetas Dispositivo y Conexión de cada controlador, credenciales y certificados, y la rejilla de tags con la edición masiva, las copias y los choques.
Tags	La página del tag tarjeta a tarjeta: General, Fuente por controlador, Conversión, Valor en vivo y Usado por.
La cadena de conversión	La conversión tipada de una lectura bruta al valor de ingeniería, y lo que muestra una lectura que falta.
Calibración	La etapa de Calibración, el asistente de dos puntos paso a paso, y lo que permite Calibrar tags por sí solo.
Descubrimiento	Dejar que un controlador explore en busca de dispositivos o de puntos, revisar los candidatos, añadirlos y emparejar un dispositivo Matter.
Habilitación y estado de salud	Qué participa en la adquisición en cada nivel, los puntos, las fichas, la barra de estado, el último error, Reconectar y Actualizar.

Los propios controladores, una página por protocolo con sus campos de conexión, su direccionamiento, sus tipos, su descubrimiento y su comportamiento de escritura, están agrupados en Controladores.