Descubrimiento

Dejar que un controlador explore en busca de dispositivos o de puntos, qué necesita y qué devuelve cada exploración, el progreso y la cancelación, añadir resultados, descubrir desde su propia página los tags que le faltan a un dispositivo, y emparejar un dispositivo Matter por Bluetooth.

Para los controladores cuyo protocolo admite una exploración de verdad, Descubrir encuentra por usted los dispositivos o los puntos en lugar de obligarle a escribirlos. Vive en la barra de comandos de un nodo de controlador (y, en Modbus RTU, en la tarjeta Descubrir unidades de la página de una línea serie, y en MQTT, en la tarjeta Descubrir dispositivos de la página de un bróker), mientras que todo lo que la exploración toma vive en la tarjeta Alcance de la exploración de la página del controlador: la barra lleva el comando, la tarjeta lleva su alcance. Todo ello exige Configurar Connector: a un rol sin ese permiso no se le dibujan ni la tarjeta del alcance ni el botón. Una exploración se rechaza mientras un ensayo retiene la estación o el runtime está detenido. Cuando una exploración no devuelve nada, eso es un resultado de la exploración y no una función que falte: el botón aparece solo donde una exploración puede producir resultados. Un dispositivo que ya tiene encuentra desde su propia página los puntos que todavía le faltan, con Descubrir tags en la cabecera de su tarjeta de tags (vea Descubrir los tags de un dispositivo).

Qué controladores exploran

Beckhoff ADS, Mitsubishi MC, LoRaWAN, HTTP y Generic serial and TCP no tienen exploración y no muestran ningún botón. El botón aparece solo una vez que el Connector está en marcha, porque es el registro de controladores del Connector el que responde si una exploración puede correr, y aparece solo para los controladores que instala esta versión: si el registro responde con un ensamblado que la aplicación no reconoce, el botón no se dibuja y la página Eventos anota que el controlador instalado no es el que trae esta versión.

Modbus TCP: la tarjeta Alcance de la exploración

La tarjeta aparece en la página del controlador Modbus TCP: "Identificación del dispositivo en solo lectura; los registros se configuran después de añadirlo."

La línea que hay bajo los campos es el presupuesto: "2 direcciones × 3 ID de unidad = 6 sondeos · límite 256", con "· 100 ms de silencio por host." cuando se fija. Una exploración puede enviar como mucho 256 sondeos; por encima del presupuesto la línea se pone roja ("Esta exploración enviaría 512 sondeos; reduzca el rango de red o de ID de unidad a 256 o menos.") y Descubrir se pone en gris. La entrada incorrecta se nombra igual ("'10.0.0' no es una dirección IPv4 válida de cuatro octetos.", "El prefijo CIDR debe estar entre /24 y /32.", "Escriba al menos un id de unidad (0-255).", "El rango de ID de unidad '9-3' debe ser ascendente."). Cambiar cualquier campo del alcance descarta los resultados de la exploración anterior, porque describían otro alcance. Se exploran como mucho cuatro direcciones a la vez, con una conexión por dirección.

Modbus RTU

La exploración está en la página de la línea, no en la del controlador: ID de unidad inicial e ID de unidad final (de 1 a 247, ascendentes; de 1 a 32 por defecto) y su propio botón Descubrir, con una estimación del peor caso ("32 sondeos · hasta ~32,1 s, incluidos 4,011 ms de silencio antes de cada sondeo."). La exploración abre el puerto una vez con los ajustes guardados de la línea, sondea cada unidad por turno, y rechaza una línea activa en lugar de interrumpirla: "Esta línea está en uso. Deshabilítela antes del descubrimiento; Ganter Lab no interrumpirá ni volverá a habilitar el bus automáticamente." Una edición pendiente en la línea se guarda antes de que arranque la exploración; si no se puede guardar, la exploración no arranca ("El descubrimiento no se inició porque no se pudo guardar la edición de la línea serie."). La página Líneas serie cubre el resto de esa tarjeta.

Redfish y AVEVA PI: el servicio que lee la exploración

Ni un servicio Redfish ni un PI System se anuncian en una red que esta estación pueda escuchar, así que esas dos exploraciones leen el único servicio al que se las apunta, en la tarjeta Alcance de la exploración de la página del controlador. Redfish toma la dirección del servicio (https://bmc-host, o https://bmc-host:8443 donde responda en otro puerto) y siempre la lee por HTTPS, porque las credenciales del dispositivo viajan en cada petición; una dirección que pide el transporte en claro se rechaza allí donde se escribe. AVEVA PI toma la dirección del servicio y, tras un #, el elemento AF donde empieza el recorrido: https://pi-host/piwebapi#\\AF-SRV\Plant\Line 3. Sin ese elemento no hay nada que recorrer, así que Descubrir se pone en gris y dice qué se espera.

Las dos exploraciones leen el servicio sin credenciales, porque corren antes de que exista el dispositivo que las guardaría. Un servicio que autentica cada petición no responde nada y la exploración no encuentra nada: añada ese servicio a mano. Después, un dispositivo Redfish encuentra sus puntos con Descubrir tags en su propia página, que inicia sesión como lo hace el dispositivo; los puntos de un dispositivo AVEVA PI se añaden a mano.

Correr una exploración

Mientras la exploración corre, la página del controlador imprime una línea de estado y el Descubrir de la barra se convierte en Cancelar. El estado viene de dos etapas independientes, el descubrimiento de endpoints y el recorrido de canales: "Explorando los endpoints…", "Inspeccionando el endpoint 2…", "Leyendo los canales de opc.tcp://plc:4840…", y luego "Se encontraron 3 dispositivos."; un controlador que lleva una exploración propia informa hasta dónde llegó y la página cuenta, "Progreso del descubrimiento: 1 de 2…", mientras que las dos exploraciones Modbus escriben la línea entera, porque el puerto, la dirección y el ID de unidad son lo que lee quien las sigue: "Explorando COM7 · 32 sondeos…", "Sondeando la unidad 5 (5 de 32)…", "Sondeo 5 de 32; unidad 5 comprobada.", "Exploración terminada: 32 sondeos." en una línea serie, y "Explorando 2 direcciones × 3 ID de unidad…", "Sondeando 192.168.0.10:502 · unidad 3…", "Dirección inaccesible 192.168.0.11:502 omitida." en una red; la exploración Rockwell nombra las redes por donde salió la difusión, "Buscando autómatas Rockwell en 192.168.0.255, 10.0.0.255…", de modo que un resultado de cero dice adónde fue la pregunta. Una exploración que se detiene por un error del controlador conserva lo que encontró y lo dice: "La exploración se detuvo con un error después de encontrar 1 dispositivo. La lista puede estar incompleta." Un endpoint cuyos canales no se pudieron leer se lista igualmente, con cero tags.

La exploración se apropia del controlador mientras corre: no se puede seleccionar otro nodo ("Cancele el descubrimiento antes de salir de este controlador."), ni añadir un dispositivo o una línea, ni habilitar o deshabilitar líneas, ni usar las acciones de fila hasta que termine. Los resultados son de la ventana que arrancó la exploración: otra pestaña del navegador en la misma estación no los ve.

Cancelar

Cancelar ("Cancelando…" una vez pulsado) detiene las dos etapas. Los candidatos preparados por completo antes de la cancelación se quedan en la lista; el endpoint cuyos canales todavía se estaban leyendo se descarta. El estado se lee "Descubrimiento cancelado." y el registro de acciones "Descubrimiento cancelado para OPC UA; se conservan 2 resultados completados." La exploración sigue ocupada hasta que el zócalo, el cliente o la sesión temporales del controlador se hayan cerrado; pasados dos segundos el estado dice "Esperando a que el controlador libere sus recursos de descubrimiento…" en lugar de fingir que la exploración ya se detuvo, porque un controlador no siempre suelta en el mismo instante en que se le pide.

Los resultados

La tarjeta Dispositivos descubiertos (en una línea, Unidades descubiertas) lista una tarjeta por candidato: un nombre editable, el endpoint y "2 de 5 tags seleccionados". Debajo, una rejilla compacta de los tags candidatos con una marca Añadir (encendida por defecto), Nombre del tag, Tipo y Acceso; sin ninguno, "No se informó de ningún tag. Añada el dispositivo para configurar sus tags en el editor." Donde el controlador da a un tag un nombre más corto que el lugar donde encontró el canal, la celda Nombre del tag muestra ese lugar en una segunda línea bajo el nombre: en OPC UA, la ruta completa del nodo (vea OPC UA). Nada se guarda hasta que se pulsa Añadir dispositivo en una tarjeta ("Añadiendo…" mientras corre): el dispositivo se crea con un nombre único en el controlador y exactamente con los tags marcados, la tarjeta deja la lista, el dispositivo nuevo queda resaltado en la tabla Dispositivos de la página donde corrió la exploración, que sigue en pantalla, y el registro de acciones se lee "Se añadió 'Pump' con 3 tags." Los tags descubiertos llegan de solo lectura o de escritura tal como los informó el controlador, con su tipo y con la cadena de conversión por defecto; nada más se deduce.

Un candidato que coincide con un dispositivo que ya se tiene se marca como Ya configurado y ofrece Abrir en lugar de Añadir, así que una exploración nunca crea un duplicado por accidente. Solo se comparan identidades estables: una unidad Modbus RTU en la misma línea, un nodo de borde o dispositivo Sparkplug B en el mismo bróker, un instrumento SCPI con el mismo recurso VISA, un dispositivo NI-DAQmx con el mismo nombre de NI MAX, un agente SNMP explorado a través de su dispositivo o en el mismo host y puerto, un archivo leído de la misma carpeta, con el mismo nombre y de la misma manera por un dispositivo File, una base de datos explorada a través de su propio dispositivo Database, una CPU Siemens en el mismo host que un dispositivo que la lee por nombre, y un id de nodo Matter. Los demás controladores no comparan nada, porque un endpoint alcanzable no demuestra que sea el mismo equipo. Un dispositivo Matter, un agente SNMP, un dispositivo File, un dispositivo Database o un dispositivo Siemens que lee por nombre configurado todavía admite algo: su tarjeta lista, marcados, los valores que el dispositivo publica y para los que aún no tiene tag, y Añadir tags, antes de Abrir, añade los marcados a ese dispositivo (véase Matter, SNMP, File, Database y Siemens S7).

Descartar vacía la lista, y espera a la exploración: mientras hay una en marcha se pone en gris, porque vaciar la lista a mitad de una exploración también la cancela y tira todo lo que ya había contestado. Seleccionar otro controlador, o cambiar el alcance, también la vacía. Mientras corre una exploración, eliminar un dispositivo o un tag y mover un dispositivo a una carpeta se ponen en gris por la misma razón: la exploración retiene el controlador, y el comando habría fallado después de confirmarlo. En Modbus RTU el ID de unidad es una columna propia, y un id ya configurado en la línea se rechaza al añadirlo: "La unidad 5 ya está configurada en 'Línea 1'."

Descubrir los tags de un dispositivo

Un dispositivo que ya tiene lee más de sus puntos sin volver a la página de su controlador: la cabecera de su tarjeta de tags lleva Descubrir tags junto a Añadir tag, siempre que su controlador pueda leer los puntos de un solo dispositivo. La exploración lee solo ese dispositivo, tal como está guardado (una edición que todavía espera su guardado se guarda primero), y lista solo los valores que publica y para los que todavía no tiene tag, comparados por el punto que lee cada uno y nunca por el nombre: un valor que el dispositivo ya lee con otro nombre no se vuelve a ofrecer.

AVEVA PI no muestra Descubrir tags: su recorrido empieza en un elemento AF, que ningún dispositivo guarda, así que sus puntos vienen del Descubrir del controlador o se añaden a mano. Modbus, BACnet, Omron, SCPI y los controladores sin exploración no encuentran puntos y tampoco lo muestran.

Mientras la exploración corre, Descubrir tags se convierte en Cancelar, una línea de estado aparece sobre la tarjeta de tags, y la exploración retiene el controlador exactamente como lo hace el Descubrir del propio controlador: los comandos que necesitan el controlador siguen dibujados, atenuados, y dicen por qué. Descubrir tags se atenúa a su vez mientras la estación no acepta cambios, mientras otra exploración o un emparejamiento retiene el controlador ("Hay una exploración de descubrimiento en marcha en este controlador. Espere a que termine.") y mientras el dispositivo todavía espera su dirección o tiene un campo que su guardado rechaza. Exige Configurar Connector: a un rol sin ese permiso no se le dibuja el botón.

Lo que la exploración encontró aparece en una tarjeta Tags descubiertos justo encima de la tarjeta de tags, con cada valor marcado, con Nombre del tag, Tipo y Acceso y, bajo un nombre, el lugar más largo en el que el controlador encontró el punto, como en las tarjetas de la página del controlador. Añadir tags, en la cabecera de la tarjeta, añade los valores marcados al dispositivo, cada uno una vez, numerado cuando un tag del dispositivo ya tiene su nombre, y lo guarda; los tags nuevos quedan resaltados en la tabla de la tarjeta de tags, que sigue en pantalla, y el registro de acciones dice "Se añadieron 2 tags a 'Line PLC'." Lo que queda sigue ofrecido, y Descartar vacía la tarjeta. A un dispositivo que ya tiene un tag para cada valor que publica se le dice ("'Line PLC' ya tiene un tag para cada valor que publica."), y también a uno del que la exploración no leyó nada ("La exploración no encontró valores en 'Line PLC'. Compruebe que responde y vuelva a ejecutar Descubrir tags."). Salir del controlador vacía la tarjeta, igual que vacía los resultados del controlador.

El Descubrir del propio controlador sigue encontrando los dispositivos que todavía no tiene, y su tarjeta Dispositivos descubiertos no cambia.

Emparejar un dispositivo Matter

Matter pone en marcha el dispositivo físico por Bluetooth antes de que exista aquí, así que el primer verbo del controlador Matter es Emparejar dispositivo, no Añadir dispositivo, y abre un formulario en la página del controlador (el menú Nuevo… y el menú contextual del controlador ofrecen lo mismo). El emparejamiento necesita Configurar Connector, una radio Bluetooth LE utilizable en este ordenador y la red a la que se unirá el dispositivo, registrada antes en la tarjeta Redes del controlador: un nombre de Wi-Fi y su contraseña, o una red Thread y su conjunto de datos (vea Redes). Mientras ninguna red de ahí sirva, Emparejar dispositivo sigue atenuado con la información emergente "Añada primero la red a la que se va a unir el dispositivo." El formulario dice: "Ponga el dispositivo físico en modo de emparejamiento antes de continuar. El emparejamiento usa el Bluetooth de este ordenador."

Emparejar dispositivo se habilita en cuanto el nombre y el código están rellenos, alguna red sirve y la estación acepta cambios. El formulario recorre entonces cinco pasos, Validar, Buscar, Emparejar, Unirse a la red y Guardar, con una línea de estado debajo: "Validando el código de configuración y la red…", "Buscando el dispositivo por Bluetooth…", "Autenticando y emparejando el dispositivo…", después, en una red Wi-Fi, "Enviando al dispositivo el nombre y la contraseña de la red Wi-Fi…" y "Esperando a que el dispositivo se una a la red Wi-Fi…" (en una red Thread, "Enviando la configuración de la red Thread existente…" y "Esperando a que el dispositivo se una a la red Thread…"), "Guardando el nodo puesto en marcha en la Fabric local…", "Emparejamiento completado." Cancelar solo se acepta hasta que se selecciona el anuncio que coincide ("Detener antes de que se modifique el dispositivo"); a partir de ahí el botón se lee "Terminando de forma segura…", porque el dispositivo ya se modificó y la estación debe registrar el nodo aunque usted se vaya. Cerrar descarta el formulario mientras no corre nada.

Si sale bien, el dispositivo se crea con el id de nodo como identidad y con el nombre de la red a la que se unió en su campo Red de solo lectura y el registro de acciones se lee "Se emparejó el dispositivo Matter 'Luz de la cocina'." Después la página se abre en el controlador Matter, con el dispositivo nuevo resaltado en su tabla Dispositivos, y explora solo ese dispositivo: su tarjeta lista, marcados, los valores que publica, junto a Añadir tags, y la exploración termina con "Marque los valores de 'Luz de la cocina' que se van a crear como tags y pulse Añadir tags." Lo que ofrece el dispositivo, y lo que hace cada valor, está en Matter. El código de configuración no se guarda, ni se anota, ni se vuelve a mostrar; la contraseña o el conjunto de datos de la red se queda en la tarjeta Redes, guardado cifrado para este usuario de Windows, y nunca llega al dispositivo, a su dirección ni al registro. Si el nodo se puso en marcha pero no se pudo crear su dispositivo, el registro de acciones lo dice y Descubrir es el camino de recuperación. Los fallos se dicen sin rodeos y el formulario se queda abierto para reintentarlo: un código no válido, una red cuyo nombre, contraseña o conjunto de datos no es válido, ningún adaptador Bluetooth utilizable, Bluetooth denegado o apagado, ningún dispositivo que coincida ("Póngalo en modo de emparejamiento, manténgalo cerca e inténtelo de nuevo."), un código de configuración rechazado, un dispositivo que se une por el otro tipo de red o por cable (no se escribe nada en él), un dispositivo que respondió que no pudo unirse a la red (un nombre de Wi-Fi que no encontró, una contraseña rechazada u otro rechazo: no conserva nada y vuelve al modo de emparejamiento, así que corrija la red y vuelva a emparejar), un dispositivo que no respondió y nunca apareció en la red local (su nodo sigue en la Fabric y se puede recuperar con Descubrir), una Fabric que no se pudo guardar (cuando el dispositivo ya se había puesto en marcha: "No reinicie el dispositivo hasta que se resuelva el problema de almacenamiento de la Fabric."), u otro emparejamiento ya en marcha. Lo que cada fallo deja en el dispositivo está en Cuando el emparejamiento falla. Se empareja de uno en uno; mientras corre no se puede salir del controlador ("Espere a que termine el emparejamiento Matter antes de salir de este controlador.").

Lo que el descubrimiento no hace

Una exploración nunca guarda nada por sí sola, nunca cambia un dispositivo existente y nunca se vuelve a lanzar sola. No deduce subredes, ni mapas de registros, ni ajustes de línea serie, no habilita ni deshabilita una línea ni un bróker, y no retira del equipo los candidatos descartados. Se rechaza para un controlador que el paquete no lleva. Lo que contienen los resultados de cada controlador está en la página de ese controlador, dentro de Controladores.