읽기 트랜잭션

거래 읽기

Matter의 노드와 상호작용할 때 첫 번째 사용 사례 중 하나는 다른 노드에서 속성(예: 센서의 온도 값)을 읽는 것입니다. 이러한 상호작용에서 가장 먼저 실행해야 하는 작업은 읽기 요청 작업입니다.

읽기 트랜잭션의 작업 순서
그림 1: 읽기 트랜잭션

요청 작업 읽기

방향: 개시자 -> 타겟

이 작업에서 시작자는 다음을 제공하는 타겟을 쿼리합니다.

  • 속성 요청: 0개 이상의 대상 속성 목록입니다. 이 목록은 대상의 요청된 속성에 대한 0개 이상의 경로로 구성됩니다.
  • 이벤트 요청: 타겟이 요청한 이벤트에 대한 경로 0개 이상 목록입니다.

타겟이 읽기 요청 작업을 수신하면 타겟은 요청된 정보로 보고서 데이터 작업을 구성합니다.

데이터 보고 작업

방향: 타겟 -> 개시자

이 작업에서 타겟은 다음과 같이 응답합니다.

  • 속성 보고서: 읽기 작업 요청에서 요청된 0개 이상의 보고된 속성 목록입니다.
  • 이벤트 보고서: 보고된 이벤트 0개 이상의 목록입니다.
  • 응답 억제: 이 작업에 대한 상태 응답을 억제해야 하는지 여부를 결정하는 플래그입니다.
  • 정기 결제 ID: 이 보고서가 정기 결제 거래의 일부인 경우 정기 결제 거래를 식별하는 데 사용되는 정수가 포함되어야 합니다.

상태 응답 작업

방향: 대상 -> 시작자 또는 개시자 -> 대상

개시자가 요청된 데이터를 수신하면 기본적으로 상태 응답 작업을 생성해야 합니다. 이 작업은 보고된 데이터 수신을 확인하는 개시자로부터 전송됩니다. 상태 응답 억제 플래그가 설정된 경우 개시자는 상태 응답 작업을 전송하면 안 됩니다.

개시자가 상태 응답 작업을 전송하거나 응답 억제 플래그를 사용 설정한 상태로 개시자가 보고서 데이터 작업을 수신하면 읽기/보고서 쿼리가 완료됩니다.

상태 응답 작업에는 작업 성공을 확인하거나 실패 코드를 표시하는 status 필드만 포함됩니다.

읽기 제한

읽기 요청 작업 및 보고서 데이터 작업은 Unicast 전용입니다. 또한 이러한 요청의 경로가 노드 그룹을 타겟팅하지 않을 수 있습니다.

상태 응답 작업은 Unicast 전용이며 그룹캐스트에 대한 응답으로 생성할 수 없습니다.

구독 거래

정기 결제 거래 작업 순서
그림 2: 구독 트랜잭션

구독 요청 작업

방향: 개시자 -> 타겟

시작자는 단일 읽기 요청 작업 외에도 속성 또는 이벤트의 주기적 업데이트를 구독할 수도 있습니다. 따라서 정기 결제 거래에 따르는 주기적인 데이터 업데이트의 결과로 동일한 보고서 데이터 작업이 생성될 수 있습니다.

정기 결제 상호작용은 2개의 노드 간에 관계를 만들고, 여기서 타겟은 시작자에게 보고서 데이터 작업을 주기적으로 생성합니다. 개시자는 구독자이고 타겟은 게시자입니다.

구독 요청 작업에는 다음이 포함됩니다.

  • Min Interval Floor(최소 간격 최솟값): 보고서 간의 최소 간격입니다.
  • Max Interval Ceiling(최대 간격 상한): 보고서 간의 최대 간격입니다.
  • 속성 보고서: 읽기 작업 요청에서 요청된 0개 이상의 보고된 속성 목록입니다.
  • 이벤트 보고서: 보고된 이벤트 0개 이상의 목록입니다.

구독 요청 후 대상은 보고된 데이터의 첫 번째 배치인 프라이밍된 게시 데이터가 포함된 보고서 데이터 작업을 사용하여 시작자에게 응답합니다.

그런 다음 개시자는 타겟에 전송된 상태 응답 작업으로 보고서 데이터 작업을 확인합니다. 타겟은 오류를 보고하는 상태 응답 작업을 수신하면 구독 응답 작업을 전송합니다.

이후 타겟은 이후 협상된 간격으로 보고서 데이터 작업을 주기적으로 전송하며, 개시자는 구독이 손실되거나 취소될 때까지 이러한 작업에 응답합니다.

구독 응답 작업

방향: 타겟 -> 개시자

정기 결제 거래에 관한 마지막 작업이며 프로세스가 종료됩니다. It includes:

  • 정기 결제 ID: 정기 결제를 식별하는 정수입니다.
  • 최소 간격: 보고서 간의 최종, 결정된 최소 간격입니다.
  • 최대 간격: 보고서 간의 최종, 결정된 최대 간격입니다.

구독 제한

  • 구독 요청 작업과 구독 응답 작업은 Unicast 전용 작업입니다.
  • 구독 상호작용의 모든 보고서 데이터 작업은 구독 ID가 동일해야 합니다.
  • 구독자가 작업 간 최대 협상 간격 내에 보고서 데이터 작업을 수신하지 않으면 정기 결제가 종료됩니다.
  • 이전 규칙에 따라 게시자는 주기적 보고서 데이터 작업 전송을 중지하여 정기 결제 상호작용을 종료할 수 있습니다.
  • 구독자는 INACTIVE_SUBSCRIPTION 상태 코드로 보고서 데이터 작업에 응답하여 정기 결제 상호작용을 종료할 수 있습니다.