nl::Weave::Profiles::ServiceProvisioning

這個命名空間包含 Weave 中有關 Weave 服務佈建設定檔的所有介面，這是三個 Weave 佈建設定檔的第三者。

摘要

列舉
@304{
  kStatusCode_TooManyServices = 1,
  kStatusCode_ServiceAlreadyRegistered = 2,
  kStatusCode_InvalidServiceConfig = 3,
  kStatusCode_NoSuchService = 4,
  kStatusCode_PairingServerError = 5,
  kStatusCode_InvalidPairingToken = 6,
  kStatusCode_PairingTokenOld = 7,
  kStatusCode_ServiceCommunicationError = 8,
  kStatusCode_ServiceConfigTooLarge = 9,
  kStatusCode_WrongFabric = 10,
  kStatusCode_TooManyFabrics = 11
} 		列舉
服務佈建狀態碼。
@305 列舉
服務佈建訊息類型。
@306{
  kTag_ServiceConfig = 1,
  kTag_ServiceEndPoint = 2,
  kTag_ServiceConfig_CACerts = 1,
  kTag_ServiceConfig_DirectoryEndPoint = 2,
  kTag_ServiceEndPoint_Id = 1,
  kTag_ServiceEndPoint_Addresses = 2,
  kTag_ServiceEndPoint_NodeId = 3,
  kTag_ServiceEndPointAddress_HostName = 1,
  kTag_ServiceEndPointAddress_Port = 2
} 		列舉
服務佈建資料元素標記。

函式
EncodeServiceConfig(WeaveCertificateSet & certSet, const char *dirHostName, uint16_t dirPort, uint8_t *outBuf, uint16_t & outLen)
NL_DLL_EXPORT WEAVE_ERROR

類別
nl::Weave::Profiles::ServiceProvisioning::IFJServiceFabricJoinMessage
nl::Weave::Profiles::ServiceProvisioning::PairDeviceToAccountMessage
nl::Weave::Profiles::ServiceProvisioning::RegisterServicePairAccountMessage
nl::Weave::Profiles::ServiceProvisioning::ServiceProvisioningDelegate
nl::Weave::Profiles::ServiceProvisioning::ServiceProvisioningServer

實作服務佈建設定檔的簡易伺服器類別。
nl::Weave::Profiles::ServiceProvisioning::UpdateServiceMessage

列舉

@304

 @304

服務佈建狀態碼。

屬性
kStatusCode_InvalidPairingToken

裝置傳遞了無效的配對權杖，因此無法完成服務配對。
kStatusCode_InvalidServiceConfig

指定的服務設定無效。
kStatusCode_NoSuchService

指定的 ID 與裝置上註冊的服務不符。
kStatusCode_PairingServerError

裝置無法與配對伺服器通訊，因此無法完成服務配對。
kStatusCode_PairingTokenOld

裝置傳送的配對權杖已過期，因此無法完成服務配對。
kStatusCode_ServiceAlreadyRegistered

裝置上已註冊指定的服務。
kStatusCode_ServiceCommunicationError

裝置與服務通訊時發生錯誤，因此無法完成服務配對。
kStatusCode_ServiceConfigTooLarge

指定的服務設定過大。
kStatusCode_TooManyFabrics

結構中的布料過多。
kStatusCode_TooManyServices

裝置上註冊的服務數量過多。
kStatusCode_WrongFabric

裝置與其他織布配對。

@305

 @305

服務佈建訊息類型。

@306

 @306

服務佈建資料元素標記。

屬性
kTag_ServiceConfig

[Structure ] 描述 Weave 服務。
kTag_ServiceConfig_CACerts

[陣列, 長度 >= 1 ] 服務的受信任 CA 憑證清單。

每個元素都是 WeaveCertificate (如 Security 設定檔中所定義的項目所述)。
kTag_ServiceConfig_DirectoryEndPoint

[struct ] 包含服務主要目錄終點的聯絡資訊。

以下是 ServiceEndPoint 結構的定義內容。
kTag_ServiceEndPoint

[結構 ] 說明 Weave 服務端點。
kTag_ServiceEndPointAddress_HostName

[ utf-8 string ] 主機名稱或常值 IP 位址。
kTag_ServiceEndPointAddress_Port

[ uint, 1-63353 ] IP 通訊埠編號。

選用
kTag_ServiceEndPoint_Addresses

[陣列, 長度 >= 1 ] 服務終點的地址清單

每個元素都是 ServiceEndPointAddress 結構，定義如下。
kTag_ServiceEndPoint_Id

[ uint, 8-64 位元 ] 指派給服務終點的服務終點 ID (EUI-64)。
kTag_ServiceEndPoint_NodeId

[ uint, 8-64 位元 ] 提供服務的節點 Weave 節點 ID。

與地址清單互斥。

函式

EncodeServiceConfig

NL_DLL_EXPORT WEAVE_ERROR EncodeServiceConfig(
  WeaveCertificateSet & certSet,
  const char *dirHostName,
  uint16_t dirPort,
  uint8_t *outBuf,
  uint16_t & outLen
)