רב-תכליתי

המודול הזה כולל את הפשטה של הפלטפורמה לתמיכה ב-Multipan.

סיכום

פונקציות
otPlatMultipanGetActiveInstance(otInstance **aInstance)
המכשיר שולט כרגע ברדיו.
otPlatMultipanIidToInstance(uint8_t aIid)
מוצאים את המצביע למכונה שתואם ל-IID הנתון.
otPlatMultipanInstanceToIid(otInstance *aInstance)
uint8_t
מקבלים את ה-IID שתואם למצביע של מופע OpenThread הנתון.
otPlatMultipanSetActiveInstance(otInstance *aInstance, bool aCompletePending)
הגדרת aInstance בתור המופע הפעיל הנוכחי ששולט ברדיו.
otPlatMultipanSwitchoverDone(otInstance *aInstance, bool aSuccess)
void
הפלטפורמה השלימה את תהליך החלפת הממשק.

פונקציות

otPlatMultipanGetActiveInstance

otError otPlatMultipanGetActiveInstance(
  otInstance **aInstance
)

המכשיר שולט כרגע ברדיו.

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

פרטים
פרמטרים
[out] aInstance
מצביעים על המשתנה כדי לאחסן את מצביע המופע הפעיל.
ערכים מוחזרים
OT_ERROR_NONE
הנכס אוחזר בהצלחה.
OT_ERROR_NOT_IMPLEMENTED
הפעולה נכשלה כי אין תמיכה ברדיו.
OT_ERROR_INVALID_COMMAND
הפלטפורמה תומכת בכל הממשקים בו-זמנית.

otPlatMultipanIidToInstance

otInstance * otPlatMultipanIidToInstance(
  uint8_t aIid
)

מוצאים את המצביע למכונה שתואם ל-IID הנתון.

פרטים
פרמטרים
[in] aIid
ה-IID של הממשק.
ערכים מוחזרים
Instance
מצביע אם ל-aIid מוקצה מופע, אחרת nullptr.

otPlatMultipanInstanceToIid

uint8_t otPlatMultipanInstanceToIid(
  otInstance *aInstance
)

מקבלים את ה-IID שתואם למצביע של מופע OpenThread הנתון.

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

otPlatMultipanSetActiveInstance

otError otPlatMultipanSetActiveInstance(
  otInstance *aInstance,
  bool aCompletePending
)

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

הפונקציה הזו מאפשרת לבחור את המכונה שפעילה כרגע בפלטפורמות שלא תומכות בתקשורת מקבילה בכמה ממשקים. במילים אחרות, אם יותר ממופע אחד נמצא במצב קבלה, קריאה ל-otPlatMultipanSetActiveInstance מבטיחה שהמכונה שצוינה תהיה זו שתקבל. הפונקציה הזו מחזירה את הערך אם הבקשה התקבלה כראוי. לאחר השלמת המעבר בין הממשק, הפלטפורמה צריכה לקרוא ל-otPlatMultipanSwitchoverDone. אם המדיניות aCompletePending מוגדרת כ-True, החלפת ממשקים עשויה להימשך זמן רב יותר.

פרטים
פרמטרים
[in] aInstance
מבנה המכונה של OpenThread.
[in] aCompletePending
הערך הוא True אם פעולת רדיו מתמשכת צריכה להסתיים לפני החלפת הממשק (מתג רך), הערך false עבור אילוץ מתג.
ערכים מוחזרים
OT_ERROR_NONE
המאפיין הוגדר בהצלחה.
OT_ERROR_BUSY
הפעולה נכשלה כי מתבצעת פעולה אחרת.
OT_ERROR_NOT_IMPLEMENTED
הפעולה נכשלה בגלל מופע לא ידוע או כי מספר המכונות גדול יותר מאשר הממשקים הזמינים.
OT_ERROR_INVALID_COMMAND
הפלטפורמה תומכת בכל הממשקים בו-זמנית.
OT_ERROR_ALREADY
הממשק הנתון כבר פעיל.

otPlatMultipanSwitchoverDone

void otPlatMultipanSwitchoverDone(
  otInstance *aInstance,
  bool aSuccess
)

הפלטפורמה השלימה את תהליך החלפת הממשק.

יש להפעיל אותן מיד לאחר העיבוד של otPlatMultipanSetActiveInstance אם אין צורך בעיכוב, או אם יש צורך בהשלמת פעולות רדיו ארוכות יותר, לאחר שהמעבר בממשקים הושלם במלואו.

פרטים
פרמטרים
[in] aInstance
מבנה המכונה של OpenThread.
[in] aSuccess
True אם הממשקים הוחלף בהצלחה, False אם ההחלפה נכשלה.

מקורות מידע

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