אבחון בעיות של היצרן – פלטפורמה

המודול הזה כולל את הפשטת הפלטפורמה לתכונות של אבחון.

סיכום

ספירות
otGpioMode{
  OT_GPIO_MODE_INPUT = 0,
  OT_GPIO_MODE_OUTPUT = 1
} 		טיפוסים בני מנייה (enum)
מגדיר את מצבי ה-gpio.

פונקציות
otPlatDiagAlarmCallback(otInstance *aInstance)
void
יעבד את אירוע ההתראה.
otPlatDiagChannelSet(uint8_t aChannel)
void
מגדיר את הערוץ לשימוש בניתוחים של היצרן.
otPlatDiagGpioGet(uint32_t aGpio, bool *aValue)
הפונקציה מקבלת את הערך של ה-gpio.
otPlatDiagGpioGetMode(uint32_t aGpio, otGpioMode *aMode)
קבלת מצב gpio.
otPlatDiagGpioSet(uint32_t aGpio, bool aValue)
מגדיר את הערך של ה-gpio.
otPlatDiagGpioSetMode(uint32_t aGpio, otGpioMode aMode)
מגדיר את המצב gpio.
otPlatDiagModeGet(void)
bool
מציינת אם מצב האבחון של היצרן מופעל או לא.
otPlatDiagModeSet(bool aMode)
void
הפעלה או השבתה של מצב האבחון של היצרן.
otPlatDiagProcess(otInstance *aInstance, uint8_t aArgsLength, char *aArgs[], char *aOutput, size_t aOutputMaxLen)
מתבצע עיבוד של שורת פקודה לניתוח נתוני יצרן.
otPlatDiagRadioGetPowerSettings(otInstance *aInstance, uint8_t aChannel, int16_t *aTargetPower, int16_t *aActualPower, uint8_t *aRawPowerSetting, uint16_t *aRawPowerSettingLength)
קבלת הגדרות ההפעלה של הערוץ הנתון.
otPlatDiagRadioGetRawPowerSetting(otInstance *aInstance, uint8_t *aRawPowerSetting, uint16_t *aRawPowerSettingLength)
קבלת ההגדרה של צריכת החשמל הגולמי של הרדיו עבור מודול האבחון.
otPlatDiagRadioRawPowerSettingEnable(otInstance *aInstance, bool aEnable)
צריך להפעיל/להשבית את שכבת הפלטפורמה כדי להשתמש בהגדרת העוצמה הגולמית שהוגדרה על ידי otPlatDiagRadioSetRawPowerSetting().
otPlatDiagRadioReceived(otInstance *aInstance, otRadioFrame *aFrame, otError aError)
void
מעבד את מסגרת הרדיו שהתקבלה.
otPlatDiagRadioSetRawPowerSetting(otInstance *aInstance, const uint8_t *aRawPowerSetting, uint16_t aRawPowerSettingLength)
צריך להגדיר את ההגדרה של צריכת החשמל הגולמי של הרדיו עבור מודול האבחון.
otPlatDiagRadioTransmitCarrier(otInstance *aInstance, bool aEnable)
יש להפעיל/להפסיק את שכבת הפלטפורמה כדי לשדר גל ספק רציף.
otPlatDiagRadioTransmitStream(otInstance *aInstance, bool aEnable)
יש להפעיל/להפסיק את שכבת הפלטפורמה כדי לשדר זרם של תווים.
otPlatDiagTxPowerSet(int8_t aTxPower)
void
מגדיר את מתח השידור לשימוש עבור אבחון של היצרן.

ספירות

otGpioMode

 otGpioMode

מגדיר את מצבי ה-gpio.

תכונות
OT_GPIO_MODE_INPUT

שיטת קלט ללא נגד משיכה.

OT_GPIO_MODE_OUTPUT

מצב פלט.

פונקציות

otPlatDiagAlarmCallback

void otPlatDiagAlarmCallback(
  otInstance *aInstance
)

יעבד את אירוע ההתראה.

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

otPlatDiagChannelSet

void otPlatDiagChannelSet(
  uint8_t aChannel
)

מגדיר את הערוץ לשימוש בניתוחים של היצרן.

פרטים
פרמטרים
[in] aChannel
ערך הערוץ.

otPlatDiagGpioGet

otError otPlatDiagGpioGet(
  uint32_t aGpio,
  bool *aValue
)

הפונקציה מקבלת את הערך של ה-gpio.

פרטים
פרמטרים
[in] aGpio
מספר ה-gpio.
[out] aValue
מצביע למקום שבו כדאי להזין את הערך של ה-gpio.
ערכים מוחזרים
OT_ERROR_NONE
הערך של ה-gpio התקבל בהצלחה.
OT_ERROR_FAILED
אירעה שגיאת פלטפורמה במהלך קבלת הערך של ה-gpio.
OT_ERROR_INVALID_ARGS
הערך aGpio לא נתמך או הערך של aValue הוא NULL.
OT_ERROR_INVALID_STATE
מצב האבחון לא הופעל, או שמצב aGpio לא מוגדר כקלט.
OT_ERROR_NOT_IMPLEMENTED
הפונקציה הזו לא הוטמעה או מוגדרת בפלטפורמה.

otPlatDiagGpioGetMode

otError otPlatDiagGpioGetMode(
  uint32_t aGpio,
  otGpioMode *aMode
)

קבלת מצב gpio.

פרטים
פרמטרים
[in] aGpio
מספר ה-gpio.
[out] aMode
מצביע למקום שבו כדאי להעביר את המצב gpio.
ערכים מוחזרים
OT_ERROR_NONE
עברת למצב gpio בהצלחה.
OT_ERROR_FAILED
המצב שהוחזר על ידי הפלטפורמה לא מיושם ב-OpenThread או שאירעה שגיאת פלטפורמה בזמן קבלת המצב gpio.
OT_ERROR_INVALID_ARGS
הערך aGpio לא נתמך או הערך של aMode הוא NULL.
OT_ERROR_INVALID_STATE
מצב האבחון לא הופעל.
OT_ERROR_NOT_IMPLEMENTED
הפונקציה הזו לא הוטמעה או מוגדרת בפלטפורמה.

otPlatDiagGpioSet

otError otPlatDiagGpioSet(
  uint32_t aGpio,
  bool aValue
)

מגדיר את הערך של ה-gpio.

פרטים
פרמטרים
[in] aGpio
מספר ה-gpio.
[in] aValue
TRUE כדי להגדיר את ה-gpio לרמה גבוהה, או FALSE אם לא.
ערכים מוחזרים
OT_ERROR_NONE
ה-gpio הוגדר בהצלחה.
OT_ERROR_FAILED
אירעה שגיאת פלטפורמה במהלך הגדרת ה-gpio.
OT_ERROR_INVALID_ARGS
אין תמיכה ב-aGpio.
OT_ERROR_INVALID_STATE
מצב האבחון לא הופעל, או ש-aGpio לא מוגדר כפלט.
OT_ERROR_NOT_IMPLEMENTED
הפונקציה הזו לא הוטמעה או מוגדרת בפלטפורמה.

otPlatDiagGpioSetMode

otError otPlatDiagGpioSetMode(
  uint32_t aGpio,
  otGpioMode aMode
)

מגדיר את המצב gpio.

פרטים
פרמטרים
[in] aGpio
מספר ה-gpio.
[out] aMode
מצב gpio.
ערכים מוחזרים
OT_ERROR_NONE
מצב ה-gpio הוגדר בהצלחה.
OT_ERROR_FAILED
אירעה שגיאת פלטפורמה במהלך ההגדרה של המצב gpio.
OT_ERROR_INVALID_ARGS
אין תמיכה ב-aGpio או ב-aMode.
OT_ERROR_INVALID_STATE
מצב האבחון לא הופעל.
OT_ERROR_NOT_IMPLEMENTED
הפונקציה הזו לא הוטמעה או מוגדרת בפלטפורמה.

otPlatDiagModeGet

bool otPlatDiagModeGet(
  void
)

מציינת אם מצב האבחון של היצרן מופעל או לא.

פרטים
החזרות
TRUE אם מצב האבחון של היצרן מופעל, FALSE אם לא.

otPlatDiagModeSet

void otPlatDiagModeSet(
  bool aMode
)

הפעלה או השבתה של מצב האבחון של היצרן.

פרטים
פרמטרים
[in] aMode
יש להזין TRUE כדי להפעיל את מצב האבחון. אחרת, יש להזין FALSE.

otPlatDiagProcess

otError otPlatDiagProcess(
  otInstance *aInstance,
  uint8_t aArgsLength,
  char *aArgs[],
  char *aOutput,
  size_t aOutputMaxLen
)

מתבצע עיבוד של שורת פקודה לניתוח נתוני יצרן.

הפלט של הפונקציה הזו (התוכן שנכתב ל-aOutput) חייב להסתיים ב-\0 וה-\0 נמצא בתוך מאגר הפלט.

פרטים
פרמטרים
[in] aInstance
המופע של OpenThread של הבקשה הנוכחית.
[in] aArgsLength
מספר הארגומנטים ב-aArgs.
[in] aArgs
הארגומנטים של שורת הפקודה של האבחון.
[out] aOutput
תוצאת הביצוע של האבחון.
[in] aOutputMaxLen
גודל מאגר הנתונים הזמני של הפלט.
ערכים מוחזרים
OT_ERROR_INVALID_ARGS
הפקודה נתמכת אבל סופקו ארגומנטים לא חוקיים.
OT_ERROR_NONE
עיבוד הפקודה הושלם בהצלחה.
OT_ERROR_INVALID_COMMAND
הפקודה לא חוקית או שאין בה תמיכה.

otPlatDiagRadioGetPowerSettings

otError otPlatDiagRadioGetPowerSettings(
  otInstance *aInstance,
  uint8_t aChannel,
  int16_t *aTargetPower,
  int16_t *aActualPower,
  uint8_t *aRawPowerSetting,
  uint16_t *aRawPowerSettingLength
)

קבלת הגדרות ההפעלה של הערוץ הנתון.

פרטים
פרמטרים
[in] aInstance
מבנה המכונה של OpenThread.
[in] aChannel
ערוץ הרדיו.
[out] aTargetPower
כוח היעד ב- 0.01 dBm.
[out] aActualPower
ההספק בפועל ב- 0.01 dBm.
[out] aRawPowerSetting
מצביעה למערך הבייטים של הגדרת העוצמה הגולמית.
[in,out] aRawPowerSettingLength
בקלט, מצביע על גודל של aRawPowerSetting. בפלט, מצביע על אורך הנתונים הגולמיים של הגדרת העוצמה.
ערכים מוחזרים
OT_ERROR_NONE
כוח היעד הגיע בהצלחה.
OT_ERROR_INVALID_ARGS
הערך aChannel לא חוקי, , aActualPower, aRawPowerSetting או aRawPowerSettingLength הוא NULL או שהוא קצר מדי.
OT_ERROR_NOT_FOUND
הגדרות ההפעלה של aChannel לא נמצאו.
OT_ERROR_NOT_IMPLEMENTED
שיטה זו לא מיושמת.

otPlatDiagRadioGetRawPowerSetting

otError otPlatDiagRadioGetRawPowerSetting(
  otInstance *aInstance,
  uint8_t *aRawPowerSetting,
  uint16_t *aRawPowerSettingLength
)

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

פרטים
פרמטרים
[in] aInstance
מבנה המכונה של OpenThread.
[out] aRawPowerSetting
מצביעה למערך הבייטים של הגדרת העוצמה הגולמית.
[in,out] aRawPowerSettingLength
בקלט, מצביע על גודל של aRawPowerSetting. בפלט, מצביע על אורך הנתונים הגולמיים של הגדרת העוצמה.
ערכים מוחזרים
OT_ERROR_NONE
הגדרת העוצמה הגולמית הוגדרה בהצלחה.
OT_ERROR_INVALID_ARGS
הערכים aRawPowerSetting או aRawPowerSettingLength הם NULL או שהם קצרים מדי.
OT_ERROR_NOT_FOUND
הגדרת העוצמה הגולמית לא נקבעה.
OT_ERROR_NOT_IMPLEMENTED
שיטה זו לא מיושמת.

otPlatDiagRadioRawPowerSettingEnable

otError otPlatDiagRadioRawPowerSettingEnable(
  otInstance *aInstance,
  bool aEnable
)

צריך להפעיל/להשבית את שכבת הפלטפורמה כדי להשתמש בהגדרת העוצמה הגולמית שהוגדרה על ידי otPlatDiagRadioSetRawPowerSetting().

פרטים
פרמטרים
[in] aInstance
מבנה המכונה של OpenThread.
[in] aEnable
TRUE כדי להפעיל או FALSE כדי להשבית את הגדרת צריכת החשמל הגולמית.
ערכים מוחזרים
OT_ERROR_NONE
ההגדרה של צריכת החשמל הגולמי הופעלה/הושבתה בהצלחה.
OT_ERROR_NOT_IMPLEMENTED
שיטה זו לא מיושמת.

otPlatDiagRadioReceived

void otPlatDiagRadioReceived(
  otInstance *aInstance,
  otRadioFrame *aFrame,
  otError aError
)

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

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

otPlatDiagRadioSetRawPowerSetting

otError otPlatDiagRadioSetRawPowerSetting(
  otInstance *aInstance,
  const uint8_t *aRawPowerSetting,
  uint16_t aRawPowerSettingLength
)

צריך להגדיר את ההגדרה של צריכת החשמל הגולמי של הרדיו עבור מודול האבחון.

פרטים
פרמטרים
[in] aInstance
מבנה המכונה של OpenThread.
[in] aRawPowerSetting
מצביעה למערך הבייטים של הגדרת העוצמה הגולמית.
[in] aRawPowerSettingLength
האורך של aRawPowerSetting.
ערכים מוחזרים
OT_ERROR_NONE
הגדרת העוצמה הגולמית הוגדרה בהצלחה.
OT_ERROR_INVALID_ARGS
הערך בעמודה aRawPowerSetting הוא NULL או שהשדה aRawPowerSettingLength ארוך מדי.
OT_ERROR_NOT_IMPLEMENTED
שיטה זו לא מיושמת.

otPlatDiagRadioTransmitCarrier

otError otPlatDiagRadioTransmitCarrier(
  otInstance *aInstance,
  bool aEnable
)

יש להפעיל/להפסיק את שכבת הפלטפורמה כדי לשדר גל ספק רציף.

פרטים
פרמטרים
[in] aInstance
מבנה המכונה של OpenThread.
[in] aEnable
צריך להזין TRUE כדי להפעיל, או FALSE כדי להשבית את שכבת הפלטפורמה לשידור גל ספק רציף.
ערכים מוחזרים
OT_ERROR_NONE
הופעל/הושבת בהצלחה .
OT_ERROR_INVALID_STATE
הרדיו לא היה במצב קבלה.
OT_ERROR_NOT_IMPLEMENTED
שיטה זו לא מיושמת.

otPlatDiagRadioTransmitStream

otError otPlatDiagRadioTransmitStream(
  otInstance *aInstance,
  bool aEnable
)

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

פרטים
פרמטרים
[in] aInstance
מבנה המכונה של OpenThread.
[in] aEnable
TRUE כדי להפעיל או FALSE כדי להשבית את שכבת הפלטפורמה לשידור זרם.
ערכים מוחזרים
OT_ERROR_NONE
הופעל/הושבת בהצלחה.
OT_ERROR_INVALID_STATE
הרדיו לא היה במצב קבלה.
OT_ERROR_NOT_IMPLEMENTED
הפונקציה הזו לא הוטמעה.

otPlatDiagTxPowerSet

void otPlatDiagTxPowerSet(
  int8_t aTxPower
)

מגדיר את מתח השידור לשימוש עבור אבחון של היצרן.

פרטים
פרמטרים
[in] aTxPower
ערך כוח השידור.

מקורות מידע

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