Matter

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

El driver Matter lee equipos Matter: sensores inteligentes, contactos, lámparas y equipos similares certificados para el estándar Matter, ya sea que se unan a la red por Wi-Fi o por Thread. Es un solo driver para los dos. La red es solo el camino de entrada: una vez que el dispositivo está en ella, Ganter Lab lo lee de la misma manera, por la red local.

Ganter Lab actúa como un controlador Matter con su propio Fabric local: pone en marcha cada dispositivo una vez por Bluetooth Low Energy en esta computadora, le entrega las credenciales de una red registrada en la tarjeta Redes del driver y, de ahí en adelante, 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: el propio dispositivo lo dice. Una vez abierta la sesión por Bluetooth, Ganter Lab lee del dispositivo a qué tipo de red se une, antes de escribirle cualquier cosa, y se detiene con un mensaje propio cuando la red elegida es del otro tipo.

Eso invierte el orden habitual de la puesta en marcha. Un dispositivo Matter no arranca de un host y un puerto: arranca de una ceremonia de emparejamiento, y después se guarda únicamente la identidad estable del nodo puesto en marcha.

Lo que hace falta antes de emparejar:

• Un adaptador Bluetooth Low Energy en esta computadora, encendido, y con Windows permitiéndole a Ganter Lab usarlo.
• La red a la que se va a unir el dispositivo, registrada en la tarjeta Redes: para un dispositivo Wi-Fi, el nombre del 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 dispositivo o en su empaque, y el dispositivo en modo de emparejamiento.

Redes

El panel del driver 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 el mismo 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 todavía no se escribe aparece como Red sin nombre.

Los campos de la red seleccionada se editan ahí mismo, debajo de 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 transmite un mismo nombre en 2.4 GHz y en 5 GHz les sirve; una red que solo existe en 5 GHz, no.
• Esta computadora 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 la computadora encuentre los dispositivos una vez que se unieron.

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 cambiarse a otra red, o cuyo router recibió una contraseña nueva, se restablece y se empareja de nuevo.

El flujo de Emparejar dispositivo

En el driver Matter, la barra de herramientas ofrece Emparejar dispositivo donde los demás drivers ofrecen Agregar 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 "Agregue primero la red a la que se va a unir el dispositivo." Si no, abre un formulario:

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

Emparejar dispositivo en el formulario se queda desactivado hasta que el nombre y el código de configuración estén llenos y alguna red sirva. Mientras corre el emparejamiento, el formulario reporta su etapa: Validar (verificando el código y el secreto de la red), Buscar (buscando el dispositivo por Bluetooth), Emparejar (autenticando con el código de configuración y leyendo a qué tipo de red se une el dispositivo), Unirse a la red (enviando la red al dispositivo y después preguntando 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 (abriendo la sesión segura con el dispositivo en la red local, terminando su puesta en marcha y registrando el nodo en el Fabric local).

Cancelar está disponible mientras el dispositivo físico todavía no se ha modificado; una vez que la puesta en marcha alteró el dispositivo, el botón dice que Ganter Lab está terminando de forma segura y el flujo completa el registro en lugar de abandonar un nodo puesto en marcha a medias. Corre un emparejamiento a la vez; un segundo intento mientras hay uno en marcha se rechaza.

El dispositivo nuevo registra 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 dice la causa y qué hacer:

Siempre que una falla llegue después de que el equipo ya se puso en marcha, el mensaje lo dice y muestra el ID de nodo: el nodo se queda en el Fabric y se puede agregar más tarde con Descubrir en cuanto alcance la red. En ese caso no reinicie el dispositivo; solo un mensaje que diga que no se guardó nada significa que el equipo se quedó sin tocar.

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 de inmediato al modo de emparejamiento, y quita su nodo del Fabric; por eso el mensaje no trae ID de nodo y Descubrir nunca lista un nodo que no puede responder. Corrija la red y empareje de nuevo. 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 del Wi-Fi y el conjunto de datos nunca aparecen en la bitácora, 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 atado 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 para cambiarlo; el ID de nodo no. Un dispositivo cuya identidad guardada ya no se puede leer muestra Necesita volver a emparejarse en su lugar.

El panel del dispositivo también muestra un campo Red de solo lectura: el nombre de la red a la que se unió el dispositivo cuando se emparejó. 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 guardan un estado de conexión independiente: desactivar, eliminar o perder un nodo no deja a otro fuera de servicio, y eliminar un dispositivo solo libera el uso que hacía de la sesión segura, no quita el equipo del Fabric local.

El descubrimiento

Descubrir en el driver Matter lista los nodos ya puestos en marcha en el 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 agrega dos veces.

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

Los 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 dice "Se emparejó el dispositivo Matter 'Luz de la cocina'.", la página se abre en el driver Matter, con el dispositivo nuevo resaltado en su tabla Dispositivos, y un escaneo 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 el escaneo termina con "Marque los valores de 'Luz de la cocina' que se van a crear como tags y después presione Agregar tags." Desmarque lo que no quiera y presione Agregar tags; el registro de acciones dice entonces "Se agregaron 5 tags a 'Luz de la cocina'." Un dispositivo que todavía no ha respondido no reporta nada: "'Luz de la cocina' todavía no reportó 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.

Agregar tags solo se dibuja para un rol con Configurar Connector. Queda atenuado, con su motivo como información emergente, mientras corre un escaneo o un emparejamiento, mientras la estación rechaza cambios y mientras no hay nada marcado ("Marque al menos un valor para agregar."). Un valor cuya salida, clúster y atributo el dispositivo ya lee nunca se vuelve a agregar; 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 agregó nada." Un nombre que ya lleva otro tag del dispositivo recibe un número detrás, como en Brillo (2).

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

Lo que ofrece el escaneo, 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 driver conoce

El driver 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 driver 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 reporta.

La especificación envía las temperaturas, la humedad y la presión en unidades fijas: centésimas de grado Celsius, centésimas de por ciento 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 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 driver, por turno con las lecturas del dispositivo, y su respuesta es la del propio dispositivo. El driver 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 reporta como escrita, ni como un equipo fuera de alcance. 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 el escaneo ofrezca, Agregar 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 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 usted 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 driver 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 driver 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 le pregunta al dispositivo qué comandos admite: un valor que el dispositivo no listó 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.