Leer transacciones
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 tales 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 -> Objetivo
En esta acción, el iniciador consulta un destino que proporciona lo siguiente:
- Solicitudes de atributo: una lista de cero o más atributos objetivo. Esta lista consta de cero o más rutas de acceso a los atributos solicitados del destino.
- Solicitudes de eventos: Es una lista de cero o más rutas de acceso a los eventos solicitados del destino.
Una vez que el destino recibe la acción de solicitud de lectura, esta ensamblará una acción de datos del informe con la información solicitada.
Acción de informar datos
Dirección: Objetivo -> Iniciador
En esta acción, el destino responde con lo siguiente:
- Informes de atributos: Es una lista de cero o más de los atributos que se informaron en la solicitud de acción de lectura.
- Informes de eventos: Una lista de cero o más eventos informados.
- Respuesta de eliminación: 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 permita identificar la transacción.
Acción de respuesta de estado
Dirección: Target -> Initiator o 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, en la que se confirma la recepción de los datos informados. Si se establece la marca Suprepress Status Response, el iniciador no debe enviar la acción Status Response.
Una vez que el iniciador envía la Acción de respuesta de estado o el Initiator recibe una Acción de informar datos, con la marca Suppress Response habilitada, la consulta de lectura/informe finaliza.
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 falla.
Restricciones de lectura
La Acción de solicitud de lectura y la Acción de datos de informe son solo para Unicast. Además, es posible que las rutas de acceso de estas solicitudes no estén orientadas a un grupo de nodos.
La acción de respuesta de estado es solo 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 -> Objetivo
Además de una acción de solicitud de lectura particular, 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 de informes como resultado de las actualizaciones de datos periódicas que siguen a una Transacción de suscripción.
Una interacción de suscripción crea una relación entre dos nodos, en la que el destino genera periódicamente acciones de datos de informes al iniciador. El iniciador es el suscriptor y el objetivo es el editor.
Una acción de solicitud de suscripción contiene lo siguiente:
- Límite mínimo mínimo: Es el intervalo mínimo entre informes.
- Límite máximo del intervalo: Es el intervalo máximo entre los informes.
- Informes de atributos: una lista de cero o más de los atributos informados que se solicitaron en la solicitud de acción de lectura.
- Informes de eventos: una lista de cero o más eventos informados.
Después de la solicitud de suscripción, el destino responde al Iniciador con una Acción de datos de informe que contiene el primer lote de datos denunciados: los Datos publicados de edición avanzada.
Luego, el iniciador reconoce la acción de datos del informe con una acción de respuesta de estado enviada al destino. 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.
El destino enviará una Acción de datos de informes de forma periódica en el intervalo negociado y el iniciador responderá a esas Acciones hasta que se pierda o cancele la suscripción.
Acción de respuesta a suscripciones
Dirección: Objetivo -> Iniciador
Esta es la última acción en la transacción de suscripción y concluye el proceso. En él, encontrarás la siguiente información:
- ID de suscripción: Es un número entero que identifica la suscripción.
- Intervalo mín.: Es el intervalo mínimo final determinado entre los informes.
- Intervalo máximo: El intervalo máximo final y determinado entre los informes.
Restricciones de suscripción
- La acción de solicitud de suscripción y la acción de respuesta de suscripción son solo para Unicast.
- Todas las acciones de datos del informe en una interacción de suscripción deben tener el mismo ID de suscripción.
- Si el suscriptor no recibe una Acción de informe de datos dentro del intervalo máximo negociado entre Acciones, se cancelará la suscripción.
- Como consecuencia de la regla anterior, el Editor puede finalizar una Interacción de suscripción con solo dejar de enviar Acciones de datos de informes periódicas.
- El Suscriptor puede rescindir la Interacción de la suscripción si responde a una Acción de datos de informe con un código de estado
INACTIVE_SUBSCRIPTION.