שונות

במודול הזה יש העמקות של התנהגויות שונות.

סיכום

מספור

otPlatMcuPowerState{
  OT_PLAT_MCU_POWER_STATE_ON = 0,
  OT_PLAT_MCU_POWER_STATE_LOW_POWER = 1,
  OT_PLAT_MCU_POWER_STATE_OFF = 2
}
טיפוסים בני מנייה (enum)
ספירה של מצבי המיקרו-בקר.
otPlatResetReason טיפוסים בני מנייה (enum)
רשימה של קודים אפשריים של סיבות לאיפוס.

פונקציות

otPlatAssertFail(const char *aFilename, int aLineNumber)
void
פונקציה זו מספקת הטמעה ספציפית לפלטפורמה לצורך הצהרה על זכויות יוצרים.
otPlatGetMcuPowerState(otInstance *aInstance)
פונקציה זו מקבלת את מצב הכוח הנוכחי ב-MCU.
otPlatGetResetReason(otInstance *aInstance)
פונקציה זו מחזירה את הסיבה לאיפוס האחרון של הפלטפורמה.
otPlatReset(otInstance *aInstance)
void
הפונקציה הזאת מבצעת איפוס תוכנה בפלטפורמה, אם היא נתמכת.
otPlatSetMcuPowerState(otInstance *aInstance, otPlatMcuPowerState aState)
פונקציה זו מגדירה את מצב העוצמה של MCU הרצוי.
otPlatWakeHost(void)
void
הפונקציה הזו מבצעת פעולה ספציפית לפלטפורמה כדי להעיר את ה-MCU של המארח.

מספור

otPlatMcuPowerState

 otPlatMcuPowerState

ספירה של מצבי המיקרו-בקר.

הערכים האלה משמשים להגדרת NCP כאשר OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL מופעל.

מצב ההפעלה מציין את מצב ההפעלה הרצוי של NCP'sMCU) כאשר מערכת ההפעלה של הפלטפורמה עוברת למצב לא פעיל (כלומר, כל המשימות/האירועים הפעילים מעובדים וייתכן שה-MCU יוכל להיכנס למצב חיסכון באנרגיה).

מצב ההפעלה קובע בעיקר את אופן האינטראקציה של המארח עם ה-NCP והאם המארח צריך להפעיל טריגר חיצוני ( "poke") לפני ה-NCP כדי לתקשר עם ה-NCP.

לאחר איפוס, מצב הטעינה ב-MCU חייב להיות OT_PLAT_POWER_STATE_ON.

מאפיינים
OT_PLAT_MCU_POWER_STATE_LOW_POWER

ב-MCC ניתן להיכנס למצב צריכת אנרגיה נמוכה (חיסכון באנרגיה).

כאשר מצב ההפעלה הרצוי של NCP' מוגדר ל-LOW_POWER, המארח צפוי להיות "poke" ה-NCP (למשל, טריגר חיצוני כמו הפרעה) לפני שהוא יכול לתקשר עם ה-NCP (שלח הודעה ל-NCP). המנגנון "poke" נקבע על ידי קוד הפלטפורמה (על סמך ממשק NCP' ).

למרות שמצב ההפעלה מוגדר ל-LOW_POWER, עדיין אפשר לשלוח הודעות ל-NCP (בכל זמן) כדי לארח הודעות. הערה: קבלת הודעה מה-NCP לא מעידה על כך שמצב העוצמה של NCP&& השתנה, כלומר המארח צפוי להמשיך ל-"poke" כשהוא רוצה לדבר עם ה-NCP עד שמצב החשמל ישתנה באופן מפורש (בקריאה מוצלחת ל-otPlatSetMcuPowerState() שינוי המצב ל-ON).

OT_PLAT_MCU_POWER_STATE_OFF

NCP כבוי באופן מלא.

יש צורך באיפוס חומרה מסוג NCP (באמצעות סיכה מסוג RESET) כדי להחזיר את ה-NCP ל-SPINEL_MCU_POWER_STATE_ON. זיכרון ה-RAM לא נשמר לאחר האיפוס.

OT_PLAT_MCU_POWER_STATE_ON

הפלטפורמה 'CPP' של CPN נשארת פעילה ופעילה כל הזמן.

כשמצב ההפעלה הרצוי של NCP & מוגדר ל-ON, המארח יכול לשלוח הודעות ל-NCP ללא צורך בטריגרים חיצוניים.

otPlatresetReason

 otPlatResetReason

רשימה של קודים אפשריים של סיבות לאיפוס.

הם באותו סדר כמו קודי הסיבות לאיפוס ה-Spinel.

פונקציות

otPlatAssertFail

void otPlatAssertFail(
  const char *aFilename,
  int aLineNumber
)

פונקציה זו מספקת הטמעה ספציפית לפלטפורמה לצורך הצהרה על זכויות יוצרים.

פרטים
פרמטרים
[in] aFilename
שם הקובץ שבו נשלחה ההצהרה.
[in] aLineNumber
מספר השורה בקובץ שבו אירעה התלונה.

otPlatGetMcuPowerState

otPlatMcuPowerState otPlatGetMcuPowerState(
  otInstance *aInstance
)

פונקציה זו מקבלת את מצב הכוח הנוכחי ב-MCU.

פעולה זו רלוונטית רק להגדרה של NCP כאשר OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL מופעל.

לאחר האיפוס, מצב ההפעלה חייב להחזיר OT_PLAT_POWER_STATE_ON. במהלך ההפעלה, מצב ההפעלה צריך להשתנות רק באמצעות קריאה מוצלחת במפורש ל-otPlatSetMcuPowerState().

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

otPlatGetResetReason

otPlatResetReason otPlatGetResetReason(
  otInstance *aInstance
)

פונקציה זו מחזירה את הסיבה לאיפוס האחרון של הפלטפורמה.

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

OTPlatreset

void otPlatReset(
  otInstance *aInstance
)

הפונקציה הזאת מבצעת איפוס תוכנה בפלטפורמה, אם היא נתמכת.

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

otPlatSetMcuPowerState

otError otPlatSetMcuPowerState(
  otInstance *aInstance,
  otPlatMcuPowerState aState
)

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

פעולה זו רלוונטית רק להגדרה של NCP כאשר OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL מופעל.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
[in] aState
מצב החשמל החדש של MCU.
ערכי החזרה
OT_ERROR_NONE
מצב הטעינה עודכן בהצלחה.
OT_ERROR_FAILED
הפלטפורמה לא תומכת במצב ההפעלה הנתון של MCU.

otPlatWakeHost

void otPlatWakeHost(
  void
)

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

המאפיין הזה משמש רק להגדרות של NCP.

מקורות מידע

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