رابط

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

ملخّص

عمليات التعداد
otMacFilterAddressMode{
  OT_MAC_FILTER_ADDRESS_MODE_DISABLED,
  OT_MAC_FILTER_ADDRESS_MODE_ALLOWLIST,
  OT_MAC_FILTER_ADDRESS_MODE_DENYLIST
} 		تعداد
تحدِّد هذه السياسة وضع العنوان في فلتر mac.

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

الدوال
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
لتحويل قوة الإشارة المستلمة إلى جودة الرابط.
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)
إضافة العنوان الممتد المحدد إلى قائمة RssIn (أو تعديل عنوان حالي في قائمة RssIn) وضبط قوة الإشارة المستلمة (بالديسيبل بالمللي وات) للرسائل الواردة من هذا العنوان.
otLinkFilterClearAddresses(otInstance *aInstance)
void
يمحو جميع العناوين الموسعة من فلتر MAC.
otLinkFilterClearAllRssIn(otInstance *aInstance)
void
يؤدي ذلك إلى محو جميع إدخالات قوة الإشارة التي تم استلامها (rss) ومؤشر جودة الرابط (lqi) (بما في ذلك القيم التلقائية) من القائمة RssIn.
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
إزالة العنوان الموسّع المحدّد من قائمة RssIn
otLinkFilterSetAddressMode(otInstance *aInstance, otMacFilterAddressMode aMode)
void
تحدِّد هذه السياسة وضع العنوان لفلتر MAC.
otLinkFilterSetDefaultRssIn(otInstance *aInstance, int8_t aRss)
void
يضبط قوة الإشارة المُستلَمة التلقائية (بالديسيبل بالمللي وات) على فلتر MAC.
otLinkGetCcaFailureRate(otInstance *aInstance)
uint16_t
لعرض معدل الفشل الحالي في CCA (Clear Channel Assessment).
otLinkGetChannel(otInstance *aInstance)
uint8_t
الحصول على قناة IEEE 802.15.4
otLinkGetCounters(otInstance *aInstance)
const otMacCounters *
احصل على عدّادات طبقة MAC.
otLinkGetCslChannel(otInstance *aInstance)
uint8_t
يحصل على قناة CSL.
otLinkGetCslPeriod(otInstance *aInstance)
uint32_t
الحصول على فترة CSL بالميكرو ثانية.
otLinkGetCslTimeout(otInstance *aInstance)
uint32_t
يؤدي ذلك إلى تلقّي مهلة CSL.
otLinkGetExtendedAddress(otInstance *aInstance)
const otExtAddress *
الحصول على العنوان الموسع لمعيار IEEE 802.15.4
otLinkGetFactoryAssignedIeeeEui64(otInstance *aInstance, otExtAddress *aEui64)
void
احصل على مواصفات IEEE EUI-64 المخصّصة للمصنِّع.
otLinkGetMaxFrameRetriesDirect(otInstance *aInstance)
uint8_t
لعرض الحد الأقصى لعدد مرات إعادة محاولة استخدام الإطارات أثناء الإرسال المباشر.
otLinkGetMaxFrameRetriesIndirect(otInstance *aInstance)
uint8_t
لعرض الحد الأقصى لعدد مرات إعادة محاولة استخدام الإطارات أثناء الإرسال غير المباشر.
otLinkGetPanId(otInstance *aInstance)
يمكنك الحصول على رقم تعريف IEEE 802.15.4 لرقم PAN.
otLinkGetPollPeriod(otInstance *aInstance)
uint32_t
يمكنك الحصول على فترة استطلاع البيانات للجهاز النهائي الذي نومه.
otLinkGetRegion(otInstance *aInstance, uint16_t *aRegionCode)
احصل على رمز المنطقة.
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 قيد التقدم حاليًا أم لا.
otLinkIsCslEnabled(otInstance *aInstance)
bool
يشير إلى ما إذا كانت لغة CSL مفعَّلة أم لا.
otLinkIsCslSupported(otInstance *aInstance)
bool
تشير هذه العلامة إلى ما إذا كان الجهاز متصلاً بأحد الوالدَين اللذين يتوافقان مع CSL.
otLinkIsEnabled(otInstance *aInstance)
bool
يشير إلى ما إذا كانت طبقة الرابط مُفعَّلة أم لا.
otLinkIsEnergyScanInProgress(otInstance *aInstance)
bool
يشير إلى ما إذا كان IEEE 802.15.4 Energy Scan قيد التقدم حاليًا أم لا.
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.
otLinkSetCslChannel(otInstance *aInstance, uint8_t aChannel)
لضبط قناة CSL
otLinkSetCslPeriod(otInstance *aInstance, uint32_t aPeriod)
لضبط فترة CSL بالميكرو ثانية.
otLinkSetCslTimeout(otInstance *aInstance, uint32_t aTimeout)
لضبط مهلة CSL بالثواني.
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)
اضبط رقم تعريف IEEE 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.
otLinkSetRegion(otInstance *aInstance, uint16_t aRegionCode)
لضبط رمز المنطقة.
otLinkSetSupportedChannelMask(otInstance *aInstance, uint32_t aChannelMask)
ضبط قناع القناة المتوافق لطبقة MAC.

الهياكل
otActiveScanResult

يُمثِّل مرشد IEEE 802.15.4 المُستلَم.

otEnergyScanResult

يمثل نتيجة مسح الطاقة.

otMacCounters

يمثل عدادات طبقة MAC.

otMacFilterEntry

يمثل إدخال عامل تصفية في Mac.

otThreadLinkInfo

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

عمليات التعداد

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
مؤشر صالح لمعلومات المرشد أو NULL عند اكتمال البحث النشط.
[in] aContext
مؤشر إلى السياق الخاص بالتطبيق.

otHandleEnergyScanResult

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

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

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

otLinkPcapCallback

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

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

التفاصيل
المَعلمات
[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

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

الدوال

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
يتم حاليًا إجراء فحص نشط.

otLinkConvertLinkQualityToRss

int8_t otLinkConvertLinkQualityToRss(
  otInstance *aInstance,
  uint8_t aLinkQuality
)

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

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aLinkQuality
يجب أن تتراوح قيمة رابط جودة الرابط [0,3].
المرتجعات
استلمّ النظام الأساسي النموذجي تعيين قوة الإشارة إلى aLinkQuality.

otLinkConvertRssToLinkQuality

uint8_t otLinkConvertRssToLinkQuality(
  otInstance *aInstance,
  int8_t aRss
)

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

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aRss
قيمة قوة الإشارة المُستلَمة المطلوب تحويلها.
المرتجعات
ربط قيمة جودة الرابط بـ "aRss"

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
تم قبول طلب Energy Scan.
OT_ERROR_BUSY
تعذَّر بدء فحص الطاقة.

otLinkFilterAddAddress

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

لإضافة عنوان موسع إلى فلتر MAC.

متاح عندما تكون إعدادات OPENTHREAD_CONFIG_MAC_FILTER_ENABLE مفعَّلة.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aExtAddress
مؤشر إلى العنوان الموسع (يجب ألا يكون فارغًا).
قيم الإرجاع
OT_ERROR_NONE
تمت إضافة aExtAddress إلى فلتر MAC بنجاح.
OT_ERROR_NO_BUFS
لا يوجد إدخال متاح.

otLinkFilterAddRssIn

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

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

وليس بالضرورة أن يكون العنوان الموسّع في فلتر address allowlist/denylist لضبط rss.

متاح عندما تكون إعدادات OPENTHREAD_CONFIG_MAC_FILTER_ENABLE مفعَّلة.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aExtAddress
مؤشر يشير إلى العنوان الموسع 802.15.4 IEEE. يجب ألا يكون فارغًا.
[in] aRss
قوة الإشارة المُستلَمة (بالديسيبل بالمللي وات).
قيم الإرجاع
OT_ERROR_NONE
تمت إضافة إدخال لـ aExtAddress وaRss بنجاح.
OT_ERROR_NO_BUFS
لا يوجد إدخال متاح.

otLinkFilterClearAddresses

void otLinkFilterClearAddresses(
  otInstance *aInstance
)

يمحو جميع العناوين الموسعة من فلتر MAC.

متاح عندما تكون إعدادات OPENTHREAD_CONFIG_MAC_FILTER_ENABLE مفعَّلة.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.

otLinkFilterClearAllRssIn

void otLinkFilterClearAllRssIn(
  otInstance *aInstance
)

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

يعني تنفيذ هذا الإجراء أن جميع العناوين الموسعة ستستخدم إشارة على الهواء.

متاح عندما تكون إعدادات OPENTHREAD_CONFIG_MAC_FILTER_ENABLE مفعَّلة.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.

otLinkFilterClearDefaultRssIn

void otLinkFilterClearDefaultRssIn(
  otInstance *aInstance
)

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

متاح عندما تكون إعدادات OPENTHREAD_CONFIG_MAC_FILTER_ENABLE مفعَّلة.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.

otLinkFilterGetAddressMode

otMacFilterAddressMode otLinkFilterGetAddressMode(
  otInstance *aInstance
)

تحصل على وضع العنوان لفلتر MAC.

متاح عندما تكون إعدادات OPENTHREAD_CONFIG_MAC_FILTER_ENABLE مفعَّلة.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
المرتجعات
وضع العنوان.

otLinkFilterGetNextAddress

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

تلقّي إدخال فلتر عنوان قيد الاستخدام.

متاح عندما تكون إعدادات OPENTHREAD_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 قيد الاستخدام.

متاح عندما تكون إعدادات OPENTHREAD_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.

متاح عندما تكون إعدادات OPENTHREAD_CONFIG_MAC_FILTER_ENABLE مفعَّلة.

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

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aExtAddress
مؤشر إلى العنوان الموسع (يجب ألا يكون فارغًا).

otLinkFilterRemoveRssIn

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

إزالة العنوان الموسّع المحدّد من قائمة RssIn

بعد إزالة عنوان MAC هذا من قائمة RssIn، سيستخدم بدلاً من ذلك إعدادات rss وlqi التلقائية بافتراض أنّه تم ضبط الإعدادات التلقائية. (وفي حال عدم تعيين إعدادات افتراضية، يتم استخدام إشارة الشبكة اللاسلكية).

متاح عندما تكون إعدادات OPENTHREAD_CONFIG_MAC_FILTER_ENABLE مفعَّلة.

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

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aExtAddress
مؤشر يشير إلى العنوان الموسع 802.15.4 IEEE. يجب ألا يكون فارغًا.

otLinkFilterSetAddressMode

void otLinkFilterSetAddressMode(
  otInstance *aInstance,
  otMacFilterAddressMode aMode
)

تحدِّد هذه السياسة وضع العنوان لفلتر MAC.

متاح عندما تكون إعدادات OPENTHREAD_CONFIG_MAC_FILTER_ENABLE مفعَّلة.

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

otLinkFilterSetDefaultRssIn

void otLinkFilterSetDefaultRssIn(
  otInstance *aInstance,
  int8_t aRss
)

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

متاح عندما تكون إعدادات OPENTHREAD_CONFIG_MAC_FILTER_ENABLE مفعَّلة.

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

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aRss
قوة الإشارة المُستلَمة التلقائية (بالديسيبل بالملي واط) المطلوب ضبطها

otLinkGetCcaFailureRate

uint16_t otLinkGetCcaFailureRate(
  otInstance *aInstance
)

لعرض معدل الفشل الحالي في CCA (Clear Channel Assessment).

يتم الحفاظ على المعدّل على مدى فترة زمنية (تقريبًا) تبلغ 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.

otLinkGetCslChannel

uint8_t otLinkGetCslChannel(
  otInstance *aInstance
)

يحصل على قناة CSL.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
المرتجعات
قناة CSL

otLinkGetCslPeriod

uint32_t otLinkGetCslPeriod(
  otInstance *aInstance
)

الحصول على فترة CSL بالميكرو ثانية.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
المرتجعات
فترة CSL بالميكرو ثانية.

otLinkGetCslTimeout

uint32_t otLinkGetCslTimeout(
  otInstance *aInstance
)

يؤدي ذلك إلى تلقّي مهلة CSL.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
المرتجعات
انتهاء مهلة CSL بالثواني.

otLinkGetExtendedAddress

const otExtAddress * otLinkGetExtendedAddress(
  otInstance *aInstance
)

الحصول على العنوان الموسع لمعيار IEEE 802.15.4

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
المرتجعات
مؤشر يشير إلى العنوان الموسع 802.15.4 IEEE.

otLinkGetFactoryAssignedIeeeEui64

void otLinkGetFactoryAssignedIeeeEui64(
  otInstance *aInstance,
  otExtAddress *aEui64
)

احصل على مواصفات IEEE EUI-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
)

يمكنك الحصول على رقم تعريف IEEE 802.15.4 لرقم PAN.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
المرتجعات
رقم تعريف IEEE 802.15.4 لرقم PAN.
يُرجى الاطّلاع أيضًا على:
otLinkSetPanId

otLinkGetPollPeriod

uint32_t otLinkGetPollPeriod(
  otInstance *aInstance
)

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

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
المرتجعات
فترة استطلاع البيانات للجهاز النهائي غير النشط بالمللي ثانية
راجِع أيضًا:
otLinkSetPollPeriod

otLinkGetRegion

otError otLinkGetRegion(
  otInstance *aInstance,
  uint16_t *aRegionCode
)

احصل على رمز المنطقة.

إنّ تنسيق منطقة الراديو هو تمثيل ascii بحجم 2 بايت لرمز ISO 3166 alpha-2.

التفاصيل
المَعلمات
[in] aInstance
بنية النسخة الافتراضية OpenThread
[out] aRegionCode
رمز منطقة الراديو. aRegionCode >> 8 هو حرف ASCII الأول وaRegionCode & 0xff هو حرف Ascii الثاني.
قيم الإرجاع
OT_ERROR_INVALID_ARGS
قيمة aRegionCode عبارة عن قيمة nullptr.
OT_ERROR_FAILED
أخطاء أخرى متعلّقة بالنظام الأساسي
OT_ERROR_NONE
تم الحصول على رمز المنطقة بنجاح.
OT_ERROR_NOT_IMPLEMENTED
لم يتم تنفيذ الميزة.

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، وهكذا.

otLinkGetTxDirectRetrySuccessHistogram

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

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

يكون صالحًا عند تفعيل الإعداد OPENthread_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[out] aNumberOfEntries
يشير ذلك المصطلح إلى مكان وضع حجم صفيفة المدرج التكراري المعروضة.
المرتجعات
يشير ذلك المصطلح إلى مؤشر المدرّج التكراري لعمليات إعادة المحاولة (في شكل صفيف). يشير العنصر n-th إلى أنه تم إرسال الحزمة مع إعادة المحاولة باستخدام n.

otLinkGetTxIndirectRetrySuccessHistogram

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

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

يكون صالحًا عند تفعيل الإعداد OPENthread_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[out] aNumberOfEntries
يشير ذلك المصطلح إلى مكان وضع حجم صفيفة المدرج التكراري المعروضة.
المرتجعات
يشير ذلك المصطلح إلى مؤشر المدرّج التكراري لعمليات إعادة المحاولة (في شكل صفيف). يشير العنصر n-th إلى أنه تم إرسال الحزمة مع إعادة المحاولة باستخدام n.

otLinkIsActiveScanInProgress

bool otLinkIsActiveScanInProgress(
  otInstance *aInstance
)

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

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
المرتجعات
صحيح إذا كان الفحص النشط IEEE 802.15.4 قيد التقدم، وإلا فسيتم اختيار false في الحالات الأخرى.

otLinkIsCslEnabled

bool otLinkIsCslEnabled(
  otInstance *aInstance
)

يشير إلى ما إذا كانت لغة CSL مفعَّلة أم لا.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
قيم الإرجاع
TRUE
طبقة الرابط مُفعَّلة (CSL).
FALSE
طبقة الرابط غير مفعّلة باستخدام CSL.

otLinkIsCslSupported

bool otLinkIsCslSupported(
  otInstance *aInstance
)

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

التفاصيل
قيم الإرجاع
TRUE
إذا كان أحد الوالدَين يتيح استخدام لغة CSL
FALSE
إذا كان أحد الوالدين لا يتيح استخدام CSL.

otLinkIsEnabled

bool otLinkIsEnabled(
  otInstance *aInstance
)

يشير إلى ما إذا كانت طبقة الرابط مُفعَّلة أم لا.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
قيم الإرجاع
TRUE
تم تفعيل طبقة الرابط.
FALSE
لم يتم تفعيل طبقة الرابط.

otLinkIsEnergyScanInProgress

bool otLinkIsEnergyScanInProgress(
  otInstance *aInstance
)

يشير إلى ما إذا كان IEEE 802.15.4 Energy Scan قيد التقدم حاليًا أم لا.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
المرتجعات
صحيح إذا كان IEEE 802.15.4 Energy Scan قيد التقدم، أو false بخلاف ذلك.

otLinkIsInTransmitState

bool otLinkIsInTransmitState(
  otInstance *aInstance
)

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

تكون وحدة MAC في حالة الإرسال أثناء إجراء CSMA/CA وCCA أو البيانات أو المرشد أو إطار طلب البيانات واستقبال 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 مفعَّلاً أم لا.

متاح عندما تكون إعدادات OPENTHREAD_CONFIG_MAC_FILTER_ENABLE مفعَّلة.

التفاصيل
قيم الإرجاع
TRUE
إذا كان فلتر الراديو مفعَّلاً.
FALSE
في حال إيقاف فلتر الراديو.

otLinkResetCounters

void otLinkResetCounters(
  otInstance *aInstance
)

إعادة ضبط عدادات طبقة MAC.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.

otLinkResetTxRetrySuccessHistogram

void otLinkResetTxRetrySuccessHistogram(
  otInstance *aInstance
)

يمحو إحصاءات المدرج التكراري لعمليات الإرسال المباشرة وغير المباشرة.

يكون صالحًا عند تفعيل الإعداد OPENthread_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_INVALID_STATE
الجهاز ليس في وضع إيقاف التشغيل عندما يكون الجهاز غير نشِط لفترة قصيرة.
OT_ERROR_NO_BUFS
لا تتوفر مخازن مؤقتة للرسائل

otLinkSendEmptyData

otError otLinkSendEmptyData(
  otInstance *aInstance
)

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

لا يتم دعمه إلا على جهاز Rx-Off-When-Idle لإرسال إطار بيانات فارغ إلى الجهاز الرئيسي. ملاحظة: لا يتوفّر هذا الخيار إلا عند تفعيل "OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE".

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
قيم الإرجاع
OT_ERROR_NONE
تمت إضافة رسالة فارغة إلى قائمة الانتظار بنجاح.
OT_ERROR_INVALID_STATE
الجهاز ليس في وضع Rx-إيقاف-عند-عدم النشاط.
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

otLinkSetCslChannel

otError otLinkSetCslChannel(
  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 غير صالح.

otLinkSetCslPeriod

otError otLinkSetCslPeriod(
  otInstance *aInstance,
  uint32_t aPeriod
)

لضبط فترة CSL بالميكرو ثانية.

يمكنك إيقاف CSL من خلال ضبط هذه المَعلمة على 0.

يجب أن تكون فترة CSL مضاعفًا لـ OT_LINK_CSL_PERIOD_TEN_SYMBOLS_UNIT_IN_USEC، وإلا يتم عرض OT_ERROR_INVALID_ARGS.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aPeriod
فترة CSL بالميكرو ثانية.
قيم الإرجاع
OT_ERROR_NONE
تم إعداد فترة CSL بنجاح.
OT_ERROR_INVALID_ARGS
فترة CSL غير صالحة

otLinkSetCslTimeout

otError otLinkSetCslTimeout(
  otInstance *aInstance,
  uint32_t aTimeout
)

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

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aTimeout
انتهاء مهلة CSL بالثواني.
قيم الإرجاع
OT_ERROR_NONE
تم بنجاح ضبط مهلة CSL.
OT_ERROR_INVALID_ARGS
مهلة CSL غير صالحة.

otLinkSetEnabled

otError otLinkSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

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

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aEnable
true لتمكين طبقة الرابط، أو false بخلاف ذلك.
قيم الإرجاع
OT_ERROR_NONE
تم تفعيل / إيقاف طبقة الرابط بنجاح.
OT_ERROR_INVALID_STATE
تعذّر إيقاف طبقة الرابط بسبب تفعيل واجهة سلسلة المحادثات.

otLinkSetExtendedAddress

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

تعيين العنوان الموسع لمعيار IEEE 802.15.4.

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

اضبط رقم تعريف IEEE 802.15.4 لرقم PAN.

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

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aPanId
رقم تعريف IEEE 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 أو قيمة فارغة (NULL) لإيقاف رد الاتصال.
[in] aCallbackContext
مؤشر إلى السياق الخاص بالتطبيق.

otLinkSetPollPeriod

otError otLinkSetPollPeriod(
  otInstance *aInstance,
  uint32_t aPollPeriod
)

يمكنك ضبط/محو فترة استطلاع البيانات الخارجية/التي حدَّدها المستخدم للجهاز النهائي النائم.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aPollPeriod
فترة استطلاع البيانات بالمللي ثانية.
قيم الإرجاع
OT_ERROR_NONE
تم بنجاح ضبط/محو فترة الاستطلاع التي حدّدها المستخدم.
OT_ERROR_INVALID_ARGS
إذا كانت قيمة aPollPeriod غير صالحة.
يمكنك الاطّلاع أيضًا على:
otLinkGetPollPeriod

otLinkSetPromiscuous

otError otLinkSetPromiscuous(
  otInstance *aInstance,
  bool aPromiscuous
)

لتمكين أو تعطيل الوضع المختلط لطبقة الرابط.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aPromiscuous
true لتفعيل النمط المختلط، أو false بخلاف ذلك.
قيم الإرجاع
OT_ERROR_NONE
تم تفعيل النمط المختلط بنجاح.
OT_ERROR_INVALID_STATE
تعذّر تفعيل الوضع المختلط بسبب تفعيل واجهة سلسلة المحادثات.

otLinkSetRadioFilterEnabled

void otLinkSetRadioFilterEnabled(
  otInstance *aInstance,
  bool aFilterEnabled
)

لتفعيل/إيقاف وضع فلتر راديو IEEE 802.15.4.

متاح عندما تكون إعدادات OPENTHREAD_CONFIG_MAC_FILTER_ENABLE مفعَّلة.

وتم تصميم فلتر الراديو بشكل أساسي للاختبار. يمكن استخدامه لحظر جميع Tx/rx مؤقتًا على الراديو 802.15.4. عند تفعيل فلتر اللاسلكي، يتم ضبط الراديو على وضع السكون بدلاً من الاستلام (لضمان عدم استقبال الجهاز لأي إطار و/أو احتمال إرسال إشعار). يظهر أيضًا طلب إرسال الإطار فورًا بدون إرسال الإطار عبر البث الهوائي (يعرض الخطأ "no ack" إذا تم طلب إرسال الإطار، وإلا سيتم عرض الخطأ).

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aFilterEnabled
TRUE لتمكين فلتر الراديو، FALSE للإيقاف

otLinkSetRegion

otError otLinkSetRegion(
  otInstance *aInstance,
  uint16_t aRegionCode
)

لضبط رمز المنطقة.

إنّ تنسيق منطقة الراديو هو تمثيل ascii بحجم 2 بايت لرمز ISO 3166 alpha-2.

التفاصيل
المَعلمات
[in] aInstance
بنية النسخة الافتراضية OpenThread
[in] aRegionCode
رمز منطقة الراديو. aRegionCode >> 8 هو حرف ASCII الأول وaRegionCode & 0xff هو حرف Ascii الثاني.
قيم الإرجاع
OT_ERROR_FAILED
أخطاء أخرى متعلّقة بالنظام الأساسي
OT_ERROR_NONE
تم ضبط رمز المنطقة بنجاح.
OT_ERROR_NOT_IMPLEMENTED
لم يتم تنفيذ الميزة.

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_LINK_CSL_PERIOD_TEN_SYMBOLS_UNIT_IN_USEC (160)

يشير إلى وحدة رموز فترة CSL بالميكرو ثانية.

يجب أن تكون فترة CSL (بالميكرو ثانية) مضاعفًا لهذه القيمة.

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 OT_RADIO_TEN_SYMBOLS_TIME

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

المراجِع

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