Matter

Referencia del controlador Matter: las redes Wi-Fi y Thread a las que se unen los dispositivos, la puesta en marcha por Bluetooth en la Fabric local, el recorrido de Emparejar dispositivo, la identidad del nodo, los tags que vienen del dispositivo y lo que hace escribir cada uno.

El controlador Matter lee equipos Matter: sensores inteligentes, enchufes, luces y dispositivos parecidos certificados para el estándar Matter, tanto si se unen a la red por Wi-Fi como por Thread. Es un solo controlador para los dos. La red es solo el camino de entrada: en cuanto un dispositivo está en ella, Ganter Lab lo lee del mismo modo, por la red local.

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 ordenador, le entrega las credenciales de una red registrada en la tarjeta Redes del controlador, y a partir de ahí habla con él por la red local: a través de su router en un dispositivo Wi-Fi, a través de su Thread Border Router en un dispositivo Thread.

Usted nunca le dice a Ganter Lab si un dispositivo es Wi-Fi o Thread: lo dice el propio dispositivo. Una vez abierta la sesión por Bluetooth, Ganter Lab lee del dispositivo a qué tipo de red se une, antes de escribir nada en él, y se detiene con un mensaje propio cuando la red elegida es del otro tipo.

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 ordenador, encendido y con Windows permitiendo que Ganter Lab lo use.
• La red a la que se unirá el dispositivo, registrada en la tarjeta Redes: para un dispositivo Wi-Fi, el nombre de la Wi-Fi y su contraseña; para un dispositivo Thread, 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.

Redes

El panel del controlador Matter lleva una tarjeta titulada Redes: las redes Wi-Fi y Thread a las que se unen los dispositivos, una por fila. Una red se registra una vez, antes del primer dispositivo, y sirve a todos los dispositivos que se emparejan en ella, así que emparejar una segunda lámpara en la misma Wi-Fi ya no pide nada. La tarjeta solo se dibuja para un rol que puede configurar el Connector, porque guarda los secretos de las redes y no sirve más que para emparejar.

La cabecera de la tarjeta lleva sus comandos, en este orden:

La tabla muestra, de cada red, su Nombre, su Tipo de red (Red Wi-Fi o Red Thread) y su Estado: Lista para emparejar, o lo que todavía le falta a la red. Una red cuyo nombre aún no se ha escrito aparece como Red sin nombre.

Los campos de la red seleccionada se editan allí mismo, bajo la tabla, y se guardan solos. Un valor que las reglas de abajo rechazan no se escribe, y el campo dice por qué.

Dos cosas deciden si un dispositivo Wi-Fi se puede emparejar, y la tarjeta dice las dos junto a los campos:

• La mayoría de los dispositivos solo se unen a redes de 2,4 GHz. Un router que emite un mismo nombre en 2,4 GHz y en 5 GHz les sirve; una red que solo existe en 5 GHz, no.
• Este equipo y los dispositivos tienen que estar en la misma red local. Una red de invitados, o el aislamiento de clientes activado en el router, impide que el equipo encuentre los dispositivos una vez que se han unido.

Una red solo sirve para emparejar mientras su secreto cumple esas reglas: una red Wi-Fi con nombre y contraseña válidos (vacía incluida), una red Thread con un conjunto de datos válido.

Editar una red cambia lo que entrega el siguiente emparejamiento, nunca lo que un dispositivo ya recibió. Un dispositivo que tiene que pasar a otra red, o cuyo router recibió una contraseña nueva, se restablece y se vuelve a emparejar.

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, y también la entrada Matter del menú Nuevo… de la columna. Mientras ninguna red sirva para emparejar, sigue dibujado y atenuado, con la información emergente "Añada primero la red a la que se va a unir el dispositivo." Si no, abre un formulario:

Una carpeta del controlador Matter ofrece Nuevo dispositivo (en su tabla Dispositivos, en su menú del clic derecho y en Nuevo… > Matter > <Carpeta>). Abre este mismo formulario, en gris del mismo modo mientras ninguna red sirva, y el dispositivo emparejado se archiva en esa carpeta.

Emparejar dispositivo en el formulario se queda deshabilitado hasta que el nombre y el código de configuración están rellenos y alguna red sirve. Mientras el emparejamiento corre, el formulario informa de su etapa: Validar (comprobar el código y el secreto de la red), Buscar (buscar el dispositivo por Bluetooth), Emparejar (autenticar con el código de configuración y leer a qué tipo de red se une el dispositivo), Unirse a la red (enviar la red al dispositivo y después preguntar por él en la red local hasta que responda; la línea de estado dice si esa red es Wi-Fi o Thread) y Guardar (abrir la sesión segura con el dispositivo en la red local, terminar su puesta en marcha y anotar el nodo 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.

El dispositivo nuevo guarda el nombre de la red a la que se unió, que se muestra en su campo Red. Emparejar el siguiente dispositivo en la misma red solo pide su nombre y su código de configuración.

Cuando el emparejamiento falla

Si el emparejamiento falla, el mensaje declara la causa y qué hacer:

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.

Un dispositivo que responde que no pudo unirse a la red es la excepción: no guarda nada que valga la pena conservar. Ganter Lab termina el emparejamiento en el dispositivo, que descarta lo que recibió y vuelve en el acto al modo de emparejamiento, y quita su nodo de la Fabric; por eso el mensaje no lleva ID de nodo y Descubrir nunca lista un nodo que no puede responder. Corrija la red y vuelva a emparejar. Solo un dispositivo que no dio ninguna respuesta conserva su nodo, porque si se unió solo se sabe cuando aparece en la red local.

Qué se guarda

La contraseña de la Wi-Fi y el conjunto de datos nunca aparecen en el diario técnico, en la dirección de un dispositivo ni en su Thing Description. Las redes y el emparejamiento no se ofrecen a los agentes por el servidor MCP: emparejar necesita a alguien junto al dispositivo, y las redes guardan secretos.

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 volver a emparejarse.

El panel del dispositivo muestra también un campo Red de solo lectura: el nombre de la red a la que se unió el dispositivo al emparejarse. Un dispositivo emparejado por una versión que no lo registraba dice que no se registró nada. El campo es un registro, no un ajuste: editar o quitar esa red en la tarjeta Redes no cambia nada en el dispositivo.

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 y lee, de cada uno, los valores que publica. Para leerlos abre una sesión segura con cada nodo, así que un nodo que está fuera de la red sigue en la lista, sin valores, una vez que su sesión no se pudo abrir. Los candidatos del descubrimiento llevan la identidad del nodo y ningún secreto de configuración. El recorrido general del descubrimiento se describe en Descubrimiento.

Los valores de un dispositivo configurado se comparan con sus tags por salida, clúster y atributo, nunca por nombre: un tag que usted renombró sigue contando, y un valor nunca se añade dos veces.

La propia página del dispositivo ofrece lo mismo sin salir de ella: Descubrir tags, en la cabecera de su tarjeta de tags, lee solo ese nodo y lista, marcados, los valores para los que todavía no tiene tag, con Añadir tags (vea Descubrir los tags de un dispositivo).

Tags

Los tags de un dispositivo Matter vienen del propio dispositivo: nadie escribe un clúster ni un número de atributo para ellos. Un emparejamiento que sale bien lleva directamente a ellos. El registro de acciones se lee "Se emparejó el dispositivo Matter 'Luz de la cocina'.", la página se abre en el controlador Matter, con el dispositivo nuevo resaltado en su tabla Dispositivos, y una exploración de ese único dispositivo se lanza enseguida. El dispositivo que creó el emparejamiento aparece en Dispositivos descubiertos con los valores que publica, todos marcados, 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." Desmarque lo que no quiera y pulse Añadir tags; el registro de acciones se lee entonces "Se añadieron 5 tags a 'Luz de la cocina'." Un dispositivo que todavía no ha respondido no informa de nada: "'Luz de la cocina' todavía no informó de ningún valor. Vuelva a ejecutar Descubrir cuando esté en línea." La misma tarjeta vuelve en cada Descubrir posterior, con los valores para los que el dispositivo todavía no tiene tag.

Añadir tags solo se dibuja para un rol con Configurar Connector. Queda atenuado, con su motivo como información emergente, mientras corre una exploración o un emparejamiento, mientras la estación rechaza cambios y mientras no hay nada marcado ("Marque al menos un valor para añadir."). Un valor cuya salida, clúster y atributo el dispositivo ya lee nunca se vuelve a añadir; cuando todos los valores marcados ya están, no se guarda nada: "'Luz de la cocina' ya tiene un tag para cada valor marcado, así que no se añadió nada." Un nombre que ya lleva otro tag del dispositivo recibe un número detrás, como en Brillo (2).

La exploración lee lo que el dispositivo publica, tal como lo organiza la especificación Matter:

Lo que ofrece la exploración, y con qué nombre:

Un tag que se ofrece como escribible llega con el acceso Lectura y escritura; todos los demás llegan con Solo lectura.

Los valores que el controlador conoce

El controlador lleva una tabla, tomada de la especificación Matter, de los valores que conoce por su nombre y de cómo cambia cada uno. Un valor cambia de una de tres formas: con un comando que envía el controlador y que el dispositivo debe listar entre los comandos que admite; con una escritura del propio atributo, donde la especificación lo hace escribible y el dispositivo lo lista; o de ninguna forma, para un valor que el dispositivo solo informa.

La especificación envía las temperaturas, la humedad y la presión en unidades fijas: centésimas de grado Celsius, centésimas de porcentaje y décimas de kilopascal. El descubrimiento ofrece esos valores ya en °C, % y kPa: el tag llega con el factor en su etapa Escala (0,01 para una temperatura y una humedad, 0,1 para una presión) y con la unidad, así que un dispositivo que envía 2150 se lee 21,5 °C. Una escritura deshace esa etapa antes de que el valor salga, así que una consigna escrita como 21,5 llega al dispositivo como 2150. La iluminancia es logarítmica (10000 × log10(lux) + 1), así que ningún factor la convierte: se lee el número que envía el dispositivo. Todos los demás valores también se leen tal como los envía el dispositivo.

Las cerraduras, el color por coordenadas X e Y, las escenas, los grupos y el comando Toggle no están en la tabla. Un dispositivo Matter tampoco tiene comandos propios: todo cambio es una escritura en uno de sus tags.

Escribir un valor

Un tag Matter con acceso Lectura y escritura cambia el dispositivo cuando se escribe: desde su tarjeta Valor en vivo, un control del dashboard, la Logic o un agente. La escritura entra en la cola del dispositivo como la de cualquier controlador, por turno con las lecturas del dispositivo, y su respuesta es la del propio dispositivo. El controlador elige el comando Matter o la escritura del atributo a partir de la tabla; nadie elige un comando. Solo el SUCCESS del dispositivo cuenta como escrito. Todo lo demás se rechaza, con un motivo:

Una escritura rechazada nunca se informa como escrita, ni como un equipo inalcanzable. En la página del tag, la línea de estado se lee "Escritura rechazada por el equipo: CONSTRAINT_ERROR, 0x87." cuando el dispositivo la rechazó, con el motivo en lugar del estado para un rechazo resuelto antes de enviar nada, y "Escritura no confirmada: el equipo no respondió a tiempo." cuando no llegó respuesta; "Error de escritura: no se pudo alcanzar el equipo." queda para un dispositivo que no está conectado. El motivo también viaja con la escritura: la línea del diario de esa escritura lo nombra, con lo que significa el estado, y el tag_write de un agente lo devuelve.

Un tag hecho a mano

Para el raro valor que el dispositivo no publica de una forma que la exploración ofrezca, Añadir tag en un dispositivo Matter crea un tag para rellenar a mano. Su tarjeta Fuente muestra tres campos en una fila, y la vista previa de la dirección debajo los monta como <endpoint>/<cluster>/<attribute>, en decimal (1/8/0 es el brillo de la primera salida). Mientras no se elige un clúster el tag no se guarda, y el panel dice: "Elija el clúster que lee este tag. Sin él, nunca se pide nada al dispositivo."

El nombre del tag es libre: nombra el tag y no selecciona nada en el dispositivo. El tipo de dato se elige entre Boolean, Int32, UInt32, Float, Double y String; una lectura que el tipo declarado no puede representar se lee como error y no como un número de relleno. El valor llega tal como lo envía el dispositivo: una temperatura, una humedad o una presión hecha a mano se lee en centésimas o décimas hasta que le dé en su etapa Escala el factor y la unidad de la tabla de arriba.

El campo de acceso ofrece escritura solo donde la tabla del controlador cambia el valor, y si no, ofrece Solo lectura y dice debajo por qué:

Cuando una edición de la salida, del clúster o del atributo apunta el tag a un valor que el controlador no puede escribir, su acceso vuelve a Solo lectura. Un tag que ofreció el descubrimiento conserva el acceso que el descubrimiento le dio, porque solo el descubrimiento pregunta al dispositivo qué comandos admite: un valor que el dispositivo no enumeró sigue en Solo lectura, y el campo sigue ofreciendo escritura.

Tags guardados por versiones anteriores

Una versión anterior nombraba el clúster de un tag Matter solo con el nombre del tag, con una dirección <endpoint>/<attribute>. Cuando esta versión arranca por primera vez, cada tag de un dispositivo Matter cuyo nombre es un clúster del catálogo Matter (la parte que sigue a los últimos dos puntos, sin los espacios de alrededor, sin distinguir mayúsculas) recibe ese clúster, así que sigue leyendo exactamente el valor que leía. Su nombre queda como estaba, y la vista previa de su dirección pasa a mostrar <endpoint>/<cluster>/<attribute>. Un tag cuyo nombre no coincidía con ningún clúster nunca leyó nada: se queda sin clúster, sus lecturas se rechazan con un motivo que lo dice, y su página pide el clúster. Un tag convertido conserva el acceso que tenía, Solo lectura, el único que ofrecían esas versiones; para escribirlo, elija Lectura y escritura, que sirve para los valores de la tabla de arriba.