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

ربط

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

الملخّص

التعدادات
`otMacFilterAddressMode{ OT_MAC_FILTER_ADDRESS_MODE_DISABLED, OT_MAC_FILTER_ADDRESS_MODE_ALLOWLIST, OT_MAC_FILTER_ADDRESS_MODE_DENYLIST }`	تعداد يحدّد وضع العنوان لفلتر Mac.

مواقد الخط
`otActiveScanResult`	مَعلمة typetype `struct otActiveScanResult` تمثل هذه البنية الإشارة الواردة إلى IEEE 802.15.4.
`otEnergyScanResult`	مَعلمة typetype `struct otEnergyScanResult` تمثّل هذه البنية نتيجة فحص الطاقة.
`otHandleActiveScanResult)(otActiveScanResult aResult, void aContext)`	مَعلمة typetype `void(*` يتم استدعاء مؤشر الدالة هذا أثناء عملية مسح ضوئي لـ IEEE 802.15.4 عند تلقي إشارة IEEE 802.15.4 أو إكمال عملية المسح.
`otHandleEnergyScanResult)(otEnergyScanResult aResult, void aContext)`	مَعلمة typetype `void(*` يتم استدعاء مؤشر الدالة هذا أثناء IEEE 802.15.4 Energy Scan عندما تكون نتيجة القناة جاهزة أو اكتمال الفحص.
`otLinkPcapCallback)(const otRadioFrame aFrame, bool aIsTx, void aContext)`	مَعلمة typetype `void(*` يتم استدعاء مؤشر الدالة هذا عند استلام إطار IEEE 802.15.4.
`otMacCounters`	مَعلمة typetype `struct otMacCounters` تمثل هذه البنية عدّادات طبقة MAC.
`otMacFilterAddressMode`	مَعلمة typetype `enum otMacFilterAddressMode` يحدّد وضع العنوان لفلتر Mac.
`otMacFilterEntry`	مَعلمة typetype `struct otMacFilterEntry` تمثل هذه البنية إدخال فلتر Mac.
`otMacFilterIterator`	مَعلمة typetype `uint8_t` يُستخدَم للردّ من خلال إدخالات فلاتر Mac.
`otThreadLinkInfo`	مَعلمة typetype `struct otThreadLinkInfo` تمثّل هذه البنية المعلومات الخاصة بالرابط للرسائل التي يتم استلامها من راديو سلسلة المحادثات.

الدوال
`otLinkActiveScan(otInstance aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleActiveScanResult aCallback, void aCallbackContext)`	`otError` تبدأ هذه الدالة فحص IEEE 802.15.4 نشط.
`otLinkConvertLinkQualityToRss(otInstance *aInstance, uint8_t aLinkQuality)`	`int8_t` تحوّل هذه الطريقة جودة الرابط إلى قوة الإشارة المُستلَمة العادية.
`otLinkConvertRssToLinkQuality(otInstance *aInstance, int8_t aRss)`	`uint8_t` تحوّل هذه الطريقة قوة الإشارة المستلمة إلى جودة الرابط.
`otLinkCslGetChannel(otInstance *aInstance)`	`uint8_t` تحصل هذه الدالة على قناة CSL.
`otLinkCslGetPeriod(otInstance *aInstance)`	`uint16_t` تحصل هذه الدالة على فترة CSL.
`otLinkCslGetTimeout(otInstance *aInstance)`	`uint32_t` تحصل هذه الدالة على مهلة CSL.
`otLinkCslSetChannel(otInstance *aInstance, uint8_t aChannel)`	`otError` تحدد هذه الدالة قناة CSL.
`otLinkCslSetPeriod(otInstance *aInstance, uint16_t aPeriod)`	`otError` تحدّد هذه الدالة الفترة CSL.
`otLinkCslSetTimeout(otInstance *aInstance, uint32_t aTimeout)`	`otError` تحدّد هذه الدالة مهلة CSL.
`otLinkEnergyScan(otInstance aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleEnergyScanResult aCallback, void aCallbackContext)`	`otError` تبدأ هذه الدالة فحص IEEE 802.15.4 للطاقة.
`otLinkFilterAddAddress(otInstance aInstance, const otExtAddress aExtAddress)`	`otError` تضيف هذه الطريقة عنوانًا موسَّعًا إلى فلتر MAC.
`otLinkFilterAddRssIn(otInstance aInstance, const otExtAddress aExtAddress, int8_t aRss)`	`otError` تضيف هذه الطريقة إدخال قوة إشارة مستلمة ثابتة (بالديسيبل ميلي واط) للرسائل من عنوان موسع محدد في فلتر MAC.
`otLinkFilterClearAddresses(otInstance *aInstance)`	`void` تعمل هذه الطريقة على محو جميع العناوين الموسّعة من فلتر MAC.
`otLinkFilterClearAllRssIn(otInstance *aInstance)`	`void` تعمل هذه الطريقة على محو جميع إدخالات مدى قوة الإشارة التي تم استلامها (بما في ذلك تنسيق RSS التلقائي) في فلتر MAC.
`otLinkFilterClearDefaultRssIn(otInstance *aInstance)`	`void` وتمحو هذه الطريقة أي قوة إشارة تلقائية مُستلَمة سابقًا (بديسيبل ملي واط) في فلتر MAC.
`otLinkFilterGetAddressMode(otInstance *aInstance)`	`otMacFilterAddressMode` تحصل هذه الدالة على وضع العنوان لفلتر MAC.
`otLinkFilterGetNextAddress(otInstance aInstance, otMacFilterIterator aIterator, otMacFilterEntry *aEntry)`	`otError` تتلقى هذه الطريقة إدخال فلتر عنوان قيد الاستخدام.
`otLinkFilterGetNextRssIn(otInstance aInstance, otMacFilterIterator aIterator, otMacFilterEntry *aEntry)`	`otError` تحصل هذه الطريقة على إدخال فلتر RssIn قيد الاستخدام.
`otLinkFilterRemoveAddress(otInstance aInstance, const otExtAddress aExtAddress)`	`void` تؤدي هذه الطريقة إلى إزالة العنوان الموسَّع من فلتر MAC.
`otLinkFilterRemoveRssIn(otInstance aInstance, const otExtAddress aExtAddress)`	`void` تزيل هذه الطريقة إدخال فلتر MAC لإعداد قوة إشارة الاستلام الثابتة لعنوان موسَّع محدَّد.
`otLinkFilterSetAddressMode(otInstance *aInstance, otMacFilterAddressMode aMode)`	`void` تضبط هذه الدالة وضع العنوان لفلتر MAC.
`otLinkFilterSetDefaultRssIn(otInstance *aInstance, int8_t aRss)`	`void` تضبط هذه الطريقة قوة الإشارة التلقائية التي تم استلامها (بالديسيبل ميلي واط) على فلتر MAC.
`otLinkGetCcaFailureRate(otInstance *aInstance)`	`uint16_t` تعرض هذه الدالة معدّل تعذُّر CCA (تقييم القناة) الحالي.
`otLinkGetChannel(otInstance *aInstance)`	`uint8_t` الحصول على قناة IEEE 802.15.4
`otLinkGetCounters(otInstance *aInstance)`	`const otMacCounters *` احصل على عدّادات طبقة MAC.
`otLinkGetExtendedAddress(otInstance *aInstance)`	`const otExtAddress *` احصل على العنوان IEEE 802.15.4 الموسَّع.
`otLinkGetFactoryAssignedIeeeEui64(otInstance aInstance, otExtAddress aEui64)`	`void` احصل على IEEE EU-64 الذي تم تخصيصه من المصنع.
`otLinkGetMaxFrameRetriesDirect(otInstance *aInstance)`	`uint8_t` تعرض هذه الطريقة الحد الأقصى لعدد إعادة محاولة عرض الإطارات أثناء النقل المباشر.
`otLinkGetMaxFrameRetriesIndirect(otInstance *aInstance)`	`uint8_t` تعرض هذه الطريقة الحد الأقصى لعدد إعادة محاولة عرض الإطارات أثناء النقل غير المباشر.
`otLinkGetPanId(otInstance *aInstance)`	`otPanId` احصل على رقم تعريف PANEE 802.15.4 PAN.
`otLinkGetPollPeriod(otInstance *aInstance)`	`uint32_t` يمكنك الحصول على فترة استطلاع البيانات لجهاز ناعس.
`otLinkGetShortAddress(otInstance *aInstance)`	`otShortAddress` احصل على العنوان القصير IEEE 802.15.4.
`otLinkGetSupportedChannelMask(otInstance *aInstance)`	`uint32_t` الحصول على قناع القناة المتوافق من طبقة MAC.
`otLinkGetTxDirectRetrySuccessHistogram(otInstance aInstance, uint8_t aNumberOfEntries)`	`const uint32_t *` تحصل هذه الطريقة على مدرج تكراري لإعادة المحاولة لحزمة مباشرة واحدة حتى ينجح.
`otLinkGetTxIndirectRetrySuccessHistogram(otInstance aInstance, uint8_t aNumberOfEntries)`	`const uint32_t *` تحصل هذه الطريقة على مدرج تكراري لإعادة المحاولة لحزمة واحدة غير مباشرة حتى ينجح.
`otLinkIsActiveScanInProgress(otInstance *aInstance)`	`bool` تشير هذه الدالة إلى ما إذا كان الفحص النشط IEEE 802.15.4 قيد التقدم حاليًا أم لا.
`otLinkIsEnabled(otInstance *aInstance)`	`bool` وتوضّح هذه الدالة ما إذا كانت طبقة الروابط مفعّلة أم لا.
`otLinkIsEnergyScanInProgress(otInstance *aInstance)`	`bool` وتوضّح هذه الدالة ما إذا كان فحص IEEE 802.15.4 للطاقة قيد التقدم حاليًا أم لا.
`otLinkIsInTransmitState(otInstance *aInstance)`	`bool` تشير هذه الدالة إلى ما إذا كان عنوان IEEE 802.15.4 MAC في حالة الإرسال أم لا.
`otLinkIsPromiscuous(otInstance *aInstance)`	`bool` تحدّد هذه الدالة ما إذا كان قد تم تفعيل وضع المبهر في طبقة الرابط أم لا.
`otLinkIsRadioFilterEnabled(otInstance *aInstance)`	`bool` تشير هذه الدالة إلى ما إذا كان فلتر راديو IEEE 802.15.4 مفعلاً أم لا.
`otLinkResetCounters(otInstance *aInstance)`	`void` أعِد ضبط عدّادات طبقة MAC.
`otLinkResetTxRetrySuccessHistogram(otInstance *aInstance)`	`void` وتمكّن هذه الطريقة من محو إحصاءات التردد الرسومي لعمليات الانتقال المباشرة وغير المباشرة.
`otLinkSendDataRequest(otInstance *aInstance)`	`otError` تُدرِج هذه الدالة رسالة طلب بيانات في IEEE 802.15.4 لنقلها.
`otLinkSendEmptyData(otInstance *aInstance)`	`otError` توجِّه هذه الدالة الجهاز إلى إرسال إطار بيانات IEEE 802.15.4 فارغ.
`otLinkSetChannel(otInstance *aInstance, uint8_t aChannel)`	`otError` ضبط قناة IEEE 802.15.4
`otLinkSetEnabled(otInstance *aInstance, bool aEnable)`	`otError` تعمل هذه الدالة على تفعيل طبقة الرابط أو إيقافها.
`otLinkSetExtendedAddress(otInstance aInstance, const otExtAddress aExtAddress)`	`otError` تحدد هذه الدالة العنوان IEEE 802.15.4 الموسَّع.
`otLinkSetMaxFrameRetriesDirect(otInstance *aInstance, uint8_t aMaxFrameRetriesDirect)`	`void` تحدد هذه الطريقة الحد الأقصى لعدد إعادة محاولة عرض الإطارات أثناء النقل المباشر.
`otLinkSetMaxFrameRetriesIndirect(otInstance *aInstance, uint8_t aMaxFrameRetriesIndirect)`	`void` تحدد هذه الطريقة الحد الأقصى لعدد إعادة محاولة عرض الإطارات أثناء النقل غير المباشر.
`otLinkSetPanId(otInstance *aInstance, otPanId aPanId)`	`otError` اضبُط معرّف PANEE 802.15.4 PAN.
`otLinkSetPcapCallback(otInstance aInstance, otLinkPcapCallback aPcapCallback, void aCallbackContext)`	`void` تسجِّل هذه الدالة رد اتصال لتوفير إطارات IEEE 802.15.4 أولية مُستلَمة.
`otLinkSetPollPeriod(otInstance *aInstance, uint32_t aPollPeriod)`	`otError` إعداد/محو فترة استطلاع البيانات الخارجية أو المحدَّدة من قِبل المستخدم في الجهاز النهائي الذي يتسم بالنعاس.
`otLinkSetPromiscuous(otInstance *aInstance, bool aPromiscuous)`	`otError` تعمل هذه الوظيفة على تفعيل أو إيقاف وضع الطبقة المشتركة.
`otLinkSetRadioFilterEnabled(otInstance *aInstance, bool aFilterEnabled)`	`void` تعمل هذه الوظيفة على تفعيل/إيقاف وضع فلتر الراديو IEEE 802.15.4.
`otLinkSetSupportedChannelMask(otInstance *aInstance, uint32_t aChannelMask)`	`otError` إعداد قناع القناة المتوافق لطبقة MAC.

التشريعات
otActiveScanResult	تمثل هذه البنية الإشارة الواردة إلى IEEE 802.15.4.
otEnergyScanResult	تمثّل هذه البنية نتيجة فحص الطاقة.
otMacCounters	تمثل هذه البنية عدّادات طبقة MAC.
otMacFilterEntry	تمثل هذه البنية إدخال فلتر Mac.
otthreadLinkInfo	تمثّل هذه البنية المعلومات الخاصة بالرابط للرسائل التي يتم استلامها من راديو سلسلة المحادثات.

التعدادات

otMacFilterAddressMode

 otMacFilterAddressMode

يحدّد وضع العنوان لفلتر Mac.

المنشآت الفندقية
`OT_MAC_FILTER_ADDRESS_MODE_ALLOWLIST`	تمّ تفعيل وضع فلتر عنوان القائمة المسموح بها.
`OT_MAC_FILTER_ADDRESS_MODE_DENYLIST`	تمّ تفعيل وضع فلتر عنوان القائمة المرفوضة.
`OT_MAC_FILTER_ADDRESS_MODE_DISABLED`	تم إيقاف فلتر العناوين.

مواقد الخط

otActiveScanResult

struct otActiveScanResult otActiveScanResult

تمثل هذه البنية الإشارة الواردة إلى IEEE 802.15.4.

otEnergyScanResult

struct otEnergyScanResult otEnergyScanResult

تمثّل هذه البنية نتيجة فحص الطاقة.

otHandleActiveScanResult

void(* otHandleActiveScanResult)(otActiveScanResult *aResult, void *aContext)

يتم استدعاء مؤشر الدالة هذا أثناء عملية مسح ضوئي لـ IEEE 802.15.4 عند تلقي إشارة IEEE 802.15.4 أو إكمال عملية المسح.

التفاصيل

المعلَمات

`[in] aResult`	مؤشر صالح إلى معلومات المرشد أو فارغ عند اكتمال الفحص النشط.
`[in] aContext`	مؤشر للسياق الخاص بالتطبيق.

otHandleEnergyEnergyResult

void(* otHandleEnergyScanResult)(otEnergyScanResult *aResult, void *aContext)

يتم استدعاء مؤشر الدالة هذا أثناء IEEE 802.15.4 Energy Scan عندما تكون نتيجة القناة جاهزة أو اكتمال الفحص.

التفاصيل

المعلَمات

`[in] aResult`	مؤشر صالح إلى معلومات نتيجة فحص الطاقة أو فارغ عند اكتمال فحص الطاقة.
`[in] aContext`	مؤشر للسياق الخاص بالتطبيق.

otLinkPcapCallback

void(* otLinkPcapCallback)(const otRadioFrame *aFrame, bool aIsTx, void *aContext)

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

ملاحظة: يتم استدعاء معاودة الاتصال بعد معالجة FCS وقد لا يحتوي aFrame على FCS الفعلي الذي تم استلامه.

التفاصيل

المعلَمات

`[in] aFrame`	مؤشر إلى إطار IEEE 802.15.4 المُستلَم.
`[in] aIsTx`	تحديد ما إذا تم نقل هذا الإطار أم لا
`[in] aContext`	مؤشر للسياق الخاص بالتطبيق.

otMacCounters

struct otMacCounters otMacCounters

تمثل هذه البنية عدّادات طبقة MAC.

otMacFilterAddressMode

enum otMacFilterAddressMode otMacFilterAddressMode

يحدّد وضع العنوان لفلتر Mac.

otMacFilterEntry

struct otMacFilterEntry otMacFilterEntry

تمثل هذه البنية إدخال فلتر Mac.

otMacFilterIterator

uint8_t otMacFilterIterator

يُستخدَم للردّ من خلال إدخالات فلاتر Mac.

otthreadLinkInfo

struct otThreadLinkInfo otThreadLinkInfo

تمثّل هذه البنية المعلومات الخاصة بالرابط للرسائل التي يتم استلامها من راديو سلسلة المحادثات.

الدوال

otLinkActiveScan

otError otLinkActiveScan(
  otInstance *aInstance,
  uint32_t aScanChannels,
  uint16_t aScanDuration,
  otHandleActiveScanResult aCallback,
  void *aCallbackContext
)

تبدأ هذه الدالة فحص IEEE 802.15.4 نشط.

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aScanChannels`	مؤشر متّجه للإشارة إلى القنوات التي يجب فحصها (مثل OT_CHANNEL_11_MASK).
`[in] aScanDuration`	الوقت بالمللي ثانية لقضاء وقت في فحص كل قناة.
`[in] aCallback`	يشير المؤشر إلى وظيفة تُسمى تلقّي إشارة أو مسح ضوئي.
`[in] aCallbackContext`	مؤشر للسياق الخاص بالتطبيق.

قيم الإرجاع

`OT_ERROR_NONE`	تم قبول طلب "المسح الضوئي النشط".
`OT_ERROR_BUSY`	جارٍ إجراء فحص نشط بالفعل.

otLinkConverLinkLinkToRss

int8_t otLinkConvertLinkQualityToRss(
  otInstance *aInstance,
  uint8_t aLinkQuality
)

تحوّل هذه الطريقة جودة الرابط إلى قوة الإشارة المُستلَمة العادية.

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aLinkQuality`	يجب أن تكون قيمة Linkquality في النطاق [0,3].

طلبات الإرجاع

تلقى النظام الأساسي العادي تعيين قوة الإشارة إلى aLinkQuality.

otLinkConverRsToLinkquality

uint8_t otLinkConvertRssToLinkQuality(
  otInstance *aInstance,
  int8_t aRss
)

تحوّل هذه الطريقة قوة الإشارة المستلمة إلى جودة الرابط.

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aRss`	قيمة قوة الإشارة المستلَمة التي سيتم تحويلها.

طلبات الإرجاع

ربط ربط جودة الجودة بـ aRss.

otLinkCslGetChannel

uint8_t otLinkCslGetChannel(
  otInstance *aInstance
)

تحصل هذه الدالة على قناة CSL.

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

طلبات الإرجاع

قناة CSL

otLinkCslGetPeriod

uint16_t otLinkCslGetPeriod(
  otInstance *aInstance
)

تحصل هذه الدالة على فترة CSL.

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

طلبات الإرجاع

فترة CSL بوحدات 10 رموز.

otLinkCslGetTimeout

uint32_t otLinkCslGetTimeout(
  otInstance *aInstance
)

تحصل هذه الدالة على مهلة CSL.

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

طلبات الإرجاع

انتهت مهلة CSL بالثواني.

otLinkCslSetChannel

otError otLinkCslSetChannel(
  otInstance *aInstance,
  uint8_t aChannel
)

تحدد هذه الدالة قناة CSL.

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aChannel`	نموذج قناة CSL. يجب أن تكون قيمة القناة `0` (تعيين قناة CSL غير محددة) أو ضمن النطاق [1، 10] (إذا كان 915 ميغاهرتز متاحًا) و11، 26.

قيم الإرجاع

`OT_ERROR_NONE`	تم ضبط معلمات CSL بنجاح.
`OT_ERROR_INVALID_ARGS`	`aChannel` غير صالح.

otLinkCslSetPeriod

otError otLinkCslSetPeriod(
  otInstance *aInstance,
  uint16_t aPeriod
)

تحدّد هذه الدالة الفترة CSL.

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aPeriod`	فترة CSL بوحدات 10 رموز.

قيم الإرجاع

`OT_ERROR_NONE`	تم ضبط فترة CSL بنجاح.
`OT_ERROR_INVALID_ARGS`	فترة CSL غير صالحة.

otLinkCslSetTimeout

otError otLinkCslSetTimeout(
  otInstance *aInstance,
  uint32_t aTimeout
)

تحدّد هذه الدالة مهلة CSL.

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aTimeout`	انتهت مهلة CSL بالثواني.

قيم الإرجاع

`OT_ERROR_NONE`	تم ضبط مهلة CSL بنجاح.
`OT_ERROR_INVALID_ARGS`	مهلة CSL غير صالحة.

otLinkEnergyScan

otError otLinkEnergyScan(
  otInstance *aInstance,
  uint32_t aScanChannels,
  uint16_t aScanDuration,
  otHandleEnergyScanResult aCallback,
  void *aCallbackContext
)

تبدأ هذه الدالة فحص IEEE 802.15.4 للطاقة.

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aScanChannels`	موجّه صغير يشير إلى القنوات التي تجري فحصًا للطاقة.
`[in] aScanDuration`	الوقت بالمللي ثانية لقضاء وقت في فحص كل قناة.
`[in] aCallback`	مؤشر إلى وظيفة تُسمى بتمرير نتيجة الفحص عند الإشارة إلى اكتمال الفحص.
`[in] aCallbackContext`	مؤشر للسياق الخاص بالتطبيق.

قيم الإرجاع

`OT_ERROR_NONE`	تم قبول طلب البحث عن الطاقة.
`OT_ERROR_BUSY`	تعذَّر بدء عملية فحص الطاقة.

otLinkFilterAddAddress

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

تضيف هذه الطريقة عنوانًا موسَّعًا إلى فلتر MAC.

تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aExtAddress`	مؤشر إلى العنوان الموسَّع (يجب ألا يكون فارغًا).

قيم الإرجاع

`OT_ERROR_NONE`	تمت إضافة `aExtAddress` إلى فلتر MAC.
`OT_ERROR_NO_BUFS`	ليس هناك إدخال متاح.

otLinkFilterAddRsIn

otError otLinkFilterAddRssIn(
  otInstance *aInstance,
  const otExtAddress *aExtAddress,
  int8_t aRss
)

تضيف هذه الطريقة إدخال قوة إشارة مستلمة ثابتة (بالديسيبل ميلي واط) للرسائل من عنوان موسع محدد في فلتر MAC.

تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aExtAddress`	مؤشر إلى العنوان IEEE 802.15.4 الموسَّع. يجب ألا يكون فارغًا.
`[in] aRss`	قوة الإشارة المستلمة (بالديسيبل ميلي واط).

قيم الإرجاع

`OT_ERROR_NONE`	تمت إضافة إدخال `aExtAddress` و`aRss` بنجاح.
`OT_ERROR_NO_BUFS`	ليس هناك إدخال متاح.

otLinkFilterClearAddresses

void otLinkFilterClearAddresses(
  otInstance *aInstance
)

تعمل هذه الطريقة على محو جميع العناوين الموسّعة من فلتر MAC.

تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

otLinkFilterClearAllRssIn

void otLinkFilterClearAllRssIn(
  otInstance *aInstance
)

تعمل هذه الطريقة على محو جميع إدخالات مدى قوة الإشارة التي تم استلامها (بما في ذلك تنسيق RSS التلقائي) في فلتر MAC.

تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

otLinkFilterClearDefaultRssIn

void otLinkFilterClearDefaultRssIn(
  otInstance *aInstance
)

وتمحو هذه الطريقة أي قوة إشارة تلقائية مُستلَمة سابقًا (بديسيبل ملي واط) في فلتر MAC.

تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

otLinkFilterGetAddressMode

otMacFilterAddressMode otLinkFilterGetAddressMode(
  otInstance *aInstance
)

تحصل هذه الدالة على وضع العنوان لفلتر MAC.

تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

طلبات الإرجاع

في وضع العنوان.

otLinkFilterGetNextAddress

otError otLinkFilterGetNextAddress(
  otInstance *aInstance,
  otMacFilterIterator *aIterator,
  otMacFilterEntry *aEntry
)

تتلقى هذه الطريقة إدخال فلتر عنوان قيد الاستخدام.

تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in,out] aIterator`	مؤشر إلى سياق تكرار فلتر MAC. للحصول على إدخال فلتر العناوين الأول قيد الاستخدام، يجب ضبطه على OT_MAC_FILTER_ITERATOR_INIT. يجب ألا يكون فارغًا.
`[out] aEntry`	مؤشر إلى مكان وضع المعلومات. يجب ألا يكون فارغًا.

قيم الإرجاع

`OT_ERROR_NONE`	تم استرداد إدخال فلتر عنوان قيد الاستخدام بنجاح.
`OT_ERROR_NOT_FOUND`	ليس هناك إدخال لاحق.

otLinkFilterGetNextRssIn

otError otLinkFilterGetNextRssIn(
  otInstance *aInstance,
  otMacFilterIterator *aIterator,
  otMacFilterEntry *aEntry
)

تحصل هذه الطريقة على إدخال فلتر RssIn قيد الاستخدام.

تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in,out] aIterator`	مؤشر إلى سياق تكرار فلتر MAC. يجب ألا يكون فارغًا. للحصول على الإدخال الأول، يجب ضبطه على OT_MAC_FILTER_ITERATOR_INIT.
`[out] aEntry`	مؤشر إلى مكان وضع المعلومات. سيتضمن الإدخال الأخير العنوان الموسّع بالكامل على أنه 0xff للإشارة إلى قوة الإشارة التلقائية التي تم استلامها في حال تعيينها. يجب ألا يكون `aEntry` فارغًا.

قيم الإرجاع

`OT_ERROR_NONE`	تم استرداد الإدخال التالي بنجاح.
`OT_ERROR_NOT_FOUND`	ليس هناك إدخال لاحق.

otLinkFilterRemoveAddress

void otLinkFilterRemoveAddress(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

تؤدي هذه الطريقة إلى إزالة العنوان الموسَّع من فلتر MAC.

تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.

لا يتم تنفيذ أي إجراء في حال عدم توفّر إدخال حالي في الفلتر يطابق "العنوان الموسّع".

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aExtAddress`	مؤشر إلى العنوان الموسَّع (يجب ألا يكون فارغًا).

otLinkFilterRemoveRssIn

void otLinkFilterRemoveRssIn(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

تزيل هذه الطريقة إدخال فلتر MAC لإعداد قوة إشارة الاستلام الثابتة لعنوان موسَّع محدَّد.

تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.

لا يتم تنفيذ أي إجراء في حال عدم توفّر إدخال حالي في الفلتر يطابق "العنوان الموسّع".

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aExtAddress`	مؤشر إلى العنوان IEEE 802.15.4 الموسَّع. يجب ألا يكون فارغًا.

otLinkFilterSetAddressMode

void otLinkFilterSetAddressMode(
  otInstance *aInstance,
  otMacFilterAddressMode aMode
)

تضبط هذه الدالة وضع العنوان لفلتر MAC.

تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aMode`	وضع العنوان المطلوب تعيينه.

otLinkFilterSetDefaultRssIn

void otLinkFilterSetDefaultRssIn(
  otInstance *aInstance,
  int8_t aRss
)

تضبط هذه الطريقة قوة الإشارة التلقائية التي تم استلامها (بالديسيبل ميلي واط) على فلتر MAC.

تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.

يتم استخدام قيمة RSS التلقائية لجميع الإطارات المُستلَمة من العناوين التي لا يتوفّر لها إدخال RSS-IN صريح في قائمة الفلاتر (تتم الإضافة باستخدام otLinkFilterAddRssIn()).

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aRss`	قوة الإشارة التلقائية التي تم استلامها (بالديسيبل ميلي واط) لضبطها.

otLinkGetCCaFailureRate

uint16_t otLinkGetCcaFailureRate(
  otInstance *aInstance
)

تعرض هذه الدالة معدّل تعذُّر CCA (تقييم القناة) الحالي.

يتم الحفاظ على معدل نقل البيانات خلال فترة (OPENTHREAD_CONFIG_CCA_FAILURE_RATE_AVERAGING_WINDOW) تقريبًا من عمليات نقل الإطارات الأخيرة.

التفاصيل
طلبات الإرجاع	معدّل حالات تعذُّر تحميل المحتوى (CCA) الذي يبلغ `0xffff` في القيمة القصوى 100%.

otLinkGetChannel

uint8_t otLinkGetChannel(
  otInstance *aInstance
)

الحصول على قناة IEEE 802.15.4

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

طلبات الإرجاع

قناة IEEE 802.15.4

اطّلع أيضًا على:
otLinkSetChannel

otLinkGetCounters

const otMacCounters * otLinkGetCounters(
  otInstance *aInstance
)

احصل على عدّادات طبقة MAC.

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

طلبات الإرجاع

مؤشر إلى عدّادات MAC.

otLinkGetExpandAddress

const otExtAddress * otLinkGetExtendedAddress(
  otInstance *aInstance
)

احصل على العنوان IEEE 802.15.4 الموسَّع.

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

طلبات الإرجاع

مؤشر إلى العنوان IEEE 802.15.4 الموسَّع.

otLinkGetfactoryAssignIeeeEui64

void otLinkGetFactoryAssignedIeeeEui64(
  otInstance *aInstance,
  otExtAddress *aEui64
)

احصل على IEEE EU-64 الذي تم تخصيصه من المصنع.

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[out] aEui64`	مؤشر إلى مكان وضع IEEE EUI-64 المخصص من جانب المصنع.

otLinkGetMaxFrameRetriesDirect

uint8_t otLinkGetMaxFrameRetriesDirect(
  otInstance *aInstance
)

تعرض هذه الطريقة الحد الأقصى لعدد إعادة محاولة عرض الإطارات أثناء النقل المباشر.

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

طلبات الإرجاع

الحد الأقصى لعدد إعادة المحاولة أثناء النقل المباشر.

otLinkGetMaxFrameRetriesIndirect

uint8_t otLinkGetMaxFrameRetriesIndirect(
  otInstance *aInstance
)

تعرض هذه الطريقة الحد الأقصى لعدد إعادة محاولة عرض الإطارات أثناء النقل غير المباشر.

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

طلبات الإرجاع

الحد الأقصى لعدد إعادة المحاولة أثناء النقل غير المباشر.

otLinkGetPanId

otPanId otLinkGetPanId(
  otInstance *aInstance
)

احصل على رقم تعريف PANEE 802.15.4 PAN.

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

طلبات الإرجاع

معرّف PANEE 802.15.4 PAN

اطّلع أيضًا على:
otLinkSetPanId

otLinkGetPollPeriod

uint32_t otLinkGetPollPeriod(
  otInstance *aInstance
)

يمكنك الحصول على فترة استطلاع البيانات لجهاز ناعس.

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

طلبات الإرجاع

فترة استطلاع البيانات للجهاز النهائي المُخصَّص للنوم، بالمللي ثانية.

اطّلع أيضًا على:
otLinkSetPollPeriod

otLinkGetShortAddress

otShortAddress otLinkGetShortAddress(
  otInstance *aInstance
)

احصل على العنوان القصير IEEE 802.15.4.

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

طلبات الإرجاع

مؤشر إلى IEEE 802.15.4 العنوان القصير.

otLinkGetSupportedChannelMask

uint32_t otLinkGetSupportedChannelMask(
  otInstance *aInstance
)

الحصول على قناع القناة المتوافق من طبقة MAC.

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

طلبات الإرجاع

قناع القناة المتوافق باسم uint32_t مع تعيين البت 0 (lsb) إلى القناة 0، البت 1 إلى القناة 1، وهكذا.

otLinkGetTxDirectRedirectSuccessHistogram

const uint32_t * otLinkGetTxDirectRetrySuccessHistogram(
  otInstance *aInstance,
  uint8_t *aNumberOfEntries
)

تحصل هذه الطريقة على مدرج تكراري لإعادة المحاولة لحزمة مباشرة واحدة حتى ينجح.

هذه الدالة صالحة عندما يتم تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE.

التفاصيل

المعلَمات

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

طلبات الإرجاع

مؤشر على المدرّج التكراري لإعادة المحاولة (في شكل مصفوفة). يشير العنصر n-th إلى أنه تم إرسال الحزمة مع إعادة المحاولة n-th.

otLinkGetTxInDirectRedirectSuccessHistogram

const uint32_t * otLinkGetTxIndirectRetrySuccessHistogram(
  otInstance *aInstance,
  uint8_t *aNumberOfEntries
)

تحصل هذه الطريقة على مدرج تكراري لإعادة المحاولة لحزمة واحدة غير مباشرة حتى ينجح.

هذه الدالة صالحة عندما يتم تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE.

التفاصيل

المعلَمات

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

طلبات الإرجاع

otLinkIsActiveScanInPROGRESS

bool otLinkIsActiveScanInProgress(
  otInstance *aInstance
)

تشير هذه الدالة إلى ما إذا كان الفحص النشط IEEE 802.15.4 قيد التقدم حاليًا أم لا.

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

طلبات الإرجاع

صحيح إذا كان IEEE 802.15.4 Active يشير إلى أن "المسح الضوئي قيد التقدم"، وخطأ على false.

otLinkIsEnabled

bool otLinkIsEnabled(
  otInstance *aInstance
)

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

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

قيم الإرجاع

`true`	تم تفعيل طبقة الرابط.
`false`	طبقة الرابط غير مفعّلة.

otLinkIsEnergyScanInPROGRESS

bool otLinkIsEnergyScanInProgress(
  otInstance *aInstance
)

وتوضّح هذه الدالة ما إذا كان فحص IEEE 802.15.4 للطاقة قيد التقدم حاليًا أم لا.

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

طلبات الإرجاع

صحيح إذا كان بحث IEEE 802.15.4 Energy قيد التقدم، أو false إذا لم يكن قيد المتابعة.

otLinkIsInTransmitState

bool otLinkIsInTransmitState(
  otInstance *aInstance
)

تشير هذه الدالة إلى ما إذا كان عنوان IEEE 802.15.4 MAC في حالة الإرسال أم لا.

وحدة MAC في حالة الإرسال أثناء إجراء CSMA/CA، أو CCA، أو Data، أو الإشارة أو نقل إطار طلب البيانات، وتتلقّى ACK لإطار منقول. وحدة MAC ليست في حالة الإرسال أثناء نقل إطار ACK أو إطار طلب إشارة.

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

طلبات الإرجاع

صحيح إذا كان IEEE 802.15.4 MAC في حالة الإرسال، أو false في الحالات الأخرى.

otLinkIsPromiscuous

bool otLinkIsPromiscuous(
  otInstance *aInstance
)

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

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

قيم الإرجاع

`true`	تم تفعيل وضع المشاعر.
`false`	لم يتم تفعيل وضع المشاعر.

otLinkIsRadioFilterEnabled

bool otLinkIsRadioFilterEnabled(
  otInstance *aInstance
)

تشير هذه الدالة إلى ما إذا كان فلتر راديو IEEE 802.15.4 مفعلاً أم لا.

تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.

التفاصيل

قيم الإرجاع

`TRUE`	في حال تفعيل فلتر الراديو.
`FALSE`	في حال إيقاف فلتر الراديو.

otLinkإعادة تعيين العدادات

void otLinkResetCounters(
  otInstance *aInstance
)

أعِد ضبط عدّادات طبقة MAC.

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

otLinkresetTxRelaunchSuccessHistogram

void otLinkResetTxRetrySuccessHistogram(
  otInstance *aInstance
)

وتمكّن هذه الطريقة من محو إحصاءات التردد الرسومي لعمليات الانتقال المباشرة وغير المباشرة.

هذه الدالة صالحة عندما يتم تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE.

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

otLinkSendDataRequest

otError otLinkSendDataRequest(
  otInstance *aInstance
)

تُدرِج هذه الدالة رسالة طلب بيانات في IEEE 802.15.4 لنقلها.

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

قيم الإرجاع

`OT_ERROR_NONE`	تم إدراج رسالة طلب بيانات IEEE 802.15.4 في قائمة الانتظار بنجاح.
`OT_ERROR_ALREADY`	تمت إضافة رسالة طلب بيانات IEEE 802.15.4 إلى قائمة الانتظار بالفعل.
`OT_ERROR_INVALID_STATE`	الجهاز ليس في وضع rx-off-when خمول.
`OT_ERROR_NO_BUFS`	يتوفّر مخازن غير كافية للرسائل.

otLinkSendEmptyData

otError otLinkSendEmptyData(
  otInstance *aInstance
)

توجِّه هذه الدالة الجهاز إلى إرسال إطار بيانات IEEE 802.15.4 فارغ.

لا تتوافق هذه الوظيفة إلا مع جهاز Rx-Off-متى كان غير نشط لإرسال إطار بيانات فارغ إلى العنصر الرئيسي. ملاحظة: متاح فقط عند تفعيل OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

التفاصيل

المعلَمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

قيم الإرجاع

`OT_ERROR_NONE`	تمّ إدراج رسالة فارغة في قائمة الانتظار.
`OT_ERROR_INVALID_STATE`	الجهاز ليس في وضع Rx-Off-عند الخمول.
`OT_ERROR_NO_BUFS`	يتوفّر مخازن غير كافية للرسائل.

otLinkSetChannel

otError otLinkSetChannel(
  otInstance *aInstance,
  uint8_t aChannel
)

ضبط قناة IEEE 802.15.4

لا تعمل هذه الدالة إلا عند إيقاف بروتوكولات سلاسل المحادثات. ويؤدي استدعاء ناجح لهذه الدالة إلى إلغاء مجموعات البيانات التشغيلية النشطة والتي تنتظر المراجعة في الذاكرة غير المتقلبة.

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aChannel`	قناة IEEE 802.15.4

قيم الإرجاع

`OT_ERROR_NONE`	تم ضبط القناة بنجاح.
`OT_ERROR_INVALID_ARGS`	إذا لم يكن `aChannel` في النطاق [11، 26] أو ليس في قناع القناة المعتمد.
`OT_ERROR_INVALID_STATE`	تم تفعيل بروتوكولات سلاسل المحادثات.

راجع أيضًا:
otLinkGetChannel

otLinkSetEnabled

otError otLinkSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

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

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aEnable`	صحيح لتفعيل طبقة الرابط، أو خطأ في غير ذلك.

قيم الإرجاع

`OT_ERROR_NONE`	تم تفعيل / إيقاف طبقة الرابط بنجاح.
`OT_ERROR_INVALID_STATE`	تعذّر إيقاف طبقة الرابط بسبب تفعيل واجهة سلسلة المحادثات.

otLinkSetExpandAddress

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

تحدد هذه الدالة العنوان IEEE 802.15.4 الموسَّع.

لا تعمل هذه الدالة إلا عند إيقاف بروتوكولات سلاسل المحادثات.

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aExtAddress`	مؤشر إلى العنوان IEEE 802.15.4 الموسَّع.

قيم الإرجاع

`OT_ERROR_NONE`	إعداد IEEE 802.15.4 العنوان الموسّع بنجاح.
`OT_ERROR_INVALID_ARGS`	كان `aExtAddress` فارغًا.
`OT_ERROR_INVALID_STATE`	تم تفعيل بروتوكولات سلاسل المحادثات.

otLinkSetMaxFrameRetriesDirect

void otLinkSetMaxFrameRetriesDirect(
  otInstance *aInstance,
  uint8_t aMaxFrameRetriesDirect
)

تحدد هذه الطريقة الحد الأقصى لعدد إعادة محاولة عرض الإطارات أثناء النقل المباشر.

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aMaxFrameRetriesDirect`	الحد الأقصى لعدد إعادة المحاولة أثناء النقل المباشر.

otLinkSetMaxFrameRetriesIndirect

void otLinkSetMaxFrameRetriesIndirect(
  otInstance *aInstance,
  uint8_t aMaxFrameRetriesIndirect
)

تحدد هذه الطريقة الحد الأقصى لعدد إعادة محاولة عرض الإطارات أثناء النقل غير المباشر.

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aMaxFrameRetriesIndirect`	الحد الأقصى لعدد إعادة المحاولة أثناء النقل غير المباشر.

otLinkSetPanId

otError otLinkSetPanId(
  otInstance *aInstance,
  otPanId aPanId
)

اضبُط معرّف PANEE 802.15.4 PAN.

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aPanId`	معرّف PANEE 802.15.4 PAN

قيم الإرجاع

`OT_ERROR_NONE`	تم ضبط رقم PAN بنجاح.
`OT_ERROR_INVALID_ARGS`	إذا لم يكن APanId في النطاق [0، 65534].
`OT_ERROR_INVALID_STATE`	تم تفعيل بروتوكولات سلاسل المحادثات.

اطّلع أيضًا على:
otLinkGetPanId

otLinkSetPcapCallback

void otLinkSetPcapCallback(
  otInstance *aInstance,
  otLinkPcapCallback aPcapCallback,
  void *aCallbackContext
)

تسجِّل هذه الدالة رد اتصال لتوفير إطارات IEEE 802.15.4 أولية مُستلَمة.

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aPcapCallback`	مؤشر للدالة التي يتم استدعاءها عند استلام إطار رابط IEEE 802.15.4 أو فارغ لإيقاف معاودة الاتصال.
`[in] aCallbackContext`	مؤشر للسياق الخاص بالتطبيق.

otLinkSetPollPeriod

otError otLinkSetPollPeriod(
  otInstance *aInstance,
  uint32_t aPollPeriod
)

إعداد/محو فترة استطلاع البيانات الخارجية أو المحدَّدة من قِبل المستخدم في الجهاز النهائي الذي يتسم بالنعاس.

ملاحظة: تعمل هذه الدالة على تعديل فترة الاستطلاع فقط للجهاز النهائي الذي أصبح نائمًا. لتحديث المهلة الفرعية، سيتم استدعاء الدالة otThreadSetChildTimeout().

ملاحظة: يجب أن تكون القيمة الدنيا غير الصفر OPENTHREAD_CONFIG_MAC_MINIMUM_POLL_PERIOD (10 ملّي ثانية). أو صفر لمحو فترة الاستطلاع التي حدّدها المستخدم.

ملاحظة: يجب ألا تكون القيمة التي حدّدها المستخدم أعلى من الحد الأقصى للقيمة 0x3FFFFFF (1 << 26) - 1) والعكس صحيح. سيتم اقتصاصها من خلال القيمة القصوى.

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aPollPeriod`	فترة استطلاع البيانات بالمللي ثانية.

قيم الإرجاع

`OT_ERROR_NONE`	تم ضبط/محو فترة الاستطلاع التي يحددها المستخدم بنجاح.
`OT_ERROR_INVALID_ARGS`	إذا كان PollPeriod غير صالح.

اطّلع أيضًا على:
otLinkGetPollPeriod

otLinkSetPromiscuous

otError otLinkSetPromiscuous(
  otInstance *aInstance,
  bool aPromiscuous
)

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

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aPromiscuous`	صحيح لتفعيل وضع المشاع، أو خطأ في الحالات الأخرى.

قيم الإرجاع

`OT_ERROR_NONE`	تم تفعيل وضع المشاربة بنجاح.
`OT_ERROR_INVALID_STATE`	تعذّر تفعيل الوضع المتنوّع بسبب تفعيل واجهة سلسلة المحادثات.

otLinkSetRadioFilterEnabled

void otLinkSetRadioFilterEnabled(
  otInstance *aInstance,
  bool aFilterEnabled
)

تعمل هذه الوظيفة على تفعيل/إيقاف وضع فلتر الراديو IEEE 802.15.4.

تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.

والهدف من تطبيق فلتر الراديو في المقام الأول هو الاختبار. ويمكن استخدامه لحظر جميع أجهزة tx/rx مؤقتًا على الراديو 802.15.4. عند تفعيل فلتر الراديو، يتم ضبط الراديو على وضع السكون بدلاً من استلامه (لضمان عدم تلقّي الجهاز لأي إطار و/أو قد يتم إرسال حزمه). كما يتم إرجاع طلبات إرسال الإطارات فورًا بدون إرسال الإطار فوق الهواء (يتم عرض رسالة الخطأ "لا توجد حزم" في حالة طلب ack، وإلا فإن إرجاع العملية ناجح).

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aFilterEnabled`	TRUE لتفعيل فلتر الراديو، اضغط على FALSE لإيقافه.

otLinkSetSupportedChannelMask

otError otLinkSetSupportedChannelMask(
  otInstance *aInstance,
  uint32_t aChannelMask
)

إعداد قناع القناة المتوافق لطبقة MAC.

لا تعمل هذه الدالة إلا عند إيقاف بروتوكولات سلاسل المحادثات.

التفاصيل

المعلَمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aChannelMask`	قناع القناة المعتمد (البت 0 أو ربط lsb بالقناة 0 وما إلى ذلك).

قيم الإرجاع

`OT_ERROR_NONE`	تم ضبط قناع القناة بنجاح.
`OT_ERROR_INVALID_STATE`	تم تفعيل بروتوكولات سلاسل المحادثات.

وحدات ماكرو

OT_MAC_FILTER_FIXED_RSS_DISABLED

 OT_MAC_FILTER_FIXED_RSS_DISABLED 127

يُستخدم للإشارة إلى عدم ضبط قوة إشارة الاستلام الثابتة.

OT_MAC_FILTER_ITERATOR_INIT

 OT_MAC_FILTER_ITERATOR_INIT 0

أداة إعداد otMacFilterIterator.

OT_US_PER_TEN_SYMBOLS

 OT_US_PER_TEN_SYMBOLS 160

الميكرو ثانية لكل 10 رموز.

المراجع

تنشأ مواضيع واجهة برمجة التطبيقات المرجعية لـ OpenThread من رمز المصدر، المتوفر على GitHub. للاطّلاع على مزيد من المعلومات أو للمساهمة في مستنداتنا، يُرجى الرجوع إلى المراجع.

ربط

الملخّص

التعدادات

مواقد الخط

الدوال

التشريعات

التعدادات

otMacFilterAddressMode

مواقد الخط

otActiveScanResult

otEnergyScanResult

otHandleActiveScanResult

otHandleEnergyEnergyResult

otLinkPcapCallback

otMacCounters

otMacFilterAddressMode

otMacFilterEntry

otMacFilterIterator

otthreadLinkInfo

الدوال

otLinkActiveScan

otLinkConverLinkLinkToRss

otLinkConverRsToLinkquality

otLinkCslGetChannel

otLinkCslGetPeriod

otLinkCslGetTimeout

otLinkCslSetChannel

otLinkCslSetPeriod

otLinkCslSetTimeout

otLinkEnergyScan

otLinkFilterAddAddress

otLinkFilterAddRsIn

otLinkFilterClearAddresses

otLinkFilterClearAllRssIn

otLinkFilterClearDefaultRssIn

otLinkFilterGetAddressMode

otLinkFilterGetNextAddress

otLinkFilterGetNextRssIn

otLinkFilterRemoveAddress

otLinkFilterRemoveRssIn

otLinkFilterSetAddressMode

otLinkFilterSetDefaultRssIn

otLinkGetCCaFailureRate

otLinkGetChannel

otLinkGetCounters

otLinkGetExpandAddress

otLinkGetfactoryAssignIeeeEui64

otLinkGetMaxFrameRetriesDirect

otLinkGetMaxFrameRetriesIndirect

otLinkGetPanId

otLinkGetPollPeriod

otLinkGetShortAddress

otLinkGetSupportedChannelMask

otLinkGetTxDirectRedirectSuccessHistogram

otLinkGetTxInDirectRedirectSuccessHistogram

otLinkIsActiveScanInPROGRESS

otLinkIsEnabled

otLinkIsEnergyScanInPROGRESS

otLinkIsInTransmitState

otLinkIsPromiscuous

otLinkIsRadioFilterEnabled

otLinkإعادة تعيين العدادات

otLinkresetTxRelaunchSuccessHistogram

otLinkSendDataRequest

otLinkSendEmptyData

otLinkSetChannel

otLinkSetEnabled

otLinkSetExpandAddress

otLinkSetMaxFrameRetriesDirect

otLinkSetMaxFrameRetriesIndirect

otLinkSetPanId

otLinkSetPcapCallback

otLinkSetPollPeriod

otLinkSetPromiscuous

otLinkSetRadioFilterEnabled

otLinkSetSupportedChannelMask

وحدات ماكرو

OT_MAC_FILTER_FIXED_RSS_DISABLED

OT_MAC_FILTER_ITERATOR_INIT

OT_US_PER_TEN_SYMBOLS