nl::Weave::Profiles::DeviceControl

تشمل مساحة الاسم هذه جميع الواجهات ضمن Weave للملف الشخصي في Weave Device Control.

ملخّص

يعمل الملف الشخصي للتحكم في الجهاز على تسهيل عمليات خادم العميل بحيث يمكن للعميل (الجهاز المتحكم) تشغيل وظائف برنامج مساعدة محددة على الخادم (الجهاز قيد الإعداد) للمساعدة في عملية إعداد الجهاز وتوفيره وتمكينه. ويتضمن ذلك، على سبيل المثال، إعادة ضبط إعدادات جهاز الخادم وتفعيل خزنات الإخفاق التي تحدد السلوك عند إلغاء إجراء الإعداد قبل أوانه.

عمليات التعداد
@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
} 		تعداد
علامات إعادة الضبط
@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)
أرسِل رسالة LookToRendezvous إلى هذا المستخدم.

صفوف
nl::Weave::Profiles::DeviceControl::DeviceControlDelegate

يمكنك تفويض الفئة لتنفيذ عمليات التحكّم في الجهاز الواردة على جهاز الخادم.

nl::Weave::Profiles::DeviceControl::DeviceControlServer

فئة الخادم لتنفيذ الملف الشخصي للتحكّم في الجهاز.

عمليات التعداد

@172

 @172

رموز حالة التحكّم بالجهاز

أماكن إقامة
kStatusCode_FailSafeAlreadyActive

هناك بالفعل أحد خيارات الأمان الآمن من الفشل مفعَّلة.

kStatusCode_NoFailSafeActive

لا يتم تفعيل أي إعدادات آمنة من تعذُّر إدارة الحسابات.

kStatusCode_NoMatchingFailSafeActive

لا يتطابق الرمز المميز للأمان من الإخفاق والتوفير النشط مع الرمز النشط لمنع حدوث الفشل.

kStatusCode_NoSystemTestDelegate

لا يمكن إجراء اختبار النظام بدون تفويض.

kStatusCode_RemotePassiveRendezvousTimedOut

لا يتم ربط أي أجهزة مع خادم "التحكم في الأجهزة" أثناء فترة الموعد التي يحددها العميل.

kStatusCode_ResetNotAllowed

رفض الجهاز السماح بإعادة الضبط المطلوبة.

kStatusCode_ResetSuccessCloseCon

ستنجح طريقة SetConfig، ولكنها ستغلق الاتصال أولاً.

kStatusCode_UnsecuredListenPreempted

فرض تطبيق آخر استبدال خادم "التحكم في الجهاز" بصفته معالج الاتصال غير الآمن في حزمة Weave هذه.

kStatusCode_UnsupportedFailSafeMode

لا يتوافق الجهاز مع الوضع الآمن المحدّد للفشل.

@173

 @173

أنواع رسائل التحكّم في الجهاز

أماكن إقامة
kMsgType_ArmFailSafe

تفعيل آلية الضبط بالتأكّد من عدم حدوث أي إخفاق على الجهاز

kMsgType_DisableConnectionMonitor

إيقاف مراقبة جودة الاتصال.

kMsgType_DisarmFailSafe

أوقِف إعدادًا نشطًا مواجهًا للفشل.

kMsgType_EnableConnectionMonitor

تفعيل مراقبة جودة الاتصال.

kMsgType_LookingToRendezvous

جارٍ البحث عن رسالة Rendezvouz.

الحمولة فارغة، والإشارة الوحيدة المفيدة داخلها هي معرّف عقدة المصدر.

kMsgType_RemoteConnectionComplete

يمكنك الإشارة إلى عميل "التحكّم في الأجهزة" بأنّه تم بنجاح إكمال عملية الربط السلبي عن بُعد بنجاح وأنّ نفق الاتصال مفتوح.

kMsgType_RemotePassiveRendezvous

طلب المواعدة السلبية عن بُعد باستخدام خادم "التحكّم في الجهاز"

kMsgType_ResetConfig

أعِد ضبط حالة ضبط الجهاز.

kMsgType_StartSystemTest

ابدأ اختبار النظام.

kMsgType_StopSystemTest

أوقِف اختبار النظام.

174@

 @174

قيم وضع ArmFailSafe

أماكن إقامة
kArmMode_New

تفعيل آلية جديدة لمنع حدوث إخفاق، وعرض رسالة خطأ إذا كان أحدها مفعَّلاً

kArmMode_Reset

يمكنك إعادة ضبط جميع إعدادات الجهاز واستخدام إصدار جديد آمن من الإخفاق.

kArmMode_ResumeExisting

يمكنك استئناف العمل بميزة آمنة من الإخفاق قيد التقدم، وعرض رسالة خطأ في حال عدم تنفيذ إجراء آمن من الإخفاق أو عدم تطابق الرمز المميز الآمن من الإخفاق.

@175

 @175

علامات إعادة الضبط

أماكن إقامة
kResetConfigFlag_All

إعادة ضبط جميع معلومات ضبط الجهاز

kResetConfigFlag_FabricConfig

إعادة ضبط معلومات ضبط القماش.

kResetConfigFlag_FactoryDefaults

إعادة ضبط الجهاز على الإعدادات الأصلية الكاملة.

kResetConfigFlag_NetworkConfig

إعادة ضبط معلومات إعدادات الشبكة

kResetConfigFlag_OperationalCredentials

إعادة ضبط بيانات الاعتماد التشغيلية للجهاز.

kResetConfigFlag_ServiceConfig

إعادة ضبط معلومات ضبط الخدمة

@176

 @176

أطوال الرسائل.

أماكن إقامة
kMessageLength_ArmFailsafe

طول رسالة التطبيق غير الآمن لذوي العجز

kMessageLength_DisableConnectionMonitor

إيقاف طول رسالة مراقبة الاتصال.

kMessageLength_DisarmFailsafe

إيقاف طول الرسالة بأمان الخطأ

kMessageLength_EnableConnectionMonitor

تفعيل طول رسالة مراقبة الاتصال.

kMessageLength_RemotePassiveRendezvous

طول رسالة المواعدة السلبية عن بُعد

kMessageLength_ResetConfig

يُرجى إعادة ضبط طول رسالة الإعداد.

kMessageLength_StartSystemTest

ابدأ طول رسالة اختبار النظام.

kMessageLength_StopSystemTest

إيقاف طول رسالة اختبار النظام

الدوال

SendLookingToRendezvous

WEAVE_ERROR SendLookingToRendezvous(
  ExchangeContext *ec
)

أرسِل رسالة LookToRendezvous إلى هذا المستخدم.

التفاصيل
المَعلمات
[in] ec
ExchangeContext للاستخدام لإرسال الرسالة
قيم الإرجاع
WEAVE_NO_ERROR
عند النجاح
WEAVE_ERROR_NO_MEMORY
إذا لم نتمكن من تخصيص مورد احتياطي للرسالة
other
الأخطاء الأخرى التي تظهر من خلال nl::Weave::ExchangeContext::SendMessage