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

لا يتطابق المعرّف المحدّد مع خدمة مسجَّلة على الجهاز.

kStatusCode_PairingServerError

تعذّر على الجهاز إكمال إقران الخدمة بسبب تعذُّر التواصل مع خادم الإقران.

kStatusCode_PairingTokenOld

تعذّر على الجهاز إكمال إقران الخدمة بسبب انتهاء صلاحية الرمز المميّز للإقران الذي تم تمريره.

kStatusCode_ServiceAlreadyRegistered

الخدمة المحدّدة مسجّلة على الجهاز من قبل.

kStatusCode_ServiceCommunicationError

تعذّر على الجهاز إكمال إقران الخدمة بسبب حدوث خطأ عند الاتصال بالخدمة.

kStatusCode_ServiceConfigTooLarge

إعدادات الخدمة المحدّدة كبيرة جدًا.

kStatusCode_TooManyFabrics

هناك عدد كبير جدًا من الأقمشة في الهيكل.

kStatusCode_TooManyServices

هناك عدد كبير جدًا من الخدمات المسجَّلة على الجهاز.

kStatusCode_WrongFabric

تم إقران الجهاز بنسيج مختلف.

@305

 @305

أنواع الرسائل المتعلّقة بتوفير الخدمات

@306

 @306

علامات عنصر البيانات لتوفير الخدمات

أماكن إقامة
kTag_ServiceConfig

[ بنية ] تصف خدمة Weave Service.

kTag_ServiceConfig_CACerts

[صفيف, الطول >= 1 ] قائمة بشهادات هيئة إصدار الشهادات (CA) الموثوق بها للخدمة.

يُعد كل عنصر شهادة Weave، كما هو موضح في ملف الأمان الشخصي.

kTag_ServiceConfig_DirectoryEndPoint

[ البنية ] يحتوي على معلومات الاتصال لنقطة نهاية الدليل الأساسي للخدمة.

يتم تحديد المحتوى أدناه لبنية ServiceEndPoint.

kTag_ServiceEndPoint

[structured ] تصف نقطة نهاية خدمة 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 بت ] معرِّف نقطة نهاية الخدمة (EUI-64) مخصّص لنقطة نهاية الخدمة.

kTag_ServiceEndPoint_NodeId

[ uint، 8-64 بت ] نسج معرِّف العقدة للعقدة التي تقدم الخدمة.

يمكن استخدام قائمة العناوين بشكل تبادلي.

الدوال

EncodeServiceConfig

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