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

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

ملخّص

أنواع المحددات
otBorderRouterNetDataFullCallback)(void *aContext) typedef
void(*
رد اتصال مؤشر الدالة الذي يتم استدعاءه عند امتلاء بيانات الشبكة (سواء المحلية أو الرئيسية)

الدوال
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)
إزالة إعدادات المسار الخارجي من بيانات الشبكة المحلية
otBorderRouterSetNetDataFullCallback(otInstance *aInstance, otBorderRouterNetDataFullCallback aCallback, void *aContext)
void
لضبط معاودة الاتصال للإشارة إلى امتلاء بيانات الشبكة.

أنواع المحددات

otBorderrouterNetDatafullCallback

void(* otBorderRouterNetDataFullCallback)(void *aContext)

رد اتصال مؤشر الدالة الذي يتم استدعاءه عند امتلاء بيانات الشبكة (سواء المحلية أو الرئيسية)

التفاصيل
المَعلمات
[in] aContext
مؤشر للمعلومات السياقية العشوائية.

الدوال

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

otBorderrouterSetNetDatafullCallback

void otBorderRouterSetNetDataFullCallback(
  otInstance *aInstance,
  otBorderRouterNetDataFullCallback aCallback,
  void *aContext
)

لضبط معاودة الاتصال للإشارة إلى امتلاء بيانات الشبكة.

يتطلب OPENTHREAD_CONFIG_BORDER_ROUTER_SIGNAL_NETWORK_DATA_FULL.

يتم استدعاء رد الاتصال في أي وقت:

  • يعمل الجهاز كرائد ويستقبل تسجيل بيانات الشبكة من جهاز توجيه الحدود (BR) الذي لا يمكن إضافته إلى بيانات الشبكة (نفدت المساحة).
  • يعمل الجهاز البرازيلي ولا يمكن إضافة الإدخالات الجديدة إلى بيانات الشبكة المحلية.
  • يعمل الجهاز كمجموعة برازيلية ويحاول تسجيل إدخالات بيانات الشبكة المحلية مع المسؤول، ولكن يحدِّد أن إدخالاتها المحلية غير مناسبة.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aCallback
رد الاتصال.
[in] aContext
مؤشّر إلى معلومات السياق العشوائية التي يتم استخدامها مع aCallback.

الموارد

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