Чтение транзакций

Транзакция чтения

Один из первых вариантов использования при взаимодействии с узлами в Matter – чтение атрибута из другого узла, например значения температуры с датчика. В таких взаимодействиях первым действием, которое необходимо выполнить, является действие запроса на чтение.

Последовательность операций транзакции чтения
Рисунок 1. Транзакция чтения

Действие "Прочитать запрос"

Направление: инициатор -> цель

В этом действии Инициатор запрашивает у Цели:

  • Запросы атрибутов – список, содержащий ноль или более атрибутов целевого объекта. Этот список состоит из нуля или более путей к запрошенным атрибутам цели.
  • Запросы событий. Список, содержащий ноль или более путей к запрошенным событиям цели.

После получения действия запроса на чтение целевое устройство соберет действие данных отчета с запрошенной информацией.

Действие с данными отчета

Направление: Target -> Initiator

В этом действии Target отвечает следующим образом:

  • Отчеты об атрибутах. Список атрибутов, запрошенных в запросе на чтение.
  • Отчеты о событиях – список, содержащий ноль или более зарегистрированных событий.
  • Suppress Response (Подавить ответ). Флаг, определяющий, нужно ли подавлять ответ о статусе для этого действия.
  • Идентификатор подписки. Если отчет относится к транзакции по подписке, он должен содержать целое число, которое используется для идентификации транзакции.

Статус ответа на приглашение

Направление: "Цель -> Инициатор" или "Инициатор -> Цель".

После получения запрошенных данных Инициатор по умолчанию должен сгенерировать ответное действие со статусом. Это действие отправляется инициатором, подтверждающим получение данных отчета. Если установлен флаг Suppress Status Response, инициатор не должен отправлять Status Response Action.

После того как инициатор отправит действие Status Response или получит действие Report Data с включенным флагом Suppress Response, запрос на чтение и данные отчетов будет завершен.

Действие Status Response Action содержит только поле status, в котором указывается, что операция выполнена успешно, или приводится код ошибки.

Ограничения на чтение

Действия Read Request Action и Report Data Action доступны только в Unicast. Кроме того, пути этих запросов не могут быть направлены на группу узлов.

Действие Status Response Action предназначено только для Unicast и не может быть сгенерировано в ответ на групповую трансляцию.

Транзакция по подписке

Последовательность операций при Транзакции с подпиской
Рисунок 2. Транзакция подписки

Действие "Запрос на подписку"

Направление: инициатор -> цель

Помимо единичного действия по запросу на чтение, инициатор также может подписаться на периодические обновления атрибута или события. Таким образом, одно и то же действие с данными отчета может быть сгенерировано в результате периодических обновлений данных, которые следуют за транзакцией подписки.

Взаимодействие по подписке создает связь между двумя узлами, при которой целевой узел периодически генерирует действия с данными отчета для инициатора. Инициатор – подписчик, а целевой объект – издатель.

Действие "Запрос на подписку" содержит:

  • Минимальный интервал. Минимальный интервал между отчетами.
  • Максимальный интервал. Максимальный интервал между отчетами.
  • Отчеты об атрибутах: список из нуля или более атрибутов, запрошенных в запросе на чтение.
  • Отчеты о событиях: список, содержащий ноль или более событий.

После запроса на подписку целевой объект отправляет инициатору ответ с действием Report Data, содержащим первую партию данных отчета – подготовленные опубликованные данные.

Затем инициатор подтверждает действие с данными отчета, отправляя целевому объекту ответ со статусом. Получив ответ о статусе без ошибок, целевой сервер отправляет ответ о подписке.

Затем Цель будет периодически отправлять Действие с данными отчета с согласованным интервалом, а Инициатор будет отвечать на эти Действия, пока подписка не будет потеряна или отменена.

Действие в ответ на подписку

Направление: Target -> Initiator

Это последнее действие в транзакции подписки, которое завершает процесс. В рамках сервиса мы предлагаем:

  • Идентификатор подписки. Целое число, которое идентифицирует подписку.
  • Минимальный интервал. Окончательный, определенный минимальный интервал между отчетами.
  • Максимальный интервал – окончательный, определенный максимальный интервал между отчетами.

Ограничения на подписку

  • Действия Subscribe Request Action и Subscribe Response Action доступны только в Unicast.
  • Все действия с данными отчетов в рамках одного взаимодействия с подпиской должны иметь одинаковый идентификатор подписки.
  • Если Подписчик не получит Действие с данными отчета в течение максимального согласованного интервала между Действиями, подписка будет прекращена.
  • В соответствии с предыдущим правилом Издатель может прекратить Взаимодействие по подписке, просто перестав отправлять периодические Действия с данными отчетов.
  • Подписчик может прекратить Взаимодействие по подписке, ответив на Действие с данными отчета кодом статуса INACTIVE_SUBSCRIPTION.