Google is committed to advancing racial equity for Black communities. See how.

موجه الحدود

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

ملخص

المهام

otBorderRouterAddOnMeshPrefix ( otInstance *aInstance, const otBorderRouterConfig *aConfig)
أضف تكوين جهاز توجيه الحدود إلى بيانات الشبكة المحلية.
otBorderRouterAddRoute ( otInstance *aInstance, const otExternalRouteConfig *aConfig)
أضف تكوين مسار خارجي إلى بيانات الشبكة المحلية.
otBorderRouterGetNetData ( otInstance *aInstance, bool aStable, uint8_t *aData, uint8_t *aDataLength)
توفر هذه الطريقة نسخة كاملة أو ثابتة من بيانات شبكة مؤشر الترابط المحلية.
otBorderRouterGetNextOnMeshPrefix ( otInstance *aInstance, otNetworkDataIterator *aIterator, otBorderRouterConfig *aConfig)
تحصل هذه الوظيفة على بادئة On Mesh التالية في بيانات الشبكة المحلية.
otBorderRouterGetNextRoute ( otInstance *aInstance, otNetworkDataIterator *aIterator, otExternalRouteConfig *aConfig)
تحصل هذه الوظيفة على المسار الخارجي التالي في بيانات الشبكة المحلية.
otBorderRouterRegister ( otInstance *aInstance)
قم على الفور بتسجيل بيانات الشبكة المحلية مع القائد.
otBorderRouterRemoveOnMeshPrefix ( otInstance *aInstance, const otIp6Prefix *aPrefix)
قم بإزالة تكوين جهاز توجيه الحدود من بيانات الشبكة المحلية.
otBorderRouterRemoveRoute ( otInstance *aInstance, const otIp6Prefix *aPrefix)
قم بإزالة تكوين مسار خارجي من بيانات الشبكة المحلية.
otBorderRoutingGetOmrPrefix ( otInstance *aInstance, otIp6Prefix *aPrefix)
تقوم هذه الطريقة بإرجاع البادئة غير القابلة للتوجيه (OMR).
otBorderRoutingGetOnLinkPrefix ( otInstance *aInstance, otIp6Prefix *aPrefix)
تقوم هذه الطريقة بإرجاع البادئة الموجودة على الارتباط لارتباط البنية التحتية المجاور.
otBorderRoutingInit ( otInstance *aInstance, uint32_t aInfraIfIndex, bool aInfraIfIsRunning)
تعمل هذه الطريقة على تهيئة مدير توجيه الحدود على واجهة بنية أساسية معينة.
otBorderRoutingSetEnabled ( otInstance *aInstance, bool aEnabled)
تعمل هذه الطريقة على تمكين / تعطيل إدارة توجيه الحدود.

المهام

otBorderRouterAddOnMeshPrefix

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

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

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

otBorderRouterAddRoute

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

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

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

otBorderRouterGetNetData

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

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

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

otBorderRouterGetNextOnMeshPrefix

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

تحصل هذه الوظيفة على بادئة On Mesh التالية في بيانات الشبكة المحلية.

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

otBorderRouterGetNextRoute

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
لا يوجد إدخال توجيه خارجي لاحق موجود في بيانات شبكة مؤشر الترابط.

otBorderRouter تسجيل

otError otBorderRouterRegister(
  otInstance *aInstance
)

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

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

otBorderRouterRemoveOnMeshPrefix

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

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

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

otBorderRouterRemoveRoute

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

قم بإزالة تكوين مسار خارجي من بيانات الشبكة المحلية.

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

otBorderRoutingGetOmrPrefix

otError otBorderRoutingGetOmrPrefix(
  otInstance *aInstance,
  otIp6Prefix *aPrefix
)

تقوم هذه الطريقة بإرجاع البادئة غير القابلة للتوجيه (OMR).

سيتم نشر بادئة 64 بت التي تم إنشاؤها عشوائيًا في شبكة الموضوع إذا لم تكن هناك بادئة OMR بالفعل.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[out] aPrefix
مؤشر إلى المكان الذي سيتم إخراج البادئة إليه.
إرجاع القيم
OT_ERROR_INVALID_STATE
لم تتم تهيئة مدير توجيه الحدود بعد.
OT_ERROR_NONE
تم استرداد بادئة OMR بنجاح.

otBorderRoutingGetOnLinkPrefix

otError otBorderRoutingGetOnLinkPrefix(
  otInstance *aInstance,
  otIp6Prefix *aPrefix
)

تقوم هذه الطريقة بإرجاع البادئة الموجودة على الارتباط لارتباط البنية التحتية المجاور.

سيتم الإعلان عن بادئة 64 بت التي تم إنشاؤها عشوائيًا على ارتباط البنية التحتية إذا لم يكن هناك بالفعل بادئة قابلة للاستخدام على الرابط يتم الإعلان عنها على الرابط.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[out] aPrefix
مؤشر إلى المكان الذي سيتم إخراج البادئة إليه.
إرجاع القيم
OT_ERROR_INVALID_STATE
لم تتم تهيئة مدير توجيه الحدود بعد.
OT_ERROR_NONE
تم استرداد بادئة الارتباط بنجاح.

otBorderRoutingInit

otError otBorderRoutingInit(
  otInstance *aInstance,
  uint32_t aInfraIfIndex,
  bool aInfraIfIsRunning
)

تعمل هذه الطريقة على تهيئة مدير توجيه الحدود على واجهة بنية أساسية معينة.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aInfraIfIndex
فهرس واجهة البنية التحتية.
[in] aInfraIfIsRunning
قيمة منطقية تشير إلى ما إذا كانت واجهة البنية الأساسية قيد التشغيل.
إرجاع القيم
OT_ERROR_NONE
تم بدء تشغيل مدير توجيه الحدود بنجاح على بنية أساسية معينة.
OT_ERROR_INVALID_STATE
تمت تهيئة مدير توجيه الحدود بالفعل.
OT_ERROR_INVALID_ARGS
فهرس واجهة البنية التحتية غير صالح.
OT_ERROR_FAILED
فشل داخلي. عادة بسبب الفشل في إنشاء بادئات عشوائية.
أنظر أيضا:
otPlatInfraIfStateChanged .

otBorderRoutingSetEnabled

otError otBorderRoutingSetEnabled(
  otInstance *aInstance,
  bool aEnabled
)

تعمل هذه الطريقة على تمكين / تعطيل إدارة توجيه الحدود.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aEnabled
قيمة منطقية لتمكين / تعطيل مدير التوجيه.
إرجاع القيم
OT_ERROR_INVALID_STATE
لم تتم تهيئة مدير توجيه الحدود بعد.
OT_ERROR_NONE
تم تمكين / تعطيل مدير توجيه الحدود بنجاح.