جهاز توجيه الحدود

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

ملخّص

الدوال

otBorderRouterAddOnMeshPrefix(otInstance *aInstance, const otBorderRouterConfig *aConfig)
أضف إعداد جهاز توجيه الحدود إلى بيانات الشبكة المحلية.
otBorderRouterAddRoute(otInstance *aInstance, const otExternalRouteConfig *aConfig)
أضف إعداد مسار خارجي إلى بيانات الشبكة المحلية.
otBorderRouterGetNetData(otInstance *aInstance, bool aStable, uint8_t *aData, uint8_t *aDataLength)
توفّر نسخة كاملة أو ثابتة من بيانات شبكة Thread المحلية.
otBorderRouterGetNextOnMeshPrefix(otInstance *aInstance, otNetworkDataIterator *aIterator, otBorderRouterConfig *aConfig)
الحصول على البادئة التالية في الشبكة المتداخلة ضمن بيانات الشبكة المحلية
otBorderRouterGetNextRoute(otInstance *aInstance, otNetworkDataIterator *aIterator, otExternalRouteConfig *aConfig)
الحصول على المسار الخارجي التالي في بيانات الشبكة المحلية
otBorderRouterRegister(otInstance *aInstance)
سجِّل على الفور بيانات الشبكة المحلية لدى "قائد الحملة".
otBorderRouterRemoveOnMeshPrefix(otInstance *aInstance, const otIp6Prefix *aPrefix)
يمكنك إزالة إعدادات جهاز توجيه الحدود من بيانات الشبكة المحلية.
otBorderRouterRemoveRoute(otInstance *aInstance, const otIp6Prefix *aPrefix)
إزالة إعدادات المسار الخارجي من بيانات الشبكة المحلية

الدوال

otBorderrouterAddOnMishPrefix

otError otBorderRouterAddOnMeshPrefix(
  otInstance *aInstance,
  const otBorderRouterConfig *aConfig
)

أضف إعداد جهاز توجيه الحدود إلى بيانات الشبكة المحلية.

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

otBorderrouterAddPath

otError otBorderRouterAddRoute(
  otInstance *aInstance,
  const otExternalRouteConfig *aConfig
)

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

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

otBorderrouterGetNetData

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

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

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

otBorderrouterGetNextOnMeshPrefix

otError otBorderRouterGetNextOnMeshPrefix(
  otInstance *aInstance,
  otNetworkDataIterator *aIterator,
  otBorderRouterConfig *aConfig
)

الحصول على البادئة التالية في الشبكة المتداخلة ضمن بيانات الشبكة المحلية

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

otBorderrouterGetNextPath

otError otBorderRouterGetNextRoute(
  otInstance *aInstance,
  otNetworkDataIterator *aIterator,
  otExternalRouteConfig *aConfig
)

الحصول على المسار الخارجي التالي في بيانات الشبكة المحلية

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

otBorderrouterregister

otError otBorderRouterRegister(
  otInstance *aInstance
)

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

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

otBorderrouterRemoveOnMeshPrefix

otError otBorderRouterRemoveOnMeshPrefix(
  otInstance *aInstance,
  const otIp6Prefix *aPrefix
)

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

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aPrefix
مؤشر لبادئة IPv6.
قيم الإرجاع
OT_ERROR_NONE
تمت إزالة الإعداد من بيانات الشبكة المحلية بنجاح.
OT_ERROR_NOT_FOUND
تعذّر العثور على إدخال جهاز توجيه الحدود.
يمكنك أيضًا الاطّلاع على ما يلي:
otBorderrouterAddOnMeshPrefix
otBorderrouterRecord

otBorderrouterRemovePath

otError otBorderRouterRemoveRoute(
  otInstance *aInstance,
  const otIp6Prefix *aPrefix
)

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

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aPrefix
مؤشر لبادئة IPv6.
قيم الإرجاع
OT_ERROR_NONE
تمت إزالة الإعداد من بيانات الشبكة المحلية بنجاح.
OT_ERROR_NOT_FOUND
تعذّر العثور على إدخال جهاز توجيه الحدود.
يمكنك أيضًا الاطّلاع على ما يلي:
otBorderrouterAddPath
otBorderrouterRecord

الموارد

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