Transacción de lectura
Uno de los primeros casos de uso cuando se interactúa con nodos en Matter es la lectura de un atributo de otro nodo, como un valor de temperatura de un sensor. En esas interacciones, la primera acción que se debe realizar es la acción de solicitud de lectura.
Acción de solicitud de lectura
Dirección: Iniciador -> Destino
En esta acción, el iniciador consulta un objetivo y proporciona lo siguiente:
- Solicitudes de atributos: Es una lista de cero o más atributos del objetivo. Esta lista se compone de cero o más rutas de acceso a los atributos solicitados del destino.
- Event Requests: Lista de cero o más rutas de acceso a los eventos solicitados del objetivo.
Después de que el destino recibe la acción de solicitud de lectura, ensamblará una acción de datos del informe con la información solicitada.
Registra la acción de datos del informe
Dirección: Objetivo -> Iniciador
En esta acción, el destino responde con lo siguiente:
- Attribute Reports: Es una lista de cero o más atributos informados solicitados en la solicitud de acción de lectura.
- Event Reports: Es una lista de cero o más eventos denunciados.
- Suppress Response: Es una marca que determina si se debe suprimir la respuesta de estado a esta acción.
- ID de suscripción: Si este informe forma parte de una transacción de suscripción, debe incluir un número entero que se use para identificar la transacción de suscripción.
Acción de respuesta de estado
Dirección: Puede ser de Target -> Initiator o de Initiator -> Target.
Una vez que el iniciador recibe los datos solicitados, de forma predeterminada, debe generar una acción de respuesta de estado. Esta acción se envía desde el iniciador y confirma la recepción de los datos informados. Si se establece la marca Suppress Status Response, el iniciador no debe enviar la acción de respuesta de estado.
Una vez que el iniciador envía la acción de respuesta de estado o recibe una acción de datos de informe con la marca de suprimir respuesta habilitada, se finaliza la consulta de lectura o informe.
La acción de respuesta de estado simplemente contiene un campo status que confirmará el éxito de la operación o presentará un código de error.
Restricciones de lectura
Las acciones Read Request Action y Report Data Action son solo para Unicast. Además, las rutas de acceso de estas solicitudes no pueden segmentarse para un grupo de nodos.
La acción de respuesta de estado es solo para Unicast y no se puede generar como respuesta a una transmisión en grupo.
Transacción de suscripción
Acción de solicitud de suscripción
Dirección: Iniciador -> Destino
Además de una sola acción de solicitud de lectura, un iniciador también puede suscribirse a actualizaciones periódicas de un atributo o evento. Por lo tanto, se puede generar la misma acción de datos del informe como resultado de las actualizaciones periódicas de datos que siguen una transacción de suscripción.
Una interacción de suscripción crea una relación entre dos nodos, en la que el objetivo genera periódicamente acciones de datos de informes para el iniciador. El iniciador es el suscriptor y el objetivo es el publicador.
Una acción de solicitud de suscripción contiene lo siguiente:
- Min Interval Floor: Es el intervalo mínimo entre informes.
- Límite máximo del intervalo: Es el intervalo máximo entre informes.
- Informes de atributos: Es una lista de cero o más atributos informados que se solicitaron en la solicitud de acción de lectura.
- Informes de eventos: Es una lista de cero o más eventos denunciados.
Después de la solicitud de suscripción, el destino responde al iniciador con una acción de datos del informe que contiene el primer lote de datos informados: los datos publicados preparados.
Luego, el iniciador confirma la acción de datos del informe con una acción de respuesta de estado que se envía al objetivo. Una vez que el destino recibe una acción de respuesta de estado que no informa errores, envía una acción de respuesta de suscripción.
Posteriormente, el destino enviará periódicamente la acción de datos del informe en el intervalo negociado, y el iniciador responderá a esas acciones hasta que se pierda o cancele la suscripción.
Acción de respuesta de suscripción
Dirección: Objetivo -> Iniciador
Esta es la última acción de la transacción de suscripción y concluye el proceso. Incluye lo siguiente:
- ID de suscripción: Es un número entero que identifica la suscripción.
- Min Interval: Es el intervalo mínimo final y determinado entre informes.
- Intervalo máx.: Es el intervalo máximo final y determinado entre informes.
Restricciones de suscripción
- La acción de solicitud de suscripción y la acción de respuesta de suscripción son acciones solo de Unicast.
- Todas las acciones de datos de informes en una interacción de suscripción deben tener el mismo ID de suscripción.
- Si el suscriptor no recibe una acción de datos del informe dentro del intervalo máximo negociado entre acciones, se cancelará la suscripción.
- Como consecuencia de la regla anterior, el Publicador puede finalizar una Interacción de Suscripción simplemente dejando de enviar Acciones de Datos de Informes periódicas.
- El Suscriptor puede finalizar la Interacción de Suscripción respondiendo a una Acción de Datos de Informe con un código de estado
INACTIVE_SUBSCRIPTION.