الخادم

تتضمن هذه الوحدة وظائف لإدارة بيانات الشبكة المحلية باستخدام OpenOpen Server.

الملخّص

الدوال

otServerAddService(otInstance *aInstance, const otServiceConfig *aConfig)
أضِف إعداد خدمة إلى بيانات الشبكة المحلية.
otServerGetNetDataLocal(otInstance *aInstance, bool aStable, uint8_t *aData, uint8_t *aDataLength)
توفِّر هذه الطريقة نسخة كاملة أو ثابتة من بيانات شبكة سلاسل المحادثات المحلية.
otServerGetNextService(otInstance *aInstance, otNetworkDataIterator *aIterator, otServiceConfig *aConfig)
تحصل هذه الدالة على الخدمة التالية في بيانات الشبكة المحلية.
otServerRegister(otInstance *aInstance)
تسجيل بيانات الشبكة المحلية على الفور مع القائد
otServerRemoveService(otInstance *aInstance, uint32_t aEnterpriseNumber, const uint8_t *aServiceData, uint8_t aServiceDataLength)
إزالة إعداد خدمة من بيانات الشبكة المحلية.

الدوال

otServerAddService

otError otServerAddService(
  otInstance *aInstance,
  const otServiceConfig *aConfig
)

أضِف إعداد خدمة إلى بيانات الشبكة المحلية.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aConfig
مؤشر إلى ضبط الخدمة.
قيم الإرجاع
OT_ERROR_NONE
تمت إضافة الإعداد إلى بيانات الشبكة المحلية بنجاح.
OT_ERROR_INVALID_ARGS
كانت معلَمة إعداد واحدة أو أكثر غير صالحة.
OT_ERROR_NO_BUFS
لا تتوفر مساحة كافية لإضافة الإعداد إلى بيانات الشبكة المحلية.
اطّلع أيضًا على:
otServerRemoveService
otServerRegister

otServerGetNetDataLocal

otError otServerGetNetDataLocal(
  otInstance *aInstance,
  bool aStable,
  uint8_t *aData,
  uint8_t *aDataLength
)

توفِّر هذه الطريقة نسخة كاملة أو ثابتة من بيانات شبكة سلاسل المحادثات المحلية.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aStable
TRUE عند نسخ الإصدار الثابت، أو FALSE عند نسخ الإصدار الكامل.
[out] aData
مؤشر إلى مخزن البيانات المؤقت.
[in,out] aDataLength
عند الإدخال، حجم المخزن المؤقت للبيانات المُشار إليه من خلال aData. عند الخروج، عدد وحدات البايت المنسوخة.

otServerGetNextService

otError otServerGetNextService(
  otInstance *aInstance,
  otNetworkDataIterator *aIterator,
  otServiceConfig *aConfig
)

تحصل هذه الدالة على الخدمة التالية في بيانات الشبكة المحلية.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in,out] aIterator
مؤشر لسياق تكرار بيانات الشبكة. للحصول على أول إدخال للخدمة، يجب ضبطه على OT_NETWORK_DATA_ITERATOR_INIT.
[out] aConfig
مؤشر إلى المكان الذي سيتم وضع معلومات الخدمة فيه.
قيم الإرجاع
OT_ERROR_NONE
تم العثور على الخدمة التالية بنجاح.
OT_ERROR_NOT_FOUND
لا تتوفّر خدمة لاحقة في بيانات شبكة سلاسل المحادثات.

otServerRegister

otError otServerRegister(
  otInstance *aInstance
)

تسجيل بيانات الشبكة المحلية على الفور مع القائد

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
قيم الإرجاع
OT_ERROR_NONE
تم وضع رسالة "طلب بيانات الخادم" في قائمة الانتظار بنجاح للتسليم.
اطّلع أيضًا على:
otServerAddService
otServerRemoveService

otServerRemoveService

otError otServerRemoveService(
  otInstance *aInstance,
  uint32_t aEnterpriseNumber,
  const uint8_t *aServiceData,
  uint8_t aServiceDataLength
)

إزالة إعداد خدمة من بيانات الشبكة المحلية.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aEnterpriseNumber
رقم مؤسسة إدخال الخدمة المراد حذفها.
[in] aServiceData
مؤشر إلى بيانات الخدمة للبحث عنها أثناء الحذف.
[in] aServiceDataLength
يبلغ طول aServiceData بايت.
قيم الإرجاع
OT_ERROR_NONE
تمت إزالة الإعداد من بيانات الشبكة المحلية بنجاح.
OT_ERROR_NOT_FOUND
تعذّر العثور على جهاز توجيه الحدود.
اطّلع أيضًا على:
otServerAddService
otServerRegister

المراجع

تنشأ مواضيع واجهة برمجة التطبيقات المرجعية لـ OpenThread من رمز المصدر، المتوفر على GitHub. للاطّلاع على مزيد من المعلومات أو للمساهمة في مستنداتنا، يُرجى الرجوع إلى المراجع.