رابط غير منسق

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

ملخّص

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

تحديدات النوع

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_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 بالديسيبل ميلي واط عندما يكون صالحًا. 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
تم إيقاف طبقة الرابط الأولية.

otLinkRawReceive

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

otLinkRawSetReceiveDone

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

لتفعيل/إيقاف طبقة الرابط الأولية.

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

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