otRadioFrame

#include <radio.h>

تمثل هذه البنية إطار الراديو IEEE 802.15.4.

الملخّص

السمات العامة

mAckFrameCounter
uint32_t
عدّاد إطار أمان ACK (ينطبق عند ضبط mAckedWithSecEnhAck).
mAckKeyId
uint8_t
فهرس مفتاح أمان ACK (ينطبق عند ضبط mAckedWithSecEnhAck).
mAckedWithFramePending
bool
يشير هذا إلى ما إذا تمت الموافقة على هذا الإطار مع ضبط الإطار في انتظار المراجعة.
mAckedWithSecEnhAck
bool
يشير هذا إلى ما إذا تم التعرّف على هذا الإطار باستخدام التحسين الآمن ACK.
mAesKey
المادة الرئيسية المستخدمة لأمان إطار 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" يكون غير ذلك.

معلومات حول mIeInfo

otRadioIeInfo * otRadioFrame::mIeInfo

المؤشر إلى المعلومات ذات الصلة بالرأس IE.

معلومات

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. للاطّلاع على مزيد من المعلومات أو للمساهمة في مستنداتنا، يُرجى الرجوع إلى المراجع.