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
} 		تعداد
علامات إعادة ضبط الإعدادات.
@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

ستنجح طريقة إعادة الضبط، ولكن سيتم إغلاق الاتصال أولاً.

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