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
يتم الضبط على "صحيح" في حال توفُّر عنوان CSL IE.
|
mCsmaCaEnabled
|
bool
اضبط القيمة على "true" لتفعيل CSMA-CA لهذه الحزمة، وإلا سيتم الضبط على "false" في الحالات الأخرى.
|
mIeInfo
|
المؤشر الذي يشير إلى معلومات IE(s) ذات الصلة بالعنوان.
|
mInfo
|
union otRadioFrame::@24
يشير ذلك المصطلح إلى اتحاد إرسال المعلومات واستلامها لإطار لاسلكي.
|
mIsARetx
|
bool
يشير إلى ما إذا كان الإطار إعادة إرسال أم لا.
|
mIsHeaderUpdated
|
bool
يشير إلى ما إذا كان يتم تحديث عدّاد الإطارات وCSL IE بشكل صحيح في العنوان.
|
mIsSecurityProcessed
|
bool
صحيح إذا كان يجب على 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
مؤشر قوة الإشارة المُستلَمة بالديسيبل بالديسيبل للإطارات التي تم استلامها.
|
mRxChannelAfterTxDone
|
uint8_t
عند الانتهاء من قناة RX بعد الإطار TX (بعد كل عمليات إعادة محاولة استخدام الإطار - استلام الإشعار، أو انتهاء المهلة، أو الإلغاء).
|
mRxInfo
|
struct otRadioFrame::@24::@26
البنية التي تمثل الإطار اللاسلكي يتلقى المعلومات.
|
mTimestamp
|
uint64_t
وقت ساعة الراديو المحلية بالميكرو ثانية عندما كانت نهاية إشارات SFD موجودة في الهوائي المحلي
|
mTxDelay
|
uint32_t
تمثّل هذه السمة وقت التأخير بالميكرو ثانية لعملية الإرسال هذه المُشار إليها إلى
mTxDelayBaseTime. |
mTxDelayBaseTime
|
uint32_t
يمكنك الاطّلاع على
otPlatRadioGetNow وmTxDelay لوقت الأساس بالميكرو ثانية لعمليات الإرسال المُجدوَلة مقارنةً بساعة الراديو المحلية. |
mTxInfo
|
struct otRadioFrame::@24::@25
البنية التي تمثِّل معلومات نقل الإطار اللاسلكي.
|
السمات العامة
mAckFrameCounter
uint32_t otRadioFrame::mAckFrameCounter
عدّاد إطار الأمان ACK (يسري ذلك عند ضبط mAckedWithSecEnhAck).
mAckKeyId
uint8_t otRadioFrame::mAckKeyId
فهرس مفتاح الأمان ACK (يسري عند ضبط mAckedWithSecEnhAck).
mAckedWithFramePending
bool otRadioFrame::mAckedWithFramePending
يشير هذا الحقل إلى ما إذا تمت الموافقة على هذا الإطار مع ضبط الإطار في انتظار المراجعة.
mAckedWithSecEnhAck
bool otRadioFrame::mAckedWithSecEnhAck
يشير هذا إلى ما إذا تمت الموافقة على هذا الإطار باستخدام ACK لتحسين الأمان.
mAesKey
const otMacKeyMaterial * otRadioFrame::mAesKey
المادة الأساسية المستخدمة في أمان إطار AES-CCM.
mChannel
uint8_t otRadioFrame::mChannel
القناة المستخدَمة لإرسال الإطار أو استقباله
mCslPresent
bool otRadioFrame::mCslPresent
يتم الضبط على "صحيح" في حال توفُّر عنوان CSL IE.
mCsmaCaEnabled
bool otRadioFrame::mCsmaCaEnabled
اضبط القيمة على "true" لتفعيل CSMA-CA لهذه الحزمة، وإلا سيتم الضبط على "false" في الحالات الأخرى.
mIeInfo
otRadioIeInfo * otRadioFrame::mIeInfo
المؤشر الذي يشير إلى معلومات IE(s) ذات الصلة بالعنوان.
mInfo
union otRadioFrame::@24 otRadioFrame::mInfo
يشير ذلك المصطلح إلى اتحاد إرسال المعلومات واستلامها لإطار لاسلكي.
mIsARetx
bool otRadioFrame::mIsARetx
يشير إلى ما إذا كان الإطار إعادة إرسال أم لا.
mIsHeaderUpdated
bool otRadioFrame::mIsHeaderUpdated
يشير إلى ما إذا كان يتم تحديث عدّاد الإطارات وCSL IE بشكل صحيح في العنوان.
إذا لم تكن طبقة النظام الأساسي توفّر إمكانية OT_RADIO_CAPS_TRANSMIT_SEC، يمكن أن تتجاهل هذه العلامة.
إذا كانت المنصّة توفّر إمكانية OT_RADIO_CAPS_TRANSMIT_SEC، من المتوقّع أن يعالج النظام الأساسي معالجة أمان Tx وتعيين عدّاد الإطار. في هذه الحالة، من المتوقع حدوث السلوك التالي:
عندما يتم ضبط mIsHeaderUpdated، يشير ذلك إلى أنّ مجموعة OpenThread الأساسية قد عيَّنت عدّاد الإطارات وCSL IEs (في حال تفعيل الأمان) في الإطار المُعدّ. ويضمن العدّاد مطابقة القيمة العدّاد من المحاولات السابقة للإطار نفسه. يجب ألا يعيّن النظام الأساسي عدّاد الإطارات أو يغيّره (ولكن قد يظل بحاجة إلى تنفيذ معالجة أمنية استنادًا إلى علامة mIsSecurityProcessed).
إذا لم يتم ضبط mIsHeaderUpdated، لن يتم ضبط عدّاد الإطارات والمفتاح CSL IE في الإطار من خلال نواة OpenThread وتقع على عاتق النظام الأساسي للراديو مسؤولية تخصيصهما. يجب أن يقوم النظام الأساسي بتحديث عنوان الإطار (قم بتعيين قيم العدّاد وقيم CSL IE) قبل إرسال الإطار عبر البث الهوائي، ولكن إذا تم إلغاء الإرسال ولم يتم إرسال الإطار مطلقًا عبر البث الهوائي (على سبيل المثال، خطأ في الوصول إلى القناة)، فقد يختار النظام الأساسي عدم تحديث الرأس. إذا عدَّل النظام الأساسي العنوان، يجب أيضًا ضبط هذه العلامة قبل إرجاع الإطار من معاودة الاتصال في otPlatRadioTxDone().
mIsSecurityProcessed
bool otRadioFrame::mIsSecurityProcessed
صحيح إذا كان يجب على SubMac تخطي معالجة AES لهذا الإطار.
mLength
uint16_t otRadioFrame::mLength
مدة PSDU
mLqi
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
نوع رابط الراديو - يجب أن يتجاهله برنامج تشغيل الراديو.
mRssi
int8_t otRadioFrame::mRssi
مؤشر قوة الإشارة المُستلَمة بالديسيبل بالديسيبل للإطارات التي تم استلامها.
mRxChannelAfterTxDone
uint8_t otRadioFrame::mRxChannelAfterTxDone
عند الانتهاء من قناة RX بعد الإطار TX (بعد كل عمليات إعادة محاولة استخدام الإطار - استلام الإشعار، أو انتهاء المهلة، أو الإلغاء).
ويمكن لمنصات الراديو اختيار تجاهل هذا الأمر بالكامل. يحرص حزمة الوقت الإضافي على استدعاء otPlatRadioReceive() بقناة RX المطلوبة بعد انتهاء إطار TX والإشارة إليه في معاودة الاتصال otPlatRadioTxDone(). يجب أن تتجاهل منصات الراديو التي لا توفّر OT_RADIO_CAPS_TRANSMIT_RETRIES هذا الخيار دائمًا.
هذا الإجراء مخصّص للحالات التي قد يحدث فيها تأخير في التفاعلات بين حزمة البث المباشر والراديو. يتم استخدام ذلك على سبيل المثال في بنية RCP/المضيف للتأكّد من تبديل RCP إلى قناة رقم PAN بسرعة أكبر. ويمكن أن يساعد ذلك على وجه الخصوص في استخدام CSL tx لطفل نائم، حيث قد يستخدم الطفل قناة CSL مختلفة عن قناة PAN. بعد الإطار tx، نريد أن يعود الراديو/RCP إلى قناة PAN بسرعة لضمان ألا يفوت الوالد tx من الطفل بعد ذلك، على سبيل المثال، إذا استجاب الطفل لإطار CSL السابق الذي تم نقله من الوالدين باستخدام قناة PAN مع استمرار بقاء الراديو على قناة CSL.
يجب أن يحدث التبديل إلى قناة RX بعد انتهاء إطار TX بالكامل، أي بعد كل عمليات إعادة المحاولة وعند تلقي الإشعار (عند ضبط علامة "Ack Request" على إطار TX) أو بعد مهلة الإقرار. يظهر الإشعار على القناة نفسها التي تم إرسال الإطار إليها.
mRxInfo
struct otRadioFrame::@24::@26 otRadioFrame::mRxInfo
البنية التي تمثل الإطار اللاسلكي يتلقى المعلومات.
mTimestamp
uint64_t otRadioFrame::mTimestamp
وقت ساعة الراديو المحلية بالميكرو ثانية عندما كانت نهاية إشارات SFD موجودة في الهوائي المحلي
mTxDelay
uint32_t otRadioFrame::mTxDelay
تمثّل هذه السمة وقت التأخير بالميكرو ثانية لعملية الإرسال هذه المُشار إليها إلى mTxDelayBaseTime.
ملاحظة: يشير الرمز mTxDelayBaseTime + mTxDelay إلى النقطة الزمنية التي تكون فيها نهاية SFD في الهوائي المحلي مقارنةً بساعة الراديو المحلية.
mTxDelayBaseTime
uint32_t otRadioFrame::mTxDelayBaseTime
يمكنك الاطّلاع على otPlatRadioGetNow وmTxDelay لوقت الأساس بالميكرو ثانية لعمليات الإرسال المُجدوَلة مقارنةً بساعة الراديو المحلية.
mTxInfo
struct otRadioFrame::@24::@25 otRadioFrame::mTxInfo
البنية التي تمثِّل معلومات نقل الإطار اللاسلكي.
المراجِع
تنشأ المواضيع المرجعية لواجهة برمجة تطبيقات OpenThread من رمز المصدر المتاح على GitHub. للحصول على مزيد من المعلومات أو للمساهمة في مستنداتنا، يمكنك الاطّلاع على المراجع.