الخادم

تتضمن هذه الوحدة وظائف لإدارة بيانات الشبكة المحلية باستخدام خادم 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
otServerEnrollment

otServerGetNetDataLocal

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

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

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aStable
صحيح عند نسخ النسخة الثابتة، خطأ عند نسخ النسخة الكاملة.
[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.

سجلّ الخادم

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
otServerEnrollment

الموارد

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