رابط أساسي

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

الملخّص

مواقد الخط
otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi) مَعلمة typetype
void(*
مؤشر الدالة هذا عند استلام إطار IEEE 802.15.4.
otLinkRawReceiveDone)(otInstance *aInstance, otRadioFrame *aFrame, otError aError) مَعلمة typetype
void(*
مؤشر الدالة هذا عند استلام إطار IEEE 802.15.4.
otLinkRawTransmitDone)(otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError) مَعلمة typetype
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)
انتقالات الراديو من خدمة Transmit toReceive (نقل المحتوى إلى الاستلام)
otLinkRawIsEnabled(otInstance *aInstance)
bool
وتوضّح هذه الدالة ما إذا كانت طبقة الروابط الأولية مفعّلة أم لا.
otLinkRawReceive(otInstance *aInstance)
جارٍ نقل الراديو من وضع السكون إلى الاستلام.
otLinkRawSetMacFrameCounter(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)
تبدأ هذه الطريقة تسلسل الإرسال على الراديو.

مواقد الخط

otLinkRawEnergyScanDone

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

مؤشر الدالة هذا عند استلام إطار IEEE 802.15.4.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aEnergyScanMaxRssi
الحد الأقصى لعدد RSSI الذي يظهر على القناة التي تم فحصها.

otLinkRawReceiveDone

void(* otLinkRawReceiveDone)(otInstance *aInstance, otRadioFrame *aFrame, otError aError)

مؤشر الدالة هذا عند استلام إطار IEEE 802.15.4.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aFrame
مؤشر إلى الإطار المُستلَم أو فارغ إذا تم إلغاء عملية الاستلام.
[in] aError
OT_ERROR_NONE عند تلقّي إطار بنجاح. OT_ERROR_ABORT عندما تم إلغاء الاستقبال ولم يتم استلام إطار.

otLinkRawTransmitDone

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_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 بالديسيبل ميلي واط عندما يكون صالحًا. 127 عندما يكون RSSI غير صالح.

otLinkRawGetTransmitBuffer

otRadioFrame * otLinkRawGetTransmitBuffer(
  otInstance *aInstance
)

انتقالات الراديو من خدمة Transmit toReceive (نقل المحتوى إلى الاستلام)

تعرض هذه الطريقة مؤشرًا إلى المخزن المؤقت للإرسال.

ويطلب المتصل إطار IEEE 802.15.4 في هذا المخزن المؤقت، ثم يستدعي otLinkRawTransmit() لطلب النقل.

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

otLinkRawIsEnabled

bool otLinkRawIsEnabled(
  otInstance *aInstance
)

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

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

otLinkRawReceive

otError otLinkRawReceive(
  otInstance *aInstance
)

جارٍ نقل الراديو من وضع السكون إلى الاستلام.

شغِّل الراديو.

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

otLinkRawSetMacFrameCounter

otError otLinkRawSetMacFrameCounter(
  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
إذا لم يتم تفعيل طبقة الرابط الأولية.

otLinkRawSetReceiveDone

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

تعمل هذه الدالة على تفعيل/إيقاف طبقة الروابط الأولية.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aCallback
مؤشر لدالة تُسمى تلقي إطار IEEE 802.15.4. فارغ لإيقاف طبقة الرابط الأولية.
قيم الإرجاع
OT_ERROR_FAILED
تعذَّر تفعيل/إيقاف الراديو.
OT_ERROR_INVALID_STATE
في حال تفعيل واجهة IPv6 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
تم إيقاف الراديو

otLinkRawSrcMatchAddExtEntry

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

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

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

otLinkRawSrcMatchAddShortEntry

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

otLinkRawSrcMatchClearExtEntry

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

otLinkRawSrcMatchClearShortEntry

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