otRadioFrame
#include <radio.h>
تمثل هذه البنية إطار الراديو IEEE 802.15.4.
الملخّص
السمات العامة |
|
---|---|
mAckFrameCounter
|
uint32_t
عدّاد إطار أمان ACK (ينطبق عند ضبط
mAckedWithSecEnhAck ). |
mAckKeyId
|
uint8_t
فهرس مفتاح أمان ACK (ينطبق عند ضبط
mAckedWithSecEnhAck ). |
mAckedWithFramePending
|
bool
يشير هذا إلى ما إذا تمت الموافقة على هذا الإطار مع ضبط الإطار في انتظار المراجعة.
|
mAckedWithSecEnhAck
|
bool
يشير هذا إلى ما إذا تم التعرّف على هذا الإطار باستخدام التحسين الآمن ACK.
|
mAesKey
|
const otMacKeyMaterial *
المادة الرئيسية المستخدمة لأمان إطار AES-CCM.
|
mChannel
|
uint8_t
القناة المستخدمة لنقل/استلام الإطار.
|
mCslPresent
|
bool
يمكنك الضبط على true في حال توفُّر رأس CSL في IE.
|
mCsmaCaEnabled
|
bool
تم الضبط على "true" لتفعيل CSMA-CA لهذه الحزمة، بينما التعيين على "false" يكون غير ذلك.
|
mIeInfo
|
المؤشر إلى المعلومات ذات الصلة بالرأس IE.
|
mInfo
|
union otRadioFrame::@19
اتحاد إرسال واستقبال المعلومات لإطار لاسلكي.
|
mIsARetx
|
bool
يشير إلى ما إذا كان الإطار هو ناقل حركة أم لا.
|
mIsHeaderUpdated
|
bool
للإشارة إلى ما إذا كان يتم تحديث عدّاد الإطارات وCSL IE في رأس الصفحة بشكل صحيح.
|
mIsSecurityProcessed
|
bool
يتم الضبط على "true" إذا كان من المفترض أن يتخطّى SubMac معالجة AES لهذا الإطار.
|
mLength
|
uint16_t
طول PSDU
|
mLqi
|
uint8_t
مؤشر الجودة للرابط للإطارات التي تم استلامها.
|
mMaxCsmaBackoffs
|
uint8_t
تم بلوغ الحد الأقصى لعدد المحاولات التي يمكن التراجع عنها قبل الإعلان عن تعذُّر تحميل المحتوى (CCA).
|
mMaxFrameRetries
|
uint8_t
الحد الأقصى لعدد إعادة المحاولة المسموح به بعد الإخفاق في النقل.
|
mPsdu
|
uint8_t *
PSDU.
|
mRadioType
|
uint8_t
نوع رابط الراديو - يجب أن يتجاهله برنامج تشغيل الراديو.
|
mRssi
|
int8_t
مؤشر قوة الإشارة التي تم استلامها بالديسيبل ميلي واط للإطارات التي تم استلامها.
|
mRxInfo
|
struct otRadioFrame::@19::@21
البنية التي تمثّل إطار الراديو تتلقّى معلومات.
|
mTimestamp
|
uint64_t
الطابع الزمني عند استلام الإطار بالميكروثانية.
|
mTxDelay
|
uint32_t
وقت التأخير لعملية النقل هذه (استنادًا إلى
mTxDelayBaseTime ) |
mTxDelayBaseTime
|
uint32_t
الوقت الأساسي لتأخير الإرسال.
|
mTxInfo
|
struct otRadioFrame::@19::@20
بنية تمثّل المعلومات التي تنقل إطارًا لاسلكيًا
|
السمات العامة
mAckFrameCounter
uint32_t otRadioFrame::mAckFrameCounter
عدّاد إطار أمان ACK (ينطبق عند ضبط mAckedWithSecEnhAck
).
معرّف mAckKeyId
uint8_t otRadioFrame::mAckKeyId
فهرس مفتاح أمان ACK (ينطبق عند ضبط mAckedWithSecEnhAck
).
في انتظار المراجعة
bool otRadioFrame::mAckedWithFramePending
يشير هذا إلى ما إذا تمت الموافقة على هذا الإطار مع ضبط الإطار في انتظار المراجعة.
CANNOT TRANSLATE
bool otRadioFrame::mAckedWithSecEnhAck
يشير هذا إلى ما إذا تم التعرّف على هذا الإطار باستخدام التحسين الآمن ACK.
خدمة mAesKey
const otMacKeyMaterial * otRadioFrame::mAesKey
المادة الرئيسية المستخدمة لأمان إطار AES-CCM.
قناة القناة
uint8_t otRadioFrame::mChannel
القناة المستخدمة لنقل/استلام الإطار.
mCslمشاركة العرض
bool otRadioFrame::mCslPresent
يمكنك الضبط على true في حال توفُّر رأس CSL في IE.
mCsmaCaEnabled
bool otRadioFrame::mCsmaCaEnabled
تم الضبط على "true" لتفعيل CSMA-CA لهذه الحزمة، بينما التعيين على "false" يكون غير ذلك.
معلومات
union otRadioFrame::@19 otRadioFrame::mInfo
اتحاد إرسال واستقبال المعلومات لإطار لاسلكي.
misARetx
bool otRadioFrame::mIsARetx
يشير إلى ما إذا كان الإطار هو ناقل حركة أم لا.
تم تعديل عنوان mIsHeader
bool otRadioFrame::mIsHeaderUpdated
للإشارة إلى ما إذا كان يتم تحديث عدّاد الإطارات وCSL IE في رأس الصفحة بشكل صحيح.
في حال لم توفّر طبقة النظام الأساسي إمكانيات OT_RADIO_CAPS_TRANSMIT_SEC
، يمكنها تجاهل هذه العلامة.
في حال كان النظام الأساسي يوفّر إمكانية OT_RADIO_CAPS_TRANSMIT_SEC
، من المتوقّع أن يتعامل النظام الأساسي مع معالجة أمان tx وتخصيص عدّاد الإطارات. في هذه الحالة، من المتوقع حدوث السلوك التالي:
عند ضبط mIsHeaderUpdated
، يشير ذلك إلى أن OpenKey الأساسي قد سبق له ضبط عدّاد الإطار وCSL IE (في حال تفعيل الأمان) في الإطار الذي تم إعداده. يتم التأكد من مطابقة العدّاد مع قيمة العدّاد من المحاولات السابقة للإطار نفسه. يجب ألا يضبط النظام الأساسي عدّاد الإطار أو يغيّره (ولكن قد يظل بحاجة إلى إجراء معالجة أمنية اعتمادًا على علامة mIsSecurityProcessed
).
إذا لم يتم ضبط mIsHeaderUpdated
، لن يتم ضبط عدّاد الإطار والمفتاح CSL IE في الإطار من خلال OpenThread الأساسي وتقع على عاتق منصة الراديو مسؤولية تخصيصهما. يجب أن تعدّل المنصّة رأس الإطار (خصِّص قيمًا لمعدّل CSL IE) قبل إرسال الإطار فوق الهواء، ولكن في حال تم إلغاء عملية النقل وعدم إرسال الإطار مطلقًا على الهواء (مثل خطأ في الوصول إلى القناة)، قد يختار النظام الأساسي ذلك. لعدم تحديث الرأس. إذا حدّث النظام الأساسي العنوان، يجب أيضًا ضبط هذه العلامة قبل تمرير الإطار مرة أخرى من رد الاتصال من otPlatRadioTxDone()
.
تمت معالجة misSecurity
bool otRadioFrame::mIsSecurityProcessed
يتم الضبط على "true" إذا كان من المفترض أن يتخطّى SubMac معالجة AES لهذا الإطار.
طول الطول
uint16_t otRadioFrame::mLength
طول PSDU
ملقن
uint8_t otRadioFrame::mLqi
مؤشر الجودة للرابط للإطارات التي تم استلامها.
إعدادات mMaxCsmabackoffs
uint8_t otRadioFrame::mMaxCsmaBackoffs
تم بلوغ الحد الأقصى لعدد المحاولات التي يمكن التراجع عنها قبل الإعلان عن تعذُّر تحميل المحتوى (CCA).
mMaxFrameRetries
uint8_t otRadioFrame::mMaxFrameRetries
الحد الأقصى لعدد إعادة المحاولة المسموح به بعد الإخفاق في النقل.
mPsdu
uint8_t * otRadioFrame::mPsdu
PSDU.
mRadioType
uint8_t otRadioFrame::mRadioType
نوع رابط الراديو - يجب أن يتجاهله برنامج تشغيل الراديو.
mRsi
int8_t otRadioFrame::mRssi
مؤشر قوة الإشارة التي تم استلامها بالديسيبل ميلي واط للإطارات التي تم استلامها.
mRxInfo
struct otRadioFrame::@19::@21 otRadioFrame::mRxInfo
البنية التي تمثّل إطار الراديو تتلقّى معلومات.
mTimestamp
uint64_t otRadioFrame::mTimestamp
الطابع الزمني عند استلام الإطار بالميكروثانية.
القيمة "يجب" أن تكون الوقت الذي تم فيه استلام SFD عندما يتم تفعيل TIME_SYNC أو CSL. وبخلاف ذلك، يقبل أيضًا الوقت الذي تم فيه تلقّي إطار MAC بالكامل.
mTxDelay
uint32_t otRadioFrame::mTxDelay
وقت التأخير لعملية النقل هذه (استنادًا إلى mTxDelayBaseTime
)
mTxDelayBaseTime
uint32_t otRadioFrame::mTxDelayBaseTime
الوقت الأساسي لتأخير الإرسال.
معلومات mTxInfo
struct otRadioFrame::@19::@20 otRadioFrame::mTxInfo
بنية تمثّل المعلومات التي تنقل إطارًا لاسلكيًا
المراجع
تنشأ مواضيع واجهة برمجة التطبيقات المرجعية لـ OpenThread من رمز المصدر، المتوفر على GitHub. للاطّلاع على مزيد من المعلومات أو للمساهمة في مستنداتنا، يُرجى الرجوع إلى المراجع.