읽기 트랜잭션

트랜잭션 읽기

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

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

읽기 요청 작업

방향: 개시자 -> 타겟

이 작업에서 개시자는 다음을 제공하여 대상에 쿼리합니다.

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

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

데이터 보고 작업

안내: 타겟 -> 개시자

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

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

상태 응답 작업

방향: 타겟 -> 개시자 또는 개시자 -> 타겟

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

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

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

읽기 제한사항

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

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

구독 거래

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

구독 요청 작업

방향: 개시자 -> 타겟

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

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

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

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

구독 요청 후 타겟은 보고된 데이터의 첫 번째 배치인 Primed Published Data가 포함된 보고서 데이터 작업으로 개시자에게 응답합니다.

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

이후 타겟은 협상된 간격으로 데이터 작업 보고서를 정기적으로 전송하고, 개시자는 정기 결제가 취소되거나 취소될 때까지 이러한 작업에 응답합니다.

구독 응답 작업

안내: 타겟 -> 개시자

이는 정기 결제 트랜잭션의 마지막 작업으로서 프로세스를 종료합니다. 다음과 같은 항목이 포함됩니다.

  • 구독 ID: 구독을 식별하는 정수입니다.
  • 최소 간격: 보고서 간의 최종 결정된 최소 간격입니다.
  • 최대 간격: 보고서 간의 최종 결정된 최대 간격입니다.

구독 제한사항

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