דף זה תורגם על ידי Cloud Translation API.

שונות

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

סיכום

ספירות
`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` מספקת הטמעה ספציפית לפלטפורמה לטענת נכוֹנוּת (assert).
`otPlatGetMcuPowerState(otInstance *aInstance)`	`otPlatMcuPowerState` מקבל את מצב החשמל הרצוי ב-MCU.
`otPlatGetResetReason(otInstance *aInstance)`	`otPlatResetReason` מחזירה את הסיבה לאיפוס הפלטפורמה האחרון.
`otPlatReset(otInstance *aInstance)`	`void` יבצע איפוס תוכנה בפלטפורמה, אם הוא נתמך.
`otPlatResetToBootloader(otInstance *aInstance)`	`otError` מאפס את החומרה בפלטפורמה כדי להפעיל את מצב תוכנת האתחול, אם הוא נתמך.
`otPlatSetMcuPowerState(otInstance *aInstance, otPlatMcuPowerState aState)`	`otError` מגדיר את מצב ההפעלה הרצוי של ה-MCU.
`otPlatWakeHost(void)`	`void` מבצע פעולה ספציפית לפלטפורמה כדי להוציא את ה-MCU של המארח ממצב שינה.

ספירות

otPlatMcuPowerState

 otPlatMcuPowerState

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

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

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

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

לאחר האיפוס, מצב החשמל של MCU חייב להיות OT_PLAT_POWER_STATE_ON.

תכונות

תכונות
`OT_PLAT_MCU_POWER_STATE_LOW_POWER`	ה-MCU של NCP יכול לעבור למצב צריכת אנרגיה נמוכה (חיסכון באנרגיה). כשמצב העוצמה הרצוי של ה-NCP מוגדר ל-`LOW_POWER`, יש לצפות מהמארח "להציק" את ה-NCP (למשל, גורם חיצוני כמו הפרעה) לפני שהיא תוכל לתקשר עם ה-NCP (לשלוח הודעה ל-NCP). מנגנון ה"פוקי" נקבע על ידי קוד הפלטפורמה (מבוסס על הממשק של NCP למארח). כשמצב ההפעלה מוגדר ל-`LOW_POWER`, ל-NCP יש עדיין הרשאה לשלוח הודעות למארח (בכל זמן). חשוב לשים לב שקבלת הודעה מ-NCP לא מציינת שמצב העוצמה של ה-NCP השתנה. כלומר, יש ציפיה מהמארח להמשיך "לדחוף" כשהוא רוצה לדבר עם ה-NCP עד שמצב העוצמה ישתנה באופן מפורש (באמצעות קריאה מוצלחת ל-`otPlatSetMcuPowerState()` שמשנה את המצב ל-`ON`). הערה: מצב ההפעלה של `LOW_POWER` קובע רק את מצב ההפעלה של ה-MCU והוא לא קשור למצב הרדיו (הרדיו מנוהל לפי ליבת OpenThread ותפקיד המכשיר, למשל, אם המכשיר עייף או לא.
`OT_PLAT_MCU_POWER_STATE_OFF`	האפשרות NCP מושבתת לגמרי. נדרש איפוס של חומרת NCP (באמצעות קוד אימות RESET) כדי להחזיר את ה-NCP אל `SPINEL_MCU_POWER_STATE_ON`. RAM לא נשמר לאחר האיפוס.
`OT_PLAT_MCU_POWER_STATE_ON`	MCU של NCP נשאר מופעל ופעיל כל הזמן. כשמצב ההפעלה הרצוי של ה-NCP הוא `ON`, המארח יכול לשלוח הודעות ל-NCP בלי לדרוש 'פוקי' או טריגרים חיצוניים. הערה: מצב ההפעלה של `ON` קובע רק את מצב ההפעלה של ה-MCU והוא לא קשור למצב הרדיו.

OT_PLAT_MCU_POWER_STATE_LOW_POWER

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

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

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

הערה: מצב ההפעלה של LOW_POWER קובע רק את מצב ההפעלה של ה-MCU והוא לא קשור למצב הרדיו (הרדיו מנוהל לפי ליבת OpenThread ותפקיד המכשיר, למשל, אם המכשיר עייף או לא.

OT_PLAT_MCU_POWER_STATE_OFF

האפשרות NCP מושבתת לגמרי.

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

OT_PLAT_MCU_POWER_STATE_ON

MCU של NCP נשאר מופעל ופעיל כל הזמן.

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

הערה: מצב ההפעלה של ON קובע רק את מצב ההפעלה של ה-MCU והוא לא קשור למצב הרדיו.

otPlatResetReason

 otPlatResetReason

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

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

פונקציות

otPlatAssertFail

void otPlatAssertFail(
  const char *aFilename,
  int aLineNumber
)

מספקת הטמעה ספציפית לפלטפורמה לטענת נכוֹנוּת (assert).

פרטים

פרמטרים

`[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.

otPlatResetToBootloader

otError otPlatResetToBootloader(
  otInstance *aInstance
)

מאפס את החומרה בפלטפורמה כדי להפעיל את מצב תוכנת האתחול, אם הוא נתמך.

בשימוש כאשר OPENTHREAD_CONFIG_PLATFORM_BOOTLOADER_MODE_ENABLE מופעל.

פרטים

פרמטרים

[in] aInstance

מבנה המכונה של OpenThread.

ערכים מוחזרים

`OT_ERROR_NONE`	האיפוס לתוכנת האתחול בוצע בהצלחה.
`OT_ERROR_BUSY`	הפעולה נכשלה כי מתבצעת פעולה אחרת.
`OT_ERROR_NOT_CAPABLE`	לא ניתן לבצע איפוס לתוכנת האתחול.

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. אפשר לקרוא מידע נוסף או לתרום למסמכי התיעוד שלנו בדף מקורות מידע.