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

nl::Weave::Profiles::DeviceControl

這個命名空間包含 Weave 針對 Weave 裝置控制設定檔的所有介面。

摘要

裝置控制設定檔可協助用戶端伺服器作業，讓用戶端 (控制裝置) 觸發伺服器上的特定公用程式功能 (正在設定裝置)，協助或啟用裝置設定和佈建程序。包括重設伺服器裝置設定並啟用「故障保險箱」功能，藉此定義設定程序過早取消時的行為。

列舉
`@172{ kStatusCode_FailSafeAlreadyActive = 1, kStatusCode_NoFailSafeActive = 2, kStatusCode_NoMatchingFailSafeActive = 3, kStatusCode_UnsupportedFailSafeMode = 4, kStatusCode_RemotePassiveRendezvousTimedOut = 5, kStatusCode_UnsecuredListenPreempted = 6, kStatusCode_ResetSuccessCloseCon = 7, kStatusCode_ResetNotAllowed = 8, kStatusCode_NoSystemTestDelegate = 9 }`	列舉裝置控制狀態碼。
`@173{ kMsgType_ResetConfig = 1, kMsgType_ArmFailSafe = 2, kMsgType_DisarmFailSafe = 3, kMsgType_EnableConnectionMonitor = 4, kMsgType_DisableConnectionMonitor = 5, kMsgType_RemotePassiveRendezvous = 6, kMsgType_RemoteConnectionComplete = 7, kMsgType_StartSystemTest = 8, kMsgType_StopSystemTest = 9, kMsgType_LookingToRendezvous = 10 }`	列舉裝置控制訊息類型。
`@174{ kArmMode_New = 1, kArmMode_Reset = 2, kArmMode_ResumeExisting = 3 }`	列舉 ArmFailSafe 模式值。
`@175{ kResetConfigFlag_All = 0x00FF, kResetConfigFlag_NetworkConfig = 0x0001, kResetConfigFlag_FabricConfig = 0x0002, kResetConfigFlag_ServiceConfig = 0x0004, kResetConfigFlag_OperationalCredentials = 0x0008, kResetConfigFlag_FactoryDefaults = 0x8000 }`	列舉 ResetConfig 標記。
`@176{ kMessageLength_ResetConfig = 2, kMessageLength_ArmFailsafe = 5, kMessageLength_DisarmFailsafe = 0, kMessageLength_EnableConnectionMonitor = 4, kMessageLength_DisableConnectionMonitor = 0, kMessageLength_RemotePassiveRendezvous = 20, kMessageLength_StartSystemTest = 8, kMessageLength_StopSystemTest = 0 }`	列舉訊息長度。

函式
`SendLookingToRendezvous(ExchangeContext *ec)`	`WEAVE_ERROR` 傳送 LookToRendezvous 訊息給同事。

類別
nl::Weave::Profiles::DeviceControl::DeviceControlDelegate	在伺服器裝置上實作傳入裝置控製作業的委派類別。
nl::Weave::Profiles::DeviceControl::DeviceControlServer	用於實作裝置控制設定檔的伺服器類別。

 @172

裝置控制狀態碼。

屬性
`kStatusCode_FailSafeAlreadyActive`	已啟用故障安全佈建程序已啟用。
`kStatusCode_NoFailSafeActive`	未啟用佈建失敗的佈建作業。
`kStatusCode_NoMatchingFailSafeActive`	佈建失敗的安全權杖與有效的故障安全憑證不符。
`kStatusCode_NoSystemTestDelegate`	系統測試無法在沒有委派項目的情況下執行。
`kStatusCode_RemotePassiveRendezvousTimedOut`	在用戶端指定的預約期間，沒有裝置與「裝置控制」伺服器搭配使用。
`kStatusCode_ResetNotAllowed`	裝置拒絕接受要求的重設要求。
`kStatusCode_ResetSuccessCloseCon`	ResetConfig 方法將成功執行，但會先關閉連線。
`kStatusCode_UnsecuredListenPreempted`	其他應用程式已強制取代「裝置控制」伺服器，因為這個 Weave 堆疊的無安全連線處理常式。
`kStatusCode_UnsupportedFailSafeMode`	裝置不支援指定的故障安全模式。

 @173

裝置控制訊息類型。

屬性
`kMsgType_ArmFailSafe`	啟動裝置上的設定故障安全機制。
`kMsgType_DisableConnectionMonitor`	停用連線有效性監控。
`kMsgType_DisarmFailSafe`	解除有效設定的安全故障情形。
`kMsgType_EnableConnectionMonitor`	啟用連線有效性監控功能。
`kMsgType_LookingToRendezvous`	正在尋找 Rendezvouz 訊息。酬載是空白的，其中唯一有意義的信號是來源節點 ID。
`kMsgType_RemoteConnectionComplete`	告知裝置控制用戶端，「Remote Passive Rendezvous」已成功完成，且連線通道已開啟。
`kMsgType_RemotePassiveRendezvous`	透過裝置控制伺服器要求遠端被動 Rendezv。
`kMsgType_ResetConfig`	重設裝置的設定狀態。
`kMsgType_StartSystemTest`	啟動系統測試。
`kMsgType_StopSystemTest`	停止系統測試。

 @174

ArmFailSafe 模式值。

屬性
`kArmMode_New`	啟動新的故障防範措施；就會傳回錯誤。
`kArmMode_Reset`	重設所有裝置設定，並啟動新的故障安全機制。
`kArmMode_ResumeExisting`	恢復正在進行的故障安全措施；如果沒有進行中的故障安全機制，或失敗安全權杖不相符，則會傳回錯誤。

 @175

ResetConfig 標記。

屬性
`kResetConfigFlag_All`	重設所有裝置設定資訊。
`kResetConfigFlag_FabricConfig`	重設架構設定資訊。
`kResetConfigFlag_FactoryDefaults`	將裝置恢復原廠設定。
`kResetConfigFlag_NetworkConfig`	重設網路設定資訊。
`kResetConfigFlag_OperationalCredentials`	重設裝置作業憑證。
`kResetConfigFlag_ServiceConfig`	重設服務設定資訊。

 @176

訊息長度。

屬性
`kMessageLength_ArmFailsafe`	執行故障安全訊息長度。
`kMessageLength_DisableConnectionMonitor`	停用連線監控器訊息長度。
`kMessageLength_DisarmFailsafe`	解除故障安全訊息長度。
`kMessageLength_EnableConnectionMonitor`	啟用連線監控器訊息長度。
`kMessageLength_RemotePassiveRendezvous`	遠端被動 Rendezv 訊息長度。
`kMessageLength_ResetConfig`	重設 Config 訊息長度。
`kMessageLength_StartSystemTest`	啟動系統測試訊息長度。
`kMessageLength_StopSystemTest`	停止系統測試訊息長度。

WEAVE_ERROR SendLookingToRendezvous(
  ExchangeContext *ec
)

傳送 LookToRendezvous 訊息給同事。

詳細資料

參數

[in] ec

ExchangeContext 用於傳送訊息

傳回值

`WEAVE_NO_ERROR`	成功時。
`WEAVE_ERROR_NO_MEMORY`	如果我們無法為訊息分配緩衝區。
`other`	nl::Weave::ExchangeContext::SendMessage 傳回的其他錯誤