本頁面由 Cloud Translation API 翻譯而成。

nl::Weave::Profiles::DeviceDescription

此命名空間包含 Weave 中 Weave 裝置說明設定檔的所有介面。

摘要

列舉
`@177`	列舉
`@178`	列舉裝置說明設定檔的訊息類型。
@179{ kTag_WeaveDeviceDescriptor = 1, kTag_VendorId = 0, kTag_ProductId = 1, kTag_ProductRevision = 2, kTag_ManufacturingDate = 3, kTag_SerialNumber = 4, kTag_Primary802154MACAddress = 5, kTag_PrimaryWiFiMACAddress = 6, kTag_RendezvousWiFiESSID = 7, kTag_PairingCode = 8, kTag_SoftwareVersion = 9, kTag_DeviceId = 10, kTag_FabricId = 11, kTag_PairingCompatibilityVersionMajor = 12, kTag_PairingCompatibilityVersionMinor = 13, kTag_RendezvousWiFiESSIDSuffix = 14, kTag_DeviceFeature_HomeAlarmLinkCapable = 100, kTag_DeviceFeature_LinePowered = 101 }	列舉裝置說明設定檔的資料元素標記。
`TargetDeviceModes{ kTargetDeviceMode_Any = 0x00000000, kTargetDeviceMode_UserSelectedMode = 0x00000001 }`	列舉位元欄位 (上限為 32 位元)，根據裝置目前模式指定哪些裝置應回應 FindRequest 訊息。
`TargetFabricIds{ kTargetFabricId_NotInFabric = kFabricIdNotSpecified, kTargetFabricId_AnyFabric = kReservedFabricIdStart, kTargetFabricId_Any = kMaxFabricId }`	列舉特殊目標架構 ID。

函式
`MatchTargetFabricId(uint64_t fabricId, uint64_t targetFabricId)`	`NL_DLL_EXPORT bool` 比較兩個布料 ID，判斷兩者是否相符 (考慮萬用字元值)。

類別
nl::Weave::Profiles::DeviceDescription::DeviceDescriptionClient	發出裝置說明要求的用戶端物件。
nl::Weave::Profiles::DeviceDescription::DeviceDescriptionServer	回應裝置說明要求的伺服器物件。
nl::Weave::Profiles::DeviceDescription::IdentifyDeviceCriteria	代表在 IdentityDevice 通訊協定中選取裝置的條件。
nl::Weave::Profiles::DeviceDescription::IdentifyRequestMessage	已剖析的 IdentityRequest 訊息。
nl::Weave::Profiles::DeviceDescription::IdentifyResponseMessage	已剖析的 IdentityResponse 訊息。
nl::Weave::Profiles::DeviceDescription::TextDescriptorReader
nl::Weave::Profiles::DeviceDescription::TextDescriptorWriter
nl::Weave::Profiles::DeviceDescription::WeaveDeviceDescriptor	包含 Weave 裝置的相關描述性資訊。

列舉

@177

 @177

@178

 @178

裝置說明設定檔的訊息類型。

@179

 @179

裝置說明設定檔的資料元素標記。

屬性
`kTag_DeviceFeature_HomeAlarmLinkCapable`	[布林值 ] 表示支援連結到住家警報面板的 Nest Protect。功能標記
`kTag_DeviceFeature_LinePowered`	[boolean ] 表示需要電源線的裝置。功能標記
`kTag_DeviceId`	[ uint, 2^64 max ] Weave 裝置 ID 內容專屬標記
`kTag_FabricId`	[ uint, 2^64 max ] 裝置所屬 Weave 織布的 ID。內容專屬標記
`kTag_ManufacturingDate`	[ uint, range 1-65535 ] 製造日期，採用編碼格式。內容專屬標記
`kTag_PairingCode`	[ UTF-8 string, len 6-16 ] 裝置的配對碼。內容專屬標記注意：重要事項：基於安全考量，我們「永遠」不要透過網路傳送 PairingCode 欄位。這個程式庫位於 WeaveDeviceDescriptor 結構中，因此能夠編碼成與裝置相關聯的資料標籤 (例如 QR code)。
`kTag_PairingCompatibilityVersionMajor`	[ uint, range 1-65535 ] 配對軟體相容性主要版本。內容專屬標記
`kTag_PairingCompatibilityVersionMinor`	[ uint, range 1-65535 ] 配對軟體相容性子版本。內容專屬標記
`kTag_Primary802154MACAddress`	[ byte string, len = 8 ] 裝置主要 802.15.4 介面的 MAC 位址。內容專屬標記
`kTag_PrimaryWiFiMACAddress`	[ byte string, len = 6 ] 裝置主要 Wi-Fi 介面的 MAC 位址。內容專屬標記
`kTag_ProductId`	[ uint, range 1-65535 ] 用於識別產品的代碼。內容專屬標記
`kTag_ProductRevision`	[ uint, range 1-65535 ] 用於識別產品修訂版本的程式碼。內容專屬標記
`kTag_RendezvousWiFiESSID`	[ UTF-8 字串, len 1-32 ] 用於裝置的 Wi-Fi 網路訊號網路的 ESSID。內容專屬的標記。注意：此標記無法與 RendezvousWiFiESSIDSuffix 標記共同使用。
`kTag_RendezvousWiFiESSIDSuffix`	[ UTF-8 字串, len 1-32 ] 裝置 Wi-Fi 網路 Wi-Fi 網路的 ESSID 後置字串。內容專屬的標記。注意：此標記無法與 RendezvousWiFiESSID 標記共同使用。
`kTag_SerialNumber`	[ UTF-8 string, len 1-32 ] 裝置序號。內容專屬標記
`kTag_SoftwareVersion`	[ UTF-8 string, len 1-32 ] 裝置上的軟體版本。內容專屬標記
`kTag_VendorId`	[ uint, range 1-65535 ] 用於識別產品供應商的代碼。內容專屬標記
`kTag_WeaveDeviceDescriptor`	包含描述 Weave 裝置資訊的結構。頂層標記

TargetDeviceModes

 TargetDeviceModes

位元欄位 (上限為 32 位元)，根據裝置目前模式指定哪些裝置應回應 FindRequest 訊息。

請注意，此處定義的模式是專為一般用途設計，以便套用到各種裝置類型。

屬性
`kTargetDeviceMode_Any`	尋找所有裝置 (不論模式為何)。
`kTargetDeviceMode_UserSelectedMode`	找出所有處於「使用者所選」模式的裝置，也就是由使用者按下按鈕 (或同等功能) 直接識別裝置的裝置。

TargetFabricIds

 TargetFabricIds

特殊目標架構 ID。

屬性
`kTargetFabricId_Any`	指定無論織布屬性為何，所有裝置都應回應。
`kTargetFabricId_AnyFabric`	指定只有「__are_」布料成員的裝置應回應。
`kTargetFabricId_NotInFabric`	指定「不是」布料成員的裝置應回應。

函式

MatchTargetFabricId

NL_DLL_EXPORT bool MatchTargetFabricId(
  uint64_t fabricId,
  uint64_t targetFabricId
)

比較兩個布料 ID，判斷兩者是否相符 (考慮萬用字元值)。

詳細說明

參數

`[in] fabricId`	要測試的架構 ID。
`[in] targetFabricId`	要用於測試的架構 ID。

傳回值

`TRUE`	如果布料 ID 相符。
`FALSE`	如果布料 ID 不相符。