الخادم

تتضمن هذه الوحدة دوال لإدارة بيانات الشبكة المحلية باستخدام خادم OpenThread.

ملخّص

الدوال

otServerAddService(otInstance *aInstance, const otServiceConfig *aConfig)
أضِف إعداد خدمة إلى بيانات الشبكة المحلية.
otServerGetNetDataLocal(otInstance *aInstance, bool aStable, uint8_t *aData, uint8_t *aDataLength)
توفّر نسخة كاملة أو ثابتة من بيانات شبكة Thread المحلية.
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
)

توفّر نسخة كاملة أو ثابتة من بيانات شبكة Thread المحلية.

التفاصيل
المَعلمات
[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
لا توجد أي خدمة لاحقة في بيانات شبكة Thread.

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. للحصول على مزيد من المعلومات أو للمساهمة في مستنداتنا، يمكنك الاطّلاع على المراجع.