קישור גולמי

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

סיכום

ערכי דף
otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi) typedef
void(*
מצביע על קבלת מסגרת IEEE 802.15.4.
otLinkRawReceiveDone)(otInstance *aInstance, otRadioFrame *aFrame, otError aError) typedef
void(*
מצביע על קבלת מסגרת IEEE 802.15.4.
otLinkRawTransmitDone)(otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError) typedef
void(*
מצביע על קבלת מסגרת IEEE 802.15.4.

פונקציות
otLinkRawEnergyScan(otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration, otLinkRawEnergyScanDone aCallback)
מתחיל את רצף סריקת האנרגיה ברדיו.
otLinkRawGetCaps(otInstance *aInstance)
קבל את יכולות הרדיו.
otLinkRawGetPromiscuous(otInstance *aInstance)
bool
קבלת הסטטוס של מצב פרוץ.
otLinkRawGetRadioTime(otInstance *aInstance)
uint64_t
קבלת זמן הפלטפורמה הנוכחי (רוחב 64 ביט) של שבב הרדיו.
otLinkRawGetRssi(otInstance *aInstance)
int8_t
קבלת מדידת ה-RSSI העדכנית ביותר.
otLinkRawGetTransmitBuffer(otInstance *aInstance)
הרדיו עובר מ'שידור' ל'קבלה'.
otLinkRawIsEnabled(otInstance *aInstance)
bool
מציינת אם שכבת הקישור הגולמית מופעלת או לא.
otLinkRawReceive(otInstance *aInstance)
העברת הרדיו ממצב שינה למצב קבלה.
otLinkRawSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)
מגדיר את הערך הנוכחי של מונה המסגרות של MAC.
otLinkRawSetMacFrameCounterIfLarger(otInstance *aInstance, uint32_t aMacFrameCounter)
מגדירה את הערך הנוכחי של מונה המסגרות של MAC רק אם הערך החדש גדול מהערך הנוכחי.
otLinkRawSetMacKey(otInstance *aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKey *aPrevKey, const otMacKey *aCurrKey, const otMacKey *aNextKey)
עדכון מפתחות MAC ואינדקס מפתחות.
otLinkRawSetPromiscuous(otInstance *aInstance, bool aEnable)
מפעילה או משביתה מצב פרוץ.
otLinkRawSetReceiveDone(otInstance *aInstance, otLinkRawReceiveDone aCallback)
הפעלה/השבתה של שכבת הקישור הגולמית.
otLinkRawSetShortAddress(otInstance *aInstance, uint16_t aShortAddress)
מגדירים את הכתובת המקוצרת לסינון כתובות.
otLinkRawSleep(otInstance *aInstance)
העברת הרדיו ממצב 'קבלה' למצב שינה.
otLinkRawSrcMatchAddExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
הוספת הכתובת המורחבת לטבלת ההתאמות של המקור.
otLinkRawSrcMatchAddShortEntry(otInstance *aInstance, uint16_t aShortAddress)
הוספת כתובת קצרה לטבלת ההתאמות של המקור.
otLinkRawSrcMatchClearExtEntries(otInstance *aInstance)
מתבצעת הסרה של כל הכתובות המורחבות מטבלת ההתאמות של קובצי המקור.
otLinkRawSrcMatchClearExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
מתבצעת הסרה של הכתובת המורחבת לטבלת ההתאמות של המקור של הרדיו.
otLinkRawSrcMatchClearShortEntries(otInstance *aInstance)
הסרת כל הכתובות הקצרות מטבלת ההתאמות של קובצי המקור.
otLinkRawSrcMatchClearShortEntry(otInstance *aInstance, uint16_t aShortAddress)
מתבצעת הסרה של כתובת מקוצרת לטבלת ההתאמות של המקור.
otLinkRawSrcMatchEnable(otInstance *aInstance, bool aEnable)
הפעלה/השבתה של התאמת המקור למסגרת בהמתנה.
otLinkRawTransmit(otInstance *aInstance, otLinkRawTransmitDone aCallback)
מתחיל את רצף השידור ברדיו.

ערכי דף

otLinkRawEnergyScanDone

void(* otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi)

מצביע על קבלת מסגרת IEEE 802.15.4.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
[in] aEnergyScanMaxRssi
מספר ה-RSSI המקסימלי שנמצא בערוץ שנסרק.

otLinkRawReceiveDone

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

מצביע על קבלת מסגרת IEEE 802.15.4.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
[in] aFrame
מצביע למסגרת שהתקבלה או ל-NULL אם פעולת הקבלה בוטלה.
[in] aError
OT_ERROR_NONE בעת קבלת מסגרת בהצלחה. OT_ERROR_ABORT כשקבלה בוטלה ולא התקבלה מסגרת.

otLinkRawTransmitDone

void(* otLinkRawTransmitDone)(otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError)

מצביע על קבלת מסגרת IEEE 802.15.4.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
[in] aFrame
מצביע למסגרת שהועברה.
[in] aAckFrame
מצביע למסגרת ה-ACK.
[in] aError
OT_ERROR_NONE מתי המסגרת הועברה. OT_ERROR_NO_ACK כשהפריים הועבר אך לא התקבל ACK OT_ERROR_CHANNEL_ACCESS_FAILURE כששידור הווידאו לא הצליח להתרחש עקב פעילות בערוץ. OT_ERROR_ABORT השידור בוטל מסיבות אחרות.

פונקציות

otLinkRawEnergyScan

otError otLinkRawEnergyScan(
  otInstance *aInstance,
  uint8_t aScanChannel,
  uint16_t aScanDuration,
  otLinkRawEnergyScanDone aCallback
)

מתחיל את רצף סריקת האנרגיה ברדיו.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
[in] aScanChannel
הערוץ שבו יש לבצע את סריקת האנרגיה.
[in] aScanDuration
משך הזמן (באלפיות שנייה) של הערוץ שייסרק.
[in] aCallback
מצביע אל פונקציה שנקראת 'השלמה של ערוץ סרוק'.
ערכים מוחזרים
OT_ERROR_NONE
סריקת הערוץ התחילה בהצלחה.
OT_ERROR_BUSY
הרדיו מבצע סריקת אנרגיה.
OT_ERROR_NOT_IMPLEMENTED
הרדיו לא תומך בסריקת אנרגיה.
OT_ERROR_INVALID_STATE
אם שכבת הקישור הגולמית לא מופעלת.

otLinkRawGetCaps

otRadioCaps otLinkRawGetCaps(
  otInstance *aInstance
)

קבל את יכולות הרדיו.

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

otLinkRawGetPromiscuous

bool otLinkRawGetPromiscuous(
  otInstance *aInstance
)

קבלת הסטטוס של מצב פרוץ.

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

otLinkRawGetRadioTime

uint64_t otLinkRawGetRadioTime(
  otInstance *aInstance
)

קבלת זמן הפלטפורמה הנוכחי (רוחב 64 ביט) של שבב הרדיו.

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

otLinkRawGetRssi

int8_t otLinkRawGetRssi(
  otInstance *aInstance
)

קבלת מדידת ה-RSSI העדכנית ביותר.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
החזרות
ערך ה-RSSI ב-dBm כשהוא תקף. 127 כשהערך בשדה RSSI לא תקין.

otLinkRawGetTransmitBuffer

otRadioFrame * otLinkRawGetTransmitBuffer(
  otInstance *aInstance
)

הרדיו עובר מ'שידור' ל'קבלה'.

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

מבצע הקריאה החוזרת יוצר את מסגרת IEEE 802.15.4 במאגר הזמני הזה ולאחר מכן קורא ל-otLinkRawTransmit() כדי לבקש שידור.

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

otLinkRawIsEnabled

bool otLinkRawIsEnabled(
  otInstance *aInstance
)

מציינת אם שכבת הקישור הגולמית מופעלת או לא.

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

otLinkRawReceive

otError otLinkRawReceive(
  otInstance *aInstance
)

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

מפעילים את הרדיו.

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

otLinkRawSetMacFrameCounter

otError otLinkRawSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

מגדיר את הערך הנוכחי של מונה המסגרות של MAC.

תמיד מגדיר את מונה ה-MAC לערך הנתון החדש aMacFrameCounter, ללא קשר לערך הנוכחי.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
[in] aMacFrameCounter
ערך מונה המסגרות של MAC.
ערכים מוחזרים
OT_ERROR_NONE
אם הפעולה בוצעה בהצלחה.
OT_ERROR_INVALID_STATE
אם שכבת הקישור הגולמית לא מופעלת.

otLinkRawSetMacFrameCounterIfLarger

otError otLinkRawSetMacFrameCounterIfLarger(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

מגדירה את הערך הנוכחי של מונה המסגרות של MAC רק אם הערך החדש גדול מהערך הנוכחי.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
[in] aMacFrameCounter
ערך מונה המסגרות של MAC.
ערכים מוחזרים
OT_ERROR_NONE
אם הפעולה בוצעה בהצלחה.
OT_ERROR_INVALID_STATE
אם שכבת הקישור הגולמית לא מופעלת.

otLinkRawSetMacKey

otError otLinkRawSetMacKey(
  otInstance *aInstance,
  uint8_t aKeyIdMode,
  uint8_t aKeyId,
  const otMacKey *aPrevKey,
  const otMacKey *aCurrKey,
  const otMacKey *aNextKey
)

עדכון מפתחות MAC ואינדקס מפתחות.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
[in] aKeyIdMode
המצב של מזהה המפתח.
[in] aKeyId
אינדקס המפתח.
[in] aPrevKey
מפתח ה-MAC הקודם.
[in] aCurrKey
מפתח ה-MAC הנוכחי.
[in] aNextKey
מפתח ה-MAC הבא.
ערכים מוחזרים
OT_ERROR_NONE
אם הפעולה בוצעה בהצלחה.
OT_ERROR_INVALID_STATE
אם שכבת הקישור הגולמית לא מופעלת.

otLinkRawSetPromiscuous

otError otLinkRawSetPromiscuous(
  otInstance *aInstance,
  bool aEnable
)

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

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
[in] aEnable
ערך להפעלה או להשבתה של מצב פרוץ.
ערכים מוחזרים
OT_ERROR_NONE
אם הפעולה בוצעה בהצלחה.
OT_ERROR_INVALID_STATE
אם שכבת הקישור הגולמית לא מופעלת.

otLinkRawSetReceiveDone

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

הפעלה/השבתה של שכבת הקישור הגולמית.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
[in] aCallback
מצביע לפונקציה שנקראת כשמקבלים מסגרת IEEE 802.15.4. NULL כדי להשבית את שכבת הקישור הגולמי.
ערכים מוחזרים
OT_ERROR_FAILED
לא ניתן להפעיל/להשבית את הרדיו.
OT_ERROR_INVALID_STATE
אם ממשק OpenThread IPv6 כבר מופעל.
OT_ERROR_NONE
אם מצב ההפעלה הוגדר בהצלחה.

otLinkRawSetShortAddress

otError otLinkRawSetShortAddress(
  otInstance *aInstance,
  uint16_t aShortAddress
)

מגדירים את הכתובת המקוצרת לסינון כתובות.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
[in] aShortAddress
הכתובת המקוצרת של IEEE 802.15.4.
ערכים מוחזרים
OT_ERROR_NONE
אם הפעולה בוצעה בהצלחה.
OT_ERROR_INVALID_STATE
אם שכבת הקישור הגולמית לא מופעלת.

otLinkRawSleep

otError otLinkRawSleep(
  otInstance *aInstance
)

העברת הרדיו ממצב 'קבלה' למצב שינה.

מכבים את הרדיו.

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

otLinkRawSrcMatchAddExtEntry

otError otLinkRawSrcMatchAddExtEntry(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

הוספת הכתובת המורחבת לטבלת ההתאמות של המקור.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
[in] aExtAddress
הכתובת המורחבת שיש להוסיף.
ערכים מוחזרים
OT_ERROR_NONE
הכתובת המורחבת נוספה בהצלחה לטבלת ההתאמות של המקור.
OT_ERROR_NO_BUFS
אין ערך זמין בטבלת ההתאמות של המקור.
OT_ERROR_INVALID_STATE
אם שכבת הקישור הגולמית לא מופעלת.

otLinkRawSrcMatchAddShortEntry

otError otLinkRawSrcMatchAddShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

הוספת כתובת קצרה לטבלת ההתאמות של המקור.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
[in] aShortAddress
הכתובת הקצרה להוספה.
ערכים מוחזרים
OT_ERROR_NONE
הכתובת הקצרה נוספה בהצלחה לטבלת ההתאמות של המקור.
OT_ERROR_NO_BUFS
אין ערך זמין בטבלת ההתאמות של המקור.
OT_ERROR_INVALID_STATE
אם שכבת הקישור הגולמית לא מופעלת.

otLinkRawSrcMatchClearExtEntries

otError otLinkRawSrcMatchClearExtEntries(
  otInstance *aInstance
)

מתבצעת הסרה של כל הכתובות המורחבות מטבלת ההתאמות של קובצי המקור.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
ערכים מוחזרים
OT_ERROR_NONE
אם הפעולה בוצעה בהצלחה.
OT_ERROR_INVALID_STATE
אם שכבת הקישור הגולמית לא מופעלת.

otLinkRawSrcMatchClearExtEntry

otError otLinkRawSrcMatchClearExtEntry(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

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

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
[in] aExtAddress
הכתובת המורחבת שיש להסיר.
ערכים מוחזרים
OT_ERROR_NONE
הכתובת המורחבת הוסרה מטבלת ההתאמות של המקור.
OT_ERROR_NO_ADDRESS
הכתובת המורחבת לא נמצאת בטבלת ההתאמות של המקור.
OT_ERROR_INVALID_STATE
אם שכבת הקישור הגולמית לא מופעלת.

otLinkRawSrcMatchClearShortEntries

otError otLinkRawSrcMatchClearShortEntries(
  otInstance *aInstance
)

הסרת כל הכתובות הקצרות מטבלת ההתאמות של קובצי המקור.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
ערכים מוחזרים
OT_ERROR_NONE
אם הפעולה בוצעה בהצלחה.
OT_ERROR_INVALID_STATE
אם שכבת הקישור הגולמית לא מופעלת.

otLinkRawSrcMatchClearShortEntry

otError otLinkRawSrcMatchClearShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

מתבצעת הסרה של כתובת מקוצרת לטבלת ההתאמות של המקור.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
[in] aShortAddress
הכתובת הקצרה שיש להסיר.
ערכים מוחזרים
OT_ERROR_NONE
הכתובת הקצרה הוסרה בהצלחה מטבלת ההתאמות של המקור.
OT_ERROR_NO_ADDRESS
הכתובת המקוצרת לא נמצאת בטבלת ההתאמות של המקור.
OT_ERROR_INVALID_STATE
אם שכבת הקישור הגולמית לא מופעלת.

otLinkRawSrcMatchEnable

otError otLinkRawSrcMatchEnable(
  otInstance *aInstance,
  bool aEnable
)

הפעלה/השבתה של התאמת המקור למסגרת בהמתנה.

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

otLinkRawTransmit

otError otLinkRawTransmit(
  otInstance *aInstance,
  otLinkRawTransmitDone aCallback
)

מתחיל את רצף השידור ברדיו.

לפני הקריאה החוזרת, השולח חייב ליצור את מסגרת IEEE 802.15.4 במאגר הנתונים הזמני שמסופק על ידי otLinkRawGetTransmitBuffer(). הערוץ ועוצמת השידור כלולים גם במבנה otRadioFrame.

רצף השידור מורכב מהרכיבים הבאים:

  1. העברת הרדיו ל'שידור' מ'קבלה'.
  2. משדר את ה-PSDU בערוץ הנתון ובעוצמת השידור הנתונה.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
[in] aCallback
מצביע לפונקציה שנקראת בסיום העברת הנתונים.
ערכים מוחזרים
OT_ERROR_NONE
הועבר בהצלחה ל'שידור'.
OT_ERROR_INVALID_STATE
הרדיו לא היה במצב קבלה.

מקורות מידע

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