رابط خام

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

ملخص

النوع
`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)`	`otError` تبدأ هذه الطريقة في تسلسل مسح الطاقة على الراديو.
`otLinkRawGetCaps ( otInstance *aInstance)`	`otRadioCaps` احصل على قدرات الراديو.
`otLinkRawGetPromiscuous ( otInstance *aInstance)`	`bool` تحصل هذه الوظيفة على حالة الوضع المختلط.
`otLinkRawGetRadioTime ( otInstance *aInstance)`	`uint64_t` احصل على وقت المنصة الحالي (عرض 64 بت) لشريحة الراديو.
`otLinkRawGetRssi ( otInstance *aInstance)`	`int8_t` احصل على أحدث قياس لـ RSSI.
`otLinkRawGetTransmitBuffer ( otInstance *aInstance)`	`otRadioFrame *` انتقالات الراديو من الإرسال إلى الاستقبال.
`otLinkRawIsEnabled ( otInstance *aInstance)`	`bool` تشير هذه الوظيفة إلى ما إذا تم تمكين طبقة الارتباط الأولية أم لا.
`otLinkRawReceive ( otInstance *aInstance)`	`otError` تحويل الراديو من وضع السكون إلى الاستقبال.
`otLinkRawSetMacFrameCounter ( otInstance *aInstance, uint32_t aMacFrameCounter)`	`otError` يضبط قيمة عداد إطار MAC الحالي.
`otLinkRawSetMacKey ( otInstance aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKey aPrevKey, const otMacKey aCurrKey, const otMacKey aNextKey)`	`otError` تحديث مفاتيح MAC وفهرس المفاتيح.
`otLinkRawSetPromiscuous ( otInstance *aInstance, bool aEnable)`	`otError` تعمل هذه الوظيفة على تمكين أو تعطيل الوضع المختلط.
`otLinkRawSetReceiveDone ( otInstance *aInstance, otLinkRawReceiveDone aCallback)`	`otError` تعمل هذه الوظيفة على تمكين / تعطيل طبقة الارتباط الأولية.
`otLinkRawSetShortAddress ( otInstance *aInstance, uint16_t aShortAddress)`	`otError` قم بتعيين العنوان القصير لتصفية العنوان.
`otLinkRawSleep ( otInstance *aInstance)`	`otError` انقل الراديو من "استقبال" إلى "وضع السكون".
`otLinkRawSrcMatchAddExtEntry ( otInstance aInstance, const otExtAddress aExtAddress)`	`otError` إضافة العنوان الممتد إلى جدول مطابقة المصدر.
`otLinkRawSrcMatchAddShortEntry ( otInstance *aInstance, uint16_t aShortAddress)`	`otError` إضافة عنوان قصير إلى جدول مطابقة المصدر.
`otLinkRawSrcMatchClearExtEntries ( otInstance *aInstance)`	`otError` إزالة كافة العناوين الممتدة من جدول مطابقة المصدر.
`otLinkRawSrcMatchClearExtEntry ( otInstance aInstance, const otExtAddress aExtAddress)`	`otError` إزالة العنوان الممتد إلى جدول مطابقة المصدر الخاص بالراديو.
`otLinkRawSrcMatchClearShortEntries ( otInstance *aInstance)`	`otError` إزالة كافة العناوين القصيرة من جدول مطابقة المصدر.
`otLinkRawSrcMatchClearShortEntry ( otInstance *aInstance, uint16_t aShortAddress)`	`otError` إزالة العنوان المختصر من جدول مطابقة المصدر.
`otLinkRawSrcMatchEnable ( otInstance *aInstance, bool aEnable)`	`otError` تمكين / تعطيل مطابقة المصدر للإطار المعلق.
`otLinkRawTransmit ( otInstance *aInstance, otLinkRawTransmitDone aCallback)`	`otError` تبدأ هذه الطريقة في تسلسل الإرسال على الراديو.

النوع

otLinkRawEnergyScan فعلت

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

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

تفاصيل

المعلمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aEnergyScanMaxRssi`	تمت مصادفة الحد الأقصى لـ RSSI على القناة الممسوحة.

otLinkRawReceive تم

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_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.

عائدات

مؤشر إلى المخزن المؤقت للإرسال أو NULL إذا لم يتم تمكين طبقة الارتباط الأولية.

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

otLinkRawSetReceive تم

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

تعمل هذه الوظيفة على تمكين / تعطيل طبقة الارتباط الأولية.

تفاصيل

المعلمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aCallback`	مؤشر لوظيفة تسمى عند استلام إطار IEEE 802.15.4. NULL لتعطيل طبقة الارتباط الأولية.

إرجاع القيم

`OT_ERROR_FAILED`	لا يمكن تمكين / تعطيل الراديو.
`OT_ERROR_INVALID_STATE`	إذا تم تمكين واجهة OpenThread Ip6 بالفعل.
`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`	إذا لم يتم تمكين طبقة الارتباط الأولية.

إدخالات otLinkRawSrcMatchClearExt

03 ب 1409870

إزالة كافة العناوين الممتدة من جدول مطابقة المصدر.

تفاصيل

المعلمات

[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`	إذا لم يتم تمكين طبقة الارتباط الأولية.

otLinkRawSrcMatchClearShortE Entries

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 .

يتكون تسلسل الإرسال من:

تحويل الراديو للإرسال من الاستقبال.
ينقل PSDU على القناة المحددة وبقدرة الإرسال المحددة.

تفاصيل

المعلمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aCallback`	مؤشر إلى وظيفة تسمى عند اكتمال الإرسال.

إرجاع القيم

`OT_ERROR_NONE`	تم الانتقال بنجاح إلى الإرسال.
`OT_ERROR_INVALID_STATE`	لم يكن الراديو في حالة الاستقبال.