ترجمت واجهة Cloud Translation API‏ هذه الصفحة.

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