أسئلة عامة
تتضمن هذه الوحدة وظائف لجميع أدوار سلسلة المحادثات.
ملخّص
يوفر ناشر بيانات الشبكة آليات لتقييد عدد الإدخالات المتشابهة في الخدمة و/أو البادئة (على الشبكة المتداخلة أو المسار الخارجي) عن طريق مراقبة بيانات الشبكة وإدارة ما إذا كان مطلوبًا إضافة إدخالات أو إزالتها.
تتطلب جميع الدوال في هذه الوحدة تفعيل OPENTHREAD_CONFIG_NETDATA_PUBLISHER_ENABLE
.
أنواع المحددات |
|
---|---|
otBorderRouterConfig
|
typedefstruct otBorderRouterConfig
يمثل إعدادًا لجهاز توجيه الحدود. |
otDetachGracefullyCallback)(void *aContext)
|
typedefvoid(*
تُبلغ عملية معاودة الاتصال هذه التطبيق بانتهاء عملية فصل البيانات. |
otExternalRouteConfig
|
typedefstruct otExternalRouteConfig
يمثل إعدادات مسار خارجي. |
otIpCounters
|
typedefstruct otIpCounters
يعرض العدادات على مستوى عنوان IP. |
otLeaderData
|
typedefstruct otLeaderData
يمثل بيانات Lead في سلسلة المحادثات. |
otLinkModeConfig
|
typedefstruct otLinkModeConfig
يمثّل إعداد "وضع رابط MLE" |
otLowpanContextInfo
|
typedefstruct otLowpanContextInfo
تمثل معلومات معرّف سياق 6LoWPAN المرتبطة ببادئة في بيانات الشبكة. |
otMleCounters
|
typedefstruct otMleCounters
بالنسبة إلى عدّادات Thread MLE. |
otNeighborInfoIterator
|
typedefint16_t
ويتم استخدامه للتكرار من خلال الجدول المجاور. |
otNetDataDnsSrpServicePublisherCallback)(otNetDataPublisherEvent aEvent, void *aContext)
|
typedefvoid(*
يحدّد نوع المؤشر معاودة الاتصال المستخدمة لإرسال إشعار عند إضافة إدخال "خدمة نظام أسماء النطاقات (DNS)/SRP" إلى بيانات شبكة Thread أو إزالتها منها. |
otNetDataPrefixPublisherCallback)(otNetDataPublisherEvent aEvent, const otIp6Prefix *aPrefix, void *aContext)
|
typedefvoid(*
يحدّد نوع المؤشر معاودة الاتصال المستخدمة لإرسال إشعار عند إضافة بادئة (شبكة داخلية أو مسار خارجي) إلى بيانات شبكة Thread أو إزالتها منها. |
otNetDataPublisherEvent
|
typedef تمثل الأحداث التي تم الإبلاغ عنها من استدعاءات الناشرين. |
otNetworkDataIterator
|
typedefuint32_t
يُستخدم للتكرار من خلال معلومات بيانات الشبكة. |
otNetworkDiagChildEntry
|
typedefstruct otNetworkDiagChildEntry
يمثّل إدخال جدول تشخيصي للأطفال على الشبكة. |
otNetworkDiagConnectivity
|
typedefstruct otNetworkDiagConnectivity
تمثل قيمة الاتصال التشخيصي بالشبكة. |
otNetworkDiagIterator
|
typedefuint16_t
يُستخدَم وتكرارًا من خلال TLV تشخيص الشبكة. |
otNetworkDiagMacCounters
|
typedefstruct otNetworkDiagMacCounters
تمثل قيمة العدّادات في أداة تشخيص البرامج في الشبكة. |
otNetworkDiagRoute
|
typedefstruct otNetworkDiagRoute
يمثل قيمة TLV في مسار تشخيص الشبكة. |
otNetworkDiagRouteData
|
typedefstruct otNetworkDiagRouteData
يمثل بيانات مسار تشخيص الشبكة. |
otNetworkDiagTlv
|
typedefstruct otNetworkDiagTlv
يمثل TLV لبيانات تشخيص الشبكة. |
otReceiveDiagnosticGetCallback)(otError aError, otMessage *aMessage, const otMessageInfo *aMessageInfo, void *aContext)
|
typedefvoid(*
يتم استدعاء المؤشر عند تلقّي استجابة الحصول على بيانات تشخيص الشبكة. |
otRoutePreference
|
typedefenum otRoutePreference
|
otServerConfig
|
typedefstruct otServerConfig
تمثل إعدادات الخادم. |
otServiceConfig
|
typedefstruct otServiceConfig
يمثّل إعداد خدمة. |
otThreadAnycastLocatorCallback)(void *aContext, otError aError, const otIp6Address *aMeshLocalAddress, uint16_t aRloc16)
|
typedefvoid(*
يحدّد نوع المؤشر معاودة الاتصال للإبلاغ عن نتيجة طلب otThreadLocateAnycastDestination() . |
otThreadDiscoveryRequestCallback)(const otThreadDiscoveryRequestInfo *aInfo, void *aContext)
|
typedefvoid(*
يتم استدعاء المؤشر في كل مرة يتم فيها تلقّي رسالة طلب اكتشاف MLE. |
otThreadDiscoveryRequestInfo
|
typedefstruct otThreadDiscoveryRequestInfo
يمثل بيانات طلب اكتشاف سلسلة المحادثات. |
otThreadParentResponseCallback)(otThreadParentResponseInfo *aInfo, void *aContext)
|
typedefvoid(*
يتم استدعاء المؤشر في كل مرة يتم فيها تلقّي رسالة رد من أحد الوالدَين. |
otThreadParentResponseInfo
|
typedefstruct otThreadParentResponseInfo
يمثّل بيانات ردّ الوالدَين MLE. |
الدوال |
|
---|---|
otConvertDurationInSecondsToString(uint32_t aDuration, char *aBuffer, uint16_t aSize)
|
void
تحوِّل مدة
uint32_t (بالثواني) إلى سلسلة يمكن للمستخدم قراءتها. |
otNetDataContainsOmrPrefix(otInstance *aInstance, const otIp6Prefix *aPrefix)
|
bool
تحقَّق مما إذا كانت بادئة معيّنة يمكن أن تعمل كبادئة OMR صالحة ومن أن بيانات الشبكة الخاصة بالقائد تحتوي على هذه البادئة.
|
otNetDataGet(otInstance *aInstance, bool aStable, uint8_t *aData, uint8_t *aDataLength)
|
تقديم نسخة كاملة أو ثابتة من بيانات شبكة Thread الخاصة بالقسم
|
otNetDataGetLength(otInstance *aInstance)
|
uint8_t
احصل على الطول الحالي (عدد وحدات البايت) لبيانات شبكة Thread ضمن القسم.
|
otNetDataGetMaxLength(otInstance *aInstance)
|
uint8_t
يمكنك الحصول على الحد الأقصى المسموح به لطول بيانات شبكة Thread منذ بدء إعداد مكدّس OT أو منذ آخر استدعاء لـ
otNetDataResetMaxLength() . |
otNetDataGetNextLowpanContextInfo(otInstance *aInstance, otNetworkDataIterator *aIterator, otLowpanContextInfo *aContextInfo)
|
احصل على معلومات رقم تعريف سياق 6LoWPAN التالية في بيانات الشبكة للقسم.
|
otNetDataGetNextOnMeshPrefix(otInstance *aInstance, otNetworkDataIterator *aIterator, otBorderRouterConfig *aConfig)
|
احصل على بادئة "الشبكة المتداخلة" التالية في بيانات الشبكة للقسم.
|
otNetDataGetNextRoute(otInstance *aInstance, otNetworkDataIterator *aIterator, otExternalRouteConfig *aConfig)
|
يمكنك الحصول على المسار الخارجي التالي في بيانات الشبكة للقسم.
|
otNetDataGetNextService(otInstance *aInstance, otNetworkDataIterator *aIterator, otServiceConfig *aConfig)
|
احصل على الخدمة التالية في بيانات الشبكة للقسم.
|
otNetDataGetStableVersion(otInstance *aInstance)
|
uint8_t
احصل على إصدار ثابت من بيانات الشبكة.
|
otNetDataGetVersion(otInstance *aInstance)
|
uint8_t
احصل على إصدار بيانات الشبكة.
|
otNetDataIsDnsSrpServiceAdded(otInstance *aInstance)
|
bool
يشير هذا الحقل إلى ما إذا كان قد تمت إضافة الإدخال "خدمة نظام أسماء النطاقات (DNS)/SRP" إلى بيانات شبكة Thread أم لا.
|
otNetDataIsPrefixAdded(otInstance *aInstance, const otIp6Prefix *aPrefix)
|
bool
يشير إلى ما إذا كان قد تمت إضافة إدخال بادئة حاليًا (داخل الشبكة أو مسار خارجي) إلى بيانات Thread Network.
|
otNetDataPublishDnsSrpServiceAnycast(otInstance *aInstance, uint8_t aSequenceNUmber)
|
void
يطلب هذا الخيار نشر "عنوان نظام أسماء النطاقات/نظام أسماء نطاقات الخدمة" ليتم نشره في بيانات شبكة Thread.
|
otNetDataPublishDnsSrpServiceUnicast(otInstance *aInstance, const otIp6Address *aAddress, uint16_t aPort)
|
void
تطلب هذه السياسة نشر "عنوان نظام أسماء النطاقات لخدمة Cloud/SRP" في بيانات شبكة Thread.
|
otNetDataPublishDnsSrpServiceUnicastMeshLocalEid(otInstance *aInstance, uint16_t aPort)
|
void
تطلب هذه السياسة نشر "عنوان نظام أسماء النطاقات لخدمة Cloud/SRP" في بيانات شبكة Thread.
|
otNetDataPublishExternalRoute(otInstance *aInstance, const otExternalRouteConfig *aConfig)
|
تطلب هذه السياسة إضافة بادئة مسار خارجي إلى بيانات Thread Network.
|
otNetDataPublishOnMeshPrefix(otInstance *aInstance, const otBorderRouterConfig *aConfig)
|
تطلب هذه البادئة منشورًا في بيانات Thread Network.
|
otNetDataReplacePublishedExternalRoute(otInstance *aInstance, const otIp6Prefix *aPrefix, const otExternalRouteConfig *aConfig)
|
لاستبدال مسار خارجي تم نشره سابقًا في بيانات شبكة Thread.
|
otNetDataResetMaxLength(otInstance *aInstance)
|
void
إعادة ضبط الحد الأقصى لطول بيانات شبكة Thread المتتبّعة.
|
otNetDataSetDnsSrpServicePublisherCallback(otInstance *aInstance, otNetDataDnsSrpServicePublisherCallback aCallback, void *aContext)
|
void
تُحدِّد معاودة الاتصال للإشعار عندما تتم إضافة "خدمة نظام أسماء النطاقات (DNS)/SRP" المنشورة إلى بيانات شبكة Thread أو إزالتها منها.
|
otNetDataSetPrefixPublisherCallback(otInstance *aInstance, otNetDataPrefixPublisherCallback aCallback, void *aContext)
|
void
تُحدِّد استدعاءً للإشعار عند إضافة إدخال بادئة منشورة إلى بيانات شبكة Thread أو إزالتها منه.
|
otNetDataSteeringDataCheckJoiner(otInstance *aInstance, const otExtAddress *aEui64)
|
تحقّق مما إذا كانت بيانات التوجيه مزوّدة برابط.
|
otNetDataSteeringDataCheckJoinerWithDiscerner(otInstance *aInstance, const struct otJoinerDiscerner *aDiscerner)
|
تحقّق مما إذا كانت بيانات التوجيه تتضمّن رابطًا مع قيمة مميّزة.
|
otNetDataUnpublishDnsSrpService(otInstance *aInstance)
|
void
يؤدي ذلك إلى إلغاء نشر أي إدخال في خدمة نظام أسماء النطاقات (DNS) أو بروتوكول SRP (أي البث أو Unicast) سبق إضافته من بيانات Thread Network.
|
otNetDataUnpublishPrefix(otInstance *aInstance, const otIp6Prefix *aPrefix)
|
إلغاء نشر بادئة "مسار على الشبكة" أو نشر بادئة خارجية تم نشرها سابقًا
|
otThreadBecomeChild(otInstance *aInstance)
|
محاولة إعادة إرفاقه كطفل.
|
otThreadBecomeDetached(otInstance *aInstance)
|
فصل عن شبكة Thread.
|
otThreadDetachGracefully(otInstance *aInstance, otDetachGracefullyCallback aCallback, void *aContext)
|
يرسل إشعارًا إلى العُقد الأخرى في الشبكة (إن وجدت) ثم يوقف تشغيل بروتوكول سلسلة المحادثات.
|
otThreadDeviceRoleToString(otDeviceRole aRole)
|
const char *
تحويل دور الجهاز إلى سلسلة يمكن للمستخدم قراءتها
|
otThreadDiscover(otInstance *aInstance, uint32_t aScanChannels, uint16_t aPanId, bool aJoiner, bool aEnableEui64Filtering, otHandleActiveScanResult aCallback, void *aCallbackContext)
|
يبدأ البحث عن Thread Discovery.
|
otThreadGetChildTimeout(otInstance *aInstance)
|
uint32_t
الحصول على مهلة المهلة الثانوية (بالثواني) المستخدمة عند العمل في دور الطفل.
|
otThreadGetDeviceRole(otInstance *aInstance)
|
الحصول على دور الجهاز
|
otThreadGetDomainName(otInstance *aInstance)
|
const char *
الحصول على اسم نطاق سلسلة المحادثات
|
otThreadGetExtendedPanId(otInstance *aInstance)
|
const otExtendedPanId *
الحصول على رقم تعريف PAN وفقًا لمعيار IEEE 802.15.4 الموسَّع
|
otThreadGetFixedDuaInterfaceIdentifier(otInstance *aInstance)
|
const otIp6InterfaceIdentifier *
الحصول على معرّف الواجهة المحدّد يدويًا لعنوان Unicast لنطاق سلسلة المحادثات
|
otThreadGetIp6Counters(otInstance *aInstance)
|
const otIpCounters *
الحصول على عدّادات IPv6.
|
otThreadGetKeySequenceCounter(otInstance *aInstance)
|
uint32_t
للحصول على thrKeySerialCounter.
|
otThreadGetKeySwitchGuardTime(otInstance *aInstance)
|
uint32_t
تحصل على thrKeySwitchGuardTime (بالساعات).
|
otThreadGetLeaderData(otInstance *aInstance, otLeaderData *aLeaderData)
|
الحصول على بيانات قائد سلسلة المحادثات
|
otThreadGetLeaderRloc(otInstance *aInstance, otIp6Address *aLeaderRloc)
|
لعرض مؤشر على RLOC للقائد.
|
otThreadGetLeaderRouterId(otInstance *aInstance)
|
uint8_t
احصل على رقم تعريف جهاز التوجيه الخاص بالقائد.
|
otThreadGetLeaderWeight(otInstance *aInstance)
|
uint8_t
احصل على وزن القائد.
|
otThreadGetLinkLocalAllThreadNodesMulticastAddress(otInstance *aInstance)
|
const otIp6Address *
الحصول على عنوان البث المتعدد عُقد Thread Link-Local All Node.
|
otThreadGetLinkLocalIp6Address(otInstance *aInstance)
|
const otIp6Address *
الحصول على عنوان IPv6 المحلي لرابط الرابط.
|
otThreadGetLinkMode(otInstance *aInstance)
|
احصل على إعدادات وضع رابط MLE.
|
otThreadGetMeshLocalEid(otInstance *aInstance)
|
const otIp6Address *
الحصول على عنوان معرّف EID المحلي للشبكة المتداخلة
|
otThreadGetMeshLocalPrefix(otInstance *aInstance)
|
const otMeshLocalPrefix *
عرض مؤشر للبادئة المحلية للشبكة المتداخلة.
|
otThreadGetMleCounters(otInstance *aInstance)
|
const otMleCounters *
للحصول على عدّادات Thread MLE
|
otThreadGetNetworkKey(otInstance *aInstance, otNetworkKey *aNetworkKey)
|
void
الحصول على مفتاح شبكة Thread
|
otThreadGetNetworkKeyRef(otInstance *aInstance)
|
الحصول على
otNetworkKeyRef لمفتاح شبكة Thread |
otThreadGetNetworkName(otInstance *aInstance)
|
const char *
الحصول على اسم شبكة Thread.
|
otThreadGetNextDiagnosticTlv(const otMessage *aMessage, otNetworkDiagIterator *aIterator, otNetworkDiagTlv *aNetworkDiagTlv)
|
الحصول على TLV تشخيص التشخيص التالي في الرسالة.
|
otThreadGetNextNeighborInfo(otInstance *aInstance, otNeighborInfoIterator *aIterator, otNeighborInfo *aInfo)
|
الحصول على معلومات الجيران التالية
|
otThreadGetParentAverageRssi(otInstance *aInstance, int8_t *aParentRssi)
|
تسترد الدالة متوسط RSSI للعنصر الرئيسي في سلسلة المحادثات.
|
otThreadGetParentInfo(otInstance *aInstance, otRouterInfo *aParentInfo)
|
تسترد الدالة معلومات التشخيص لجهاز توجيه سلاسل المحادثات كعنصر رئيسي.
|
otThreadGetParentLastRssi(otInstance *aInstance, int8_t *aLastRssi)
|
تسترد الدالة RSSI للحزمة الأخيرة من العنصر الرئيسي Thread.
|
otThreadGetPartitionId(otInstance *aInstance)
|
uint32_t
الحصول على معرّف القسم.
|
otThreadGetRealmLocalAllThreadNodesMulticastAddress(otInstance *aInstance)
|
const otIp6Address *
الحصول على عنوان البث المتعدد عُقد Thread Realm-Local All Threads
|
otThreadGetRloc(otInstance *aInstance)
|
const otIp6Address *
الحصول على عنوان مُحدِّد موقع سلسلة المحادثات (RLOC)
|
otThreadGetRloc16(otInstance *aInstance)
|
uint16_t
الحصول على RLOC16
|
otThreadGetServiceAloc(otInstance *aInstance, uint8_t aServiceId, otIp6Address *aServiceAloc)
|
لاسترداد ALOC للخدمة لمعرّف الخدمة المحدد.
|
otThreadGetVendorModel(otInstance *aInstance)
|
const char *
الحصول على سلسلة طراز المورِّد
|
otThreadGetVendorName(otInstance *aInstance)
|
const char *
الحصول على سلسلة اسم المورِّد
|
otThreadGetVendorSwVersion(otInstance *aInstance)
|
const char *
الحصول على سلسلة الإصدار الخاصة بميزة المورِّد
|
otThreadGetVersion(void)
|
uint16_t
للحصول على إصدار بروتوكول Thread
|
otThreadIsAnycastLocateInProgress(otInstance *aInstance)
|
bool
تشير إلى ما إذا كان طلب تحديد موقع أي بث قيد التقدم حاليًا.
|
otThreadIsDiscoverInProgress(otInstance *aInstance)
|
bool
تُحدِّد السياسة ما إذا كانت عملية اكتشاف سلسلة محادثات MLE قيد التقدُّم.
|
otThreadIsSingleton(otInstance *aInstance)
|
bool
تشير هذه العلامة إلى ما إذا كانت العقدة هي جهاز التوجيه الوحيد على الشبكة.
|
otThreadLocateAnycastDestination(otInstance *aInstance, const otIp6Address *aAnycastAddress, otThreadAnycastLocatorCallback aCallback, void *aContext)
|
يطلب أقرب وجهة لعنوان بث مباشر محدد.
|
otThreadRegisterParentResponseCallback(otInstance *aInstance, otThreadParentResponseCallback aCallback, void *aContext)
|
void
تسجيل معاودة الاتصال لتلقّي بيانات ردّ MLE Parent
|
otThreadResetIp6Counters(otInstance *aInstance)
|
void
إعادة ضبط عدّادات IPv6.
|
otThreadResetMleCounters(otInstance *aInstance)
|
void
يؤدي هذا الخيار إلى إعادة ضبط عدّادات MLE Threads.
|
otThreadSearchForBetterParent(otInstance *aInstance)
|
لبدء عملية البحث عن أحد الوالدَين بشكل أفضل مع البقاء على تواصل مع أحد الوالدَين الحالي
|
otThreadSendAddressNotification(otInstance *aInstance, otIp6Address *aDestination, otIp6Address *aTarget, otIp6InterfaceIdentifier *aMlIid)
|
void
يتم إرسال رسالة إشعار استباقية بشأن العنوان (userName_NTF.ntf).
|
otThreadSendDiagnosticGet(otInstance *aInstance, const otIp6Address *aDestination, const uint8_t aTlvTypes[], uint8_t aCount, otReceiveDiagnosticGetCallback aCallback, void *aCallbackContext)
|
إرسال طلب الحصول على بيانات تشخيصية للشبكة.
|
otThreadSendDiagnosticReset(otInstance *aInstance, const otIp6Address *aDestination, const uint8_t aTlvTypes[], uint8_t aCount)
|
إرسال طلب إعادة ضبط بيانات تشخيص الشبكة
|
otThreadSendProactiveBackboneNotification(otInstance *aInstance, otIp6Address *aTarget, otIp6InterfaceIdentifier *aMlIid, uint32_t aTimeSinceLastTransaction)
|
يُرسِل هذا الإشعار إشعارًا استباقيًا حول الخلفية (PRO_BB.ntf).
|
otThreadSetChildTimeout(otInstance *aInstance, uint32_t aTimeout)
|
void
لضبط مهلة السلسلة الفرعية (بالثواني) المستخدمة عند العمل في الدور الفرعي.
|
otThreadSetDiscoveryRequestCallback(otInstance *aInstance, otThreadDiscoveryRequestCallback aCallback, void *aContext)
|
void
ضبط معاودة اتصال لتلقّي بيانات طلب استكشاف MLE.
|
otThreadSetDomainName(otInstance *aInstance, const char *aDomainName)
|
ضبط اسم نطاق سلسلة المحادثات
|
otThreadSetEnabled(otInstance *aInstance, bool aEnabled)
|
يبدأ تشغيل بروتوكول Thread.
|
otThreadSetExtendedPanId(otInstance *aInstance, const otExtendedPanId *aExtendedPanId)
|
إعداد معرّف IEEE 802.15.4 الموسّع رقم PAN
|
otThreadSetFixedDuaInterfaceIdentifier(otInstance *aInstance, const otIp6InterfaceIdentifier *aIid)
|
تُحدِّد هذه السياسة معرّف الواجهة الذي يتم تحديده يدويًا لعنوان Thread لنطاق Unicast أو يمحوه.
|
otThreadSetJoinerAdvertisement(otInstance *aInstance, uint32_t aOui, const uint8_t *aAdvData, uint8_t aAdvDataLength)
|
لضبط إعلان سلسلة المحادثات عند اكتشاف شبكة Thread.
|
otThreadSetKeySequenceCounter(otInstance *aInstance, uint32_t aKeySequenceCounter)
|
void
لضبط thrKeySerialCounter.
|
otThreadSetKeySwitchGuardTime(otInstance *aInstance, uint32_t aKeySwitchGuardTime)
|
void
لضبط thrKeySwitchGuardTime (بالساعات).
|
otThreadSetLinkMode(otInstance *aInstance, otLinkModeConfig aConfig)
|
ضبط إعدادات "وضع رابط MLE"
|
otThreadSetMeshLocalPrefix(otInstance *aInstance, const otMeshLocalPrefix *aMeshLocalPrefix)
|
لضبط البادئة المحلية لشبكة متشابكة.
|
otThreadSetNetworkKey(otInstance *aInstance, const otNetworkKey *aKey)
|
ضبط مفتاح شبكة Thread
|
otThreadSetNetworkKeyRef(otInstance *aInstance, otNetworkKeyRef aKeyRef)
|
اضبط مفتاح شبكة Thread كـ
otNetworkKeyRef . |
otThreadSetNetworkName(otInstance *aInstance, const char *aNetworkName)
|
ضبط اسم شبكة Thread
|
otThreadSetVendorModel(otInstance *aInstance, const char *aVendorModel)
|
أدخِل سلسلة نموذج المورِّد.
|
otThreadSetVendorName(otInstance *aInstance, const char *aVendorName)
|
ضبط سلسلة اسم المورّد
|
otThreadSetVendorSwVersion(otInstance *aInstance, const char *aVendorSwVersion)
|
حدِّد سلسلة إصدار برنامج المورِّد.
|
هياكل |
|
---|---|
otBorderrouterConfig |
يمثل إعدادًا لجهاز توجيه الحدود. |
otExternalPathConfig |
يمثل إعدادات مسار خارجي. |
otIpCounters |
يعرض العدادات على مستوى عنوان IP. |
otLeaderData |
يمثل بيانات Lead في سلسلة المحادثات. |
otLinkModeConfig |
يمثّل إعداد "وضع رابط MLE" |
otlowpanContextInfo |
تمثل معلومات معرّف سياق 6LoWPAN المرتبطة ببادئة في بيانات الشبكة. |
otMleCounters |
بالنسبة إلى عدّادات Thread MLE. |
otNeighborInfo |
يحتوي على معلومات تشخيصية لعقدة سلسلة محادثات مجاورة. |
otNetworkDiagChildEntry |
يمثّل إدخال جدول تشخيصي للأطفال على الشبكة. |
otNetworkDiagConnectivity |
تمثل قيمة الاتصال التشخيصي بالشبكة. |
otNetworkDiagMacCounters |
تمثل قيمة العدّادات في أداة تشخيص البرامج في الشبكة. |
otNetworkDiagPath |
يمثل قيمة TLV في مسار تشخيص الشبكة. |
otNetworkDiagrouteData |
يمثل بيانات مسار تشخيص الشبكة. |
otNetworkDiagTlv |
يمثل TLV لبيانات تشخيص الشبكة. |
otrouterInfo |
يحتوي على معلومات التشخيص لجهاز توجيه سلسلة المحادثات. |
otServerConfig |
تمثل إعدادات الخادم. |
otServiceConfig |
يمثّل إعداد خدمة. |
otThreadDiscoveryRequestInfo |
يمثل بيانات طلب اكتشاف سلسلة المحادثات. |
otThreadParentResponseInfo |
يمثّل بيانات ردّ الوالدَين MLE. |
التعدادات
تعداد مجهول
anonymous enum
otDeviceRole
otDeviceRole
يمثل دور جهاز سلسلة محادثات.
أماكن إقامة | |
---|---|
OT_DEVICE_ROLE_CHILD
|
دور سلسلة المحادثات الثانوية |
OT_DEVICE_ROLE_DETACHED
|
لا تشارك حاليًا في شبكة أو قسم سلسلة محادثات. |
OT_DEVICE_ROLE_DISABLED
|
تم إيقاف حزمة سلاسل المحادثات. |
OT_DEVICE_ROLE_LEADER
|
دور قائد سلسلة المحادثات |
OT_DEVICE_ROLE_ROUTER
|
دور جهاز توجيه سلسلة المحادثات |
otNetDataPublisherEvent
otNetDataPublisherEvent
تمثل الأحداث التي تم الإبلاغ عنها من استدعاءات الناشرين.
أماكن إقامة | |
---|---|
OT_NETDATA_PUBLISHER_EVENT_ENTRY_ADDED
|
تتم إضافة الإدخال المنشور إلى بيانات شبكة Thread. |
OT_NETDATA_PUBLISHER_EVENT_ENTRY_REMOVED
|
تتم إزالة الإدخال المنشور من "بيانات شبكة Thread". |
المسار المفضّل
otRoutePreference
تعريف القيم الصالحة لـ mPreference
في otExternalRouteConfig
وotBorderRouterConfig
أماكن إقامة | |
---|---|
OT_ROUTE_PREFERENCE_HIGH
|
الخيار المفضّل للمسار مرتفع. |
OT_ROUTE_PREFERENCE_LOW
|
تفضيل مسار منخفض. |
OT_ROUTE_PREFERENCE_MED
|
الخيار المفضّل للمسار |
أنواع المحددات
otBorderrouterConfig
struct otBorderRouterConfig otBorderRouterConfig
يمثل إعدادًا لجهاز توجيه الحدود.
otDetachGracefulCallback
void(* otDetachGracefullyCallback)(void *aContext)
تُبلغ عملية معاودة الاتصال هذه التطبيق بانتهاء عملية فصل البيانات.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
otlowpanContextInfo
struct otLowpanContextInfo otLowpanContextInfo
تمثل معلومات معرّف سياق 6LoWPAN المرتبطة ببادئة في بيانات الشبكة.
otNeighborInfoIterator
int16_t otNeighborInfoIterator
ويتم استخدامه للتكرار من خلال الجدول المجاور.
otNetDataDnsSrpServicePublisherCallback
void(* otNetDataDnsSrpServicePublisherCallback)(otNetDataPublisherEvent aEvent, void *aContext)
يحدّد نوع المؤشر معاودة الاتصال المستخدمة لإرسال إشعار عند إضافة إدخال "خدمة نظام أسماء النطاقات (DNS)/SRP" إلى بيانات شبكة Thread أو إزالتها منها.
وعند استدعاء رد الاتصال، يتم استدعاءه بشكل مستقل بغض النظر عما إذا تمت إزالة الإدخال عن طريق Publisher
(على سبيل المثال، عندما يكون هناك عدد كبير جدًا من الإدخالات المماثلة في بيانات الشبكة) أو من خلال استدعاء صريح لإلغاء نشر الإدخال (أي إجراء مكالمة مع otNetDataUnpublishDnsSrpService()
).
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
otNetDataبادئةPublisherCallback
void(* otNetDataPrefixPublisherCallback)(otNetDataPublisherEvent aEvent, const otIp6Prefix *aPrefix, void *aContext)
يحدّد نوع المؤشر معاودة الاتصال المستخدمة لإرسال إشعار عند إضافة بادئة (شبكة داخلية أو مسار خارجي) إلى بيانات شبكة Thread أو إزالتها منها.
عند إزالة استدعاء الاتصال، يتم استدعاءه بشكل مستقل بغض النظر عما إذا تمت إزالة الإدخال من خلال Publisher
(على سبيل المثال، عندما يكون هناك عدد كبير جدًا من الإدخالات المماثلة في بيانات الشبكة) أو من خلال استدعاء صريح لإلغاء نشر الإدخال.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
otNetDataPublisherEvent
enum otNetDataPublisherEvent otNetDataPublisherEvent
تمثل الأحداث التي تم الإبلاغ عنها من استدعاءات الناشرين.
otNetworkDataIterator
uint32_t otNetworkDataIterator
يُستخدم للتكرار من خلال معلومات بيانات الشبكة.
إدخال otNetworkDiagChild
struct otNetworkDiagChildEntry otNetworkDiagChildEntry
يمثّل إدخال جدول تشخيصي للأطفال على الشبكة.
otNetworkDiagConnectionivity
struct otNetworkDiagConnectivity otNetworkDiagConnectivity
تمثل قيمة الاتصال التشخيصي بالشبكة.
otNetworkDiagIterator
uint16_t otNetworkDiagIterator
يُستخدَم وتكرارًا من خلال TLV تشخيص الشبكة.
OotNetworkDiagMacCounters
struct otNetworkDiagMacCounters otNetworkDiagMacCounters
تمثل قيمة العدّادات في أداة تشخيص البرامج في الشبكة.
يمكنك الاطّلاع على RFC 2863 للحصول على تعريفات حقول الأعضاء.
مسار الشبكة الإعلانية
struct otNetworkDiagRoute otNetworkDiagRoute
يمثل قيمة TLV في مسار تشخيص الشبكة.
otNetworkDiagrouteData
struct otNetworkDiagRouteData otNetworkDiagRouteData
يمثل بيانات مسار تشخيص الشبكة.
otReceivedDignGetCallback
void(* otReceiveDiagnosticGetCallback)(otError aError, otMessage *aMessage, const otMessageInfo *aMessageInfo, void *aContext)
يتم استدعاء المؤشر عند تلقّي استجابة الحصول على بيانات تشخيص الشبكة.
التفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
المسار المفضّل
enum otRoutePreference otRoutePreference
تعريف القيم الصالحة لـ mPreference
في otExternalRouteConfig
وotBorderRouterConfig
otThreadAndcastLocatorCallback
void(* otThreadAnycastLocatorCallback)(void *aContext, otError aError, const otIp6Address *aMeshLocalAddress, uint16_t aRloc16)
يحدّد نوع المؤشر معاودة الاتصال للإبلاغ عن نتيجة طلب otThreadLocateAnycastDestination()
.
التفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
otThreadDiscoveryRequestCallback
void(* otThreadDiscoveryRequestCallback)(const otThreadDiscoveryRequestInfo *aInfo, void *aContext)
يتم استدعاء المؤشر في كل مرة يتم فيها تلقّي رسالة طلب اكتشاف MLE.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
otThreadDiscoveryRequestInfo
struct otThreadDiscoveryRequestInfo otThreadDiscoveryRequestInfo
يمثل بيانات طلب اكتشاف سلسلة المحادثات.
otThreadParentResponseCallback
void(* otThreadParentResponseCallback)(otThreadParentResponseInfo *aInfo, void *aContext)
يتم استدعاء المؤشر في كل مرة يتم فيها تلقّي رسالة رد من أحد الوالدَين.
يتم استخدام هذا في otThreadRegisterParentResponseCallback()
.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
otThreadParentResponseInfo
struct otThreadParentResponseInfo otThreadParentResponseInfo
يمثّل بيانات ردّ الوالدَين MLE.
الدوال
otConvertDurationInSecondsToString
void otConvertDurationInSecondsToString( uint32_t aDuration, char *aBuffer, uint16_t aSize )
تحوِّل مدة uint32_t
(بالثواني) إلى سلسلة يمكن للمستخدم قراءتها.
يتطلّب تفعيل OPENTHREAD_CONFIG_UPTIME_ENABLE
.
يجب أن تتّبع السلسلة التنسيق "
إذا كانت السلسلة الناتجة لا تناسب aBuffer
(خلال aSize
من الأحرف)، سيتم اقتطاع السلسلة ولكن يتم دائمًا إنهاء السلسلة التي يتم إخراجها.
مخصَّص للاستخدام مع mAge
أو mConnectionTime
في بُنى otNeighborInfo
أو otChildInfo
.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
otNetDataContainsOmrبادئة
bool otNetDataContainsOmrPrefix( otInstance *aInstance, const otIp6Prefix *aPrefix )
تحقَّق مما إذا كانت بادئة معيّنة يمكن أن تعمل كبادئة OMR صالحة ومن أن بيانات الشبكة الخاصة بالقائد تحتوي على هذه البادئة.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
المرتجعات |
ما إذا كانت
aPrefix بادئة OMR صالحة وتحتوي بيانات الشبكة الخاصة بالبادئة على OMR aPrefix . |
otNetDataGet
otError otNetDataGet( otInstance *aInstance, bool aStable, uint8_t *aData, uint8_t *aDataLength )
تقديم نسخة كاملة أو ثابتة من بيانات شبكة Thread الخاصة بالقسم
التفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||
قيم الإرجاع |
|
otNetDataGetLength
uint8_t otNetDataGetLength( otInstance *aInstance )
احصل على الطول الحالي (عدد وحدات البايت) لبيانات شبكة Thread ضمن القسم.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
طول بيانات الشبكة.
|
otNetDataGetMaxLength
uint8_t otNetDataGetMaxLength( otInstance *aInstance )
يمكنك الحصول على الحد الأقصى المسموح به لطول بيانات شبكة Thread منذ بدء إعداد مكدّس OT أو منذ آخر استدعاء لـ otNetDataResetMaxLength()
.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
الحد الأقصى لطول بيانات الشبكة (علامة مائية عالية لطول بيانات الشبكة).
|
otNetDataGetNextlowpanContextInfo
otError otNetDataGetNextLowpanContextInfo( otInstance *aInstance, otNetworkDataIterator *aIterator, otLowpanContextInfo *aContextInfo )
احصل على معلومات رقم تعريف سياق 6LoWPAN التالية في بيانات الشبكة للقسم.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otNetDataGetNextOnMeshبادئة
otError otNetDataGetNextOnMeshPrefix( otInstance *aInstance, otNetworkDataIterator *aIterator, otBorderRouterConfig *aConfig )
احصل على بادئة "الشبكة المتداخلة" التالية في بيانات الشبكة للقسم.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otNetDataGetNextPath
otError otNetDataGetNextRoute( otInstance *aInstance, otNetworkDataIterator *aIterator, otExternalRouteConfig *aConfig )
يمكنك الحصول على المسار الخارجي التالي في بيانات الشبكة للقسم.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otNetDataGetNextService
otError otNetDataGetNextService( otInstance *aInstance, otNetworkDataIterator *aIterator, otServiceConfig *aConfig )
احصل على الخدمة التالية في بيانات الشبكة للقسم.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otNetDataGetStableVersion
uint8_t otNetDataGetStableVersion( otInstance *aInstance )
احصل على إصدار ثابت من بيانات الشبكة.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
إصدار بيانات الشبكة الثابتة
|
otNetDataGetVersion
uint8_t otNetDataGetVersion( otInstance *aInstance )
احصل على إصدار بيانات الشبكة.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
إصدار بيانات الشبكة:
|
otNetDataIsDnsSrpServiceتمت الإضافة
bool otNetDataIsDnsSrpServiceAdded( otInstance *aInstance )
يشير هذا الحقل إلى ما إذا كان قد تمت إضافة الإدخال "خدمة نظام أسماء النطاقات (DNS)/SRP" إلى بيانات شبكة Thread أم لا.
تتطلب هذه الميزة تفعيل OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otNetDataIsبادئة المضافة
bool otNetDataIsPrefixAdded( otInstance *aInstance, const otIp6Prefix *aPrefix )
يشير إلى ما إذا كان قد تمت إضافة إدخال بادئة حاليًا (داخل الشبكة أو مسار خارجي) إلى بيانات Thread Network.
تتطلب هذه الميزة تفعيل OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE
.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otNetDataPublishDnsSrpServiceAndcast
void otNetDataPublishDnsSrpServiceAnycast( otInstance *aInstance, uint8_t aSequenceNUmber )
يطلب هذا الخيار نشر "عنوان نظام أسماء النطاقات/نظام أسماء نطاقات الخدمة" ليتم نشره في بيانات شبكة Thread.
تتطلب هذه الميزة تفعيل OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
.
سيؤدي طلب هذه الوظيفة إلى إزالة أو استبدال أي إدخال سابق من نوع "خدمة نظام أسماء النطاقات/بروتوكول SRP" الذي تم نشره (من استدعاء سابق لأي من وظائف otNetDataPublishDnsSrpService{Type}()
).
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
otNetDataPublishDnsSrpServiceUnicast
void otNetDataPublishDnsSrpServiceUnicast( otInstance *aInstance, const otIp6Address *aAddress, uint16_t aPort )
تطلب هذه السياسة نشر "عنوان نظام أسماء النطاقات لخدمة Cloud/SRP" في بيانات شبكة Thread.
تتطلب هذه الميزة تفعيل OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
.
سيؤدي طلب هذه الوظيفة إلى إزالة أو استبدال أي إدخال سابق من نوع "خدمة نظام أسماء النطاقات/بروتوكول SRP" الذي تم نشره (من استدعاء سابق لأي من وظائف otNetDataPublishDnsSrpService{Type}()
).
يتم نشر "عنوان Unicast DNS/SRP Service" من خلال تضمين العنوان ومعلومات المنفذ في بيانات الخدمة TLV.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
otNetDataPublishDnsSrpServiceUnicastMeshLocalEid
void otNetDataPublishDnsSrpServiceUnicastMeshLocalEid( otInstance *aInstance, uint16_t aPort )
تطلب هذه السياسة نشر "عنوان نظام أسماء النطاقات لخدمة Cloud/SRP" في بيانات شبكة Thread.
تتطلب هذه الميزة تفعيل OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
.
سيؤدي طلب هذه الوظيفة إلى إزالة أو استبدال أي إدخال سابق من نوع "خدمة نظام أسماء النطاقات/بروتوكول SRP" الذي تم نشره (من استدعاء سابق لأي من وظائف otNetDataPublishDnsSrpService{Type}()
).
على عكس otNetDataPublishDnsSrpServiceUnicast()
التي تتطلّب تقديم العنوان المنشور وتتضمّن المعلومات الواردة في بيانات خدمة TLV، تستخدم هذه الدالة رقم EID المحلي لشبكة الجهاز وتتضمّن المعلومات الواردة في بيانات خادم TLV.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
otNetDataPublishExternalPath
otError otNetDataPublishExternalRoute( otInstance *aInstance, const otExternalRouteConfig *aConfig )
تطلب هذه السياسة إضافة بادئة مسار خارجي إلى بيانات Thread Network.
تتطلب هذه الميزة تفعيل OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE
.
يمكن نشر الإدخالات الثابتة فقط (أييجب أن تكون قيمة aConfig.mStable
صحيحة.
وسيحل طلب لاحق لهذه الطريقة محل طلب سابق للبادئة نفسها. وعلى وجه الخصوص، إذا غيّرت المكالمة الجديدة العلامات (على سبيل المثال، مستوى تفضيل) وكانت البادئة قد تمت إضافتها في بيانات الشبكة، سينعكس تغيير العلامات على الفور في بيانات الشبكة. ويضمن ذلك عدم إزالة الإدخالات الحالية في بيانات الشبكة فجأة. تجدر الإشارة إلى أنّ التغيير في مستوى الإعدادات المفضّلة قد يؤدي لاحقًا إلى إزالة الإدخال من بيانات الشبكة بعد تحديد وجود عُقد أخرى تنشر البادئة نفسها بالخيار المفضّل نفسه أو مستوى أعلى.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otNetDataPublishOnMishPrefix
otError otNetDataPublishOnMeshPrefix( otInstance *aInstance, const otBorderRouterConfig *aConfig )
تطلب هذه البادئة منشورًا في بيانات Thread Network.
تتطلب هذه الميزة تفعيل OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE
.
يمكن نشر الإدخالات الثابتة فقط (أييجب أن تكون قيمة aConfig.mStable
صحيحة.
وسيحل طلب لاحق لهذه الطريقة محل طلب سابق للبادئة نفسها. وعلى وجه الخصوص، إذا غيّرت المكالمة الجديدة العلامات (على سبيل المثال، مستوى تفضيل) وكانت البادئة قد تمت إضافتها في بيانات الشبكة، سينعكس تغيير العلامات على الفور في بيانات الشبكة. ويضمن ذلك عدم إزالة الإدخالات الحالية في بيانات الشبكة فجأة. تجدر الإشارة إلى أنّ التغيير في مستوى الإعدادات المفضّلة قد يؤدي لاحقًا إلى إزالة الإدخال من بيانات الشبكة بعد تحديد وجود عُقد أخرى تنشر البادئة نفسها بالخيار المفضّل نفسه أو مستوى أعلى.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otNetDataباد تم نشره خارجيًا
otError otNetDataReplacePublishedExternalRoute( otInstance *aInstance, const otIp6Prefix *aPrefix, const otExternalRouteConfig *aConfig )
لاستبدال مسار خارجي تم نشره سابقًا في بيانات شبكة Thread.
تتطلب هذه الميزة تفعيل OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE
.
إذا لم يكن هناك مسار خارجي تم نشره سابقًا يطابق aPrefix
، ستعمل هذه الدالة بشكل مشابه لـ otNetDataPublishExternalRoute()
، أي أنها ستبدأ عملية نشر aConfig كمسار خارجي في بيانات Thread Network.
إذا كان هناك إدخال مسار منشور سابقًا يطابق aPrefix
، سيتم استبداله بالبادئة الجديدة من aConfig
.
- إذا سبق أن تمت إضافة
aPrefix
في بيانات الشبكة، سينعكس التغيير على البادئة الجديدة فيaConfig
على الفور في بيانات الشبكة. ويضمن ذلك عدم إزالة إدخالات المسار بشكلٍ مفاجئ في بيانات الشبكة وأن الانتقال من البادئة إلى البادئة الجديدة سلس. - إذا لم تتم إضافة بيانات
aPrefix
القديمة المنشورة في بيانات الشبكة، سيتم استبدالها بالبادئة الجديدةaConfig
ولكن لن تتم إضافتها على الفور. وبدلاً من ذلك، ستبدأ عملية نشره في بيانات الشبكة (مراقبة بيانات الشبكة لتحديد الوقت الذي يتم فيه إضافة البادئة أو في حال إضافتها)، وذلك بناءً على عدد البادئات المشابهة الواردة في بيانات الشبكة).
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otNetDataResetMaxLength
void otNetDataResetMaxLength( otInstance *aInstance )
إعادة ضبط الحد الأقصى لطول بيانات شبكة Thread المتتبّعة.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
otNetDataGetMaxLength
otNetDataSetDnsSrpServicePublisherCallback
void otNetDataSetDnsSrpServicePublisherCallback( otInstance *aInstance, otNetDataDnsSrpServicePublisherCallback aCallback, void *aContext )
تُحدِّد معاودة الاتصال للإشعار عندما تتم إضافة "خدمة نظام أسماء النطاقات (DNS)/SRP" المنشورة إلى بيانات شبكة Thread أو إزالتها منها.
يحلّ استدعاء لاحق لهذه الدالة محل أي دالة رد اتصال تم ضبطها في السابق.
تتطلب هذه الميزة تفعيل OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
otNetDataSetPrefixPublisherCallback
void otNetDataSetPrefixPublisherCallback( otInstance *aInstance, otNetDataPrefixPublisherCallback aCallback, void *aContext )
تُحدِّد استدعاءً للإشعار عند إضافة إدخال بادئة منشورة إلى بيانات شبكة Thread أو إزالتها منه.
يحلّ استدعاء لاحق لهذه الدالة محل أي دالة رد اتصال تم ضبطها في السابق.
تتطلب هذه الميزة تفعيل OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE
.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
otNetDataSteeringDataCheckChecker
otError otNetDataSteeringDataCheckJoiner( otInstance *aInstance, const otExtAddress *aEui64 )
تحقّق مما إذا كانت بيانات التوجيه مزوّدة برابط.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otNetDataSteeringDataCheckLinkerWithDiscerner
otError otNetDataSteeringDataCheckJoinerWithDiscerner( otInstance *aInstance, const struct otJoinerDiscerner *aDiscerner )
تحقّق مما إذا كانت بيانات التوجيه تتضمّن رابطًا مع قيمة مميّزة.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otNetDataUnpublishDnsSrpService
void otNetDataUnpublishDnsSrpService( otInstance *aInstance )
يؤدي ذلك إلى إلغاء نشر أي إدخال في خدمة نظام أسماء النطاقات (DNS) أو بروتوكول SRP (أي البث أو Unicast) سبق إضافته من بيانات Thread Network.
يجب تفعيل OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
otNetDataUnpublishبادئة
otError otNetDataUnpublishPrefix( otInstance *aInstance, const otIp6Prefix *aPrefix )
إلغاء نشر بادئة "مسار على الشبكة" أو نشر بادئة خارجية تم نشرها سابقًا
يجب تفعيل OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE
.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otThreadSendChild
otError otThreadBecomeChild( otInstance *aInstance )
محاولة إعادة إرفاقه كطفل.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otThreadGetDetached
otError otThreadBecomeDetached( otInstance *aInstance )
فصل عن شبكة Thread.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otThreadDetachGracely
otError otThreadDetachGracefully( otInstance *aInstance, otDetachGracefullyCallback aCallback, void *aContext )
يرسل إشعارًا إلى العُقد الأخرى في الشبكة (إن وجدت) ثم يوقف تشغيل بروتوكول سلسلة المحادثات.
ويتم إرسال إصدار "العنوان" إذا كان جهاز توجيه، أو ضبط مهلة الطفل على 0 إذا كان طفلاً.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otThreadDeviceRoleToString
const char * otThreadDeviceRoleToString( otDeviceRole aRole )
تحويل دور الجهاز إلى سلسلة يمكن للمستخدم قراءتها
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
سلسلة تمثّل
aRole . |
اكتشاف
otError otThreadDiscover( otInstance *aInstance, uint32_t aScanChannels, uint16_t aPanId, bool aJoiner, bool aEnableEui64Filtering, otHandleActiveScanResult aCallback, void *aCallbackContext )
يبدأ البحث عن Thread Discovery.
التفاصيل | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||||||||
قيم الإرجاع |
|
otThreadGetChildTimeout
uint32_t otThreadGetChildTimeout( otInstance *aInstance )
الحصول على مهلة المهلة الثانوية (بالثواني) المستخدمة عند العمل في دور الطفل.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
قيمة مهلة سلسلة المحادثات الثانوية بالثواني
|
otThreadSetChildTimeout
otThreadGetDeviceRole
otDeviceRole otThreadGetDeviceRole( otInstance *aInstance )
الحصول على دور الجهاز
التفاصيل | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||||
قيم الإرجاع |
|
otThreadGetPermission
const char * otThreadGetDomainName( otInstance *aInstance )
الحصول على اسم نطاق سلسلة المحادثات
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
مؤشر إلى اسم نطاق سلسلة المحادثات.
|
otThreadSetDomainName
otThreadGetExtendedPanId
const otExtendedPanId * otThreadGetExtendedPanId( otInstance *aInstance )
الحصول على رقم تعريف PAN وفقًا لمعيار IEEE 802.15.4 الموسَّع
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
مؤشر إلى رقم تعريف PAN الموسَّع 802.15.4.
|
otThreadSetExtendedPanId
otThreadGetFixedDuaInterfaceId
const otIp6InterfaceIdentifier * otThreadGetFixedDuaInterfaceIdentifier( otInstance *aInstance )
الحصول على معرّف الواجهة المحدّد يدويًا لعنوان Unicast لنطاق سلسلة المحادثات
متاحة عند تفعيل OPENTHREAD_CONFIG_DUA_ENABLE
.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
مؤشر إلى معرِّف الواجهة الذي تم ضبطه يدويًا، أو إلى NULL إذا لم يتم ضبط أي منهما.
|
otThreadSetededuuInterfaceIdentifier
عدّاد في ما يخص سلسلة المحادثات
const otIpCounters * otThreadGetIp6Counters( otInstance *aInstance )
الحصول على عدّادات IPv6.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
مؤشر لعدادات IPv6.
|
otThreadGetKeyStringCount
uint32_t otThreadGetKeySequenceCounter( otInstance *aInstance )
للحصول على thrKeySerialCounter.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
تمثّل هذه السمة قيمة thrKeySerialCounter.
|
otThreadSetKeySerialCounter
otThreadGetKeySwitchGuardTime
uint32_t otThreadGetKeySwitchGuardTime( otInstance *aInstance )
تحصل على thrKeySwitchGuardTime (بالساعات).
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
قيمة thrKeySwitchGuardTime (بالساعات).
|
otThreadSetKeySwitchGuardTime
otThreadGetLeaderData
otError otThreadGetLeaderData( otInstance *aInstance, otLeaderData *aLeaderData )
الحصول على بيانات قائد سلسلة المحادثات
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otThreadGetLeaderRloc
otError otThreadGetLeaderRloc( otInstance *aInstance, otIp6Address *aLeaderRloc )
لعرض مؤشر على RLOC للقائد.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otThreadGetLeaderrouterId
uint8_t otThreadGetLeaderRouterId( otInstance *aInstance )
احصل على رقم تعريف جهاز التوجيه الخاص بالقائد.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
رقم تعريف جهاز التوجيه للقائد
|
otThreadGetLeaderوزن الوزن
uint8_t otThreadGetLeaderWeight( otInstance *aInstance )
احصل على وزن القائد.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
وزن القائد
|
otThreadGetLinkLocalAllThreadNodesMulticastAddress
const otIp6Address * otThreadGetLinkLocalAllThreadNodesMulticastAddress( otInstance *aInstance )
الحصول على عنوان البث المتعدد عُقد Thread Link-Local All Node.
العنوان هو عنوان البث المتعدد المستنِد إلى Unicast بادئة الرابط [RFC 3306]، مع:
- ضبط flgs على 3 (P = 1 وT = 1)
- ضبط scop على 2
- تم ضبط مبلغ Plen على 64
- تم ضبط بادئة الشبكة على البادئة المحلي للشبكة المتداخلة.
- تم ضبط رقم تعريف المجموعة على 1.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
مؤشر إلى رابط البث المتعدد لجميع سلاسل المحادثات المحلية في جميع سلاسل المحادثات.
|
otThreadGetLinkLocalIp6العنوان
const otIp6Address * otThreadGetLinkLocalIp6Address( otInstance *aInstance )
الحصول على عنوان IPv6 المحلي لرابط الرابط.
يتم اشتقاق العنوان المحلي لرابط سلسلة المحادثات باستخدام IEEE802.15.4 العنوان الموسَّع كمعرِّف الواجهة.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
مؤشر إلى عنوان IPv6 المحلي لرابط Thread.
|
otThreadGetLinkMode
otLinkModeConfig otThreadGetLinkMode( otInstance *aInstance )
احصل على إعدادات وضع رابط MLE.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
ضبط وضع رابط MLE
|
otThreadSetLinkMode
otThreadGetMeshLocalEid
const otIp6Address * otThreadGetMeshLocalEid( otInstance *aInstance )
الحصول على عنوان معرّف EID المحلي للشبكة المتداخلة
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
مؤشر إلى عنوان معرّف EID المحلي للشبكة المتداخلة.
|
otThreadGetMishLocalPrefix
const otMeshLocalPrefix * otThreadGetMeshLocalPrefix( otInstance *aInstance )
عرض مؤشر للبادئة المحلية للشبكة المتداخلة.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
مؤشر للبادئة المحلية للشبكة المتداخلة.
|
otThreadGetMleCounters
const otMleCounters * otThreadGetMleCounters( otInstance *aInstance )
للحصول على عدّادات Thread MLE
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
مؤشر لعدادات Thread MLE
|
otThreadGetNetworkKey
void otThreadGetNetworkKey( otInstance *aInstance, otNetworkKey *aNetworkKey )
الحصول على مفتاح شبكة Thread
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
otThreadSetNetworkKey
otThreadGetNetworkKeyref
otNetworkKeyRef otThreadGetNetworkKeyRef( otInstance *aInstance )
الحصول على otNetworkKeyRef
لمفتاح شبكة Thread
تتطلّب هذه الميزة تفعيل إصدار OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE
.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
الرجوع إلى مفتاح شبكة سلسلة المحادثات المخزَّن في الذاكرة
|
otThreadSetNetworkKeyref
otThreadGetNetworkName
const char * otThreadGetNetworkName( otInstance *aInstance )
الحصول على اسم شبكة Thread.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
مؤشر إلى اسم شبكة Thread.
|
otThreadSetNetworkName
otThreadGetNextDignTlv
otError otThreadGetNextDiagnosticTlv( const otMessage *aMessage, otNetworkDiagIterator *aIterator, otNetworkDiagTlv *aNetworkDiagTlv )
الحصول على TLV تشخيص التشخيص التالي في الرسالة.
يتطلب OPENTHREAD_CONFIG_TMF_NETDIAG_CLIENT_ENABLE
.
لا يُسمح باستدعاء هذه الدالة لاحقًا إلا عندما تكون قيمة العرض الحالية OT_ERROR_NONE.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otThreadGetNextNeighborInfo
otError otThreadGetNextNeighborInfo( otInstance *aInstance, otNeighborInfoIterator *aIterator, otNeighborInfo *aInfo )
الحصول على معلومات الجيران التالية
ويتم استخدامه للإدخالات في جدول الجدول المجاور.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otThreadGetParentAvgRssi
otError otThreadGetParentAverageRssi( otInstance *aInstance, int8_t *aParentRssi )
تسترد الدالة متوسط RSSI للعنصر الرئيسي في سلسلة المحادثات.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
otThreadGetParentInfo
otError otThreadGetParentInfo( otInstance *aInstance, otRouterInfo *aParentInfo )
تسترد الدالة معلومات التشخيص لجهاز توجيه سلاسل المحادثات كعنصر رئيسي.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
otThreadGetParentLastRssi
otError otThreadGetParentLastRssi( otInstance *aInstance, int8_t *aLastRssi )
تسترد الدالة RSSI للحزمة الأخيرة من العنصر الرئيسي Thread.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otThreadGetPartitionId
uint32_t otThreadGetPartitionId( otInstance *aInstance )
الحصول على معرّف القسم.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
معرّف القسم.
|
otThreadGetRealmLocalAllThreadNodesMulticastAddress
const otIp6Address * otThreadGetRealmLocalAllThreadNodesMulticastAddress( otInstance *aInstance )
الحصول على عنوان البث المتعدد عُقد Thread Realm-Local All Threads
العنوان هو عنوان متعدد البث يستند إلى بادئة Unicast محلية تستند إلى النطاق [RFC 3306]، مع:
- ضبط flgs على 3 (P = 1 وT = 1)
- ضبط scop على 3
- تم ضبط مبلغ Plen على 64
- تم ضبط بادئة الشبكة على البادئة المحلي للشبكة المتداخلة.
- تم ضبط رقم تعريف المجموعة على 1.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
مؤشر إلى عنوان البث المتعدد لعُقد Thread Realm-Local All Threads
|
otThreadGetRloc
const otIp6Address * otThreadGetRloc( otInstance *aInstance )
الحصول على عنوان مُحدِّد موقع سلسلة المحادثات (RLOC)
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
مؤشر إلى عنوان موجِّه سلسلة المحادثات (RLOC)
|
otThreadGetRloc16
uint16_t otThreadGetRloc16( otInstance *aInstance )
الحصول على RLOC16
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
قناة RLOC16
|
otThreadGetServiceAloc
otError otThreadGetServiceAloc( otInstance *aInstance, uint8_t aServiceId, otIp6Address *aServiceAloc )
لاسترداد ALOC للخدمة لمعرّف الخدمة المحدد.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otThreadGetSellerModel
const char * otThreadGetVendorModel( otInstance *aInstance )
الحصول على سلسلة طراز المورِّد
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
سلسلة طراز المورِّد.
|
otThreadGetSellerName
const char * otThreadGetVendorName( otInstance *aInstance )
الحصول على سلسلة اسم المورِّد
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
سلسلة اسم المورِّد.
|
otThreadGetSellerSwVersion
const char * otThreadGetVendorSwVersion( otInstance *aInstance )
الحصول على سلسلة الإصدار الخاصة بميزة المورِّد
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
عرض المورِّد سلسلة الإصدار.
|
otThreadGetVersion
uint16_t otThreadGetVersion( void )
للحصول على إصدار بروتوكول Thread
التفاصيل | |
---|---|
المرتجعات |
إصدار بروتوكول Thread.
|
otThreadIsAndcastLocateInProgress
bool otThreadIsAnycastLocateInProgress( otInstance *aInstance )
تشير إلى ما إذا كان طلب تحديد موقع أي بث قيد التقدم حاليًا.
لا يتوفّر هذا الإعداد إلا عند تفعيل OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE
.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
صحيح إذا كان طلب تحديد موقع أي حزمة قيد التقدم حاليًا، أو "خطأ" في الحالات الأخرى.
|
otThreadIsDiscoverInProgress
bool otThreadIsDiscoverInProgress( otInstance *aInstance )
تُحدِّد السياسة ما إذا كانت عملية اكتشاف سلسلة محادثات MLE قيد التقدُّم.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
OotThreadIsأغنية فردية
bool otThreadIsSingleton( otInstance *aInstance )
تشير هذه العلامة إلى ما إذا كانت العقدة هي جهاز التوجيه الوحيد على الشبكة.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otThreadLocateAncastDestination
otError otThreadLocateAnycastDestination( otInstance *aInstance, const otIp6Address *aAnycastAddress, otThreadAnycastLocatorCallback aCallback, void *aContext )
يطلب أقرب وجهة لعنوان بث مباشر محدد.
لا يتوفّر هذا الإعداد إلا عند تفعيل OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE
.
إذا كان الطلب السابق مستمرًا، سيتم إلغاء المكالمة التالية إلى هذه الدالة واستبدال الطلب السابق.
التفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||
قيم الإرجاع |
|
otThreadRecordParentResponseCallback
void otThreadRegisterParentResponseCallback( otInstance *aInstance, otThreadParentResponseCallback aCallback, void *aContext )
تسجيل معاودة الاتصال لتلقّي بيانات ردّ MLE Parent
يتطلب OPENTHREAD_CONFIG_MLE_PARENT_RESPONSE_CALLBACK_API_ENABLE
.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
عدّادات
void otThreadResetIp6Counters( otInstance *aInstance )
إعادة ضبط عدّادات IPv6.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
otThreadResetMleCounters
void otThreadResetMleCounters( otInstance *aInstance )
يؤدي هذا الخيار إلى إعادة ضبط عدّادات MLE Threads.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
otThreadSearchForBetterParent
otError otThreadSearchForBetterParent( otInstance *aInstance )
لبدء عملية البحث عن أحد الوالدَين بشكل أفضل مع البقاء على تواصل مع أحد الوالدَين الحالي
يجب استخدام هذه الميزة عندما يكون الجهاز متصلاً بجهاز طفل.
التفاصيل | |||||
---|---|---|---|---|---|
قيم الإرجاع |
|
otThreadSendAddressإشعار
void otThreadSendAddressNotification( otInstance *aInstance, otIp6Address *aDestination, otIp6Address *aTarget, otIp6InterfaceIdentifier *aMlIid )
يتم إرسال رسالة إشعار استباقية بشأن العنوان (userName_NTF.ntf).
لا يتوفّر هذا الإعداد إلا عند تفعيل OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
.
التفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
otThreadSendDiagnosticGet
otError otThreadSendDiagnosticGet( otInstance *aInstance, const otIp6Address *aDestination, const uint8_t aTlvTypes[], uint8_t aCount, otReceiveDiagnosticGetCallback aCallback, void *aCallbackContext )
إرسال طلب الحصول على بيانات تشخيصية للشبكة.
يتطلب OPENTHREAD_CONFIG_TMF_NETDIAG_CLIENT_ENABLE
.
التفاصيل | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||||||
قيم الإرجاع |
|
otThreadSendDiagnostic بإعادة الضبط
otError otThreadSendDiagnosticReset( otInstance *aInstance, const otIp6Address *aDestination, const uint8_t aTlvTypes[], uint8_t aCount )
إرسال طلب إعادة ضبط بيانات تشخيص الشبكة
يتطلب OPENTHREAD_CONFIG_TMF_NETDIAG_CLIENT_ENABLE
.
التفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||
قيم الإرجاع |
|
otThreadSendProactiveBackbackNotification
otError otThreadSendProactiveBackboneNotification( otInstance *aInstance, otIp6Address *aTarget, otIp6InterfaceIdentifier *aMlIid, uint32_t aTimeSinceLastTransaction )
يُرسِل هذا الإشعار إشعارًا استباقيًا حول الخلفية (PRO_BB.ntf).
لا يتوفّر هذا الإعداد إلا عند تفعيل OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
.
التفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||
قيم الإرجاع |
|
otThreadSetChildTimeout
void otThreadSetChildTimeout( otInstance *aInstance, uint32_t aTimeout )
لضبط مهلة السلسلة الفرعية (بالثواني) المستخدمة عند العمل في الدور الفرعي.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
otThreadGetChildTimeout
otThreadSetSetyRequestCallback
void otThreadSetDiscoveryRequestCallback( otInstance *aInstance, otThreadDiscoveryRequestCallback aCallback, void *aContext )
ضبط معاودة اتصال لتلقّي بيانات طلب استكشاف MLE.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
otThreadSetDomainName
otError otThreadSetDomainName( otInstance *aInstance, const char *aDomainName )
ضبط اسم نطاق سلسلة المحادثات
ولا يعمل هذا الإعداد إلا عند إيقاف بروتوكولات سلاسل المحادثات.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otThreadGetDomainName
otThreadSetEnabled
otError otThreadSetEnabled( otInstance *aInstance, bool aEnabled )
يبدأ تشغيل بروتوكول Thread.
يجب أن تكون الواجهة للأعلى عند طلب هذه الدالة.
ويؤدي استدعاء هذه الدالة التي تم ضبط aEnabled
على "خطأ" إلى إيقاف أي عمليات فصل جارية بدءًا من otThreadDetachGraceful(). وسيتم طلب معاودة الاتصال بها.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otThreadSetSetPanId
otError otThreadSetExtendedPanId( otInstance *aInstance, const otExtendedPanId *aExtendedPanId )
إعداد معرّف IEEE 802.15.4 الموسّع رقم PAN
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otThreadGetExtendedPanId
otThreadSetededuuInterInterface
otError otThreadSetFixedDuaInterfaceIdentifier( otInstance *aInstance, const otIp6InterfaceIdentifier *aIid )
تُحدِّد هذه السياسة معرّف الواجهة الذي يتم تحديده يدويًا لعنوان Thread لنطاق Unicast أو يمحوه.
متاحة عند تفعيل OPENTHREAD_CONFIG_DUA_ENABLE
.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otThreadGetFixedDuaInterfaceidentifier
otThreadSetSeterالإعلان
otError otThreadSetJoinerAdvertisement( otInstance *aInstance, uint32_t aOui, const uint8_t *aAdvData, uint8_t aAdvDataLength )
لضبط إعلان سلسلة المحادثات عند اكتشاف شبكة Thread.
يتم استخدام إعلان رابط سلسلة المحادثات للسماح للمنضم بالإعلان عن معلوماته الخاصة بالطلب (مثل معرّف المورّد أو معرّف المنتج أو التمييز وما إلى ذلك) من خلال إعلان الخدمة الجماعية المقترَح حديثًا، وتوفير هذه المعلومات للمفوّضين أو المرشّحين المفوّضين بدون تفاعل بشري.
التفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||
قيم الإرجاع |
|
otThreadSetKeySerialCount
void otThreadSetKeySequenceCounter( otInstance *aInstance, uint32_t aKeySequenceCounter )
لضبط thrKeySerialCounter.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
otThreadGetKeySerialCounter
otThreadSetKeySwitchGuardTime
void otThreadSetKeySwitchGuardTime( otInstance *aInstance, uint32_t aKeySwitchGuardTime )
لضبط thrKeySwitchGuardTime (بالساعات).
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
otThreadGetKeyGuardGuardTime
otThreadSetLinkMode
otError otThreadSetLinkMode( otInstance *aInstance, otLinkModeConfig aConfig )
ضبط إعدادات "وضع رابط MLE"
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otThreadGetLinkMode
otThreadSetMeshLocalPrefix
otError otThreadSetMeshLocalPrefix( otInstance *aInstance, const otMeshLocalPrefix *aMeshLocalPrefix )
لضبط البادئة المحلية لشبكة متشابكة.
لا يتم النجاح إلا عند إيقاف بروتوكولات سلاسل المحادثات. يؤدي الاستدعاء الناجح لهذه الدالة إلى إبطال مجموعات البيانات التشغيلية النشطة والمُعلقة في الذاكرة غير المتغيرة.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otThreadSetNetworkKey
otError otThreadSetNetworkKey( otInstance *aInstance, const otNetworkKey *aKey )
ضبط مفتاح شبكة Thread
لا يتم النجاح إلا عند إيقاف بروتوكولات سلاسل المحادثات. يؤدي الاستدعاء الناجح لهذه الدالة إلى إبطال مجموعات البيانات التشغيلية النشطة والمُعلقة في الذاكرة غير المتغيرة.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otThreadGetNetworkKey
otThreadSetNetworkKeyref
otError otThreadSetNetworkKeyRef( otInstance *aInstance, otNetworkKeyRef aKeyRef )
اضبط مفتاح شبكة Thread كـ otNetworkKeyRef
.
لا يتم النجاح إلا عند إيقاف بروتوكولات سلاسل المحادثات. يؤدي الاستدعاء الناجح لهذه الدالة إلى إبطال مجموعات البيانات التشغيلية النشطة والمُعلقة في الذاكرة غير المتغيرة.
تتطلّب هذه الميزة تفعيل إصدار OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE
.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otThreadGetNetworkKeyref
otThreadSetNetworkName
otError otThreadSetNetworkName( otInstance *aInstance, const char *aNetworkName )
ضبط اسم شبكة Thread
لا يتم النجاح إلا عند إيقاف بروتوكولات سلاسل المحادثات. يؤدي الاستدعاء الناجح لهذه الدالة إلى إبطال مجموعات البيانات التشغيلية النشطة والمُعلقة في الذاكرة غير المتغيرة.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otThreadGetNetworkName
otThreadSetSetModel
otError otThreadSetVendorModel( otInstance *aInstance, const char *aVendorModel )
أدخِل سلسلة نموذج المورِّد.
يتطلب OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE
.
يجب أن تكون القيمة aVendorModel
UTF8 بحد أقصى 32 حرفًا (MAX_VENDOR_MODEL_TLV_LENGTH
). لا يشمل الحد الأقصى للحرف حرف \0
الفارغ.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otThreadSetItemName
otError otThreadSetVendorName( otInstance *aInstance, const char *aVendorName )
ضبط سلسلة اسم المورّد
يتطلب OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE
.
يجب أن تكون القيمة aVendorName
UTF8 بحد أقصى 32 حرفًا (MAX_VENDOR_NAME_TLV_LENGTH
). لا يشمل الحد الأقصى للحرف حرف \0
الفارغ.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otThreadSetSetSwVersion
otError otThreadSetVendorSwVersion( otInstance *aInstance, const char *aVendorSwVersion )
حدِّد سلسلة إصدار برنامج المورِّد.
يتطلب OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE
.
يجب أن يكون aVendorSwVersion
UTF8 بحد أقصى 16 حرفًا(MAX_VENDOR_SW_VERSION_TLV_LENGTH
). لا يشمل الحد الأقصى للحرف حرف \0
الفارغ.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
وحدات ماكرو
الـ OT_DURATION_STRING_SIZE
OT_DURATION_STRING_SIZE 21
الحجم الموصى به لتمثيل السلسلة لمدة uint32_t
ثانية.
الوقت الإضافي: OT_JOINER_ADVDATA_MAX_LENGTH
OT_JOINER_ADVDATA_MAX_LENGTH 64
الحدّ الأقصى لمدة AdvData أطول معدّل الإعلان.
OT_NEIGHBOR_INFO_ITERATOR_INIT
OT_NEIGHBOR_INFO_ITERATOR_INIT 0
أداة إعداد otNeighborInfoIterator.
OT_NETWORK_BASE_TLV_MAX_LENGTH
OT_NETWORK_BASE_TLV_MAX_LENGTH 254
الحد الأقصى لطول قيمة Thread Base TLV.
OT_NETWORK_DATA_ITERATOR_INIT
OT_NETWORK_DATA_ITERATOR_INIT 0
القيمة لإعداد otNetworkDataIterator
.
OT_NETWORK_DIAGNOSTIC_CHILD_TABLE_ENTRY_SIZE
OT_NETWORK_DIAGNOSTIC_CHILD_TABLE_ENTRY_SIZE 3
حجم إدخال الجدول التشخيصي للشبكة.
OT_NETWORK_DIAGNOSTIC_ITERATOR_INIT
OT_NETWORK_DIAGNOSTIC_ITERATOR_INIT 0
أداة إعداد otNetworkDiagIterator.
OT_NETWORK_DIAGNOSTIC_MAX_thread_STACK_DESCRIPTION_TLV_LENGTH
OT_NETWORK_DIAGNOSTIC_MAX_THREAD_STACK_VERSION_TLV_LENGTH 64
الحد الأقصى لطول إصدار TLV من حزمة سلاسل المحادثات.
OT_NETWORK_DIAGNOSTIC_MAX_VENDOR_MODEL_TLV_LENGTH
OT_NETWORK_DIAGNOSTIC_MAX_VENDOR_MODEL_TLV_LENGTH 32
الحد الأقصى لطول نموذج المورّد TLV
OT_NETWORK_DIAGNOSTIC_MAX_VENDOR_NAME_TLV_LENGTH
OT_NETWORK_DIAGNOSTIC_MAX_VENDOR_NAME_TLV_LENGTH 32
الحد الأقصى لطول اسم المورّد TLV
OT_NETWORK_DIAGNOSTIC_MAX_VENDOR_SW_DESCRIPTION_TLV_LENGTH
OT_NETWORK_DIAGNOSTIC_MAX_VENDOR_SW_VERSION_TLV_LENGTH 16
الحد الأقصى لطول مورّد الخدمة بإصدار TLV
OT_NETWORK_DIAGNOSTIC_TYPELIST_MAX_ENTRIES
OT_NETWORK_DIAGNOSTIC_TYPELIST_MAX_ENTRIES 19
الحد الأقصى لعدد أنواع TLV تشخيصية للشبكة للطلب أو إعادة الضبط.
الوقت الإضافي_OT_NETWORK_MAX_ROUTER_ID
OT_NETWORK_MAX_ROUTER_ID 62
الحد الأقصى لرقم تعريف جهاز التوجيه.
الوقت الإضافي: DATA_DATA_MAX_SIZE
OT_SERVER_DATA_MAX_SIZE 248
الحد الأقصى لحجم بيانات الخادم بالبايت هذا هو النظري، وهو أقل بكثير من الناحية العملية.
الوقت الإضافي: DATA_DATA_MAX_SIZE
OT_SERVICE_DATA_MAX_SIZE 252
الحد الأقصى لحجم بيانات الخدمة بالبايت
الموارد
تبدأ مواضيع مراجع واجهة برمجة تطبيقات OpenThread من رمز المصدر، وهو متاح على GitHub. للحصول على مزيد من المعلومات أو للمساهمة في المستندات، يمكنك الاطّلاع على المراجع.