רב-תכליתי

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

סיכום

פונקציות
otPlatMultipanGetActiveInstance(otInstance **aInstance)	otError המכשיר שולט כרגע ברדיו.
otPlatMultipanIidToInstance(uint8_t aIid)	otInstance * מוצאים את המצביע למכונה שתואם ל-IID הנתון.
otPlatMultipanInstanceToIid(otInstance *aInstance)	uint8_t מקבלים את ה-IID שתואם למצביע של מופע OpenThread הנתון.
otPlatMultipanSetActiveInstance(otInstance *aInstance, bool aCompletePending)	otError הגדרת 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. אפשר לקרוא מידע נוסף או לתרום למסמכי התיעוד שלנו בדף מקורות מידע.