Matter

Referencia del controlador Matter: la puesta en marcha por Bluetooth en la Fabric local, el recorrido de Emparejar dispositivo, la identidad del nodo y los tags de clúster.

Ver como Markdown

El controlador Matter lee equipos Matter sobre Thread: sensores inteligentes, enchufes, luces y dispositivos parecidos certificados para el estándar Matter. Ganter Lab actúa como un controlador Matter con su propia Fabric local: pone en marcha cada dispositivo una vez por Bluetooth Low Energy desde este equipo, le entrega las credenciales de su red Thread existente, y a partir de ahí habla con él por esa red a través de su Thread Border Router.

Eso invierte el orden habitual de configuración. Un dispositivo Matter no parte de un host y un puerto: parte de una ceremonia de emparejamiento, y después solo se guarda la identidad estable del nodo puesto en marcha.

Lo que hace falta antes de emparejar:

Un adaptador Bluetooth Low Energy en este equipo, encendido y con Windows permitiendo que Ganter Lab lo use.
Una red Thread existente con un Border Router, y su conjunto de datos operativo activo completo. Ganter Lab une dispositivos a su red; no puede inventarle credenciales.
El código de configuración del dispositivo, impreso en el propio dispositivo o en su embalaje, y el dispositivo en modo de emparejamiento.

El recorrido de Emparejar dispositivo

En el controlador Matter, la barra de herramientas ofrece Emparejar dispositivo donde los demás controladores ofrecen Añadir dispositivo. Abre un formulario con tres campos:

Campo	Qué es	Formato	Por defecto
Nombre del dispositivo	El nombre editable que llevará el dispositivo en el Connector.	Texto libre	`Dispositivo Matter`
Código de configuración Matter	El código de emparejamiento manual oficial, o la carga QR completa. Se escribe oculto, con un mando para revelarlo.	Un código manual de 11 o 21 dígitos (los guiones y los espacios se ignoran; el dígito de control se verifica), o la carga QR completa que empieza por `MT:`. Una carga QR que no anuncia la puesta en marcha por Bluetooth se rechaza, igual que los códigos de acceso reservados o fuera de rango.	vacío
Conjunto de datos operativo Thread	El conjunto de datos activo completo de su red Thread, obtenido del administrador de la red o del Border Router. Se escribe oculto, con un mando para revelarlo.	Texto hexadecimal (se toleran los espacios en blanco y un prefijo `hex:`), de 254 bytes como mucho una vez descodificado. Tiene que ser el conjunto de datos completo: Active Timestamp, Channel, Channel Mask, Extended PAN ID, Mesh-Local Prefix, Network Key, Network Name, PAN ID, PSKc y Security Policy tienen que estar todos presentes, y un conjunto de datos parcial o mal formado se rechaza nombrando el elemento que falta.	vacío

Emparejar dispositivo se queda deshabilitado hasta que los tres campos están rellenos. Mientras el emparejamiento corre, el formulario informa de su etapa: Validar (comprobar el código y el conjunto de datos), Buscar (buscar el dispositivo por Bluetooth), Emparejar (autenticar con el código de configuración), Unirse a Thread (enviar la configuración de la red y esperar a que el dispositivo aparezca en la red Thread) y Guardar (anotar el nodo puesto en marcha en la Fabric local).

Cancelar está disponible mientras el dispositivo físico todavía no se ha modificado; en cuanto la puesta en marcha ha alterado el dispositivo, el botón dice que Ganter Lab está terminando de forma segura y el recorrido completa el registro en vez de abandonar un nodo a medio poner en marcha. Se empareja de uno en uno; un segundo intento mientras hay uno en curso se rechaza.

Los secretos no se guardan nunca. El código de configuración y el conjunto de datos Thread existen solo en el formulario mientras está abierto; se borran cuando el emparejamiento termina, falla o se cancela, y de ellos no se escribe nada en la configuración. Lo que se guarda es únicamente la identidad del nodo.

Si el emparejamiento falla, el mensaje declara la causa: un código o un conjunto de datos no válidos, Bluetooth ausente o apagado, Windows denegando el acceso a Bluetooth, ningún dispositivo encontrado que coincida, el dispositivo rechazando el código de configuración, o el dispositivo que se pone en marcha pero nunca aparece en la red Thread. Un código de configuración equivocado se nombra como tal, así que la respuesta es releer el código impreso y volver a poner el dispositivo en modo de emparejamiento.

Siempre que un fallo llega después de que el equipo ya se hubiera puesto en marcha, el mensaje lo dice y muestra el ID de nodo: el nodo sigue en la Fabric y se puede añadir más tarde con Descubrir en cuanto alcance la red. En ese caso no reinicie el dispositivo; solo un mensaje que dice que no se guardó nada significa que el equipo quedó intacto.

La identidad del nodo

Un dispositivo emparejado queda ligado al ID de nodo estable de 64 bits del equipo, mostrado de solo lectura en su tarjeta Conexión como 16 dígitos hexadecimales, junto al estado del dispositivo. El nombre visible editable es suyo y se puede cambiar; el ID de nodo no. Un dispositivo cuya identidad guardada ya no se puede leer muestra en su lugar Necesita un nuevo emparejamiento.

Como la identidad es el ID de nodo, los dispositivos Matter mantienen un estado de conexión independiente: deshabilitar, eliminar o perder un nodo no deja a otro no disponible, y eliminar un dispositivo libera solo su uso de la sesión segura, no quita el equipo de la Fabric local.

Descubrimiento

Descubrir en el controlador Matter lista los nodos ya puestos en marcha en la Fabric local de esta aplicación, así que un nodo cuyo dispositivo se eliminó (o cuyo emparejamiento terminó sin dispositivo) se puede volver a añadir sin una ceremonia nueva. Un ID de nodo que ya está configurado se marca como tal y Abrir lleva al dispositivo existente. Los candidatos del descubrimiento llevan la identidad del nodo y ningún secreto de configuración. El recorrido general del descubrimiento se describe en la página Connector.

Tags

Un tag Matter no tiene ningún campo de dirección de texto libre. El nombre del tag es el nombre del clúster que se va a leer. El nombre tiene que coincidir con el nombre del clúster tal como lo escribe la especificación Matter, espacios y signos de puntuación incluidos y sin distinguir mayúsculas de minúsculas: On/Off, Level Control, Temperature Measurement. Como el nombre es la dirección, no puede contener dos puntos; el panel los rechaza y lo dice. Un nombre que no lleva ningún clúster se lee como un error que nombra el clúster desconocido. El valor se convierte al tipo de dato declarado del tag; un valor que el tipo declarado no puede representar se lee también como un error, y no como un número sustituto.

Dos campos numéricos dicen dónde hay que leer ese clúster en el dispositivo. Un dispositivo expone un endpoint por cada salida controlable, numerado a partir de 1, así que una lámpara de dos canales o una regleta se leen con un tag por endpoint; el endpoint 0 es el nodo en sí. El atributo es qué valor del clúster se lee, y 0 es el valor propio del clúster, que es lo que quiere casi todo tag.

Campo	Qué hace	Valores	Por defecto
Nombre del tag	Nombra el tag y selecciona el clúster Matter que se lee del nodo. Sin dos puntos.	El nombre del clúster tal cual, por ejemplo `On/Off`	`Tag 1`
Salida (endpoint)	Qué salida del dispositivo lee este tag.	0 en adelante; 1 es la primera salida controlable	1
Atributo	Qué atributo del clúster lee este tag.	0 en adelante; 0 es el valor propio del clúster	0
Tipo de dato	El tipo OPC UA con el que se expone el valor.	Boolean, Int32, UInt32, Float, Double, String	Float
Intervalo de sondeo	Cada cuánto se lee el atributo, por tag, con el valor por defecto del dispositivo (1000 ms) aplicándose donde el tag no declara ninguno.	milisegundos	el valor por defecto del dispositivo

Los tags Matter son de solo lectura: el campo de acceso no ofrece ninguna opción con escritura y el runtime rechaza las escrituras de atributo. Cambiar un dispositivo Matter (encenderlo, por ejemplo) es un comando Matter, y las escrituras de tag no modelan eso.