nl::
이 네임스페이스에는 지원 중단될 Weave 데이터 관리 (WDM) 프로필을 위한 Weave 내의 모든 인터페이스가 포함되어 있습니다.
요약
Typedef |
|
|---|---|
TopicIdentifier
|
typedefuint64_t
주제 식별자입니다. |
함수 |
|
|---|---|
CheckTLVType(nl::Weave::TLV::TLVType aType, nl::Weave::TLV::TLVReader & aReader)
|
bool
|
CheckWDMTag(uint32_t aTagNum, nl::Weave::TLV::TLVReader & aReader)
|
bool
WDM 관련 태그를 확인합니다.
|
CloseDataListElement(nl::Weave::TLV::TLVReader & aReader)
|
WDM 데이터 목록 요소 읽기를 중지합니다.
|
CloseList(nl::Weave::TLV::TLVReader & aReader)
|
WDM 경로 또는 데이터 목록 읽기를 중지합니다.
|
EncodeDeprecatedPath(TLVWriter & aWriter, const uint64_t & aTag, uint32_t aProfileId, const uint64_t & aInstanceId, uint32_t aPathLen, ...)
|
지원 중단된 태그와 정수 인스턴스 ID를 사용하여 WDM 경로를 인코딩합니다.
|
EncodeDeprecatedPath(TLVWriter & aWriter, const uint64_t & aTag, uint32_t aProfileId, const char *aInstanceId, uint32_t aPathLen, ...)
|
지원 중단된 태그 및 문자열 인스턴스 ID로 WDM 경로를 인코딩합니다.
|
EncodePath(TLVWriter & aWriter, const uint64_t & aTag, uint32_t aProfileId, const uint64_t & aInstanceId, uint32_t aPathLen, ...)
|
정수 프로필 인스턴스 ID로 WDM 경로를 인코딩합니다.
|
EncodePath(TLVWriter & aWriter, const uint64_t & aTag, uint32_t aProfileId, const uint32_t aInstanceIdLen, const uint8_t *aInstanceId, uint32_t aPathLen, ...)
|
바이트 배열 인스턴스 ID로 WDM 경로를 인코딩합니다.
|
EncodePath(TLVWriter & aWriter, const uint64_t & aTag, uint32_t aProfileId, const char *aInstanceId, uint32_t aPathLen, ...)
|
문자열 인스턴스 ID로 WDM 경로를 인코딩합니다.
|
EndDataListElement(nl::Weave::TLV::TLVWriter & aWriter)
|
데이터 목록 요소 작성을 완료합니다.
|
EndEncodePath(TLVWriter & aWriter, TLVType & mOuterContainer, WEAVE_ERROR mError)
|
|
EndList(nl::Weave::TLV::TLVWriter & aWriter)
|
경로 목록 또는 데이터 목록 작성을 완료합니다.
|
EndList(ReferencedTLVData & aList, nl::Weave::TLV::TLVWriter & aWriter)
|
경로 목록 또는 데이터 목록 작성을 완료합니다.
|
IsPublisherSpecific(const TopicIdentifier & aTopicId)
|
bool
게시자별 주제 ID인지 확인합니다.
|
OpenDataList(ReferencedTLVData & aDataList, nl::Weave::TLV::TLVReader & aReader)
|
데이터 목록 읽기를 시작합니다.
|
OpenDataListElement(nl::Weave::TLV::TLVReader & aReader, nl::Weave::TLV::TLVReader & aPathReader, uint64_t & aVersion)
|
데이터 목록 요소 읽기를 시작합니다.
|
OpenPathList(ReferencedTLVData & aPathList, nl::Weave::TLV::TLVReader & aReader)
|
경로 목록 읽기를 시작합니다.
|
PublisherSpecificTopicId(void)
|
게시자별 주제 ID를 처음부터 생성합니다.
|
SendStatusReport(ExchangeContext *aExchangeCtx, StatusReport & aStatus)
|
|
StartDataList(nl::Weave::TLV::TLVWriter & aWriter)
|
데이터 목록 작성을 시작합니다.
|
StartDataList(ReferencedTLVData & aDataList, nl::Weave::TLV::TLVWriter & aWriter)
|
지정된 ReferencedTLVData 객체에 데이터 목록 작성을 시작합니다.
|
StartDataListElement(nl::Weave::TLV::TLVWriter & aWriter)
|
데이터 목록 요소를 작성합니다.
|
StartEncodePath(TLVWriter & aWriter, const uint64_t & aTag, uint32_t aProfileId, TLVType & mOuterContainer, TLVType & mPath)
|
|
StartPathList(nl::Weave::TLV::TLVWriter & aWriter)
|
경로 목록을 작성합니다.
|
TxnResponseHandler(ExchangeContext *anExchangeCtx, const IPPacketInfo *anAddrInfo, const WeaveMessageInfo *aMsgInfo, uint32_t aProfileId, uint8_t aMsgType, PacketBuffer *aMsg)
|
void
|
TxnTimeoutHandler(ExchangeContext *anExchangeCtx)
|
void
|
ValidateTLVType(nl::Weave::TLV::TLVType aType, nl::Weave::TLV::TLVReader & aReader)
|
|
ValidateWDMTag(uint32_t aTagNum, nl::Weave::TLV::TLVReader & aReader)
|
읽는 TLV 요소에 예상 WDM 태그가 있는지 확인합니다.
|
클래스 |
|
|---|---|
|
nl:: |
Binding 클래스는 Weave를 사용하여 애플리케이션 항목을 대신하여 통신 상태를 관리합니다. |
|
nl:: |
WDM 클라이언트에서 요구하는 확인 및 표시 메서드 정의를 포함하는 추상 클래스입니다. |
|
nl:: |
WDM 클라이언트에서 구독 및 알림 지원이 필요한 경우 사용되는 보조 클래스입니다. |
|
nl:: |
애플리케이션별 WDM 클라이언트의 기본 추상 클래스입니다. |
|
nl:: |
애플리케이션별 WDM 게시자를 위한 추상 기본 클래스입니다. |
|
nl:: |
추상 ProfileDatabase 보조 클래스입니다. |
|
nl:: |
WDM 프로토콜 엔진 클래스입니다. |
|
nl:: |
WDM 게시자가 요구하는 확인 및 알림 메서드 정의를 포함하는 추상 클래스입니다. |
열거형
@103
@103
| 속성 | |
|---|---|
kStatus_CancelSuccess
|
이 기존 상태 코드는 구독이 취소되었음을 의미합니다. 이 상태 코드는 구독이 성공적으로 취소되었음을 의미합니다. |
kStatus_IllegalReadRequest
|
이 레거시 상태 코드는 특정 데이터 항목을 읽기 위해 요청하는 노드에 권한이 없음을 의미합니다. 이 상태 코드는 특정 데이터 항목을 읽기 위해 요청한 노드에 읽기 권한이 없음을 의미합니다. |
kStatus_IllegalWriteRequest
|
이 레거시 상태 코드는 특정 데이터 항목에 쓰기를 요청하는 노드에 쓰기 권한이 없음을 의미합니다. 이 상태 코드는 특정 데이터 항목 쓰기를 요청하는 노드에 쓰기 권한이 없음을 의미합니다. |
kStatus_InvalidPath
|
이 기존 상태 코드는 뷰 또는 업데이트 요청 프레임의 경로 목록의 경로가 응답자의 노드 상주 스키마와 일치하지 않음을 의미합니다. 이 상태 코드는 뷰 또는 업데이트 요청 프레임의 경로 목록의 경로가 응답자의 노드 상주 스키마와 일치하지 않음을 의미합니다. |
kStatus_InvalidVersion
|
이 기존 상태 코드는 업데이트 요청에 포함된 데이터의 버전이 게시자의 최신 버전과 일치하지 않아 업데이트를 적용할 수 없음을 의미합니다. 이 상태 코드는 업데이트 요청에 포함된 데이터의 버전이 게시자의 최신 버전과 일치하지 않아 업데이트를 적용할 수 없음을 의미합니다. |
kStatus_UnknownTopic
|
이 기존 상태 코드는 취소 요청 또는 알림에 제공된 주제 식별자가 수신 노드에 존재하는 구독과 일치하지 않음을 의미합니다. 이 상태 코드는 취소 요청 또는 알림에 제공된 주제 식별자가 수신 노드에 존재하는 구독과 일치하지 않음을 의미합니다. |
kStatus_UnsupportedSubscriptionMode
|
이 레거시 상태 코드는 요청된 구독 모드가 수신 기기에서 지원되지 않음을 의미합니다. 이 상태 코드는 수신 기기에서 요청된 구독 모드를 지원하지 않음을 의미합니다. |
@166
@166
WDM 풀 및 테이블 크기
WDM은 작업에 필요한 다양한 풀과 테이블을 다음과 같이 정의합니다.
클라이언트 트랜잭션 풀:
- kViewPoolSize
- kSubscribePoolSize
- kCancelSubscriptionPoolSize
- kUpdatePoolSize
게시자 거래 풀:
- kNotifyPoolSize
프로토콜 엔진 테이블:
- kTransactionTableSize
- kBindingTableSize
구독 관련 테이블:
- kNotifierTableSize (클라이언트 전용)
- kSubscriptionMgrTableSize (게시자 전용)
이는 수량을 구성할 수 있으며 플랫폼별 값은 연결된 WeaveConfig.h에 표시됩니다.
| 속성 | |
|---|---|
kBindingTableSize
|
WDM 프로토콜 엔진에서 결합 테이블의 기본 크기입니다. 이 값은 WEAVE_CONFIG_WDM_BINDING_TABLE_SIZE를 통해 구성할 수 있습니다. |
kCancelSubscriptionPoolSize
|
WDM 클라이언트의 구독 취소 요청 트랜잭션 풀의 기본 크기입니다. 이 값은 WEAVE_CONFIG_WDM_CANCEL_SUBSCRIPTION_POOL_SIZE를 통해 구성할 수 있습니다. |
kNotifierTableSize
|
WDM 클라이언트에 대한 알림 표의 기본 크기입니다. 이 값은 WEAVE_CONFIG_WDM_NOTIFIER_TABLE_SIZE를 통해 구성할 수 있습니다. |
kNotifyPoolSize
|
WDM 게시자의 알림 요청 트랜잭션 풀의 기본 크기입니다. 이 값은 WEAVE_CONFIG_WDM_NOTIFY_POOL_SIZE를 통해 구성할 수 있습니다. |
kSubscribePoolSize
|
WDM 클라이언트의 구독 요청 트랜잭션 풀의 기본 크기입니다. 이 값은 WEAVE_CONFIG_WDM_SUBSCRIBE_POOL_SIZE를 통해 구성할 수 있습니다. |
kSubscriptionMgrTableSize
|
WDM 게시자의 경우 구독 표의 기본 크기입니다. 이 값은 WEAVE_CONFIG_WDM_SUBSCRIPTION_MGR_TABLE_SIZE를 통해 구성할 수 있습니다. |
kTransactionTableSize
|
WDM 프로토콜 엔진에서 트랜잭션 표의 기본 크기입니다. 이 값은 WEAVE_CONFIG_WDM_TRANSACTION_TABLE_SIZE를 통해 구성할 수 있습니다. |
kUpdatePoolSize
|
WDM 클라이언트의 업데이트 요청 트랜잭션 풀의 기본 크기입니다. 이 값은 WEAVE_CONFIG_WDM_UPDATE_POOL_SIZE를 통해 구성할 수 있습니다. |
kViewPoolSize
|
WDM 클라이언트의 뷰 요청 트랜잭션 풀의 기본 크기입니다. 이 값은 WEAVE_CONFIG_WDM_VIEW_POOL_SIZE를 통해 구성할 수 있습니다. |
@167
@167
WDM 프로필 메시지 유형입니다.
이러한 값은 데이터 관리 사양에서 호출됩니다.
참고!! 2015년 1분기 현재, 이전 버전의 WDM에서 사용된 메시지 유형이 지원 중단되고 새 메시지 유형이 정의되었습니다. 이는 명확한 중단을 정당화하기 위해 과거의 압축 및 파싱 세부정보와 함께 충분한 변화를 반영했기 때문입니다.
| 속성 | |
|---|---|
kMsgType_CancelSubscriptionRequest
|
구독 요청 취소 메시지입니다. |
kMsgType_CancelSubscriptionRequest_Deprecated
|
지원 중단됨 |
kMsgType_NotifyRequest
|
요청 메시지를 알립니다. |
kMsgType_NotifyRequest_Deprecated
|
지원 중단됨 |
kMsgType_SubscribeRequest
|
구독 요청 메시지입니다. |
kMsgType_SubscribeRequest_Deprecated
|
지원 중단됨 |
kMsgType_SubscribeResponse
|
구독 응답 메시지입니다. |
kMsgType_SubscribeResponse_Deprecated
|
지원 중단됨 |
kMsgType_UpdateRequest
|
업데이트 요청 메시지입니다. |
kMsgType_UpdateRequest_Deprecated
|
지원 중단됨 |
kMsgType_ViewRequest
|
요청 메시지 보기 |
kMsgType_ViewRequest_Deprecated
|
지원 중단됨 |
kMsgType_ViewResponse
|
응답 메시지 보기 |
kMsgType_ViewResponse_Deprecated
|
지원 중단됨 |
@168
@168
기타 WDM 관련 상수입니다.
| 속성 | |
|---|---|
kDefaultBindingTableIndex
|
항목이 2개 이상 있는 프로토콜 엔진 바인딩 테이블에 있는 기본 바인딩의 색인입니다. |
kInstanceIdNotSpecified
|
프로필 인스턴스 지정이 필요한 호출에서는 '없음'을 나타냅니다. 대부분의 경우 해당 항목에 프로필의 인스턴스가 하나만 있음을 의미합니다. |
kResponseTimeoutNotSpecified
|
트랜잭션을 요청하는 메서드에서 호출자가 시간 제한 지정을 거부했음을 나타냅니다. 일반적으로 이는 기본값을 사용해야 함을 의미합니다. |
kTransactionIdNotSpecified
|
거래 ID를 사용하는 메서드 및 데이터 구조에서는 '없음' 또는 와일드 카드 값을 나타냅니다. |
kVersionNotSpecified
|
데이터 버전의 사양이 필요한 호출에서는 '특정 버전이 없음'을 나타냅니다. |
kWeaveTLVControlByteLen
|
|
kWeaveTLVTagLen
|
정규화된 TLV 태그의 표준 길이(바이트)로, TLV에서 WDM 구조를 인코딩하는 지원 메서드에 사용됩니다. |
@169
@169
WDM 관련 상태 코드.
| 속성 | |
|---|---|
kStatus_CancelSuccess
|
이 기존 상태 코드는 구독이 취소되었음을 의미합니다. 이 상태 코드는 구독이 성공적으로 취소되었음을 의미합니다. |
kStatus_IllegalReadRequest
|
이 레거시 상태 코드는 특정 데이터 항목을 읽기 위해 요청하는 노드에 권한이 없음을 의미합니다. 이 상태 코드는 특정 데이터 항목을 읽기 위해 요청한 노드에 읽기 권한이 없음을 의미합니다. |
kStatus_IllegalWriteRequest
|
이 레거시 상태 코드는 특정 데이터 항목에 쓰기를 요청하는 노드에 쓰기 권한이 없음을 의미합니다. 이 상태 코드는 특정 데이터 항목 쓰기를 요청하는 노드에 쓰기 권한이 없음을 의미합니다. |
kStatus_InvalidPath
|
이 기존 상태 코드는 뷰 또는 업데이트 요청 프레임의 경로 목록의 경로가 응답자의 노드 상주 스키마와 일치하지 않음을 의미합니다. 이 상태 코드는 뷰 또는 업데이트 요청 프레임의 경로 목록의 경로가 응답자의 노드 상주 스키마와 일치하지 않음을 의미합니다. |
kStatus_InvalidVersion
|
이 기존 상태 코드는 업데이트 요청에 포함된 데이터의 버전이 게시자의 최신 버전과 일치하지 않아 업데이트를 적용할 수 없음을 의미합니다. 이 상태 코드는 업데이트 요청에 포함된 데이터의 버전이 게시자의 최신 버전과 일치하지 않아 업데이트를 적용할 수 없음을 의미합니다. |
kStatus_UnknownTopic
|
이 기존 상태 코드는 취소 요청 또는 알림에 제공된 주제 식별자가 수신 노드에 존재하는 구독과 일치하지 않음을 의미합니다. 이 상태 코드는 취소 요청 또는 알림에 제공된 주제 식별자가 수신 노드에 존재하는 구독과 일치하지 않음을 의미합니다. |
kStatus_UnsupportedSubscriptionMode
|
이 레거시 상태 코드는 요청된 구독 모드가 수신 기기에서 지원되지 않음을 의미합니다. 이 상태 코드는 수신 기기에서 요청된 구독 모드를 지원하지 않음을 의미합니다. |
@170
@170
데이터 관리 프로토콜 태그.
데이터 관리 프로토콜은 프로필 데이터의 TLV 표현에 사용되는 여러 태그를 정의합니다.
평소와 같이 새 WDM과 이전 버전 사이에 호환성 문제가 있습니다. 예전에는 이러한 태그가 모두 프로필에 따라 적용되었기 때문에 공간 낭비가 되었습니다. 이제는 가능한 경우 컨텍스트 태그를 사용하고 있지만 적절한 경우 이전 태그를 유지하고 이를 포함하는 경로를 인코딩하기 위한 메커니즘을 마련해야 합니다.
kTag_WDMDataListElementData 태그는 이전 출시에서 사용되지 않았으며 코드에서 완전히 무시되었으므로 지원 중단된 버전을 제공할 필요가 없습니다.
| 속성 | |
|---|---|
kTag_WDMDataList
|
요소는 경로, 선택적 버전, 데이터 요소를 포함하는 구조의 목록입니다. 태그 유형: 프로필별 요소 유형: 배열 처리: 최상위 |
kTag_WDMDataListElementData
|
이 요소는 지정된 경로로 가리키고 지정된 버전을 가진 데이터를 나타냅니다. 태그 유형: 컨텍스트 관련 요소 유형: 모든 처리: 필수 |
kTag_WDMDataListElementData_Deprecated
|
지원이 중단되었습니다. 태그 유형: 컨텍스트 관련 요소 유형: 모든 처리: 필수 |
kTag_WDMDataListElementPath
|
요소는 데이터 목록 요소의 경로 구성요소입니다. 태그 유형: 컨텍스트 관련 요소 유형: 경로 처리: 필수 |
kTag_WDMDataListElementPath_Deprecated
|
지원이 중단되었습니다. 태그 유형: 프로필별 요소 유형: 경로 처리: 필수 |
kTag_WDMDataListElementVersion
|
요소는 데이터 목록 요소의 버전 구성요소입니다. 태그 유형: 컨텍스트 관련 요소 유형: 정수 처리: 필수 |
kTag_WDMDataListElementVersion_Deprecated
|
지원이 중단되었습니다. 태그 유형: 프로필별 요소 유형: 정수 처리: 필수 |
kTag_WDMPathArrayIndexSelector
|
경로 요소는 스키마의 배열에 해당하며, 포함된 정수 요소는 해당 배열의 색인으로 사용됩니다. 태그 유형: 프로필별 요소 유형: 정수 처리: 선택사항 |
kTag_WDMPathArrayValueSelector
|
경로 요소는 스키마의 배열에 해당하며 캡슐화된 요소는 레코드 선택기로 사용됩니다. 태그 유형: 프로필별 요소 유형: 구조 처리: 선택사항 |
kTag_WDMPathList
|
이 요소는 TLV 경로의 목록입니다. 태그 유형: 프로필별 요소 유형: 배열 처리: 최상위 |
kTag_WDMPathProfile
|
이 요소는 경로를 시작하는 데 사용되는 구조이며, 경로의 태그를 해석해야 하는 프로필 정보를 포함합니다. 태그 유형: 프로필별 요소 유형: 구조 처리: 필수 |
kTag_WDMPathProfileId
|
요소는 TLV 경로를 시작하는 경로 프로필 요소의 프로필 ID 구성요소입니다. 태그 유형: 컨텍스트 관련 요소 유형: 정수 처리: 필수 |
kTag_WDMPathProfileId_Deprecated
|
지원이 중단되었습니다. 태그 유형: 프로필별 요소 유형: 정수 처리: 필수 |
kTag_WDMPathProfileInstance
|
이 요소는 프로필 인스턴스이며 TLV 경로에서 프로필 ID를 따를 수 있습니다. 노드에는 특정 프로필의 인스턴스가 여러 개 있을 수도 있고 그렇지 않을 수도 있으며, 인스턴스가 하나만 있는 경우 이 요소를 생략해도 됩니다. 태그 유형: 컨텍스트 관련 요소 유형: 모든 처리: 선택사항 |
kTag_WDMPathProfileInstance_Deprecated
|
지원이 중단되었습니다. 태그 유형: 프로필별 요소 유형: 모든 처리: 선택사항 |
@171
@171
고유한 주제 ID입니다.
관심 있는 주제 ID에는 세 가지가 있으며 모두 '게시자별' 형식으로 지정되어 있습니다.
| 속성 | |
|---|---|
kAnyTopicId
|
와일드 카드 주제 ID로 예약되어 있습니다. |
kTopicIdNotSpecified
|
유효하지 않은 와일드 카드 주제 ID나 와일드 카드 주제 ID를 표현하기 위해 예약된 특수 값입니다. |
kTopicIdPublisherSpecificMask
|
Topci ID를 만들거나 분해하기 위한 마스크로 사용됩니다. |
WeaveTransportOption
WeaveTransportOption
WDM 전송 옵션
이들은 WDM의 상호 배타적인 전송 옵션입니다.
| 속성 | |
|---|---|
kTransport_TCP
|
기본 전송은 TCP입니다 바인딩은 서비스 관리자를 사용하거나 직접 메시지 레이어를 사용하여 완료할 수 있습니다. |
kTransport_UDP
|
기본 전송은 오직 UDP입니다. |
kTransport_WRMP
|
기본 전송은 전적으로 UDP이지만 '애플리케이션 지원 레이어' 안정성이 개선되었습니다. |
Typedef
TopicIdentifier
uint64_t TopicIdentifier
주제 식별자입니다.
주제 식별자는 서로 관련된 두 가지 용도/의미가 있는 64비트 수량입니다. 우선 'Nest 연기 감지기'와 같이 잘 알려진 경로의 일반적인 약식으로 사용할 수 있습니다. 이러한 방식으로 사용되는 주제 ID는 프로필 식별자와 마찬가지로 다음과 같이 서로 다른 공급업체가 자율적으로 선택한 주제 ID의 충돌을 방지하는 공급업체 코드를 포함해야 합니다.
| 비트 48~63 | 비트 0~47 |
| 공급업체 ID | 주제 번호 |
WeaveVendorIdentifiers.hpp
함수
CheckTLVType
bool CheckTLVType( nl::Weave::TLV::TLVType aType, nl::Weave::TLV::TLVReader & aReader )
CheckWDMTag
bool CheckWDMTag( uint32_t aTagNum, nl::Weave::TLV::TLVReader & aReader )
CloseDataListElement
WEAVE_ERROR CloseDataListElement( nl::Weave::TLV::TLVReader & aReader )
WDM 데이터 목록 요소 읽기를 중지합니다.
이 메서드는 해당 요소가 WDM 데이터 목록의 일부라고 가정하므로 kTLVType_Array를 ExitContainer()에 전달합니다.
| 세부정보 | |||
|---|---|---|---|
| 매개변수 |
|
||
| 반환 |
성공 시 WEAVE_NO_ERROR 그 외의 경우에는 컨테이너를 종료할 수 없음을 반영하는 WEAVE_ERROR를 반환합니다.
|
||
CloseList
WEAVE_ERROR CloseList( nl::Weave::TLV::TLVReader & aReader )
WDM 경로 또는 데이터 목록 읽기를 중지합니다.
이 메서드는 문제의 목록이 최상위 TLV 요소라고 가정하므로 kTLVType_Sructure를 ExitContainer()에 전달합니다.
| 세부정보 | |||
|---|---|---|---|
| 매개변수 |
|
||
| 반환 |
성공 시 WEAVE_NO_ERROR 그 외의 경우에는 컨테이너를 종료할 수 없음을 반영하는 WEAVE_ERROR를 반환합니다.
|
||
EncodeDeprecatedPath
WEAVE_ERROR EncodeDeprecatedPath( TLVWriter & aWriter, const uint64_t & aTag, uint32_t aProfileId, const uint64_t & aInstanceId, uint32_t aPathLen, ... )
지원 중단된 태그와 정수 인스턴스 ID를 사용하여 WDM 경로를 인코딩합니다.
참고: Weave 버전 2.0 이전에 서비스에서 허용하는 지원 중단된 태그 집합을 사용하여 경로를 인코딩하세요. 이 버전의 메서드는 숫자 인스턴스 식별자를 사용합니다. 이 메서드는 ProfileTag(kWeaveProfile_WDM, kTag_WDMPathProfile)로 컨테이너를 시작한 다음 ProfileTag(kWeaveProfile_WDM, kTag_WDMPathProfileId_Deprecated)로 프로필 ID를 삽입합니다. 그런 다음 ProfileTag(kWeaveProfile_WDM, kTag_WDMPathProfileInstance_Deprecated)를 사용하여 인스턴스 ID를 삽입합니다. 이는 경로를 인코딩하는 데 사용되지 않는 버전 중 하나이며 새 디자인에서는 이 형식을 사용하지 않아야 합니다.
| 세부정보 | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 매개변수 |
|
||||||||||||
| 반환 |
성공 시 WEAVE_NO_ERROR 그 외의 경우에는 지정된 경로의 형식을 지정할 수 없음을 반영하는 WEAVE_ERROR를 반환합니다.
|
||||||||||||
EncodeDeprecatedPath
WEAVE_ERROR EncodeDeprecatedPath( TLVWriter & aWriter, const uint64_t & aTag, uint32_t aProfileId, const char *aInstanceId, uint32_t aPathLen, ... )
지원 중단된 태그 및 문자열 인스턴스 ID로 WDM 경로를 인코딩합니다.
참고: 지원 중단된 태그 집합을 사용하여 경로를 인코딩합니다 (DMConstants.h 참고). 이 버전의 메서드는 인스턴스 ID 문자열을 사용합니다. 이 메서드는 ProfileTag(kWeaveProfile_WDM, kTag_WDMPathProfile)로 컨테이너를 시작한 다음 ProfileTag(kWeaveProfile_WDM, kTag_WDMPathProfileId_Deprecated)로 프로필 ID를 삽입합니다. 그런 다음 ProfileTag(kWeaveProfile_WDM, kTag_WDMPathProfileInstance_Deprecated)를 사용하여 인스턴스 ID를 삽입합니다. 이는 경로를 인코딩하는 데 사용되지 않는 버전 중 하나이며 새 디자인에서는 이 형식을 사용하지 않아야 합니다.
| 세부정보 | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 매개변수 |
|
||||||||||||
| 반환 |
성공 시 WEAVE_NO_ERROR 그 외의 경우에는 지정된 경로의 형식을 지정할 수 없음을 반영하는 WEAVE_ERROR를 반환합니다.
|
||||||||||||
EncodePath
WEAVE_ERROR EncodePath( TLVWriter & aWriter, const uint64_t & aTag, uint32_t aProfileId, const uint64_t & aInstanceId, uint32_t aPathLen, ... )
정수 프로필 인스턴스 ID로 WDM 경로를 인코딩합니다.
참고: 특히 후속 경로 요소를 해석할 수 있도록 시작 부분에 프로필 지정이 있는 경우 데이터 관리에 사용되는 종류의 TLV 경로를 작성하세요. 이 메서드 버전은 정수 프로필 인스턴스 ID를 사용합니다.
이 메서드는 경로 인코딩을 위한 최신 버전인 ContextTag(kTag_WDMPathProfileInstance)를 사용하여 인스턴스 ID를 삽입합니다.
| 세부정보 | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 매개변수 |
|
||||||||||||
| 반환 |
성공 시 WEAVE_NO_ERROR 그 외의 경우에는 지정된 경로의 형식을 지정할 수 없음을 반영하는 WEAVE_ERROR를 반환합니다.
|
||||||||||||
EncodePath
WEAVE_ERROR EncodePath( TLVWriter & aWriter, const uint64_t & aTag, uint32_t aProfileId, const uint32_t aInstanceIdLen, const uint8_t *aInstanceId, uint32_t aPathLen, ... )
바이트 배열 인스턴스 ID로 WDM 경로를 인코딩합니다.
참고: 특히 후속 경로 요소를 해석할 수 있도록 시작 부분에 프로필 지정이 있는 경우 데이터 관리에 사용되는 종류의 TLV 경로를 작성하세요. 이 버전의 메서드는 길이와 함께 바이트 배열 프로필 인스턴스 ID를 사용합니다.
이 메서드는 경로 인코딩을 위한 최신 버전인 ContextTag(kTag_WDMPathProfileInstance)를 사용하여 인스턴스 ID를 삽입합니다.
| 세부정보 | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 매개변수 |
|
||||||||||||||
| 반환 |
성공 시 WEAVE_NO_ERROR 그 외의 경우에는 지정된 경로의 형식을 지정할 수 없음을 반영하는 WEAVE_ERROR를 반환합니다.
|
||||||||||||||
EncodePath
WEAVE_ERROR EncodePath( TLVWriter & aWriter, const uint64_t & aTag, uint32_t aProfileId, const char *aInstanceId, uint32_t aPathLen, ... )
문자열 인스턴스 ID로 WDM 경로를 인코딩합니다.
참고: 특히 후속 경로 요소를 해석할 수 있도록 시작 부분에 프로필 지정이 있는 경우 데이터 관리에 사용되는 종류의 TLV 경로를 작성하세요. 이 메서드 버전은 문자열 프로필 인스턴스 ID를 사용합니다.
이 메서드는 경로 인코딩을 위한 최신 버전인 ContextTag(kTag_WDMPathProfileInstance)를 사용하여 인스턴스 ID를 삽입합니다.
| 세부정보 | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 매개변수 |
|
||||||||||||
| 반환 |
성공 시 WEAVE_NO_ERROR 그 외의 경우에는 지정된 경로의 형식을 지정할 수 없음을 반영하는 WEAVE_ERROR를 반환합니다.
|
||||||||||||
EndDataListElement
WEAVE_ERROR EndDataListElement( nl::Weave::TLV::TLVWriter & aWriter )
데이터 목록 요소 작성을 완료합니다.
WDM 데이터 목록 요소의 끝에 대한 TLV를 작성합니다. 항상 목록 항목을 닫는다고 가정하여 kTLVType_Array 유형을 EndContainer() 호출에 자동으로 전달합니다.
| 세부정보 | |||
|---|---|---|---|
| 매개변수 |
|
||
| 반환 |
성공 시 WEAVE_NO_ERROR 그 외의 경우에는 컨테이너를 종료할 수 없음을 반영하는 WEAVE_ERROR를 반환합니다.
|
||
EndEncodePath
WEAVE_ERROR EndEncodePath( TLVWriter & aWriter, TLVType & mOuterContainer, WEAVE_ERROR mError )
EndList
WEAVE_ERROR EndList( nl::Weave::TLV::TLVWriter & aWriter )
경로 목록 또는 데이터 목록 작성을 완료합니다.
WDM 경로 또는 데이터 목록 끝에 TLV를 작성합니다. 마지막으로 작성자를 마무리합니다.
| 세부정보 | |||
|---|---|---|---|
| 매개변수 |
|
||
| 반환 |
성공 시 WEAVE_NO_ERROR 그 외의 경우에는 컨테이너를 종료할 수 없음을 반영하는 WEAVE_ERROR를 반환합니다.
|
||
EndList
WEAVE_ERROR EndList( ReferencedTLVData & aList, nl::Weave::TLV::TLVWriter & aWriter )
경로 목록 또는 데이터 목록 작성을 완료합니다.
WDM 경로 또는 데이터 목록 끝에 TLV를 작성합니다. 마지막으로 작성자를 마무리합니다. 이 경우 TLV가 작성되는 ReferencedTLVData 객체가 전달되고 작성된 데이터의 양을 반영하도록 수정됩니다.
| 세부정보 | |||||
|---|---|---|---|---|---|
| 매개변수 |
|
||||
| 반환 |
성공 시 WEAVE_NO_ERROR 그 외의 경우에는 컨테이너를 종료할 수 없음을 반영하는 WEAVE_ERROR를 반환합니다.
|
||||
IsPublisherSpecific
bool IsPublisherSpecific( const TopicIdentifier & aTopicId )
게시자별 주제 ID인지 확인합니다.
| 세부정보 | |||
|---|---|---|---|
| 매개변수 |
|
||
| 반환 |
주제 ID가 게시자별이면 true, 그렇지 않으면 false입니다.
|
||
OpenDataList
WEAVE_ERROR OpenDataList( ReferencedTLVData & aDataList, nl::Weave::TLV::TLVReader & aReader )
데이터 목록 읽기를 시작합니다.
새로운 리더와 데이터 목록이 주어지면 목록을 읽고 그 과정에서 처음 만났던 태그와 유형을 확인하세요. 순조롭게 진행되면 목록 컨테이너가 입력된 후 리더가 중지됩니다.
| 세부정보 | |||||
|---|---|---|---|---|---|
| 매개변수 |
|
||||
| 반환 |
성공 시 WEAVE_NO_ERROR 그 외의 경우에는 실패를 반영하여 WEAVE_ERROR를 반환하고 데이터 목록을 열거나 관련 태그 및 유형을 검증합니다.
|
||||
OpenDataListElement
WEAVE_ERROR OpenDataListElement( nl::Weave::TLV::TLVReader & aReader, nl::Weave::TLV::TLVReader & aPathReader, uint64_t & aVersion )
데이터 목록 요소 읽기를 시작합니다.
데이터 목록 요소에 위치한 리더가 주어지면 요소를 읽기 시작하고 프로세스에서 처음 나타난 태그 및 유형을 확인합니다. 순조롭게 진행되면 판독기가 데이터 요소 데이터에 배치되고 입출력 경로 판독기가 해당 경로에 배치됩니다.
| 세부정보 | |||||||
|---|---|---|---|---|---|---|---|
| 매개변수 |
|
||||||
| 반환 |
성공 시 WEAVE_NO_ERROR 또는 데이터 목록 요소 열기 및 읽기와 관련된 WEAVE_ERROR입니다.
|
||||||
OpenPathList
WEAVE_ERROR OpenPathList( ReferencedTLVData & aPathList, nl::Weave::TLV::TLVReader & aReader )
경로 목록 읽기를 시작합니다.
새로운 판독기와 경로 목록이 주어지면 목록을 읽고 그 과정에서 처음 만났던 태그와 유형을 확인합니다. 순조롭게 진행되면 목록 컨테이너가 입력된 후 리더가 중지됩니다.
| 세부정보 | |||||
|---|---|---|---|---|---|
| 매개변수 |
|
||||
| 반환 |
성공 시 WEAVE_NO_ERROR, 실패 시 실패를 반영하는 WEAVE_ERROR로, 경로 목록을 열거나 관련 태그 및 유형을 검증합니다.
|
||||
PublisherSpecificTopicId
TopicIdentifier PublisherSpecificTopicId( void )
게시자별 주제 ID를 처음부터 생성합니다.
| 세부정보 | |
|---|---|
| 반환 |
새 주제 식별자입니다
|
SendStatusReport
WEAVE_ERROR SendStatusReport( ExchangeContext *aExchangeCtx, StatusReport & aStatus )
StartDataList
WEAVE_ERROR StartDataList( nl::Weave::TLV::TLVWriter & aWriter )
데이터 목록 작성을 시작합니다.
WDM 데이터 목록의 시작 부분에 대한 TLV를 작성합니다(예: UpdateRequest()의 기본 인수로).
| 세부정보 | |||
|---|---|---|---|
| 매개변수 |
|
||
| 반환 |
성공 시 WEAVE_NO_ERROR 그 외의 경우에는 컨테이너를 시작할 수 없음을 반영하는 WEAVE_ERROR를 반환합니다.
|
||
StartDataList
WEAVE_ERROR StartDataList( ReferencedTLVData & aDataList, nl::Weave::TLV::TLVWriter & aWriter )
지정된 ReferencedTLVData 객체에 데이터 목록 작성을 시작합니다.
WDM 데이터 목록의 시작 부분에 대한 TLV를 작성합니다. 여기서는 참조된 TLV 데이터 구조에 데이터 목록을 작성한다고 가정합니다. 작성기는 초기화되지 않은 것으로 간주됩니다. 어떤 경우에도 지정된 객체를 가리키도록 초기화됩니다.
| 세부정보 | |||||
|---|---|---|---|---|---|
| 매개변수 |
|
||||
| 반환 |
성공 시 WEAVE_NO_ERROR 그 외의 경우에는 컨테이너를 시작할 수 없음을 반영하는 WEAVE_ERROR를 반환합니다.
|
||||
StartDataListElement
WEAVE_ERROR StartDataListElement( nl::Weave::TLV::TLVWriter & aWriter )
데이터 목록 요소를 작성합니다.
WDM 데이터 목록 요소의 시작을 나타내는 TLV를 작성합니다.
| 세부정보 | |||
|---|---|---|---|
| 매개변수 |
|
||
| 반환 |
성공 시 WEAVE_NO_ERROR 그 외의 경우에는 컨테이너를 시작할 수 없음을 반영하는 WEAVE_ERROR를 반환합니다.
|
||
StartEncodePath
WEAVE_ERROR StartEncodePath( TLVWriter & aWriter, const uint64_t & aTag, uint32_t aProfileId, TLVType & mOuterContainer, TLVType & mPath )
StartPathList
WEAVE_ERROR StartPathList( nl::Weave::TLV::TLVWriter & aWriter )
경로 목록을 작성합니다.
WDM 경로 목록의 시작 부분에 대한 TLV를 작성합니다(예: ViewRequest()의 기본 인수로).
| 세부정보 | |||
|---|---|---|---|
| 매개변수 |
|
||
| 반환 |
성공 시 WEAVE_NO_ERROR 그 외의 경우에는 컨테이너를 시작할 수 없음을 반영하는 WEAVE_ERROR를 반환합니다.
|
||
TxnResponseHandler
void TxnResponseHandler( ExchangeContext *anExchangeCtx, const IPPacketInfo *anAddrInfo, const WeaveMessageInfo *aMsgInfo, uint32_t aProfileId, uint8_t aMsgType, PacketBuffer *aMsg )
TxnTimeoutHandler
void TxnTimeoutHandler( ExchangeContext *anExchangeCtx )
ValidateTLVType
WEAVE_ERROR ValidateTLVType( nl::Weave::TLV::TLVType aType, nl::Weave::TLV::TLVReader & aReader )
읽는 TLV 요소에 예상 TLV 유형이 있는지 확인합니다.
지정된 TLV 유형을 TLV 리더의 헤드에 있는 요소 유형과 비교하여 확인하고 일치하는 항목이 없으면 오류를 반환합니다.
| 세부정보 | |||||
|---|---|---|---|---|---|
| 매개변수 |
|
||||
| 반환 |
일치하는 항목이 있으면 WEAVE_NO_ERROR, 일치하지 않으면 WEAVE_ERROR_WRONG_TLV_TYPE을 반환합니다.
|
||||
WeaveTLVTypes.h
ValidateWDMTag
WEAVE_ERROR ValidateWDMTag( uint32_t aTagNum, nl::Weave::TLV::TLVReader & aReader )
읽는 TLV 요소에 예상 WDM 태그가 있는지 확인합니다.
| 세부정보 | |||||
|---|---|---|---|---|---|
| 매개변수 |
|
||||
| 반환 |
성공 시 WEAVE_NO_ERROR 그렇지 않고 WDM 태그로 해석될 때 태그가 지정된 태그 번호와 일치하지 않는 경우 WEAVE_ERROR_INVALID_TLV_TAG
|
||||