ربط

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

الملخّص

التعدادات

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

مواقد الخط

otActiveScanResult مَعلمة typetype
تمثل هذه البنية الإشارة الواردة إلى IEEE 802.15.4.
otEnergyScanResult مَعلمة typetype
تمثّل هذه البنية نتيجة فحص الطاقة.
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
يحدّد وضع العنوان لفلتر Mac.
otMacFilterEntry مَعلمة typetype
تمثل هذه البنية إدخال فلتر Mac.
otMacFilterIterator مَعلمة typetype
uint8_t
يُستخدَم للردّ من خلال إدخالات فلاتر Mac.
otThreadLinkInfo مَعلمة typetype
تمثّل هذه البنية المعلومات الخاصة بالرابط للرسائل التي يتم استلامها من راديو سلسلة المحادثات.

الدوال

otLinkActiveScan(otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleActiveScanResult aCallback, void *aCallbackContext)
تبدأ هذه الدالة فحص 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)
تحدد هذه الدالة قناة CSL.
otLinkCslSetPeriod(otInstance *aInstance, uint16_t aPeriod)
تحدّد هذه الدالة الفترة CSL.
otLinkCslSetTimeout(otInstance *aInstance, uint32_t aTimeout)
تحدّد هذه الدالة مهلة CSL.
otLinkEnergyScan(otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleEnergyScanResult aCallback, void *aCallbackContext)
تبدأ هذه الدالة فحص IEEE 802.15.4 للطاقة.
otLinkFilterAddAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
تضيف هذه الطريقة عنوانًا موسَّعًا إلى فلتر MAC.
otLinkFilterAddRssIn(otInstance *aInstance, const otExtAddress *aExtAddress, int8_t aRss)
تضيف هذه الطريقة إدخال قوة إشارة مستلمة ثابتة (بالديسيبل ميلي واط) للرسائل من عنوان موسع محدد في فلتر MAC.
otLinkFilterClearAddresses(otInstance *aInstance)
void
تعمل هذه الطريقة على محو جميع العناوين الموسّعة من فلتر MAC.
otLinkFilterClearAllRssIn(otInstance *aInstance)
void
تعمل هذه الطريقة على محو جميع إدخالات مدى قوة الإشارة التي تم استلامها (بما في ذلك تنسيق RSS التلقائي) في فلتر MAC.
otLinkFilterClearDefaultRssIn(otInstance *aInstance)
void
وتمحو هذه الطريقة أي قوة إشارة تلقائية مُستلَمة سابقًا (بديسيبل ملي واط) في فلتر MAC.
otLinkFilterGetAddressMode(otInstance *aInstance)
تحصل هذه الدالة على وضع العنوان لفلتر MAC.
otLinkFilterGetNextAddress(otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry)
تتلقى هذه الطريقة إدخال فلتر عنوان قيد الاستخدام.
otLinkFilterGetNextRssIn(otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry)
تحصل هذه الطريقة على إدخال فلتر 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)
احصل على رقم تعريف PANEE 802.15.4 PAN.
otLinkGetPollPeriod(otInstance *aInstance)
uint32_t
يمكنك الحصول على فترة استطلاع البيانات لجهاز ناعس.
otLinkGetShortAddress(otInstance *aInstance)
احصل على العنوان القصير 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)
تُدرِج هذه الدالة رسالة طلب بيانات في IEEE 802.15.4 لنقلها.
otLinkSendEmptyData(otInstance *aInstance)
توجِّه هذه الدالة الجهاز إلى إرسال إطار بيانات IEEE 802.15.4 فارغ.
otLinkSetChannel(otInstance *aInstance, uint8_t aChannel)
ضبط قناة IEEE 802.15.4
otLinkSetEnabled(otInstance *aInstance, bool aEnable)
تعمل هذه الدالة على تفعيل طبقة الرابط أو إيقافها.
otLinkSetExtendedAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
تحدد هذه الدالة العنوان IEEE 802.15.4 الموسَّع.
otLinkSetMaxFrameRetriesDirect(otInstance *aInstance, uint8_t aMaxFrameRetriesDirect)
void
تحدد هذه الطريقة الحد الأقصى لعدد إعادة محاولة عرض الإطارات أثناء النقل المباشر.
otLinkSetMaxFrameRetriesIndirect(otInstance *aInstance, uint8_t aMaxFrameRetriesIndirect)
void
تحدد هذه الطريقة الحد الأقصى لعدد إعادة محاولة عرض الإطارات أثناء النقل غير المباشر.
otLinkSetPanId(otInstance *aInstance, otPanId aPanId)
اضبُط معرّف PANEE 802.15.4 PAN.
otLinkSetPcapCallback(otInstance *aInstance, otLinkPcapCallback aPcapCallback, void *aCallbackContext)
void
تسجِّل هذه الدالة رد اتصال لتوفير إطارات IEEE 802.15.4 أولية مُستلَمة.
otLinkSetPollPeriod(otInstance *aInstance, uint32_t aPollPeriod)
إعداد/محو فترة استطلاع البيانات الخارجية أو المحدَّدة من قِبل المستخدم في الجهاز النهائي الذي يتسم بالنعاس.
otLinkSetPromiscuous(otInstance *aInstance, bool aPromiscuous)
تعمل هذه الوظيفة على تفعيل أو إيقاف وضع الطبقة المشتركة.
otLinkSetRadioFilterEnabled(otInstance *aInstance, bool aFilterEnabled)
void
تعمل هذه الوظيفة على تفعيل/إيقاف وضع فلتر الراديو IEEE 802.15.4.
otLinkSetSupportedChannelMask(otInstance *aInstance, uint32_t aChannelMask)
إعداد قناع القناة المتوافق لطبقة MAC.

التشريعات

otActiveScanResult

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

otEnergyScanResult

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

otMacCounters

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

otMacFilterEntry

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

otthreadLinkInfo

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

التعدادات

مواقد الخط

الدوال

وحدات ماكرو

المراجع

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