أسئلة عامة

تتضمن هذه الوحدة وظائف لجميع أدوار سلسلة المحادثات.

الملخّص

يوفر ناشر بيانات الشبكة آليات للحد من عدد إدخالات خدمة و/أو بادئة (بادئة على الشبكة المتداخلة أو مسار خارجي) مماثلة في بيانات شبكة سلسلة المحادثات عن طريق مراقبة بيانات الشبكة وإدارة ما إذا كان يمكن إضافة إدخالات أو إزالتها.

تتطلب جميع الوظائف في هذه الوحدة تفعيل OPENTHREAD_CONFIG_NETDATA_PUBLISHER_ENABLE.

تعداد

anonymous enum{
  OT_NETWORK_DIAGNOSTIC_TLV_EXT_ADDRESS = 0,
  OT_NETWORK_DIAGNOSTIC_TLV_SHORT_ADDRESS = 1,
  OT_NETWORK_DIAGNOSTIC_TLV_MODE = 2,
  OT_NETWORK_DIAGNOSTIC_TLV_TIMEOUT = 3,
  OT_NETWORK_DIAGNOSTIC_TLV_CONNECTIVITY = 4,
  OT_NETWORK_DIAGNOSTIC_TLV_ROUTE = 5,
  OT_NETWORK_DIAGNOSTIC_TLV_LEADER_DATA = 6,
  OT_NETWORK_DIAGNOSTIC_TLV_NETWORK_DATA = 7,
  OT_NETWORK_DIAGNOSTIC_TLV_IP6_ADDR_LIST = 8,
  OT_NETWORK_DIAGNOSTIC_TLV_MAC_COUNTERS = 9,
  OT_NETWORK_DIAGNOSTIC_TLV_BATTERY_LEVEL = 14,
  OT_NETWORK_DIAGNOSTIC_TLV_SUPPLY_VOLTAGE = 15,
  OT_NETWORK_DIAGNOSTIC_TLV_CHILD_TABLE = 16,
  OT_NETWORK_DIAGNOSTIC_TLV_CHANNEL_PAGES = 17,
  OT_NETWORK_DIAGNOSTIC_TLV_TYPE_LIST = 18,
  OT_NETWORK_DIAGNOSTIC_TLV_MAX_CHILD_TIMEOUT = 19
}
تعداد
otDeviceRole{
  OT_DEVICE_ROLE_DISABLED = 0,
  OT_DEVICE_ROLE_DETACHED = 1,
  OT_DEVICE_ROLE_CHILD = 2,
  OT_DEVICE_ROLE_ROUTER = 3,
  OT_DEVICE_ROLE_LEADER = 4
}
تعداد
يمثل دور جهاز Thread.
otNetDataPublisherEvent{
  OT_NETDATA_PUBLISHER_EVENT_ENTRY_ADDED = 0,
  OT_NETDATA_PUBLISHER_EVENT_ENTRY_REMOVED = 1
}
تعداد
تمثل هذه الرسوم البيانية الأحداث التي تم الإبلاغ عنها من استدعاءات الناشر.
otRoutePreference{
  OT_ROUTE_PREFERENCE_LOW = -1,
  OT_ROUTE_PREFERENCE_MED = 0,
  OT_ROUTE_PREFERENCE_HIGH = 1
}
تعداد
لتحديد قيم صالحة لـ mPreference في otExternalRouteConfig وotBorderRouterConfig.

رفوف النوع

otBorderRouterConfig typedef
تمثل هذه البنية ضبط جهاز توجيه الحدود.
otExternalRouteConfig typedef
تمثل هذه البنية ضبط مسار خارجي.
otIpCounters typedef
struct otIpCounters
تمثل هذه البنية العدادات على مستوى عنوان IP.
otLeaderData typedef
struct otLeaderData
تمثّل هذه البنية بيانات العملاء المحتملين.
otLinkModeConfig typedef
تمثل هذه البنية ضبط وضع رابط MLE.
otMleCounters typedef
struct otMleCounters
تمثل هذه البنية عدادات MLE Thread.
otNeighborInfoIterator typedef
int16_t
كان يُستخدم وتكرارًا من خلال جدول مجاور.
otNetDataDnsSrpServicePublisherCallback)(otNetDataPublisherEvent aEvent, void *aContext) typedef
void(*
يحدد نوع مؤشر الدالة هذا معاودة الاتصال المستخدمة للإشعار عندما تتم إضافة &&quot؛نظام أسماء النطاقات/SRP خدمة&quot؛ عند إضافة أو إزالة من بيانات Thread Network.
otNetDataPrefixPublisherCallback)(otNetDataPublisherEvent aEvent, const otIp6Prefix *aPrefix, void *aContext) typedef
void(*
يعرِّف نوع مؤشر الدالة هذا رد الاتصال المستخدَم لإرسال إشعار عند إضافة بادئة (مسار داخلي أو مسار خارجي) إلى بيانات سلسلة المحادثات أو إزالتها منها.
otNetDataPublisherEvent typedef
تمثل هذه الرسوم البيانية الأحداث التي تم الإبلاغ عنها من استدعاءات الناشر.
otNetworkDataIterator typedef
uint32_t
يُستخدم لتجديد معلومات شبكة البيانات.
otNetworkDiagChildEntry typedef
تمثل هذه البنية إدخال جدول بيانات تشخيصية للشبكة.
otNetworkDiagConnectivity typedef
تمثل هذه البنية قيمة اتصال بيانات تشخيص الشبكة.
otNetworkDiagIterator typedef
uint16_t
كان يُستخدم وتكرارًا من خلال TLV تشخيص بيانات الشبكة.
otNetworkDiagMacCounters typedef
تمثل هذه البنية قيمة عدّادات Mac تشخيصية للشبكة.
otNetworkDiagRoute typedef
تمثل هذه البنية قيمة TLV لمسار تشخيص الشبكة.
otNetworkDiagRouteData typedef
تمثل هذه البنية بيانات مسار بيانات تشخيص الشبكة.
otNetworkDiagTlv typedef
تمثل هذه البنية TLV.
otReceiveDiagnosticGetCallback)(otError aError, otMessage *aMessage, const otMessageInfo *aMessageInfo, void *aContext) typedef
void(*
يتم استدعاء مؤشر الدالة هذا عند تلقي استجابة الحصول على بيانات تشخيص الشبكة.
otRoutePreference typedef
لتحديد قيم صالحة لـ mPreference في otExternalRouteConfig وotBorderRouterConfig.
otServerConfig typedef
تمثل هذه البنية إعداد الخادم.
otServiceConfig typedef
تمثل هذه البنية ضبط الخدمة.
otThreadAnycastLocatorCallback)(void *aContext, otError aError, const otIp6Address *aMeshLocalAddress, uint16_t aRloc16) typedef
void(*
يحدّد نوع مؤشر الدالة هذا معاودة الاتصال لإبلاغ نتيجة طلب otThreadLocateAnycastDestination().
otThreadDiscoveryRequestCallback)(const otThreadDiscoveryRequestInfo *aInfo, void *aContext) typedef
void(*
يتم استدعاء مؤشر الدالة هذا في كل مرة يتم فيها تلقي رسالة طلب استكشاف MLE.
otThreadDiscoveryRequestInfo typedef
تمثل هذه البنية بيانات طلب اكتشاف سلسلة المحادثات.
otThreadParentResponseCallback)(otThreadParentResponseInfo *aInfo, void *aContext) typedef
void(*
يتم استدعاء مؤشر الدالة هذا في كل مرة يتم فيها تلقي رسالة استجابة رئيسية MLE.
otThreadParentResponseInfo typedef
تمثل هذه البنية بيانات استجابة MLE الرئيسية.

الدوال

otNetDataContainsOmrPrefix(otInstance *aInstance, const otIp6Prefix *aPrefix)
bool
تتحقّق هذه الدالة مما إذا كانت بادئة معيّنة يمكنها العمل كبادئة OMR صالحة وتحتوي أيضًا بيانات الشبكة للقائد على هذه البادئة.
otNetDataGet(otInstance *aInstance, bool aStable, uint8_t *aData, uint8_t *aDataLength)
توفر هذه الطريقة نسخة كاملة أو ثابتة من بيانات شبكة سلسلة الأقسام.
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
تدل هذه الدالة على ما إذا كان تتم حاليًا إضافة الإدخال &quot&DNS/SRP Service" إلى بيانات شبكة Thread.
otNetDataIsPrefixAdded(otInstance *aInstance, const otIp6Prefix *aPrefix)
bool
تشير هذه الدالة إلى ما إذا كان قد تمت إضافة إدخال بادئة منشورة (مثل التوجيه الداخلي أو الشبكة المتداخلة) إلى بيانات شبكة Thread.
otNetDataPublishDnsSrpServiceAnycast(otInstance *aInstance, uint8_t aSequenceNUmber)
void
تطلب هذه الدالة &"نظام أسماء النطاقات/SRP خدمة بث متوافق مع أي مصدر&quot؛ في بيانات شبكة Thread.
otNetDataPublishDnsSrpServiceUnicast(otInstance *aInstance, const otIp6Address *aAddress, uint16_t aPort)
void
تطلب هذه الدالة نشر "DNS/SRP Service Unicast Address&quot في بيانات شبكة Thread.
otNetDataPublishDnsSrpServiceUnicastMeshLocalEid(otInstance *aInstance, uint16_t aPort)
void
تطلب هذه الدالة نشر "DNS/SRP Service Unicast Address&quot في بيانات شبكة Thread.
otNetDataPublishExternalRoute(otInstance *aInstance, const otExternalRouteConfig *aConfig)
تطلب هذه الدالة بادئة مسار خارجي لنشرها في بيانات شبكة Thread.
otNetDataPublishOnMeshPrefix(otInstance *aInstance, const otBorderRouterConfig *aConfig)
تطلب هذه الدالة بادئة على الشبكة المتداخلة ليتم نشرها في بيانات شبكة Thread.
otNetDataSetDnsSrpServicePublisherCallback(otInstance *aInstance, otNetDataDnsSrpServicePublisherCallback aCallback, void *aContext)
void
تضبط هذه الدالة استدعاءً للإبلاغ عند إضافة خدمة &نظام أسماء النطاقات/SRP المنشورة إلى بيانات شبكة سلسلة المحادثات أو إزالتها منها.
otNetDataSetPrefixPublisherCallback(otInstance *aInstance, otNetDataPrefixPublisherCallback aCallback, void *aContext)
void
تضبط هذه الدالة استدعاءً للإبلاغ عند إضافة إدخال بادئة منشورة إلى بيانات سلسلة المحادثات أو إزالتها منها.
otNetDataSteeringDataCheckJoiner(otInstance *aInstance, const otExtAddress *aEui64)
تحقق مما إذا كانت بيانات التوجيه تتضمن رابطًا.
otNetDataSteeringDataCheckJoinerWithDiscerner(otInstance *aInstance, const struct otJoinerDiscerner *aDiscerner)
تحقّق مما إذا كانت بيانات التوجيه تتضمّن رابطًا ذا قيمة مميّزة معيّنة.
otNetDataUnpublishDnsSrpService(otInstance *aInstance)
void
تلغي هذه الوظيفة نشر أي من &&quot؛نظام أسماء النطاقات/SRP (أي بث أو Unicast){/1} مُضاف من قبل من بيانات شبكة سلاسل المحادثات.
otNetDataUnpublishPrefix(otInstance *aInstance, const otIp6Prefix *aPrefix)
تلغي هذه الدالة نشر بادئة تم نشرها مسبقًا (مسار داخلي أو خارجي).
otThreadBecomeChild(otInstance *aInstance)
حاول إعادة التوصيل كطفل.
otThreadBecomeDetached(otInstance *aInstance)
يمكنك إجراء فصل عن شبكة Thread.
otThreadDeviceRoleToString(otDeviceRole aRole)
const char *
حوِّل دور الجهاز إلى سلسلة يمكن للمستخدمين قراءتها.
otThreadDiscover(otInstance *aInstance, uint32_t aScanChannels, uint16_t aPanId, bool aJoiner, bool aEnableEui64Filtering, otHandleActiveScanResult aCallback, void *aCallbackContext)
تبدأ هذه الدالة فحص سلسلة المحادثات.
otThreadGetChildTimeout(otInstance *aInstance)
uint32_t
يمكنك استخدام "المهلة الفرعية لسلاسل المحادثات" عند التشغيل في دور "الطفل".
otThreadGetDeviceRole(otInstance *aInstance)
الحصول على دور الجهاز.
otThreadGetDomainName(otInstance *aInstance)
const char *
احصل على اسم نطاق سلسلة المحادثات.
otThreadGetExtendedPanId(otInstance *aInstance)
const otExtendedPanId *
احصل على رقم تعريف PAN الموسَّع 802.15.4.
otThreadGetFixedDuaInterfaceIdentifier(otInstance *aInstance)
احصل على معرف الواجهة يدويًا لعنوان Unicast لنطاق سلسلة المحادثات.
otThreadGetIp6Counters(otInstance *aInstance)
const otIpCounters *
الحصول على عدادات IPv6.
otThreadGetKeySequenceCounter(otInstance *aInstance)
uint32_t
احصل على thrKeySerialCounter.
otThreadGetKeySwitchGuardTime(otInstance *aInstance)
uint32_t
احصل على thrKeySwitchGuardTime.
otThreadGetLeaderData(otInstance *aInstance, otLeaderData *aLeaderData)
تحصل هذه الدالة على بيانات Thread Lead.
otThreadGetLeaderRloc(otInstance *aInstance, otIp6Address *aLeaderRloc)
تعرض هذه الدالة مؤشرًا إلى RLOC للقائد.
otThreadGetLeaderRouterId(otInstance *aInstance)
uint8_t
احصل على رقم تعريف موجّه القائد.
otThreadGetLeaderWeight(otInstance *aInstance)
uint8_t
احصل على وزن القائد.
otThreadGetLinkLocalAllThreadNodesMulticastAddress(otInstance *aInstance)
const otIp6Address *
تعرِض هذه الدالة عنوان البث المتعدد لعُقد سلاسل المحادثات المحلية.
otThreadGetLinkLocalIp6Address(otInstance *aInstance)
const otIp6Address *
تعرض هذه الدالة عنوان IPv6 المحلي لرابط سلسلة المحادثات.
otThreadGetLinkMode(otInstance *aInstance)
احصل على إعداد وضع رابط MLE.
otThreadGetMeshLocalEid(otInstance *aInstance)
const otIp6Address *
تعرض هذه الدالة مؤشرًا إلى عنوان EID المحلي في Esh.
otThreadGetMeshLocalPrefix(otInstance *aInstance)
تعرض هذه الدالة مؤشرًا إلى بادئة الشبكة المتداخلة المحلية.
otThreadGetMleCounters(otInstance *aInstance)
const otMleCounters *
الحصول على عدادات MLE Thread.
otThreadGetNetworkKey(otInstance *aInstance, otNetworkKey *aNetworkKey)
void
احصل على مفتاح سلسلة المحادثات.
otThreadGetNetworkKeyRef(otInstance *aInstance)
احصل على otNetworkKeyRef لمفتاح شبكة سلسلة المحادثات.
otThreadGetNetworkName(otInstance *aInstance)
const char *
احصل على اسم سلسلة المحادثات.
otThreadGetNextDiagnosticTlv(const otMessage *aMessage, otNetworkDiagIterator *aIterator, otNetworkDiagTlv *aNetworkDiagTlv)
تحصل هذه الدالة على ملف TLV التشخيصي التالي في الرسالة.
otThreadGetNextNeighborInfo(otInstance *aInstance, otNeighborInfoIterator *aIterator, otNeighborInfo *aInfo)
تحصل هذه الدالة على المعلومات المجاورة.
otThreadGetParentAverageRssi(otInstance *aInstance, int8_t *aParentRssi)
تسترد الدالة متوسط RSSI للعنصر الرئيسي Thread.
otThreadGetParentInfo(otInstance *aInstance, otRouterInfo *aParentInfo)
تسترد الدالة معلومات التشخيص لجهاز توجيه سلسلة المحادثات كوالد رئيسي.
otThreadGetParentLastRssi(otInstance *aInstance, int8_t *aLastRssi)
تسترد الدالة RSSI للحزمة الأخيرة من العنصر الرئيسي لسلسلة المحادثات.
otThreadGetPartitionId(otInstance *aInstance)
uint32_t
احصل على رقم تعريف القسم.
otThreadGetRealmLocalAllThreadNodesMulticastAddress(otInstance *aInstance)
const otIp6Address *
تعرض هذه الدالة عنوان البث المتعدد لعقدة سلسلة محادثات محلية.
otThreadGetRloc(otInstance *aInstance)
const otIp6Address *
تعرِض هذه الدالة مؤشرًا إلى عنوان محدِّد موقع سلسلة المحادثات (RLOC).
otThreadGetRloc16(otInstance *aInstance)
uint16_t
احصل على RLOC16.
otThreadGetServiceAloc(otInstance *aInstance, uint8_t aServiceId, otIp6Address *aServiceAloc)
تسترد هذه الدالة ALOC للخدمة لرقم تعريف خدمة معيّن.
otThreadGetVersion(void)
uint16_t
تحصل هذه الدالة على إصدار بروتوكول Thread.
otThreadIsAnycastLocateInProgress(otInstance *aInstance)
bool
تشير هذه الدالة إلى ما إذا كان طلب تحديد الموقع الجغرافي لـ Anycast قيد التقدم حاليًا.
otThreadIsDiscoverInProgress(otInstance *aInstance)
bool
تحدِّد هذه الدالة ما إذا كان استكشاف سلسلة MLE قيد التقدم حاليًا.
otThreadIsSingleton(otInstance *aInstance)
bool
تشير هذه الدالة إلى ما إذا كانت العقدة هي جهاز التوجيه الوحيد على الشبكة.
otThreadLocateAnycastDestination(otInstance *aInstance, const otIp6Address *aAnycastAddress, otThreadAnycastLocatorCallback aCallback, void *aContext)
تتطلب هذه الدالة تحديد أقرب موقع لعنوان Anycast محدد.
otThreadRegisterParentResponseCallback(otInstance *aInstance, otThreadParentResponseCallback aCallback, void *aContext)
void
تسجِّل هذه الدالة استدعاءً لتلقي بيانات استجابة MLE Parent.
otThreadResetIp6Counters(otInstance *aInstance)
void
أعِد ضبط عدادات IPv6.
otThreadResetMleCounters(otInstance *aInstance)
void
أعِد ضبط عدادات MLE Thread.
otThreadSendAddressNotification(otInstance *aInstance, otIp6Address *aDestination, otIp6Address *aTarget, otIp6InterfaceIdentifier *aMlIid)
void
ترسل هذه الدالة رسالة إشعار استباقية (ADDR_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)
اضبُط معرّف رقم PAN الموسَّع 802.15.4.
otThreadSetFixedDuaInterfaceIdentifier(otInstance *aInstance, const otIp6InterfaceIdentifier *aIid)
تحديد/محو معرّف الواجهة المحدّد يدويًا لعنوان 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)
اضبط مفتاح شبكة سلسلة المحادثات.
otThreadSetNetworkKeyRef(otInstance *aInstance, otNetworkKeyRef aKeyRef)
اضبط مفتاح شبكة سلسلة المحادثات بوصفه otNetworkKeyRef.
otThreadSetNetworkName(otInstance *aInstance, const char *aNetworkName)
اضبط اسم شبكة Thread.

الهياكل

otBorderRouterConfig

تمثل هذه البنية ضبط جهاز توجيه الحدود.

otExternalRouteConfig

تمثل هذه البنية ضبط مسار خارجي.

otIpCounters

تمثل هذه البنية العدادات على مستوى عنوان IP.

otLeaderData

تمثّل هذه البنية بيانات العملاء المحتملين.

otLinkModeConfig

تمثل هذه البنية ضبط وضع رابط MLE.

otMleCounters

تمثل هذه البنية عدادات MLE Thread.

otNeighborInfo

تتوفّر في هذه البنية معلومات تشخيص خاصة بعقدة سلسلة محادثات مجاورة.

otNetworkDiagChildEntry

تمثل هذه البنية إدخال جدول بيانات تشخيصية للشبكة.

otNetworkDiagConnectivity

تمثل هذه البنية قيمة اتصال بيانات تشخيص الشبكة.

otNetworkDiagMacCounters

تمثل هذه البنية قيمة عدّادات Mac تشخيصية للشبكة.

otNetworkDiagRoute

تمثل هذه البنية قيمة TLV لمسار تشخيص الشبكة.

otNetworkDiagRouteData

تمثل هذه البنية بيانات مسار بيانات تشخيص الشبكة.

otNetworkDiagTlv

تمثل هذه البنية TLV.

otRouterInfo

تتوفّر في هذه البنية معلومات تشخيصية لجهاز توجيه سلسلة المحادثات.

otServerConfig

تمثل هذه البنية إعداد الخادم.

otServiceConfig

تمثل هذه البنية ضبط الخدمة.

otThreadDiscoveryRequestInfo

تمثل هذه البنية بيانات طلب اكتشاف سلسلة المحادثات.

otThreadParentResponseInfo

تمثل هذه البنية بيانات استجابة MLE الرئيسية.

تعداد

تعداد مجهول

 anonymous enum
أماكن إقامة
OT_NETWORK_DIAGNOSTIC_TLV_BATTERY_LEVEL

مستوى شحن TLV للبطارية

OT_NETWORK_DIAGNOSTIC_TLV_CHANNEL_PAGES

صفحات القناة TLV.

OT_NETWORK_DIAGNOSTIC_TLV_CHILD_TABLE

Child Table TLV.

OT_NETWORK_DIAGNOSTIC_TLV_CONNECTIVITY

اتصال TLV.

OT_NETWORK_DIAGNOSTIC_TLV_EXT_ADDRESS

MAC Extended Address TLV.

OT_NETWORK_DIAGNOSTIC_TLV_IP6_ADDR_LIST

تنسيق قائمة عناوين IPv6.

OT_NETWORK_DIAGNOSTIC_TLV_LEADER_DATA

.LV بيانات العملاء

OT_NETWORK_DIAGNOSTIC_TLV_MAC_COUNTERS

عدادات MAC TLV.

OT_NETWORK_DIAGNOSTIC_TLV_MAX_CHILD_TIMEOUT

Max Child Timeout TLV.

OT_NETWORK_DIAGNOSTIC_TLV_MODE

وضع TLV

OT_NETWORK_DIAGNOSTIC_TLV_NETWORK_DATA

Network Data TLV.

OT_NETWORK_DIAGNOSTIC_TLV_ROUTE

Route64 TLV.

OT_NETWORK_DIAGNOSTIC_TLV_SHORT_ADDRESS

العنوان 16 TLV.

OT_NETWORK_DIAGNOSTIC_TLV_SUPPLY_VOLTAGE

توريد جهد كهربائي TLV

OT_NETWORK_DIAGNOSTIC_TLV_TIMEOUT

انتهاء مهلة TLV (الحدّ الأقصى للفترة الزمنية للاستطلاعات بالنسبة إلى SED)

OT_NETWORK_DIAGNOSTIC_TLV_TYPE_LIST

اكتب قائمة TLV.

otDeviceRole

 otDeviceRole

يمثل دور جهاز Thread.

أماكن إقامة
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

تتم إضافة الإدخال المنشور إلى بيانات سلسلة المحادثات.

OT_NETDATA_PUBLISHER_EVENT_ENTRY_REMOVED

تتم إزالة الإدخال المنشور من بيانات شبكة سلسلة المحادثات.

otRoutePreference

 otRoutePreference

لتحديد قيم صالحة لـ mPreference في otExternalRouteConfig وotBorderRouterConfig.

أماكن إقامة
OT_ROUTE_PREFERENCE_HIGH

تفضيل المسار العالي.

OT_ROUTE_PREFERENCE_LOW

تفضيل مسار منخفض.

OT_ROUTE_PREFERENCE_MED

تفضيل مسار متوسط.

رفوف النوع

otBorderRouterConfig

struct otBorderRouterConfig otBorderRouterConfig

تمثل هذه البنية ضبط جهاز توجيه الحدود.

otExternalRouteConfig

struct otExternalRouteConfig otExternalRouteConfig

تمثل هذه البنية ضبط مسار خارجي.

عدادات

struct otIpCounters otIpCounters

تمثل هذه البنية العدادات على مستوى عنوان IP.

otLeaderData

struct otLeaderData otLeaderData

تمثّل هذه البنية بيانات العملاء المحتملين.

otLinkModeConfig

struct otLinkModeConfig otLinkModeConfig

تمثل هذه البنية ضبط وضع رابط MLE.

otMleCounters

struct otMleCounters otMleCounters

تمثل هذه البنية عدادات MLE Thread.

otNeighborInfoIterator

int16_t otNeighborInfoIterator

كان يُستخدم وتكرارًا من خلال جدول مجاور.

otNetDataDnsSrpServicePublisherCallback

void(* otNetDataDnsSrpServicePublisherCallback)(otNetDataPublisherEvent aEvent, void *aContext)

يحدد نوع مؤشر الدالة هذا معاودة الاتصال المستخدمة للإشعار عندما تتم إضافة &&quot؛نظام أسماء النطاقات/SRP خدمة&quot؛ عند إضافة أو إزالة من بيانات Thread Network.

عند استدعاء إجراء الاستدعاء، يتم بشكل مستقل عن ما إذا كان الإدخال ستتم إزالته بواسطة Publisher (على سبيل المثال، عند وجود عدد كبير جدًا من الإدخالات المشابهة في بيانات الشبكة) أو من خلال استدعاء صريح لإلغاء نشر الإدخال (أي استدعاء otNetDataUnpublishDnsSrpService()).

التفاصيل
المعلَمات
[in] aEvent
يشير إلى الحدث (ما إذا كان قد تمت إضافة الإدخال أو إزالته).
[in] aContext
مؤشر للسياق الخاص بالتطبيق.

otNetDataPrefixPublisherCallback

void(* otNetDataPrefixPublisherCallback)(otNetDataPublisherEvent aEvent, const otIp6Prefix *aPrefix, void *aContext)

يعرِّف نوع مؤشر الدالة هذا رد الاتصال المستخدَم لإرسال إشعار عند إضافة بادئة (مسار داخلي أو مسار خارجي) إلى بيانات سلسلة المحادثات أو إزالتها منها.

عند استدعاء إجراء الاستدعاء، يتم بشكل مستقل عن ما إذا كان الإدخال ستتم إزالته بواسطة Publisher (مثلاً، في حال وجود عدد كبير جدًا من الإدخالات المشابهة في بيانات الشبكة) أو من خلال استدعاء صريح لإلغاء نشر الإدخال.

التفاصيل
المعلَمات
[in] aEvent
يشير إلى الحدث (ما إذا كان قد تمت إضافة الإدخال أو إزالته).
[in] aPrefix
مؤشر إلى إدخال البادئة.
[in] aContext
مؤشر للسياق الخاص بالتطبيق.

otNetDataPublisherEvent

enum otNetDataPublisherEvent otNetDataPublisherEvent

تمثل هذه الرسوم البيانية الأحداث التي تم الإبلاغ عنها من استدعاءات الناشر.

otNetworkDataIterator

uint32_t otNetworkDataIterator

يُستخدم لتجديد معلومات شبكة البيانات.

otNetworkDiagChildEntry

struct otNetworkDiagChildEntry otNetworkDiagChildEntry

تمثل هذه البنية إدخال جدول بيانات تشخيصية للشبكة.

otNetworkDiagConnectivity

struct otNetworkDiagConnectivity otNetworkDiagConnectivity

تمثل هذه البنية قيمة اتصال بيانات تشخيص الشبكة.

otNetworkDiagIterator

uint16_t otNetworkDiagIterator

كان يُستخدم وتكرارًا من خلال TLV تشخيص بيانات الشبكة.

otNetworkDiagMacCounters

struct otNetworkDiagMacCounters otNetworkDiagMacCounters

تمثل هذه البنية قيمة عدّادات Mac تشخيصية للشبكة.

راجِع RFC 2863 للحصول على تعريفات حقول الأعضاء.

otNetworkDiagRoute

struct otNetworkDiagRoute otNetworkDiagRoute

تمثل هذه البنية قيمة TLV لمسار تشخيص الشبكة.

otNetworkDiagRouteData

struct otNetworkDiagRouteData otNetworkDiagRouteData

تمثل هذه البنية بيانات مسار بيانات تشخيص الشبكة.

otNetworkDiagTlv

struct otNetworkDiagTlv otNetworkDiagTlv

تمثل هذه البنية TLV.

otReceivedDiagnosticGetCallback

void(* otReceiveDiagnosticGetCallback)(otError aError, otMessage *aMessage, const otMessageInfo *aMessageInfo, void *aContext)

يتم استدعاء مؤشر الدالة هذا عند تلقي استجابة الحصول على بيانات تشخيص الشبكة.

التفاصيل
المعلَمات
[in] aError
الخطأ الذي تعذَّر الحصول عليه.
[in] aMessage
مؤشر إلى المخزن المؤقت للرسائل الذي يحتوي على البيانات الأساسية المستلمة لاستجابة الحصول على الشبكة. متاح فقط عندما يكون aError هو OT_ERROR_NONE.
[in] aMessageInfo
مؤشر إلى معلومات الرسالة في aMessage. متاح فقط عندما يكون aError هو OT_ERROR_NONE.
[in] aContext
مؤشر للسياق الخاص بالتطبيق.

otRoutePreference

enum otRoutePreference otRoutePreference

لتحديد قيم صالحة لـ mPreference في otExternalRouteConfig وotBorderRouterConfig.

otServerConfig

struct otServerConfig otServerConfig

تمثل هذه البنية إعداد الخادم.

otServiceConfig

struct otServiceConfig otServiceConfig

تمثل هذه البنية ضبط الخدمة.

otThreadAnycastLocatorCallback

void(* otThreadAnycastLocatorCallback)(void *aContext, otError aError, const otIp6Address *aMeshLocalAddress, uint16_t aRloc16)

يحدّد نوع مؤشر الدالة هذا معاودة الاتصال لإبلاغ نتيجة طلب otThreadLocateAnycastDestination().

التفاصيل
المعلَمات
[in] aContext
مؤشر إلى سياق عشوائي (يتم تقديمه عند تسجيل معاودة الاتصال)
[in] aError
حدث خطأ أثناء معالجة الطلب. OT_ERROR_NONE تشير إلى نجاح. الإشارة إلى OT_ERROR_Response_TW تشير إلى تعذّر العثور على وجهة. تشير الحالة OT_ERROR_ABORT إلى أنه تم إلغاء الطلب.
[in] aMeshLocalAddress
مؤشر إلى EID محلي في أقرب وجهة لعنوان Anycast عندما يكون aError هو OT_ERROR_NONE، NULL بخلاف ذلك.
[in] aRloc16
RLOC16 للوجهة إذا تم العثور عليها، بخلاف RLOC16 (0xfffe).

otThreadDiscoveryRequestCallback

void(* otThreadDiscoveryRequestCallback)(const otThreadDiscoveryRequestInfo *aInfo, void *aContext)

يتم استدعاء مؤشر الدالة هذا في كل مرة يتم فيها تلقي رسالة طلب استكشاف MLE.

التفاصيل
المعلَمات
[in] aInfo
مؤشر إلى بيانات معلومات طلب الاكتشاف.
[in] aContext
مؤشر لاستدعاء السياق المتعلق بالتطبيق.

otThreadDiscoveryRequestInfo

struct otThreadDiscoveryRequestInfo otThreadDiscoveryRequestInfo

تمثل هذه البنية بيانات طلب اكتشاف سلسلة المحادثات.

otThreadParentResponseCallback

void(* otThreadParentResponseCallback)(otThreadParentResponseInfo *aInfo, void *aContext)

يتم استدعاء مؤشر الدالة هذا في كل مرة يتم فيها تلقي رسالة استجابة رئيسية MLE.

التفاصيل
المعلَمات
[in] aInfo
مؤشر لموقع إلى الحزمة يحتوي على بيانات الإحصاءات.
[in] aContext
مؤشر لاستدعاء السياق الخاص بالعميل.

otThreadParentResponseInfo

struct otThreadParentResponseInfo otThreadParentResponseInfo

تمثل هذه البنية بيانات استجابة MLE الرئيسية.

الدوال

otNetDataContainsOmrPrefix

bool otNetDataContainsOmrPrefix(
  otInstance *aInstance,
  const otIp6Prefix *aPrefix
)

تتحقّق هذه الدالة مما إذا كانت بادئة معيّنة يمكنها العمل كبادئة OMR صالحة وتحتوي أيضًا بيانات الشبكة للقائد على هذه البادئة.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aPrefix
مؤشر إلى بادئة IPv6.
المرتجعات
تحدِّد هذه السمة ما إذا كانت aPrefix بادئة OMR صالحة وتحتوي بيانات المُصدِر على بادئة OMR على aPrefix.

otNetDataGet

otError otNetDataGet(
  otInstance *aInstance,
  bool aStable,
  uint8_t *aData,
  uint8_t *aDataLength
)

توفر هذه الطريقة نسخة كاملة أو ثابتة من بيانات شبكة سلسلة الأقسام.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aStable
صحيح عند نسخ النسخة الثابتة، خطأ عند نسخ النسخة الكاملة.
[out] aData
مؤشر إلى المخزن المؤقت للبيانات.
[in,out] aDataLength
عند الإدخال، يشير حجم المخزن المؤقت للبيانات إلى aData. عند الخروج، عدد وحدات البايت التي تم نسخها.

otNetDataGetNextOnMeshPrefix

otError otNetDataGetNextOnMeshPrefix(
  otInstance *aInstance,
  otNetworkDataIterator *aIterator,
  otBorderRouterConfig *aConfig
)

تحصل هذه الدالة على "بادئة الشبكة المتداخلة التالية" في بيانات شبكة القسم.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in,out] aIterator
مؤشر إلى سياق تكرار بيانات الشبكة. للحصول على أول إدخال على الشبكة المتداخلة يجب ضبطه على OT_network_DATA_ITERATOR_INIT.
[out] aConfig
مؤشر إلى مكان وضع معلومات "بادئة الشبكة المتداخلة"
قيم الإرجاع
OT_ERROR_NONE
تم العثور على بادئة "شبكة متداخلة" التالية.
OT_ERROR_NOT_FOUND
لا تتوفّر بادئة "شبكة متداخلة" لاحقة في بيانات شبكة Thread.

otNetDataGetNextRoute

otError otNetDataGetNextRoute(
  otInstance *aInstance,
  otNetworkDataIterator *aIterator,
  otExternalRouteConfig *aConfig
)

تحصل هذه الدالة على المسار الخارجي التالي في قسم شبكة بيانات القسم.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in,out] aIterator
مؤشر إلى سياق تكرار بيانات الشبكة. للحصول على أول إدخال للمسار الخارجي يجب ضبطه على OT_network_DATA_ITERATOR_INIT.
[out] aConfig
مؤشر إلى مكان وضع معلومات المسار الخارجي.
قيم الإرجاع
OT_ERROR_NONE
تم العثور على المسار الخارجي التالي بنجاح.
OT_ERROR_NOT_FOUND
لا يتوفّر إدخال مسار خارجي خارجي في بيانات "سلسلة المحادثات".

otNetDataGetNextService

otError otNetDataGetNextService(
  otInstance *aInstance,
  otNetworkDataIterator *aIterator,
  otServiceConfig *aConfig
)

تحصل هذه الوظيفة على الخدمة التالية في قسم شبكة بيانات القسم.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in,out] aIterator
مؤشر إلى سياق تكرار بيانات الشبكة. وللحصول على إدخال الخدمة الأول، يجب ضبطه على OT_network_DATA_ITERATOR_INIT.
[out] aConfig
مؤشر إلى مكان وضع معلومات الخدمة.
قيم الإرجاع
OT_ERROR_NONE
تم العثور على الخدمة التالية بنجاح.
OT_ERROR_NOT_FOUND
لا تتوفّر خدمة لاحقة في بيانات شبكة القسم.

otNetDataGetStableVersion

uint8_t otNetDataGetStableVersion(
  otInstance *aInstance
)

احصل على إصدار بيانات الشبكة الثابت.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
الإصدار الثابت لبيانات الشبكة.

otNetDataGetVersion

uint8_t otNetDataGetVersion(
  otInstance *aInstance
)

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

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
إصدار بيانات الشبكة.

otNetDataIsDnsSrpService المضافة

bool otNetDataIsDnsSrpServiceAdded(
  otInstance *aInstance
)

تدل هذه الدالة على ما إذا كان تتم حاليًا إضافة الإدخال &quot&DNS/SRP Service" إلى بيانات شبكة Thread.

تتطلب هذه الدالة تفعيل الميزة OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
قيم الإرجاع
TRUE
تتم إضافة إدخال خدمة نظام أسماء النطاقات/SRP المنشورة إلى بيانات شبكة Thread.
FALSE
لا تتم إضافة الإدخال إلى بيانات سلسلة المحادثات أو ليس هناك إدخال للنشر.

otNetDataIsPrefix المضافة

bool otNetDataIsPrefixAdded(
  otInstance *aInstance,
  const otIp6Prefix *aPrefix
)

تشير هذه الدالة إلى ما إذا كان قد تمت إضافة إدخال بادئة منشورة (مثل التوجيه الداخلي أو الشبكة المتداخلة) إلى بيانات شبكة Thread.

تتطلب هذه الدالة تفعيل الميزة OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aPrefix
مؤشر للبادئة (MUST NOT NULL).
قيم الإرجاع
TRUE
تتم إضافة إدخال البادئة المنشور إلى بيانات شبكة سلسلة المحادثات.
FALSE
لا تتم إضافة الإدخال إلى بيانات سلسلة المحادثات أو ليس هناك إدخال للنشر.

otNetDataPublishDnsSrpServiceAnycast

void otNetDataPublishDnsSrpServiceAnycast(
  otInstance *aInstance,
  uint8_t aSequenceNUmber
)

تطلب هذه الدالة &"نظام أسماء النطاقات/SRP خدمة بث متوافق مع أي مصدر&quot؛ في بيانات شبكة Thread.

تتطلب هذه الدالة تفعيل الميزة OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE.

سينتج عن الاستدعاء لهذه الدالة إزالة أي إدخال &سابق سابق خاص بنظام "&نظام أسماء النطاقات/SRP" واستبدال هذا الإدخال الذي تم نشره (من الاستدعاء السابق لأي من وظائف otNetDataPublishDnsSrpService{Type}()).

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aSequenceNUmber
رقم تسلسل خدمة DNS/SRP Anycast.

otNetDataPublishDnsSrpServiceUnicast

void otNetDataPublishDnsSrpServiceUnicast(
  otInstance *aInstance,
  const otIp6Address *aAddress,
  uint16_t aPort
)

تطلب هذه الدالة نشر "DNS/SRP Service Unicast Address&quot في بيانات شبكة Thread.

تتطلب هذه الدالة تفعيل الميزة OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE.

سينتج عن الاستدعاء لهذه الدالة إزالة أي إدخال &سابق سابق خاص بنظام "&نظام أسماء النطاقات/SRP" واستبدال هذا الإدخال الذي تم نشره (من الاستدعاء السابق لأي من وظائف otNetDataPublishDnsSrpService{Type}()).

تنشر هذه الدالة العنوان "DNS/SRP Service Unicast ، بما في ذلك العنوان ومعلومات المنفذ في بيانات خدمة TLV.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aAddress
عنوان خادم نظام أسماء النطاقات/SRP للنشر (يجب ألا يكون فارغًا).
[in] aPort
رقم منفذ خادم SRP للنشر.

otNetDataPublishDnsSrpServiceUnicastMeshLocalEid

void otNetDataPublishDnsSrpServiceUnicastMeshLocalEid(
  otInstance *aInstance,
  uint16_t aPort
)

تطلب هذه الدالة نشر "DNS/SRP Service Unicast Address&quot في بيانات شبكة Thread.

تتطلب هذه الدالة تفعيل الميزة OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE.

سينتج عن الاستدعاء لهذه الدالة إزالة أي إدخال &سابق سابق خاص بنظام "&نظام أسماء النطاقات/SRP" واستبدال هذا الإدخال الذي تم نشره (من الاستدعاء السابق لأي من وظائف otNetDataPublishDnsSrpService{Type}()).

على عكس otNetDataPublishDnsSrpServiceUnicast() التي تتطلب توفير العنوان المنشور وتتضمّن المعلومات الواردة في بيانات TLV للخدمة، تستخدم هذه الوظيفة رقم EID المحلي على الشبكة المتداخلة والمعلومات في بيانات خادم TLV.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aPort
رقم منفذ خادم SRP للنشر.

otNetDataPublishExternalRoute

otError otNetDataPublishExternalRoute(
  otInstance *aInstance,
  const otExternalRouteConfig *aConfig
)

تطلب هذه الدالة بادئة مسار خارجي لنشرها في بيانات شبكة Thread.

تتطلب هذه الدالة تفعيل الميزة OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE.

لا يمكن نشر سوى الإدخالات الثابتة (بعبارة أخرى،يجب أن تكون قيمة aConfig.mStable صحيحة.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aConfig
ضبط المسار الخارجي للنشر (MUST NOT NULL).
قيم الإرجاع
OT_ERROR_NONE
تم نشر المسار الخارجي بنجاح.
OT_ERROR_INVALID_ARGS
aConfig غير صالحة (بادئة غير صحيحة، أو مجموعات علامات غير صالحة، أو غير ثابتة).
OT_ERROR_ALREADY
يتوفّر إدخال بالبادئة نفسها في القائمة المنشورة من قبل.
OT_ERROR_NO_BUFS
تعذّر تخصيص إدخال للطلب الجديد. يتيح الناشر عددًا محدودًا من الإدخالات (التي تتم مشاركتها بين بادئة الشبكة المتداخلة والمسار الخارجي) التي يتم تحديدها من خلال إعداد OPENTHREAD_CONFIG_NETDATA_PUBLISHER_MAX_PREFIX_ENTRIES.

otNetDataPublishOnMeshPrefix

otError otNetDataPublishOnMeshPrefix(
  otInstance *aInstance,
  const otBorderRouterConfig *aConfig
)

تطلب هذه الدالة بادئة على الشبكة المتداخلة ليتم نشرها في بيانات شبكة Thread.

تتطلب هذه الدالة تفعيل الميزة OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE.

لا يمكن نشر سوى الإدخالات الثابتة (بعبارة أخرى،يجب أن تكون قيمة aConfig.mStable صحيحة.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aConfig
ضبط بادئة on-mesh للنشر (MUST NOT NULL).
قيم الإرجاع
OT_ERROR_NONE
تم نشر البادئة on-mesh بنجاح.
OT_ERROR_INVALID_ARGS
aConfig غير صالحة (بادئة غير صحيحة، أو مجموعات علامات غير صالحة، أو غير ثابتة).
OT_ERROR_ALREADY
يتوفّر إدخال بالبادئة نفسها في القائمة المنشورة من قبل.
OT_ERROR_NO_BUFS
تعذّر تخصيص إدخال للطلب الجديد. يتيح الناشر عددًا محدودًا من الإدخالات (التي تتم مشاركتها بين بادئة الشبكة المتداخلة والمسار الخارجي) التي يتم تحديدها من خلال إعداد OPENTHREAD_CONFIG_NETDATA_PUBLISHER_MAX_PREFIX_ENTRIES.

otNetDataSetDnsSrpServicePublisherCallback

void otNetDataSetDnsSrpServicePublisherCallback(
  otInstance *aInstance,
  otNetDataDnsSrpServicePublisherCallback aCallback,
  void *aContext
)

تضبط هذه الدالة استدعاءً للإبلاغ عند إضافة خدمة &نظام أسماء النطاقات/SRP المنشورة إلى بيانات شبكة سلسلة المحادثات أو إزالتها منها.

سيحل استدعاء التالي لهذه الدالة محل أي دالة رد اتصال تم إعدادها سابقًا.

تتطلب هذه الدالة تفعيل الميزة OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aCallback
مؤشر دالة رد الاتصال (يمكن تركه فارغًا إذا لم يكن هناك حاجة إليه).
[in] aContext
مؤشر للسياق الخاص بالتطبيق (يُستخدَم عند استدعاء aCallback).

otNetDataSetPrefixPublisherPublisherback

void otNetDataSetPrefixPublisherCallback(
  otInstance *aInstance,
  otNetDataPrefixPublisherCallback aCallback,
  void *aContext
)

تضبط هذه الدالة استدعاءً للإبلاغ عند إضافة إدخال بادئة منشورة إلى بيانات سلسلة المحادثات أو إزالتها منها.

سيحل استدعاء التالي لهذه الدالة محل أي دالة رد اتصال تم إعدادها سابقًا.

تتطلب هذه الدالة تفعيل الميزة OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aCallback
مؤشر دالة رد الاتصال (يمكن تركه فارغًا إذا لم يكن هناك حاجة إليه).
[in] aContext
مؤشر للسياق الخاص بالتطبيق (يُستخدَم عند استدعاء aCallback).

otNetDataSteeringDataCheckانضمام

otError otNetDataSteeringDataCheckJoiner(
  otInstance *aInstance,
  const otExtAddress *aEui64
)

تحقق مما إذا كانت بيانات التوجيه تتضمن رابطًا.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aEui64
مؤشر للوصلة الدخول إلى شبكة IEEE EUI-64.
قيم الإرجاع
OT_ERROR_NONE
يتم تضمين aEui64 في بيانات التوجيه.
OT_ERROR_INVALID_STATE
لا تتوفّر أي بيانات قيادة.
OT_ERROR_NOT_FOUND
لم يتم تضمين aEui64 في بيانات التوجيه.

otNetDataSteeringDataCheckjoinerWithDiscerner

otError otNetDataSteeringDataCheckJoinerWithDiscerner(
  otInstance *aInstance,
  const struct otJoinerDiscerner *aDiscerner
)

تحقّق مما إذا كانت بيانات التوجيه تتضمّن رابطًا ذا قيمة مميّزة معيّنة.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aDiscerner
مؤشر إلى مميِّز المفصل.
قيم الإرجاع
OT_ERROR_NONE
يتم تضمين aDiscerner في بيانات التوجيه.
OT_ERROR_INVALID_STATE
لا تتوفّر أي بيانات قيادة.
OT_ERROR_NOT_FOUND
لم يتم تضمين aDiscerner في بيانات التوجيه.

otNetDataUnpublishDnsSrpService

void otNetDataUnpublishDnsSrpService(
  otInstance *aInstance
)

تلغي هذه الوظيفة نشر أي من &&quot؛نظام أسماء النطاقات/SRP (أي بث أو Unicast){/1} مُضاف من قبل من بيانات شبكة سلاسل المحادثات.

تتطلب هذه الدالة تفعيل الميزة OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE.

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

otNetDataUnpublishPrefix

otError otNetDataUnpublishPrefix(
  otInstance *aInstance,
  const otIp6Prefix *aPrefix
)

تلغي هذه الدالة نشر بادئة تم نشرها مسبقًا (مسار داخلي أو خارجي).

تتطلب هذه الدالة تفعيل الميزة OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aPrefix
البادئة المراد إلغاء نشرها (MUST NOT NULL).
قيم الإرجاع
OT_ERROR_NONE
تم إلغاء نشر البادئة بنجاح.
OT_ERROR_NOT_FOUND
تعذّر العثور على البادئة في القائمة المنشورة.

otThreadGetChild

otError otThreadBecomeChild(
  otInstance *aInstance
)

حاول إعادة التوصيل كطفل.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
قيم الإرجاع
OT_ERROR_NONE
بدأت محاولة أن تصبح طفلاً بنجاح.
OT_ERROR_INVALID_STATE
تم إيقاف سلسلة المحادثات.

otThreadGetDetached

otError otThreadBecomeDetached(
  otInstance *aInstance
)

يمكنك إجراء فصل عن شبكة Thread.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
قيم الإرجاع
OT_ERROR_NONE
تم فصل البيانات عن شبكة Thread بنجاح.
OT_ERROR_INVALID_STATE
تم إيقاف سلسلة المحادثات.

otThreadDeviceRoleToString

const char * otThreadDeviceRoleToString(
  otDeviceRole aRole
)

حوِّل دور الجهاز إلى سلسلة يمكن للمستخدمين قراءتها.

التفاصيل
المعلَمات
[in] aRole
دور الجهاز المطلوب تحويله.
المرتجعات
سلسلة تمثّل aRole.

otThreadDiscover

otError otThreadDiscover(
  otInstance *aInstance,
  uint32_t aScanChannels,
  uint16_t aPanId,
  bool aJoiner,
  bool aEnableEui64Filtering,
  otHandleActiveScanResult aCallback,
  void *aCallbackContext
)

تبدأ هذه الدالة فحص سلسلة المحادثات.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aScanChannels
متّجه قليلاً يشير إلى القنوات التي يجب البحث عنها (على سبيل المثال، OT_CHANNEL_11_MASK).
[in] aPanId
فلتر رقم PAN (ضبط على PAN للبث لإيقاف الفلترة).
[in] aJoiner
قيمة علامة "الطالب" في طلب TLV في ميزة "اقتراحات"
[in] aEnableEui64Filtering
صواب لفلترة الردود على EUI-64 أو FALSE في الحالات الأخرى.
[in] aCallback
اكتمال مؤشر لدالة تُسمى تلقّي استجابة استكشاف MLE أو اكتمال المسح.
[in] aCallbackContext
مؤشر للسياق الخاص بالتطبيق.
قيم الإرجاع
OT_ERROR_NONE
تم بدء البحث عن سلاسل المحادثات بنجاح.
OT_ERROR_INVALID_STATE
واجهة IPv6 غير مفعّلة (netif is not up).
OT_ERROR_NO_BUFS
تعذّر تخصيص الرسالة لطلب الاكتشاف.
OT_ERROR_BUSY
جارٍ البحث عن Thread Discovery.

otThreadGetChildTimeout

uint32_t otThreadGetChildTimeout(
  otInstance *aInstance
)

يمكنك استخدام "المهلة الفرعية لسلاسل المحادثات" عند التشغيل في دور "الطفل".

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
قيمة مهلة سلسلة المحادثات الفرعية بالثواني.
يُرجى الاطِّلاع أيضًا على:
otThreadSetChildTimeout

otThreadGetDeviceRole

otDeviceRole otThreadGetDeviceRole(
  otInstance *aInstance
)

الحصول على دور الجهاز.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
قيم الإرجاع
OT_DEVICE_ROLE_DISABLED
تم إيقاف حزمة سلاسل المحادثات.
OT_DEVICE_ROLE_DETACHED
الجهاز غير مشارك حاليًا في شبكة/قسم سلسلة محادثات.
OT_DEVICE_ROLE_CHILD
يعمل الجهاز حاليًا كسلسلة محادثات فرعية.
OT_DEVICE_ROLE_ROUTER
يعمل الجهاز حاليًا باسم جهاز توجيه سلسلة المحادثات.
OT_DEVICE_ROLE_LEADER
يعمل الجهاز حاليًا كقائد سلسلة محادثات.

otThreadGetDomainName

const char * otThreadGetDomainName(
  otInstance *aInstance
)

احصل على اسم نطاق سلسلة المحادثات.

لا تتوفر هذه الوظيفة إلا منذ سلسلة المحادثات 1.2.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
مؤشر إلى اسم نطاق سلسلة المحادثات.
يُرجى الاطِّلاع أيضًا على:
otThreadSetDomainName

otThreadGetExtendedPanId

const otExtendedPanId * otThreadGetExtendedPanId(
  otInstance *aInstance
)

احصل على رقم تعريف PAN الموسَّع 802.15.4.

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

otThreadGetFixedDuaInterfaceIdentifier

const otIp6InterfaceIdentifier * otThreadGetFixedDuaInterfaceIdentifier(
  otInstance *aInstance
)

احصل على معرف الواجهة يدويًا لعنوان Unicast لنطاق سلسلة المحادثات.

لا تتوفر هذه الوظيفة إلا منذ تفعيل Thread 1.2 عند تفعيل OPENTHREAD_CONFIG_DUA_ENABLE.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
مؤشر لمعرّف الواجهة، والذي تم ضبطه يدويًا، أو فارغًا في حال عدم ضبط أي قيمة.
يُرجى أيضًا الاطّلاع على:
otThreadSetFixedDuaInterfaceIdentifier

otthreadGetIp6Counters

const otIpCounters * otThreadGetIp6Counters(
  otInstance *aInstance
)

الحصول على عدادات IPv6.

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

otThreadGetKeySerialCounter

uint32_t otThreadGetKeySequenceCounter(
  otInstance *aInstance
)

احصل على thrKeySerialCounter.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
قيمة thrKeySerialCounter
يُرجى الاطّلاع أيضًا على:
otThreadSetKeySerialCounter

otThreadGetKeySwitchGuardTime

uint32_t otThreadGetKeySwitchGuardTime(
  otInstance *aInstance
)

احصل على thrKeySwitchGuardTime.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
قيمة thrKeySwitchGuardTime (بالساعات).
يُرجى الاطّلاع أيضًا على:
otThreadSetKeySwitchGuardTime

otThreadGetLeaderData

otError otThreadGetLeaderData(
  otInstance *aInstance,
  otLeaderData *aLeaderData
)

تحصل هذه الدالة على بيانات Thread Lead.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[out] aLeaderData
مؤشر إلى مكان وضع بيانات القائد.
قيم الإرجاع
OT_ERROR_NONE
تم استرداد بيانات القائد بنجاح.
OT_ERROR_DETACHED
غير مرفق حاليًا.

otthreadGetLeaderRloc

otError otThreadGetLeaderRloc(
  otInstance *aInstance,
  otIp6Address *aLeaderRloc
)

تعرض هذه الدالة مؤشرًا إلى RLOC للقائد.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[out] aLeaderRloc
مؤشر إلى لعبة RLOC للقائد.
قيم الإرجاع
OT_ERROR_NONE
تمت كتابة RLOC بنجاح في aLeaderRloc.
OT_ERROR_INVALID_ARGS
aLeaderRloc كان فارغًا.
OT_ERROR_DETACHED
غير مرتبط حاليًا بجزء سلسلة محادثات.

otthreadGetLeaderRouterId

uint8_t otThreadGetLeaderRouterId(
  otInstance *aInstance
)

احصل على رقم تعريف موجّه القائد.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
رقم تعريف موجّه القائد.

otthreadGetLeaderWeight

uint8_t otThreadGetLeaderWeight(
  otInstance *aInstance
)

احصل على وزن القائد.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
وزن القائد.

otThreadGetLinkLocalAllThreadNodesAddresscast

const otIp6Address * otThreadGetLinkLocalAllThreadNodesMulticastAddress(
  otInstance *aInstance
)

تعرِض هذه الدالة عنوان البث المتعدد لعُقد سلاسل المحادثات المحلية.

العنوان هو عنوان Multcast يستند إلى بادئة محلية من خلال رابط من نوع Unicast [RFC 3306]، مع:

  • ضبط flgs على 3 (P = 1 وT = 1)
  • ضبط scop على 2
  • تم ضبط الدخول على 64
  • تم ضبط بادئة الشبكة على بادئة الشبكة المتداخلة المحلية
  • تم ضبط رقم تعريف المجموعة على 1.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
مؤشر إلى عنوان البث المتعدد لكل عُقد سلسلة المحادثات المرتبطة بـ Thread Link-Local.

otThreadGetLinkLocalIp6Address

const otIp6Address * otThreadGetLinkLocalIp6Address(
  otInstance *aInstance
)

تعرض هذه الدالة عنوان IPv6 المحلي لرابط سلسلة المحادثات.

يتم اشتقاق العنوان المحلي لرابط سلسلة المحادثات باستخدام IEEE802.15.4 العنوان الموسّع كمُعرّف الواجهة.

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

otThreadGetLinkMode

otLinkModeConfig otThreadGetLinkMode(
  otInstance *aInstance
)

احصل على إعداد وضع رابط MLE.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
ضبط وضع رابط MLE
يُرجى الاطّلاع أيضًا على:
otThreadSetLinkMode

otThreadGetMeshLocalEid

const otIp6Address * otThreadGetMeshLocalEid(
  otInstance *aInstance
)

تعرض هذه الدالة مؤشرًا إلى عنوان EID المحلي في Esh.

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

otThreadGetMeshLocalPrefix

const otMeshLocalPrefix * otThreadGetMeshLocalPrefix(
  otInstance *aInstance
)

تعرض هذه الدالة مؤشرًا إلى بادئة الشبكة المتداخلة المحلية.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
مؤشر إلى البادئة المحلية الشبكة المتداخلة.

otThreadGetMleCounters

const otMleCounters * otThreadGetMleCounters(
  otInstance *aInstance
)

الحصول على عدادات MLE Thread.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
مؤشر إلى عدادات خوارزمية MLE.

otThreadGetNetworkKey

void otThreadGetNetworkKey(
  otInstance *aInstance,
  otNetworkKey *aNetworkKey
)

احصل على مفتاح سلسلة المحادثات.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[out] aNetworkKey
مؤشر إلى otNetworkkey لعرض مفتاح شبكة المحادثات.
يُرجى الاطّلاع أيضًا على:
otThreadSetNetworkKey

otThreadGetNetworkKeyRef

otNetworkKeyRef otThreadGetNetworkKeyRef(
  otInstance *aInstance
)

احصل على otNetworkKeyRef لمفتاح شبكة سلسلة المحادثات.

تتطلب هذه الدالة تفعيل ميزة وقت التشغيل OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
يشير إلى مفتاح شبكة سلسلة المحادثات المخزَّن في الذاكرة.
يُرجى الاطّلاع أيضًا على:
otThreadSetNetworkKeyRef

otThreadGetNetworkName

const char * otThreadGetNetworkName(
  otInstance *aInstance
)

احصل على اسم سلسلة المحادثات.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
مؤشر إلى اسم شبكة سلسلة المحادثات.
يُرجى الاطِّلاع أيضًا على:
otThreadSetNetworkName

otThreadGetNextDiagnosticTlv

otError otThreadGetNextDiagnosticTlv(
  const otMessage *aMessage,
  otNetworkDiagIterator *aIterator,
  otNetworkDiagTlv *aNetworkDiagTlv
)

تحصل هذه الدالة على ملف TLV التشخيصي التالي في الرسالة.

لا يُسمح بالاستدعاء اللاحق لهذه الدالة إلا عندما تكون قيمة العرض الحالية هي OT_ERROR_NONE.

التفاصيل
المعلَمات
[in] aMessage
مؤشر إلى رسالة.
[in,out] aIterator
مؤشر إلى سياق نُسخ بيانات تشخيص الشبكة. للحصول على أول برنامج TLV تشخيصي للشبكة، يجب ضبطه على OT_Network_DIAGNOSTIC_ITERATOR_INIT.
[out] aNetworkDiagTlv
مؤشر إلى مكان وضع معلومات TLV التشخيصية للشبكة.
قيم الإرجاع
OT_ERROR_NONE
تم العثور على جهاز TLV التشخيصي التالي بنجاح.
OT_ERROR_NOT_FOUND
ما مِن TLV تشخيص بيانات الشبكة في الرسالة.
OT_ERROR_PARSE
تعذّر تحليل بيانات تشخيص الشبكة التالية.

otthreadGetNextNeighborInfo

otError otThreadGetNextNeighborInfo(
  otInstance *aInstance,
  otNeighborInfoIterator *aIterator,
  otNeighborInfo *aInfo
)

تحصل هذه الدالة على المعلومات المجاورة.

ويتم استخدامه للإدخال خلال إدخالات الجدول المجاور.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in,out] aIterator
مؤشر إلى سياق المكرر. للحصول على أول إدخال للجار، يجب تعيينه على OT_NEIGHBOR_INFO_ITERATOR_INIT.
[out] aInfo
مؤشر إلى معلومات الجيران.
قيم الإرجاع
OT_ERROR_NONE
تم العثور على الإدخال المجاور التالي بنجاح في الجدول.
OT_ERROR_NOT_FOUND
لا يوجد إدخال مجاور مجاور في الجدول.
OT_ERROR_INVALID_ARGS
قيمة aIterator أو aInfo كانت فارغة.

otThreadGetParentRssi

otError otThreadGetParentAverageRssi(
  otInstance *aInstance,
  int8_t *aParentRssi
)

تسترد الدالة متوسط RSSI للعنصر الرئيسي Thread.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[out] aParentRssi
مؤشر إلى مكان وضع RSSI الرئيسي

otThreadGetParentInfo

otError otThreadGetParentInfo(
  otInstance *aInstance,
  otRouterInfo *aParentInfo
)

تسترد الدالة معلومات التشخيص لجهاز توجيه سلسلة المحادثات كوالد رئيسي.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[out] aParentInfo
مؤشر إلى مكان وضع معلومات جهاز التوجيه الرئيسي.

otthreadGetParentLastRssi

otError otThreadGetParentLastRssi(
  otInstance *aInstance,
  int8_t *aLastRssi
)

تسترد الدالة RSSI للحزمة الأخيرة من العنصر الرئيسي لسلسلة المحادثات.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[out] aLastRssi
مؤشر إلى مكان وضع آخر RSSI.
قيم الإرجاع
OT_ERROR_NONE
تم استرداد بيانات RSSI بنجاح.
OT_ERROR_FAILED
يتعذّر الحصول على بيانات RSSI.
OT_ERROR_INVALID_ARGS
aLastRssi فارغ.

otThreadGet احصل على رقم تعريف

uint32_t otThreadGetPartitionId(
  otInstance *aInstance
)

احصل على رقم تعريف القسم.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
رقم تعريف القسم.

otThreadGetRealmLocalAllThreadNodesMulticastAddress

const otIp6Address * otThreadGetRealmLocalAllThreadNodesMulticastAddress(
  otInstance *aInstance
)

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

العنوان هو عنوان بلد أول يستند إلى نظام Unicast بادئة قائمة من نوع Unicast [RFC 3306]، مع:

  • ضبط flgs على 3 (P = 1 وT = 1)
  • ضبط scop على 3
  • تم ضبط الدخول على 64
  • تم ضبط بادئة الشبكة على بادئة الشبكة المتداخلة المحلية
  • تم ضبط رقم تعريف المجموعة على 1.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
مؤشر إلى عنوان البث المتعدد لعقدة سلاسل المحادثات المحلية

otThreadGetRloc

const otIp6Address * otThreadGetRloc(
  otInstance *aInstance
)

تعرِض هذه الدالة مؤشرًا إلى عنوان محدِّد موقع سلسلة المحادثات (RLOC).

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
مؤشر إلى عنوان محدِّد مواقع سلسلة المحادثات (RLOC).

otThreadGetRloc16

uint16_t otThreadGetRloc16(
  otInstance *aInstance
)

احصل على RLOC16.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
RLOC16.

otThreadGetServiceAloc

otError otThreadGetServiceAloc(
  otInstance *aInstance,
  uint8_t aServiceId,
  otIp6Address *aServiceAloc
)

تسترد هذه الدالة ALOC للخدمة لرقم تعريف خدمة معيّن.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aServiceId
رقم تعريف الخدمة للحصول على ALOC.
[out] aServiceAloc
مؤشر لإخراج خدمة ALOC. يجب ألا يكون فارغًا.
قيم الإرجاع
OT_ERROR_NONE
تم استرداد ALOC للخدمة بنجاح.
OT_ERROR_DETACHED
واجهة سلسلة المحادثات غير مرفقة حاليًا بسلسلة محادثات.

otThreadGetVersion

uint16_t otThreadGetVersion(
  void
)

تحصل هذه الدالة على إصدار بروتوكول Thread.

التفاصيل
المرتجعات
إصدار بروتوكول Thread.

otThreadIsanycastLocateInProgress

bool otThreadIsAnycastLocateInProgress(
  otInstance *aInstance
)

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

لا تتوفّر هذه الوظيفة إلا عند تفعيل OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
صواب إذا كان طلب تحديد موقع Anycast قيد التقدم حاليًا، أو "خطأ" بخلاف.

otThreadIsDiscoverInProgress

bool otThreadIsDiscoverInProgress(
  otInstance *aInstance
)

تحدِّد هذه الدالة ما إذا كان استكشاف سلسلة MLE قيد التقدم حاليًا.

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

otThreadIsSingleton

bool otThreadIsSingleton(
  otInstance *aInstance
)

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

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
قيم الإرجاع
TRUE
هذا الجهاز هو جهاز التوجيه الوحيد في الشبكة.
FALSE
عبارة عن طفل أو ليس جهاز توجيه واحدًا في الشبكة.

otThreadLocateanycastDestination

otError otThreadLocateAnycastDestination(
  otInstance *aInstance,
  const otIp6Address *aAnycastAddress,
  otThreadAnycastLocatorCallback aCallback,
  void *aContext
)

تتطلب هذه الدالة تحديد أقرب موقع لعنوان Anycast محدد.

لا تتوفّر هذه الوظيفة إلا عند تفعيل OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE.

إذا كان الطلب السابق مستمرًا، سيؤدي الاستدعاء التالي لهذه الدالة إلى إلغاء الطلب السابق واستبداله.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aAnycastAddress
عنوان Anycast لتحديد موقعه. يجب ألا يكون فارغًا.
[in] aCallback
دالة رد الاتصال للإبلاغ عن النتيجة
[in] aContext
يتم استخدام سياق عشوائي مع السمة aCallback.
قيم الإرجاع
OT_ERROR_NONE
بدأ الطلب بنجاح. تم استدعاء aCallback للإبلاغ عن النتيجة.
OT_ERROR_INVALID_ARGS
aAnycastAddress ليس عنوان Anycast صالحًا أو aCallback فارغ.
OT_ERROR_NO_BUFS
الخروج من المخزن المؤقت لإعداد رسالة الطلب وإرسالها

otThreadRegisterParentResponseCallback

void otThreadRegisterParentResponseCallback(
  otInstance *aInstance,
  otThreadParentResponseCallback aCallback,
  void *aContext
)

تسجِّل هذه الدالة استدعاءً لتلقي بيانات استجابة MLE Parent.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aCallback
مؤشر إلى دالة يتم استدعاؤها عند تلقّي رسالة استجابة رئيسية من MLE.
[in] aContext
مؤشر لاستدعاء السياق الخاص بالعميل.

عدّاد إعادة الضبط

void otThreadResetIp6Counters(
  otInstance *aInstance
)

أعِد ضبط عدادات IPv6.

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

otThreadResetMleCounters

void otThreadResetMleCounters(
  otInstance *aInstance
)

أعِد ضبط عدادات MLE Thread.

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

otThreadSendAddressNotify

void otThreadSendAddressNotification(
  otInstance *aInstance,
  otIp6Address *aDestination,
  otIp6Address *aTarget,
  otIp6InterfaceIdentifier *aMlIid
)

ترسل هذه الدالة رسالة إشعار استباقية (ADDR_NTF.ntf).

لا تتوفّر هذه الوظيفة إلا عند تفعيل OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aDestination
وجهة إرسال الرسالة ADDR_NTF.ntf
[in] aTarget
العنوان المستهدف للرسالة ADDR_NTF.ntf
[in] aMlIid
معرّف ML-IID للرسالة ADDR_NTF.ntf

otThreadSendDiagnosticGet

otError otThreadSendDiagnosticGet(
  otInstance *aInstance,
  const otIp6Address *aDestination,
  const uint8_t aTlvTypes[],
  uint8_t aCount,
  otReceiveDiagnosticGetCallback aCallback,
  void *aCallbackContext
)

أرسِل طلب الحصول على بيانات تشخيص الشبكة.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aDestination
مؤشر إلى عنوان الوجهة.
[in] aTlvTypes
مصفوفة من أنواع TLV لتشخيص بيانات الشبكة
[in] aCount
عدد الأنواع في aTlvTypes.
[in] aCallback
مؤشر إلى دالة تُسمى عند تلقّي استجابة الحصول على بيانات تشخيص الشبكة أو القيمة فارغ لإيقاف معاودة الاتصال.
[in] aCallbackContext
مؤشر للسياق الخاص بالتطبيق.
قيم الإرجاع
OT_ERROR_NONE
تم وضع ملف DIAG_GET.req في قائمة الانتظار.
OT_ERROR_NO_BUFS
التخزين المؤقت غير كافٍ للرسائل متاح لإرسال DIAG_GET.req.

otThreadSendDiagnosticReset

otError otThreadSendDiagnosticReset(
  otInstance *aInstance,
  const otIp6Address *aDestination,
  const uint8_t aTlvTypes[],
  uint8_t aCount
)

أرسِل طلب إعادة ضبط بيانات تشخيص الشبكة.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aDestination
مؤشر إلى عنوان الوجهة.
[in] aTlvTypes
مصفوفة من أنواع TLV لتشخيص بيانات الشبكة يُسمح في الوقت الحالي بنوع 9 فقط.
[in] aCount
عدد الأنواع في aTlvTypes
قيم الإرجاع
OT_ERROR_NONE
تم وضع الملف DIAG_RST.ntf في قائمة الانتظار.
OT_ERROR_NO_BUFS
التخزين المؤقت غير كافٍ للرسائل متاح لإرسال DIAG_RST.ntf.

otThreadSendProactiveback المتوقّع

otError otThreadSendProactiveBackboneNotification(
  otInstance *aInstance,
  otIp6Address *aTarget,
  otIp6InterfaceIdentifier *aMlIid,
  uint32_t aTimeSinceLastTransaction
)

ترسل هذه الدالة إشعارًا استباقيًا بشأن ظهر ظهر (PRO_BB.ntf) على رابط ظهر العظام.

لا تتوفّر هذه الوظيفة إلا عند تفعيل OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aTarget
العنوان المستهدف للرسالة PRO_BB.ntf.
[in] aMlIid
معرّف ML-IID لرسالة PRO_BB.ntf
[in] aTimeSinceLastTransaction
الوقت منذ آخر معاملة (بالثواني)
قيم الإرجاع
OT_ERROR_NONE
تم إرسال PRO_BB.ntf بنجاح على الرابط الخلفي.
OT_ERROR_NO_BUFS
في حال عدم توفّر مخازن مؤقتة للرسائل.

otThreadSetChildChildTimeout

void otThreadSetChildTimeout(
  otInstance *aInstance,
  uint32_t aTimeout
)

يمكنك تحديد "المهلة الفرعية لسلاسل المحادثات" المستخدمة عند التشغيل في دور "الطفل".

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aTimeout
قيمة المهلة بالثواني.
يُرجى الاطّلاع أيضًا على:
otThreadGetChildTimeout

otThreadSetDiscoveryRequestCallback

void otThreadSetDiscoveryRequestCallback(
  otInstance *aInstance,
  otThreadDiscoveryRequestCallback aCallback,
  void *aContext
)

تضبط هذه الدالة استدعاءً لتلقي بيانات طلب استكشاف MLE.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aCallback
مؤشر إلى دالة يتم استدعاءها عند تلقي رسالة طلب الاكتشاف MLE.
[in] aContext
مؤشر لاستدعاء السياق المتعلق بالتطبيق.

otThreadSetDomainName

otError otThreadSetDomainName(
  otInstance *aInstance,
  const char *aDomainName
)

اضبط اسم نطاق سلسلة المحادثات.

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

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aDomainName
مؤشر إلى اسم نطاق سلسلة المحادثات.
قيم الإرجاع
OT_ERROR_NONE
تم ضبط اسم نطاق سلسلة المحادثات بنجاح.
OT_ERROR_INVALID_STATE
بروتوكولات سلاسل المحادثات مفعّلة.
يُرجى الاطِّلاع أيضًا على:
otThreadGetDomainName

otThreadSetEnabled

otError otThreadSetEnabled(
  otInstance *aInstance,
  bool aEnabled
)

تبدأ هذه الدالة عملية بروتوكول Thread.

يجب أن تكون الواجهة للأعلى عند استدعاء هذه الدالة.

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

otThreadSetExtendedPanId

otError otThreadSetExtendedPanId(
  otInstance *aInstance,
  const otExtendedPanId *aExtendedPanId
)

اضبُط معرّف رقم PAN الموسَّع 802.15.4.

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

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aExtendedPanId
مؤشر إلى رقم PAN الموسَّع 802.15.4.
قيم الإرجاع
OT_ERROR_NONE
تم إعداد رقم PAN الموسَّع بنجاح.
OT_ERROR_INVALID_STATE
بروتوكولات سلاسل المحادثات مفعّلة.
يُرجى الاطّلاع أيضًا على:
otThreadGetExtendedPanId

otThreadSetedDuaInterfaceIdentifier

otError otThreadSetFixedDuaInterfaceIdentifier(
  otInstance *aInstance,
  const otIp6InterfaceIdentifier *aIid
)

تحديد/محو معرّف الواجهة المحدّد يدويًا لعنوان Unicast لنطاق سلسلة المحادثات.

لا تتوفر هذه الوظيفة إلا منذ تفعيل Thread 1.2 عند تفعيل OPENTHREAD_CONFIG_DUA_ENABLE.

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

otThreadSetانضمامه الإعلان

otError otThreadSetJoinerAdvertisement(
  otInstance *aInstance,
  uint32_t aOui,
  const uint8_t *aAdvData,
  uint8_t aAdvDataLength
)

تُحدِّد هذه الطريقة إعلان سلسلة وصلات الانضمام عند اكتشاف شبكة Thread.

يتم استخدام إعلان الانضمام إلى سلسلة المحادثات للسماح للطالب بالإعلان عن معلوماته الخاصة بالتطبيق (مثل معرّف المورّد ومعرّف المنتج والمميّز وما إلى ذلك) عبر TLV.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aOui
قيمة المورّد IEEE OUI التي سيتم تضمينها في إعلان الانضمام. سيتم استخدام وحدات 3 بايت الأقل أهمية، وسيتم تجاهل وحدات البايت الأكثر أهمية.
[in] aAdvData
مؤشر إلى AdvData الذي سيتم تضمينه في إعلان الانضمام.
[in] aAdvDataLength
طول AdvData بالبايت.
قيم الإرجاع
OT_ERROR_NONE
تم بنجاح إعداد إعلان جهة الانضمام.
OT_ERROR_INVALID_ARGS
بيانات AdvData غير صالحة.

otThreadSetKeySerialCounter

void otThreadSetKeySequenceCounter(
  otInstance *aInstance,
  uint32_t aKeySequenceCounter
)

اضبط thrKeySerialCounter.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aKeySequenceCounter
قيمة thrKeySerialCounter
يُرجى الاطّلاع أيضًا على:
otThreadGetKeySerialCounter

otThreadSetKeySwitchGuardTime

void otThreadSetKeySwitchGuardTime(
  otInstance *aInstance,
  uint32_t aKeySwitchGuardTime
)

اضبط thrKeySwitchGuardTime.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aKeySwitchGuardTime
قيمة thrKeySwitchGuardTime (بالساعات).
يمكنك أيضًا الاطّلاع على ما يلي:
otThreadGetKeySwitchGuardTime

otThreadSetLinkMode

otError otThreadSetLinkMode(
  otInstance *aInstance,
  otLinkModeConfig aConfig
)

اضبط إعداد وضع رابط MLE.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aConfig
مؤشر لضبط وضع الرابط.
قيم الإرجاع
OT_ERROR_NONE
تم ضبط إعداد وضع رابط MLE بنجاح.
يمكنك أيضًا الاطّلاع على ما يلي:
otThreadGetLinkMode

otThreadSetMeshLocalPrefix

otError otThreadSetMeshLocalPrefix(
  otInstance *aInstance,
  const otMeshLocalPrefix *aMeshLocalPrefix
)

تضبط هذه الدالة البادئة "الشبكية المتداخلة".

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

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aMeshLocalPrefix
مؤشر إلى البادئة المحلية الشبكة المتداخلة.
قيم الإرجاع
OT_ERROR_NONE
تم إعداد البادئة المحلية "شبكة متداخلة" بنجاح.
OT_ERROR_INVALID_STATE
بروتوكولات سلاسل المحادثات مفعّلة.

otThreadSetNetworkKey

otError otThreadSetNetworkKey(
  otInstance *aInstance,
  const otNetworkKey *aKey
)

اضبط مفتاح شبكة سلسلة المحادثات.

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

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aKey
مؤشر إلى المخزن المؤقت الذي يحتوي على مفتاح شبكة سلسلة المحادثات.
قيم الإرجاع
OT_ERROR_NONE
تم ضبط مفتاح شبكة سلسلة المحادثات بنجاح.
OT_ERROR_INVALID_STATE
بروتوكولات سلاسل المحادثات مفعّلة.
يمكنك أيضًا الاطِّلاع على ما يلي:
otThreadGetNetworkKey

otThreadSetNetworkKeyRef

otError otThreadSetNetworkKeyRef(
  otInstance *aInstance,
  otNetworkKeyRef aKeyRef
)

اضبط مفتاح شبكة سلسلة المحادثات بوصفه otNetworkKeyRef.

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

تتطلب هذه الدالة تفعيل ميزة وقت التشغيل OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aKeyRef
يمكنك الرجوع إلى مفتاح شبكة سلاسل المحادثات.
قيم الإرجاع
OT_ERROR_NONE
تم ضبط مفتاح شبكة سلسلة المحادثات بنجاح.
OT_ERROR_INVALID_STATE
بروتوكولات سلاسل المحادثات مفعّلة.
يُرجى الاطّلاع أيضًا على:
otThreadGetNetworkKeyRef

otThreadSetNetworkName

otError otThreadSetNetworkName(
  otInstance *aInstance,
  const char *aNetworkName
)

اضبط اسم شبكة Thread.

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

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aNetworkName
مؤشر إلى اسم شبكة سلسلة المحادثات.
قيم الإرجاع
OT_ERROR_NONE
تم ضبط اسم سلسلة المحادثات بنجاح.
OT_ERROR_INVALID_STATE
بروتوكولات سلاسل المحادثات مفعّلة.
يُرجى الاطِّلاع أيضًا على:
otThreadGetNetworkName

وحدات ماكرو

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_TYPELIST_MAX_ENTRIES

 OT_NETWORK_DIAGNOSTIC_TYPELIST_MAX_ENTRIES 19

الحد الأقصى لعدد أنواع TLV التشخيصية للشبكة لطلبها أو إعادة ضبطها.

OT_الشبكة_MAX_ROUTER_ID

 OT_NETWORK_MAX_ROUTER_ID 62

الحد الأقصى لرقم تعريف جهاز التوجيه.

OT_server_DATA_MAX_SIZE

 OT_SERVER_DATA_MAX_SIZE 248

الحد الأقصى لحجم بيانات الخادم بالبايت. الحد النظري، أقل عمليًا.

OT_SERVICE_DATA_MAX_SIZE

 OT_SERVICE_DATA_MAX_SIZE 252

الحد الأقصى لحجم بيانات الخدمة بالبايت.

المراجع

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