Ler transações

Ler transação

Um dos primeiros casos de uso ao interagir com nós Matter é a leitura de um atributo de outro nó; como um valor de temperatura de um sensor. Nessas interações, o primeiro A ação que precisa ser realizada é a ação de solicitação de leitura.

Sequência de operações de uma transação de leitura
Figura 1: transação de leitura

Ação de solicitação de leitura

Direção: Iniciador -> Alvo

Nesta ação, o iniciador consulta um destino fornecendo:

  • Solicitações de atributo: uma lista de zero ou mais atributos do destino. Esta lista é composta por zero ou mais caminhos para os Atributos.
  • Solicitações de evento: lista de zero ou mais caminhos para os destinos solicitados Eventos.

Depois que a ação de solicitação de leitura for recebida pelo destino, ele reunirá um Relatar ação de dados com as informações solicitadas.

Ação de dados do relatório

Direção: alvo -> Iniciador

Nesta ação, o alvo responde com:

  • Relatórios de atributos: uma lista de zero ou mais dos atributos informados. na solicitação de ação de leitura.
  • Relatórios de eventos: uma lista de zero ou mais eventos informados.
  • Suprimir resposta: uma sinalização que determina se o status response a esta ação deve ser suprimida.
  • ID da assinatura: se este relatório fizer parte de uma transação de assinatura, ela precisa incluir um número inteiro usado para identificar a transação de assinatura.

Ação de resposta de status

Direção: Segmentar -> Iniciador ou iniciador -> Alvo

Assim que o iniciador recebe os dados solicitados, por padrão, ele deve gerar uma Ação de resposta de status. Esta ação é enviada pelo iniciador, reconhecendo o recebimento dos dados relatados. Se o flag "Suprimir resposta de status" estiver definido, o iniciador não poderá enviar a ação de resposta de status.

Quando a ação de resposta de status for enviada pelo iniciador ou pelo A ação é recebida pelo iniciador com a sinalização "Suprimir resposta" ativada, o consulta de leitura/relatório é concluída.

A ação de resposta de status contém apenas um campo status que confirma o sucesso da operação ou apresenta um código de falha.

Restrições de leitura

As ações de solicitação de leitura e de dados de relatório são Somente Unicast. Além disso, os caminhos dessas solicitações não podem um grupo de nós.

A ação de resposta de status é somente para Unicast e não pode ser gerado como resposta a um groupcast.

Transação de assinatura

Sequência de operações de uma transação de assinatura
Figura 2: transação de assinatura

Ação de solicitação de inscrição

Direção: Iniciador -> Alvo

Além de uma única ação de solicitação de leitura, um iniciador também pode assinar a atualizações periódicas de um Atributo ou Evento. Assim, a mesma ação de dados do relatório como resultado de atualizações periódicas de dados que seguem uma Transação de assinatura.

Uma interação de assinatura cria uma relação entre dois nós, em que o destino gera periodicamente ações de dados de relatório para o iniciador. O iniciador é o assinante, e o destino é o editor.

Uma ação de solicitação de assinatura contém:

  • Valor mínimo do intervalo mínimo: o intervalo mínimo entre os relatórios.
  • Limite máximo do intervalo: o intervalo máximo entre os relatórios.
  • Relatórios de atributos: uma lista de zero ou mais dos atributos informados. na solicitação de ação de leitura.
  • Relatórios de eventos: uma lista de zero ou mais Eventos relatados.

Após a solicitação de assinatura, o alvo responde ao iniciador com uma Ação de dados do relatório que contém o primeiro lote de dados reportados: o Primed Dados publicados.

Em seguida, o iniciador confirma a ação relacionada aos dados do relatório com uma resposta de status. Ação enviada ao destino. Quando o alvo receber uma ação de resposta de status não relatar erros, ele enviará uma ação de resposta de assinatura.

O Destino enviará posteriormente a Ação de Dados de Relatório periodicamente em intervalo negociado, e o iniciador responderá a essas ações até a assinatura for perdida ou cancelada.

Ação de resposta de inscrição

Direção: alvo -> Iniciador

Esta é a última ação na transação de assinatura e conclui a de desenvolvimento de software. It includes:

  • ID da assinatura: um número inteiro que identifica a assinatura.
  • Min Interval: o intervalo mínimo final, determinado entre e detecção de ameaças.
  • Intervalo máximo: o intervalo máximo final, determinado entre e detecção de ameaças.

Restrições de assinatura

  • A ação de solicitação de inscrição e a ação de resposta de inscrição são Ações exclusivas para Unicast.
  • Todas as ações de dados do relatório em uma interação de assinatura precisam ter o mesmo ID da assinatura.
  • Se o assinante não receber uma ação de dados de relatório dentro do negociado entre as ações, a assinatura será encerrada.
  • Como consequência da regra anterior, o Editor pode rescindir uma Interação de assinaturas ao interromper o envio periódico de dados de relatórios Ações.
  • O Assinante pode encerrar a Interação de Assinatura respondendo a um Denunciar ação de dados com um código de status INACTIVE_SUBSCRIPTION.