ربط
تشمل هذه الوحدة وظائف تتحكم في إعداد طبقة الرابط.
الملخّص
التعدادات |
|
---|---|
otMacFilterAddressMode{
|
تعداد يحدّد وضع العنوان لفلتر Mac. |
مواقد الخط |
|
---|---|
otActiveScanResult
|
مَعلمة typetypestruct otActiveScanResult
تمثل هذه البنية الإشارة الواردة إلى IEEE 802.15.4. |
otEnergyScanResult
|
مَعلمة typetypestruct otEnergyScanResult
تمثّل هذه البنية نتيجة فحص الطاقة. |
otHandleActiveScanResult)(otActiveScanResult *aResult, void *aContext)
|
مَعلمة typetypevoid(*
يتم استدعاء مؤشر الدالة هذا أثناء عملية مسح ضوئي لـ IEEE 802.15.4 عند تلقي إشارة IEEE 802.15.4 أو إكمال عملية المسح. |
otHandleEnergyScanResult)(otEnergyScanResult *aResult, void *aContext)
|
مَعلمة typetypevoid(*
يتم استدعاء مؤشر الدالة هذا أثناء IEEE 802.15.4 Energy Scan عندما تكون نتيجة القناة جاهزة أو اكتمال الفحص. |
otLinkPcapCallback)(const otRadioFrame *aFrame, bool aIsTx, void *aContext)
|
مَعلمة typetypevoid(*
يتم استدعاء مؤشر الدالة هذا عند استلام إطار IEEE 802.15.4. |
otMacCounters
|
مَعلمة typetypestruct otMacCounters
تمثل هذه البنية عدّادات طبقة MAC. |
otMacFilterAddressMode
|
مَعلمة typetype يحدّد وضع العنوان لفلتر Mac. |
otMacFilterEntry
|
مَعلمة typetypestruct otMacFilterEntry
تمثل هذه البنية إدخال فلتر Mac. |
otMacFilterIterator
|
مَعلمة typetypeuint8_t
يُستخدَم للردّ من خلال إدخالات فلاتر Mac. |
otThreadLinkInfo
|
مَعلمة typetypestruct otThreadLinkInfo
تمثّل هذه البنية المعلومات الخاصة بالرابط للرسائل التي يتم استلامها من راديو سلسلة المحادثات. |
الدوال |
|
---|---|
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 |
تمثّل هذه البنية المعلومات الخاصة بالرابط للرسائل التي يتم استلامها من راديو سلسلة المحادثات. |
التعدادات
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.
otHandleActiveScanResult
void(* otHandleActiveScanResult)(otActiveScanResult *aResult, void *aContext)
يتم استدعاء مؤشر الدالة هذا أثناء عملية مسح ضوئي لـ IEEE 802.15.4 عند تلقي إشارة IEEE 802.15.4 أو إكمال عملية المسح.
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
otHandleEnergyEnergyResult
void(* otHandleEnergyScanResult)(otEnergyScanResult *aResult, void *aContext)
يتم استدعاء مؤشر الدالة هذا أثناء IEEE 802.15.4 Energy Scan عندما تكون نتيجة القناة جاهزة أو اكتمال الفحص.
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
otLinkPcapCallback
void(* otLinkPcapCallback)(const otRadioFrame *aFrame, bool aIsTx, void *aContext)
يتم استدعاء مؤشر الدالة هذا عند استلام إطار IEEE 802.15.4.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلَمات |
|
otMacFilterAddressMode
enum otMacFilterAddressMode otMacFilterAddressMode
يحدّد وضع العنوان لفلتر 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 نشط.
التفاصيل | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||||||
قيم الإرجاع |
|
otLinkConverLinkLinkToRss
int8_t otLinkConvertLinkQualityToRss( otInstance *aInstance, uint8_t aLinkQuality )
تحوّل هذه الطريقة جودة الرابط إلى قوة الإشارة المُستلَمة العادية.
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
||||
طلبات الإرجاع |
تلقى النظام الأساسي العادي تعيين قوة الإشارة إلى
aLinkQuality . |
otLinkConverRsToLinkquality
uint8_t otLinkConvertRssToLinkQuality( otInstance *aInstance, int8_t aRss )
تحوّل هذه الطريقة قوة الإشارة المستلمة إلى جودة الرابط.
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
||||
طلبات الإرجاع |
ربط ربط جودة الجودة بـ
aRss . |
otLinkCslGetChannel
uint8_t otLinkCslGetChannel( otInstance *aInstance )
تحصل هذه الدالة على قناة CSL.
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
||
طلبات الإرجاع |
قناة CSL
|
otLinkCslGetPeriod
uint16_t otLinkCslGetPeriod( otInstance *aInstance )
تحصل هذه الدالة على فترة CSL.
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
||
طلبات الإرجاع |
فترة CSL بوحدات 10 رموز.
|
otLinkCslGetTimeout
uint32_t otLinkCslGetTimeout( otInstance *aInstance )
تحصل هذه الدالة على مهلة CSL.
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
||
طلبات الإرجاع |
انتهت مهلة CSL بالثواني.
|
otLinkCslSetChannel
otError otLinkCslSetChannel( otInstance *aInstance, uint8_t aChannel )
تحدد هذه الدالة قناة CSL.
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
||||
قيم الإرجاع |
|
otLinkCslSetPeriod
otError otLinkCslSetPeriod( otInstance *aInstance, uint16_t aPeriod )
تحدّد هذه الدالة الفترة CSL.
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
||||
قيم الإرجاع |
|
otLinkCslSetTimeout
otError otLinkCslSetTimeout( otInstance *aInstance, uint32_t aTimeout )
تحدّد هذه الدالة مهلة CSL.
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
||||
قيم الإرجاع |
|
otLinkEnergyScan
otError otLinkEnergyScan( otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleEnergyScanResult aCallback, void *aCallbackContext )
تبدأ هذه الدالة فحص IEEE 802.15.4 للطاقة.
التفاصيل | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||||||
قيم الإرجاع |
|
otLinkFilterAddAddress
otError otLinkFilterAddAddress( otInstance *aInstance, const otExtAddress *aExtAddress )
تضيف هذه الطريقة عنوانًا موسَّعًا إلى فلتر MAC.
تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
||||
قيم الإرجاع |
|
otLinkFilterAddRsIn
otError otLinkFilterAddRssIn( otInstance *aInstance, const otExtAddress *aExtAddress, int8_t aRss )
تضيف هذه الطريقة إدخال قوة إشارة مستلمة ثابتة (بالديسيبل ميلي واط) للرسائل من عنوان موسع محدد في فلتر MAC.
تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||
قيم الإرجاع |
|
otLinkFilterClearAddresses
void otLinkFilterClearAddresses( otInstance *aInstance )
تعمل هذه الطريقة على محو جميع العناوين الموسّعة من فلتر MAC.
تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
otLinkFilterClearAllRssIn
void otLinkFilterClearAllRssIn( otInstance *aInstance )
تعمل هذه الطريقة على محو جميع إدخالات مدى قوة الإشارة التي تم استلامها (بما في ذلك تنسيق RSS التلقائي) في فلتر MAC.
تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
otLinkFilterClearDefaultRssIn
void otLinkFilterClearDefaultRssIn( otInstance *aInstance )
وتمحو هذه الطريقة أي قوة إشارة تلقائية مُستلَمة سابقًا (بديسيبل ملي واط) في فلتر MAC.
تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
otLinkFilterGetAddressMode
otMacFilterAddressMode otLinkFilterGetAddressMode( otInstance *aInstance )
تحصل هذه الدالة على وضع العنوان لفلتر MAC.
تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
||
طلبات الإرجاع |
في وضع العنوان.
|
otLinkFilterGetNextAddress
otError otLinkFilterGetNextAddress( otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry )
تتلقى هذه الطريقة إدخال فلتر عنوان قيد الاستخدام.
تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||
قيم الإرجاع |
|
otLinkFilterGetNextRssIn
otError otLinkFilterGetNextRssIn( otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry )
تحصل هذه الطريقة على إدخال فلتر RssIn قيد الاستخدام.
تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||
قيم الإرجاع |
|
otLinkFilterRemoveAddress
void otLinkFilterRemoveAddress( otInstance *aInstance, const otExtAddress *aExtAddress )
تؤدي هذه الطريقة إلى إزالة العنوان الموسَّع من فلتر MAC.
تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.
لا يتم تنفيذ أي إجراء في حال عدم توفّر إدخال حالي في الفلتر يطابق "العنوان الموسّع".
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
otLinkFilterRemoveRssIn
void otLinkFilterRemoveRssIn( otInstance *aInstance, const otExtAddress *aExtAddress )
تزيل هذه الطريقة إدخال فلتر MAC لإعداد قوة إشارة الاستلام الثابتة لعنوان موسَّع محدَّد.
تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.
لا يتم تنفيذ أي إجراء في حال عدم توفّر إدخال حالي في الفلتر يطابق "العنوان الموسّع".
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
otLinkFilterSetAddressMode
void otLinkFilterSetAddressMode( otInstance *aInstance, otMacFilterAddressMode aMode )
تضبط هذه الدالة وضع العنوان لفلتر MAC.
تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
otLinkFilterSetDefaultRssIn
void otLinkFilterSetDefaultRssIn( otInstance *aInstance, int8_t aRss )
تضبط هذه الطريقة قوة الإشارة التلقائية التي تم استلامها (بالديسيبل ميلي واط) على فلتر MAC.
تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.
يتم استخدام قيمة RSS التلقائية لجميع الإطارات المُستلَمة من العناوين التي لا يتوفّر لها إدخال RSS-IN صريح في قائمة الفلاتر (تتم الإضافة باستخدام otLinkFilterAddRssIn()
).
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
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
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
||
طلبات الإرجاع |
قناة IEEE 802.15.4
|
otLinkSetChannel
otLinkGetCounters
const otMacCounters * otLinkGetCounters( otInstance *aInstance )
احصل على عدّادات طبقة MAC.
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
||
طلبات الإرجاع |
مؤشر إلى عدّادات MAC.
|
otLinkGetExpandAddress
const otExtAddress * otLinkGetExtendedAddress( otInstance *aInstance )
احصل على العنوان IEEE 802.15.4 الموسَّع.
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
||
طلبات الإرجاع |
مؤشر إلى العنوان IEEE 802.15.4 الموسَّع.
|
otLinkGetfactoryAssignIeeeEui64
void otLinkGetFactoryAssignedIeeeEui64( otInstance *aInstance, otExtAddress *aEui64 )
احصل على IEEE EU-64 الذي تم تخصيصه من المصنع.
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
otLinkGetMaxFrameRetriesDirect
uint8_t otLinkGetMaxFrameRetriesDirect( otInstance *aInstance )
تعرض هذه الطريقة الحد الأقصى لعدد إعادة محاولة عرض الإطارات أثناء النقل المباشر.
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
||
طلبات الإرجاع |
الحد الأقصى لعدد إعادة المحاولة أثناء النقل المباشر.
|
otLinkGetMaxFrameRetriesIndirect
uint8_t otLinkGetMaxFrameRetriesIndirect( otInstance *aInstance )
تعرض هذه الطريقة الحد الأقصى لعدد إعادة محاولة عرض الإطارات أثناء النقل غير المباشر.
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
||
طلبات الإرجاع |
الحد الأقصى لعدد إعادة المحاولة أثناء النقل غير المباشر.
|
otLinkGetPanId
otPanId otLinkGetPanId( otInstance *aInstance )
احصل على رقم تعريف PANEE 802.15.4 PAN.
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
||
طلبات الإرجاع |
معرّف PANEE 802.15.4 PAN
|
otLinkSetPanId
otLinkGetPollPeriod
uint32_t otLinkGetPollPeriod( otInstance *aInstance )
يمكنك الحصول على فترة استطلاع البيانات لجهاز ناعس.
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
||
طلبات الإرجاع |
فترة استطلاع البيانات للجهاز النهائي المُخصَّص للنوم، بالمللي ثانية.
|
otLinkSetPollPeriod
otLinkGetShortAddress
otShortAddress otLinkGetShortAddress( otInstance *aInstance )
احصل على العنوان القصير IEEE 802.15.4.
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
||
طلبات الإرجاع |
مؤشر إلى IEEE 802.15.4 العنوان القصير.
|
otLinkGetSupportedChannelMask
uint32_t otLinkGetSupportedChannelMask( otInstance *aInstance )
الحصول على قناع القناة المتوافق من طبقة MAC.
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
||
طلبات الإرجاع |
قناع القناة المتوافق باسم
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.
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
||||
طلبات الإرجاع |
مؤشر على المدرّج التكراري لإعادة المحاولة (في شكل مصفوفة). يشير العنصر n-th إلى أنه تم إرسال الحزمة مع إعادة المحاولة n-th.
|
otLinkGetTxInDirectRedirectSuccessHistogram
const uint32_t * otLinkGetTxIndirectRetrySuccessHistogram( otInstance *aInstance, uint8_t *aNumberOfEntries )
تحصل هذه الطريقة على مدرج تكراري لإعادة المحاولة لحزمة واحدة غير مباشرة حتى ينجح.
هذه الدالة صالحة عندما يتم تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE.
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
||||
طلبات الإرجاع |
مؤشر على المدرّج التكراري لإعادة المحاولة (في شكل مصفوفة). يشير العنصر n-th إلى أنه تم إرسال الحزمة مع إعادة المحاولة n-th.
|
otLinkIsActiveScanInPROGRESS
bool otLinkIsActiveScanInProgress( otInstance *aInstance )
تشير هذه الدالة إلى ما إذا كان الفحص النشط IEEE 802.15.4 قيد التقدم حاليًا أم لا.
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
||
طلبات الإرجاع |
صحيح إذا كان IEEE 802.15.4 Active يشير إلى أن "المسح الضوئي قيد التقدم"، وخطأ على false.
|
otLinkIsEnabled
bool otLinkIsEnabled( otInstance *aInstance )
وتوضّح هذه الدالة ما إذا كانت طبقة الروابط مفعّلة أم لا.
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
||||
قيم الإرجاع |
|
otLinkIsEnergyScanInPROGRESS
bool otLinkIsEnergyScanInProgress( otInstance *aInstance )
وتوضّح هذه الدالة ما إذا كان فحص IEEE 802.15.4 للطاقة قيد التقدم حاليًا أم لا.
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
||
طلبات الإرجاع |
صحيح إذا كان بحث IEEE 802.15.4 Energy قيد التقدم، أو false إذا لم يكن قيد المتابعة.
|
otLinkIsInTransmitState
bool otLinkIsInTransmitState( otInstance *aInstance )
تشير هذه الدالة إلى ما إذا كان عنوان IEEE 802.15.4 MAC في حالة الإرسال أم لا.
وحدة MAC في حالة الإرسال أثناء إجراء CSMA/CA، أو CCA، أو Data، أو الإشارة أو نقل إطار طلب البيانات، وتتلقّى ACK لإطار منقول. وحدة MAC ليست في حالة الإرسال أثناء نقل إطار ACK أو إطار طلب إشارة.
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
||
طلبات الإرجاع |
صحيح إذا كان IEEE 802.15.4 MAC في حالة الإرسال، أو false في الحالات الأخرى.
|
otLinkIsPromiscuous
bool otLinkIsPromiscuous( otInstance *aInstance )
تحدّد هذه الدالة ما إذا كان قد تم تفعيل وضع المبهر في طبقة الرابط أم لا.
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
||||
قيم الإرجاع |
|
otLinkIsRadioFilterEnabled
bool otLinkIsRadioFilterEnabled( otInstance *aInstance )
تشير هذه الدالة إلى ما إذا كان فلتر راديو IEEE 802.15.4 مفعلاً أم لا.
تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.
التفاصيل | |||||
---|---|---|---|---|---|
قيم الإرجاع |
|
otLinkإعادة تعيين العدادات
void otLinkResetCounters( otInstance *aInstance )
أعِد ضبط عدّادات طبقة MAC.
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
otLinkresetTxRelaunchSuccessHistogram
void otLinkResetTxRetrySuccessHistogram( otInstance *aInstance )
وتمكّن هذه الطريقة من محو إحصاءات التردد الرسومي لعمليات الانتقال المباشرة وغير المباشرة.
هذه الدالة صالحة عندما يتم تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE.
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
otLinkSendDataRequest
otError otLinkSendDataRequest( otInstance *aInstance )
تُدرِج هذه الدالة رسالة طلب بيانات في IEEE 802.15.4 لنقلها.
التفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||||
قيم الإرجاع |
|
otLinkSendEmptyData
otError otLinkSendEmptyData( otInstance *aInstance )
توجِّه هذه الدالة الجهاز إلى إرسال إطار بيانات IEEE 802.15.4 فارغ.
لا تتوافق هذه الوظيفة إلا مع جهاز Rx-Off-متى كان غير نشط لإرسال إطار بيانات فارغ إلى العنصر الرئيسي. ملاحظة: متاح فقط عند تفعيل OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||
قيم الإرجاع |
|
otLinkSetChannel
otError otLinkSetChannel( otInstance *aInstance, uint8_t aChannel )
ضبط قناة IEEE 802.15.4
لا تعمل هذه الدالة إلا عند إيقاف بروتوكولات سلاسل المحادثات. ويؤدي استدعاء ناجح لهذه الدالة إلى إلغاء مجموعات البيانات التشغيلية النشطة والتي تنتظر المراجعة في الذاكرة غير المتقلبة.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||
قيم الإرجاع |
|
otLinkGetChannel
otLinkSetEnabled
otError otLinkSetEnabled( otInstance *aInstance, bool aEnable )
تعمل هذه الدالة على تفعيل طبقة الرابط أو إيقافها.
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
||||
قيم الإرجاع |
|
otLinkSetExpandAddress
otError otLinkSetExtendedAddress( otInstance *aInstance, const otExtAddress *aExtAddress )
تحدد هذه الدالة العنوان IEEE 802.15.4 الموسَّع.
لا تعمل هذه الدالة إلا عند إيقاف بروتوكولات سلاسل المحادثات.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||
قيم الإرجاع |
|
otLinkSetMaxFrameRetriesDirect
void otLinkSetMaxFrameRetriesDirect( otInstance *aInstance, uint8_t aMaxFrameRetriesDirect )
تحدد هذه الطريقة الحد الأقصى لعدد إعادة محاولة عرض الإطارات أثناء النقل المباشر.
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
otLinkSetMaxFrameRetriesIndirect
void otLinkSetMaxFrameRetriesIndirect( otInstance *aInstance, uint8_t aMaxFrameRetriesIndirect )
تحدد هذه الطريقة الحد الأقصى لعدد إعادة محاولة عرض الإطارات أثناء النقل غير المباشر.
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
otLinkSetPanId
otError otLinkSetPanId( otInstance *aInstance, otPanId aPanId )
اضبُط معرّف PANEE 802.15.4 PAN.
لا تعمل هذه الدالة إلا عند إيقاف بروتوكولات سلاسل المحادثات. ويؤدي استدعاء ناجح لهذه الدالة إلى إلغاء مجموعات البيانات التشغيلية النشطة والتي تنتظر المراجعة في الذاكرة غير المتقلبة.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||
قيم الإرجاع |
|
otLinkGetPanId
otLinkSetPcapCallback
void otLinkSetPcapCallback( otInstance *aInstance, otLinkPcapCallback aPcapCallback, void *aCallbackContext )
تسجِّل هذه الدالة رد اتصال لتوفير إطارات IEEE 802.15.4 أولية مُستلَمة.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلَمات |
|
otLinkSetPollPeriod
otError otLinkSetPollPeriod( otInstance *aInstance, uint32_t aPollPeriod )
إعداد/محو فترة استطلاع البيانات الخارجية أو المحدَّدة من قِبل المستخدم في الجهاز النهائي الذي يتسم بالنعاس.
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
||||
قيم الإرجاع |
|
otLinkGetPollPeriod
otLinkSetPromiscuous
otError otLinkSetPromiscuous( otInstance *aInstance, bool aPromiscuous )
تعمل هذه الوظيفة على تفعيل أو إيقاف وضع الطبقة المشتركة.
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
||||
قيم الإرجاع |
|
otLinkSetRadioFilterEnabled
void otLinkSetRadioFilterEnabled( otInstance *aInstance, bool aFilterEnabled )
تعمل هذه الوظيفة على تفعيل/إيقاف وضع فلتر الراديو IEEE 802.15.4.
تتوفر هذه الدالة عند تفعيل ضبط OpenGLيجب أن تكون تهيئة OpenGL_CONFIG_MAC_FILTER_ENABLE.
والهدف من تطبيق فلتر الراديو في المقام الأول هو الاختبار. ويمكن استخدامه لحظر جميع أجهزة tx/rx مؤقتًا على الراديو 802.15.4. عند تفعيل فلتر الراديو، يتم ضبط الراديو على وضع السكون بدلاً من استلامه (لضمان عدم تلقّي الجهاز لأي إطار و/أو قد يتم إرسال حزمه). كما يتم إرجاع طلبات إرسال الإطارات فورًا بدون إرسال الإطار فوق الهواء (يتم عرض رسالة الخطأ "لا توجد حزم" في حالة طلب ack، وإلا فإن إرجاع العملية ناجح).
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
otLinkSetSupportedChannelMask
otError otLinkSetSupportedChannelMask( otInstance *aInstance, uint32_t aChannelMask )
إعداد قناع القناة المتوافق لطبقة MAC.
لا تعمل هذه الدالة إلا عند إيقاف بروتوكولات سلاسل المحادثات.
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
||||
قيم الإرجاع |
|
وحدات ماكرو
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. للاطّلاع على مزيد من المعلومات أو للمساهمة في مستنداتنا، يُرجى الرجوع إلى المراجع.