رابط Raw

تتضمن هذه الوحدة وظائف تتحكم في ضبط طبقة الرابط الأولية.

ملخّص

أنواع المحددات
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)
لبدء تسلسل الإرسال على الراديو.

أنواع المحددات

otLinkRawEnergyScanتم

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

مؤشر عند استلام إطار IEEE 802.15.4

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aEnergyScanMaxRssi
الحد الأقصى لبيانات RSSI التي تم العثور عليها في القناة التي تم مسحها ضوئيًا

otLinkRaw الاستلامتم

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 عندما تم إلغاء الاستقبال ولم يتم تلقّي الإطار.

otLinkRawTransmitتمّ

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.
المرتجعات
مؤشر إلى المخزن المؤقت للنقل أو القيمة الفارغة إذا لم يتم تفعيل طبقة الرابط الأولية.

otLinkRawIsEnabled

bool otLinkRawIsEnabled(
  otInstance *aInstance
)

يشير إلى ما إذا كان قد تم تفعيل طبقة الروابط الأولية.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
قيم الإرجاع
true
ويتم تفعيل طبقة الرابط الأولية.
false
طبقة الرابط الأولية غير مفعّلة.

otLinkRawReceived

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
في حال لم يتم تفعيل طبقة الرابط الأولية.

otLinkRawSetReceivedتمّ

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
تم إيقاف الراديو.

إدخال otLinkRawSrcmatchAddExt

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

إضافة عنوان موسع إلى جدول مطابقة المصدر

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aExtAddress
العنوان الموسَّع المطلوب إضافته
قيم الإرجاع
OT_ERROR_NONE
تمّت إضافة العنوان الموسّع إلى جدول مطابقة المصدر بنجاح.
OT_ERROR_NO_BUFS
لا يتوفّر إدخال في جدول مطابقة المصدر.
OT_ERROR_INVALID_STATE
في حال لم يتم تفعيل طبقة الرابط الأولية.

إدخال otLinkRawSrcmatchAddShort

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
في حال لم يتم تفعيل طبقة الرابط الأولية.

إدخال otLinkRawSrcmatchClearExt

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
في حال لم يتم تفعيل طبقة الرابط الأولية.

إدخال otLinkRawSrcmatchClearShort

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