מנהל ניתוב גבולות

המודול הזה כולל הגדרות הקשורות ל'מנהל ניתוב הגבול'.

סיכום

כדי להשתמש בכל הפונקציות במודול הזה צריך להפעיל את OPENTHREAD_CONFIG_BORDER_ROUTING_ENABLE.

מנהל ניתוב הגבולות מטפל בניתוב דו-כיווני בין רשת Thread לבין קישור תשתית סמוך (AIL).

הוא פולט הודעות ICMRv6 ND Router פרסומת (RA) ב-AIL לפרסום קידומות קישור וקידומות של מסלולים. בנוסף, הוא מעבד הודעות RA מהתשתית ומשקף את הקידומות שהתגלו בנתוני Thread Network Data כדי להבטיח שמכשירים ב-Thread mesh יוכלו להגיע ל-AIL דרך נתב הגבולות.

Routing Manager מנהל את הקידומת Off-Mesh Routable (OMR) בנתוני ה-Thread Network. כדי להגדיר את מכשירי Thread עם כתובת ה-IPv6 המתאימה ל-Out-Mesh Routable, צריך להגדיר את המכשירים. היא מודיעה על יכולת ההגעה של הקידומת הזו ב-AIL על ידי הכללתה בהודעות ה-RA שנפלטו כאפשרות פרטי מסלול של IPv6 (RIO).

בנוסף, מנהל הניתוב עוקב אחר רשת התשתית ומוסיפים לה קידומת on-link. אם נתב ב-AIL כבר מספק הודעות RA שמכילות אפשרות פרטי קידומת (PIO) של IPv6 שמאפשרת למכשירי IPv6 להגדיר באופן עצמאי כתובת IPv6 מסוג unicast שניתן לנתב בעצמם, מכשירי Thread יכולים להשתמש בכתובת הזו כדי להגיע ל-AIL. אם נתב Border Router לא מוצא הודעת RA כזו ב-AIL, הוא יוצר קידומת ULA בקישור אשר לאחר מכן היא מפרסמת ב-AIL בהודעות ה-RA שנשלחו.

ספירות
otBorderRoutingDhcp6PdState{   OT_BORDER_ROUTING_DHCP6_PD_STATE_DISABLED,   OT_BORDER_ROUTING_DHCP6_PD_STATE_STOPPED,   OT_BORDER_ROUTING_DHCP6_PD_STATE_RUNNING }	טיפוסים בני מנייה (enum) המספור הזה מייצג את המצב של 'מצב הענקת גישה לקידומת DHCPv6'.
otBorderRoutingState{   OT_BORDER_ROUTING_STATE_UNINITIALIZED,   OT_BORDER_ROUTING_STATE_DISABLED,   OT_BORDER_ROUTING_STATE_STOPPED,   OT_BORDER_ROUTING_STATE_RUNNING }	טיפוסים בני מנייה (enum) מייצג את המצב של מנהל ניתוב הגבול.

ערכי דף
otBorderRoutingPrefixTableEntry	typedef struct otBorderRoutingPrefixTableEntry מייצג ערך מטבלת הקידומות שהתגלתה.
otBorderRoutingPrefixTableIterator	typedef struct otBorderRoutingPrefixTableIterator מייצג איטרטור שחוזר על עצמו דרך טבלת הקידומתים שהתגלתה נתב הגבול.
otBorderRoutingRouterEntry	typedef struct otBorderRoutingRouterEntry מייצג נתב שהתגלה בקישור לתשתית.
otPdProcessedRaInfo	typedef struct otPdProcessedRaInfo מייצג קבוצת נתונים של הודעות RA שנוצרו על ידי פלטפורמה שעובדו.

פונקציות
otBorderRoutingClearRouteInfoOptionPreference(otInstance *aInstance)	void פעולה זו מנקה ערך העדפה שהוגדר קודם לכן עבור אפשרויות פרטי נתיב שפורסמו.
otBorderRoutingClearRoutePreference(otInstance *aInstance)	void פעולה זו מנקה ערך העדפה שהוגדר קודם לנתיבים שפורסמו בנתוני רשת.
otBorderRoutingDhcp6PdGetState(otInstance *aInstance)	otBorderRoutingDhcp6PdState הפונקציה מקבלת את המצב הנוכחי של הענקת תחילית DHCPv6.
otBorderRoutingDhcp6PdSetEnabled(otInstance *aInstance, bool aEnabled)	void הפעלה / השבתה של הקצאת קידומת DHCPv6.
otBorderRoutingGetFavoredNat64Prefix(otInstance *aInstance, otIp6Prefix *aPrefix, otRoutePreference *aPreference)	otError הפונקציה מקבלת את קידומת NAT64 המועדפת כרגע.
otBorderRoutingGetFavoredOmrPrefix(otInstance *aInstance, otIp6Prefix *aPrefix, otRoutePreference *aPreference)	otError הפונקציה מקבלת את הקידומת המועדפת כיום של Off-Mesh-Routable (OMR).
otBorderRoutingGetFavoredOnLinkPrefix(otInstance *aInstance, otIp6Prefix *aPrefix)	otError קבלת קידומת On-Link המועדפת כרגע.
otBorderRoutingGetNat64Prefix(otInstance *aInstance, otIp6Prefix *aPrefix)	otError מקבל את קידומת NAT64 המקומית של נתב הגבול.
otBorderRoutingGetNextPrefixTableEntry(otInstance *aInstance, otBorderRoutingPrefixTableIterator *aIterator, otBorderRoutingPrefixTableEntry *aEntry)	otError חוזר על הערכים בטבלת התחילית של נתב הגבול שאותרה.
otBorderRoutingGetNextRouterEntry(otInstance *aInstance, otBorderRoutingPrefixTableIterator *aIterator, otBorderRoutingRouterEntry *aEntry)	otError מתבצע איטרציה של הרשומות של הנתב שזוהו בקישור לתשתית.
otBorderRoutingGetOmrPrefix(otInstance *aInstance, otIp6Prefix *aPrefix)	otError הפונקציה מקבלת את הקידומת המקומית Off-Mesh-Routable (OMR) המקומית, לדוגמה fdfc:1ff5:1512:5622::/64.
otBorderRoutingGetOnLinkPrefix(otInstance *aInstance, otIp6Prefix *aPrefix)	otError הפונקציה מקבלת את הקידומת המקומית On-Link עבור קישור התשתית הצמוד.
otBorderRoutingGetPdOmrPrefix(otInstance *aInstance, otBorderRoutingPrefixTableEntry *aPrefixInfo)	otError הפונקציה מקבלת את הקידומת DHCPv6 Prefix Delegation (PD) שסופקה off-mesh-routable (OMR).
otBorderRoutingGetPdProcessedRaInfo(otInstance *aInstance, otPdProcessedRaInfo *aPdProcessedRaInfo)	otError מקבל את הנתונים של הודעת RA שנוצרה בפלטפורמה.
otBorderRoutingGetRouteInfoOptionPreference(otInstance *aInstance)	otRoutePreference קבלת ההעדפה הנוכחית שנעשה בה שימוש בעת פרסום 'אפשרויות מידע על המסלול' (RIO) בהודעות הפרסומת של הנתב שנשלחות דרך הקישור לתשתית.
otBorderRoutingGetRoutePreference(otInstance *aInstance)	otRoutePreference הפונקציה מקבלת את ההעדפה הנוכחית המשמשת למסלולים שפורסמו בנתוני הרשת.
otBorderRoutingGetState(otInstance *aInstance)	otBorderRoutingState קבלת המצב הנוכחי של מנהל ניתוב הגבול.
otBorderRoutingInit(otInstance *aInstance, uint32_t aInfraIfIndex, bool aInfraIfIsRunning)	otError הפעלת מנהל ניתוב הגבול בממשק התשתית הנתון.
otBorderRoutingPrefixTableInitIterator(otInstance *aInstance, otBorderRoutingPrefixTableIterator *aIterator)	void מופעלת otBorderRoutingPrefixTableIterator.
otBorderRoutingSetEnabled(otInstance *aInstance, bool aEnabled)	otError מפעילה או משביתה את 'מנהל ניתוב הגבולות'.
otBorderRoutingSetRouteInfoOptionPreference(otInstance *aInstance, otRoutePreference aPreference)	void המדיניות הזו מגדירה באופן מפורש את ההעדפה לשימוש בזמן פרסום של אפשרויות מידע על המסלול (RIO) בהודעות הפרסומת של הנתב שנשלחות דרך הקישור לתשתית.
otBorderRoutingSetRoutePreference(otInstance *aInstance, otRoutePreference aPreference)	void המדיניות מגדירה באופן מפורש את ההעדפה של נתיבים שפורסמו בנתוני הרשת.

מבנים
otBorderRoutingPrefixTableEntry	מייצג ערך מטבלת הקידומות שהתגלתה.
otBorderRoutingPrefixTableIterator	מייצג איטרטור שחוזר על עצמו דרך טבלת הקידומתים שהתגלתה נתב הגבול.
otBorderRoutingRouterEntry	מייצג נתב שהתגלה בקישור לתשתית.
otPdProcessedRaInfo	מייצג קבוצת נתונים של הודעות RA שנוצרו על ידי פלטפורמה שעובדו.

ספירות

otBorderRoutingDhcp6PdState

 otBorderRoutingDhcp6PdState

המספור הזה מייצג את המצב של 'מצב הענקת גישה לקידומת DHCPv6'.

תכונות
OT_BORDER_ROUTING_DHCP6_PD_STATE_DISABLED	DHCPv6 PD מושבת בנתב הגבולות.
OT_BORDER_ROUTING_DHCP6_PD_STATE_RUNNING	DHCPv6 PD מופעל וינסה לבקש ולפרסם קידומת.
OT_BORDER_ROUTING_DHCP6_PD_STATE_STOPPED	DHCPv6 PD מופעל, אבל לא ינסה לבקש ולפרסם קידומת.

otBorderRoutingState

 otBorderRoutingState

מייצג את המצב של מנהל ניתוב הגבול.

תכונות
OT_BORDER_ROUTING_STATE_DISABLED	מנהל הניתוב הופעל אך מושבת.
OT_BORDER_ROUTING_STATE_RUNNING	מנהל הניתוב מאותחל, מופעל ופועל.
OT_BORDER_ROUTING_STATE_STOPPED	מנהל הניתוב הופעל והופעל אבל הופסק כרגע.
OT_BORDER_ROUTING_STATE_UNINITIALIZED	מנהל הניתוב לא מאותחל.

ערכי דף

otBorderRoutingPrefixTableEntry

struct otBorderRoutingPrefixTableEntry otBorderRoutingPrefixTableEntry

מייצג ערך מטבלת הקידומות שהתגלתה.

הרשומות בטבלה שהתגלתה עוקבות אחר אפשרויות הקידומת/פרטי המסלול בהודעות הפרסומת שהתקבלו מהנתב נתבים אחרים בקישור התשתית.

otBorderRoutingPrefixTableIterator

struct otBorderRoutingPrefixTableIterator otBorderRoutingPrefixTableIterator

מייצג איטרטור שחוזר על עצמו דרך טבלת הקידומתים שהתגלתה נתב הגבול.

השדות בסוג הזה אטומים (מיועדים לשימוש על ידי ליבת OpenThread בלבד) ולכן מבצע הקריאה החוזרת (caller) לא יכול לגשת אליהם או להשתמש בהם.

לפני השימוש באיטרטור, הוא חייב להיות מופעל באמצעות otBorderRoutingPrefixTableInitIterator().

otBorderRoutingRouterEntry

struct otBorderRoutingRouterEntry otBorderRoutingRouterEntry

מייצג נתב שהתגלה בקישור לתשתית.

otPdProcessedRaInfo

struct otPdProcessedRaInfo otPdProcessedRaInfo

מייצג קבוצת נתונים של הודעות RA שנוצרו על ידי פלטפורמה שעובדו.

פונקציות

otBorderRoutingClearRouteInfoOptionPreference

void otBorderRoutingClearRouteInfoOptionPreference(
  otInstance *aInstance
)

פעולה זו מנקה ערך העדפה שהוגדר קודם לכן עבור אפשרויות פרטי נתיב שפורסמו.

לאחר קריאה לפונקציה הזו, BR ישתמש בתפקיד המכשיר כדי לקבוע את העדפת ה-RIO: העדפה בינונית במהלך תפקיד הנתב/מנהיג והעדפה נמוכה בתפקיד צאצא.

פרטים
פרמטרים	[in] aInstance מצביע למופע של OpenThread.

otBorderRoutingClearRoutePreference

void otBorderRoutingClearRoutePreference(
  otInstance *aInstance
)

פעולה זו מנקה ערך העדפה שהוגדר קודם לנתיבים שפורסמו בנתוני רשת.

לאחר קריאה לפונקציה הזו, BR יקבע את ההעדפה באופן אוטומטי על סמך תפקיד המכשיר ואיכות הקישור (להורה כשהוא פועל כמכשיר קצה).

פרטים
פרמטרים	[in] aInstance מצביע למופע של OpenThread.

otBorderRoutingDhcp6PdGetState

otBorderRoutingDhcp6PdState otBorderRoutingDhcp6PdGetState(
  otInstance *aInstance
)

הפונקציה מקבלת את המצב הנוכחי של הענקת תחילית DHCPv6.

צריך להפעיל את OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE.

פרטים
פרמטרים	[in] aInstance מצביע למופע של OpenThread.
החזרות	המצב הנוכחי של הקצאת קידומת DHCPv6.

otBorderRoutingDhcp6PdSetEnabled

void otBorderRoutingDhcp6PdSetEnabled(
  otInstance *aInstance,
  bool aEnabled
)

הפעלה / השבתה של הקצאת קידומת DHCPv6.

חובה להפעיל את OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE.

פרטים
פרמטרים	[in] aInstance מצביע למופע של OpenThread. [in] aEnabled האם לקבל הודעות RA שנוצרו על ידי פלטפורמה.

otBorderRoutingGetFavoredNat64Prefix

otError otBorderRoutingGetFavoredNat64Prefix(
  otInstance *aInstance,
  otIp6Prefix *aPrefix,
  otRoutePreference *aPreference
)

הפונקציה מקבלת את קידומת NAT64 המועדפת כרגע.

ניתן למצוא את קידומת NAT64 המועדפת באמצעות קישור לתשתית, או להיות קידומת NAT64 המקומית במכשיר.

פרטים
פרמטרים	[in] aInstance מצביע למופע של OpenThread. [out] aPrefix מצביע לפלט של קידומת NAT64 המועדפת. [out] aPreference מצביע לפלט של ההעדפה המשויכת לקידומת המועדפת.
ערכים מוחזרים	OT_ERROR_INVALID_STATE מנהל ניתוב הגבול עדיין לא אותחל. OT_ERROR_NONE קידומת NAT64 המועדפת אוחזרה בהצלחה.

otBorderRoutingGetFavoredOmrPrefix

otError otBorderRoutingGetFavoredOmrPrefix(
  otInstance *aInstance,
  otIp6Prefix *aPrefix,
  otRoutePreference *aPreference
)

הפונקציה מקבלת את הקידומת המועדפת כיום של Off-Mesh-Routable (OMR).

ניתן לגלות את קידומת ה-OMR המועדפת מנתוני רשת, או שהיא יכולה להיות קידומת ה-OMR המקומית של המכשיר.

פרטים
פרמטרים	[in] aInstance מצביע למופע של OpenThread. [out] aPrefix מצביע לפלט של קידומת ה-OMR המועדפת. [out] aPreference מצביע לפלט של ההעדפה המשויכת לקידומת המועדפת.
ערכים מוחזרים	OT_ERROR_INVALID_STATE מנהל ניתוב הגבול עדיין לא פועל. OT_ERROR_NONE קידומת ה-OMR המועדפת אוחזרה בהצלחה.

otBorderRoutingGetFavoredOnLinkPrefix

otError otBorderRoutingGetFavoredOnLinkPrefix(
  otInstance *aInstance,
  otIp6Prefix *aPrefix
)

קבלת קידומת On-Link המועדפת כרגע.

התחילית המועדפת היא קידומת שהתגלתה בקישור לתשתית או קידומת מקומית בקישור.

פרטים
פרמטרים	[in] aInstance מצביע למופע של OpenThread. [out] aPrefix מצביע למקום שאליו תיוצא הפלט.
ערכים מוחזרים	OT_ERROR_INVALID_STATE מנהל ניתוב הגבול עדיין לא אותחל. OT_ERROR_NONE התחילית של הקישור המועדפת אוחזרה בהצלחה.

otBorderRoutingGetNat64Prefix

otError otBorderRoutingGetNat64Prefix(
  otInstance *aInstance,
  otIp6Prefix *aPrefix
)

מקבל את קידומת NAT64 המקומית של נתב הגבול.

יכול להיות שקידומת NAT64 לא מפורסמת ברשת Thread.

חובה להפעיל את OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE.

פרטים
פרמטרים	[in] aInstance מצביע למופע של OpenThread. [out] aPrefix מצביע למקום שאליו תיוצא הפלט.
ערכים מוחזרים	OT_ERROR_INVALID_STATE מנהל ניתוב הגבול עדיין לא אותחל. OT_ERROR_NONE קידומת NAT64 אוחזרה בהצלחה.

otBorderRoutingGetNextPrefixTableEntry

otError otBorderRoutingGetNextPrefixTableEntry(
  otInstance *aInstance,
  otBorderRoutingPrefixTableIterator *aIterator,
  otBorderRoutingPrefixTableEntry *aEntry
)

חוזר על הערכים בטבלת התחילית של נתב הגבול שאותרה.

מובטחות שרשומות קידומת שמשויכות לאותו נתב שהתגלה בקישור לתשתית יקובצו יחד (יאוחזרו בזה אחר זה).

פרטים
פרמטרים	[in] aInstance במכונה של OpenThread. [in,out] aIterator מצביע על האיטרטור. [out] aEntry מצביע לרשומה שצריך לאכלס.
ערכים מוחזרים	OT_ERROR_NONE בוצע עדכון לערך הבא, aEntry ו-aIterator מתעדכנים. OT_ERROR_NOT_FOUND אין עוד ערכים בטבלה.

otBorderRoutingGetNextRouterEntry

otError otBorderRoutingGetNextRouterEntry(
  otInstance *aInstance,
  otBorderRoutingPrefixTableIterator *aIterator,
  otBorderRoutingRouterEntry *aEntry
)

מתבצע איטרציה של הרשומות של הנתב שזוהו בקישור לתשתית.

פרטים
פרמטרים	[in] aInstance במכונה של OpenThread. [in,out] aIterator מצביע על האיטרטור. [out] aEntry מצביע לרשומה שצריך לאכלס.
ערכים מוחזרים	OT_ERROR_NONE בוצע עדכון בנתב הבא, aEntry ו-aIterator מתעדכנים. OT_ERROR_NOT_FOUND לא יוצגו רשומות נתבים נוספות.

otBorderRoutingGetOmrPrefix

otError otBorderRoutingGetOmrPrefix(
  otInstance *aInstance,
  otIp6Prefix *aPrefix
)

הפונקציה מקבלת את הקידומת המקומית Off-Mesh-Routable (OMR) המקומית, לדוגמה fdfc:1ff5:1512:5622::/64.

קידומת OMR היא קידומת של 64 ביט שנוצרת באופן אקראי ומתפרסמת ברשת Thread, אם אין עדיין קידומת OMR. אפשר להגיע לקידומת הזו מרשת ה-Wi-Fi או האתרנט המקומית.

הערה: כאשר DHCPv6 PD מופעל, נתב הגבולות עשוי לפרסם את הקידומת מ-DHCPv6 PD.

פרטים
פרמטרים	[in] aInstance מצביע למופע של OpenThread. [out] aPrefix מצביע למקום שאליו תיוצא הפלט.
ערכים מוחזרים	OT_ERROR_INVALID_STATE מנהל ניתוב הגבול עדיין לא אותחל. OT_ERROR_NONE קידומת ה-OMR אוחזרה בהצלחה.

למידע נוסף:
otBorderRoutingGetPdOmrPrefix

otBorderRoutingGetOnLinkPrefix

otError otBorderRoutingGetOnLinkPrefix(
  otInstance *aInstance,
  otIp6Prefix *aPrefix
)

הפונקציה מקבלת את הקידומת המקומית On-Link עבור קישור התשתית הצמוד.

הקידומת המקומית On-Link היא קידומת של 64 ביט שמפורסמת בקישור התשתית, אם עדיין לא פורסמה קידומת בקישור שניתנת לשימוש.

פרטים
פרמטרים	[in] aInstance מצביע למופע של OpenThread. [out] aPrefix מצביע למקום שאליו תיוצא הפלט.
ערכים מוחזרים	OT_ERROR_INVALID_STATE מנהל ניתוב הגבול עדיין לא אותחל. OT_ERROR_NONE האחזור של הקידומת המקומית בקישור בוצע בהצלחה.

otBorderRoutingGetPdOmrPrefix

otError otBorderRoutingGetPdOmrPrefix(
  otInstance *aInstance,
  otBorderRoutingPrefixTableEntry *aPrefixInfo
)

הפונקציה מקבלת את הקידומת DHCPv6 Prefix Delegation (PD) שסופקה off-mesh-routable (OMR).

רק השדות mPrefix, mValidLifetime ו-mPreferredLifetime משמשים בפרטי הקידומת שמוחזרת.

חובה להפעיל את OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE.

פרטים
פרמטרים	[in] aInstance מצביע למופע של OpenThread. [out] aPrefixInfo מצביע למקום שאליו יש לשלוח את פרטי הקידומת.
ערכים מוחזרים	OT_ERROR_NONE קידומת ה-OMR אוחזרה בהצלחה. OT_ERROR_INVALID_STATE מנהל ניתוב הגבול עדיין לא אותחל. OT_ERROR_NOT_FOUND אין קידומת PD חוקית בברזיל הזה.

כדאי לעיין גם בנתונים:
otBorderRoutingGetOmrPrefix
otPlatBorderRoutingProcessIcmp6Ra

otBorderRoutingGetPdProcessedRaInfo

otError otBorderRoutingGetPdProcessedRaInfo(
  otInstance *aInstance,
  otPdProcessedRaInfo *aPdProcessedRaInfo
)

מקבל את הנתונים של הודעת RA שנוצרה בפלטפורמה.

חובה להפעיל את OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE.

פרטים
פרמטרים	[in] aInstance מצביע למופע של OpenThread. [out] aPrefixInfo מצביע למקום שאליו יש לשלוח את פרטי הקידומת.
ערכים מוחזרים	OT_ERROR_NONE המידע אוחזר בהצלחה. OT_ERROR_INVALID_STATE מנהל ניתוב הגבול עדיין לא אותחל. OT_ERROR_NOT_FOUND אין מידע חוקי על ברזיל.

otBorderRoutingGetRouteInfoOptionPreference

otRoutePreference otBorderRoutingGetRouteInfoOptionPreference(
  otInstance *aInstance
)

קבלת ההעדפה הנוכחית שנעשה בה שימוש בעת פרסום 'אפשרויות מידע על המסלול' (RIO) בהודעות הפרסומת של הנתב שנשלחות דרך הקישור לתשתית.

העדפת ה-RIO נקבעת כך:

• אם המשתמש הגדיר במפורש את ההרשאה באמצעות otBorderRoutingSetRouteInfoOptionPreference(), המערכת תשתמש בהעדפה הנתונה.
• אחרת, היא נקבעת על סמך התפקיד הנוכחי של המכשיר: העדפה בינונית במסגרת תפקיד הנתב/המנהיג והעדפה נמוכה בתפקיד הצאצא.

פרטים
החזרות	ההעדפה הנוכחית של האפשרות 'פרטי נתיב'.

otBorderRoutingGetRoutePreference

otRoutePreference otBorderRoutingGetRoutePreference(
  otInstance *aInstance
)

הפונקציה מקבלת את ההעדפה הנוכחית המשמשת למסלולים שפורסמו בנתוני הרשת.

ההעדפה נקבעת כך:

• אם המשתמש הגדיר במפורש את ההרשאה באמצעות otBorderRoutingSetRoutePreference(), המערכת תשתמש בהעדפה הנתונה.
• אחרת, הוא נקבע באופן אוטומטי על ידי RoutingManager על סמך תפקיד המכשיר ואיכות הקישור.

פרטים
פרמטרים	[in] aInstance מצביע למופע של OpenThread.
החזרות	העדפת המסלול הנוכחית שפורסמה.

otBorderRoutingGetState

otBorderRoutingState otBorderRoutingGetState(
  otInstance *aInstance
)

קבלת המצב הנוכחי של מנהל ניתוב הגבול.

פרטים
פרמטרים	[in] aInstance מצביע למופע של OpenThread.
החזרות	המצב הנוכחי של מנהל ניתוב הגבול.

otBorderRoutingInit

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

הפעלת מנהל ניתוב הגבול בממשק התשתית הנתון.

הערה: חובה להפעיל את השיטה הזו לפני ממשקי API אחרים מסוג otBorderRouting*.

הערה: אפשר לקרוא לשיטה הזו מחדש כדי לשנות את ממשק התשתית, אבל קודם צריך להשבית את Border Routing Manager ולהפעיל אותו מחדש.

פרטים
פרמטרים	[in] aInstance מצביע למופע של OpenThread. [in] aInfraIfIndex האינדקס של ממשק התשתית. [in] aInfraIfIsRunning ערך בוליאני שמציין אם ממשק התשתית פועל.
ערכים מוחזרים	OT_ERROR_NONE בוצעה הפעלה של 'מנהל ניתוב הגבול' בתשתית הנתונה. OT_ERROR_INVALID_STATE מנהל ניתוב הגבול נמצא במצב שאינו מושבת או לא מאותחל. OT_ERROR_INVALID_ARGS האינדקס של ממשק התשתית לא חוקי. OT_ERROR_FAILED כשל פנימי. לרוב בשל כשל ביצירת תחיליות אקראיות.

ראו גם:
otPlatInfraIfStateChanged.
otBorderRoutingSetEnabled.

otBorderRoutingPrefixTableInitIterator

void otBorderRoutingPrefixTableInitIterator(
  otInstance *aInstance,
  otBorderRoutingPrefixTableIterator *aIterator
)

מופעלת otBorderRoutingPrefixTableIterator.

חובה לאתחל איטרטור לפני השימוש בו.

אפשר לאתחל איטרטור כדי לבצע הפעלה מחדש מתחילת הטבלה.

כשחוזרים על רשומות בטבלה, כדי להבטיח שזמני העדכון של mMsecSinceLastUpdate של הרשומות יהיו עקביים, הם ניתנים ביחס לזמן שהאיטרטור הופעל.

פרטים
פרמטרים	[in] aInstance במכונה של OpenThread. [out] aIterator מצביע לאטרטור כדי לאתחל.

otBorderRoutingSetEnabled

otError otBorderRoutingSetEnabled(
  otInstance *aInstance,
  bool aEnabled
)

מפעילה או משביתה את 'מנהל ניתוב הגבולות'.

הערה: מנהל ניתוב הגבולות מושבת כברירת מחדל.

פרטים
פרמטרים	[in] aInstance מצביע למופע של OpenThread. [in] aEnabled ערך בוליאני להפעלה/השבתה של מנהל הניתוב.
ערכים מוחזרים	OT_ERROR_INVALID_STATE מנהל ניתוב הגבול עדיין לא אותחל. OT_ERROR_NONE הופעל/הושבת בהצלחה מנהל ניתוב הגבול.

otBorderRoutingSetRouteInfoOptionPreference

void otBorderRoutingSetRouteInfoOptionPreference(
  otInstance *aInstance,
  otRoutePreference aPreference
)

המדיניות הזו מגדירה באופן מפורש את ההעדפה לשימוש בזמן פרסום של אפשרויות מידע על המסלול (RIO) בהודעות הפרסומת של הנתב שנשלחות דרך הקישור לתשתית.

לאחר קריאה לפונקציה הזו, BR ישתמש בהעדפה הנתונה בכל ה-RIO שהיא מפרסמת. אפשר להתקשר אל otBorderRoutingClearRouteInfoOptionPreference() כדי לבטל את ההעדפה.

פרטים
פרמטרים	[in] aInstance מצביע למופע של OpenThread. [in] aPreference העדפת המסלול שבה כדאי להשתמש.

otBorderRoutingSetRoutePreference

void otBorderRoutingSetRoutePreference(
  otInstance *aInstance,
  otRoutePreference aPreference
)

המדיניות מגדירה באופן מפורש את ההעדפה של נתיבים שפורסמו בנתוני הרשת.

לאחר קריאה לפונקציה הזו, BR ישתמש בהעדפה הנתונה. אפשר להתקשר אל otBorderRoutingClearRoutePreference() כדי לבטל את ההעדפה.

פרטים
פרמטרים	[in] aInstance מצביע למופע של OpenThread. [in] aPreference העדפת המסלול שבה כדאי להשתמש.

מקורות מידע

המקור של נושאי העזר של OpenThread API הוא קוד המקור, שזמין ב-GitHub. אפשר לקרוא מידע נוסף או לתרום למסמכי התיעוד שלנו בדף מקורות מידע.