أسئلة عامة

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

ملخّص

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

تتطلب جميع الدوال في هذه الوحدة تفعيل 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,
  OT_NETWORK_DIAGNOSTIC_TLV_VERSION = 24,
  OT_NETWORK_DIAGNOSTIC_TLV_VENDOR_NAME = 25,
  OT_NETWORK_DIAGNOSTIC_TLV_VENDOR_MODEL = 26,
  OT_NETWORK_DIAGNOSTIC_TLV_VENDOR_SW_VERSION = 27,
  OT_NETWORK_DIAGNOSTIC_TLV_THREAD_STACK_VERSION = 28
}
تعداد
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
}
تعداد
يمثل دور جهاز سلسلة محادثات.
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
يمثل إعدادًا لجهاز توجيه الحدود.
otDetachGracefullyCallback)(void *aContext) typedef
void(*
تُبلغ عملية معاودة الاتصال هذه التطبيق بانتهاء عملية فصل البيانات.
otExternalRouteConfig typedef
يمثل إعدادات مسار خارجي.
otIpCounters typedef
struct otIpCounters
يعرض العدادات على مستوى عنوان IP.
otLeaderData typedef
struct otLeaderData
يمثل بيانات Lead في سلسلة المحادثات.
otLinkModeConfig typedef
يمثّل إعداد "وضع رابط MLE"
otLowpanContextInfo typedef
تمثل معلومات معرّف سياق 6LoWPAN المرتبطة ببادئة في بيانات الشبكة.
otMleCounters typedef
struct otMleCounters
بالنسبة إلى عدّادات Thread MLE.
otNeighborInfoIterator typedef
int16_t
ويتم استخدامه للتكرار من خلال الجدول المجاور.
otNetDataDnsSrpServicePublisherCallback)(otNetDataPublisherEvent aEvent, void *aContext) typedef
void(*
يحدّد نوع المؤشر معاودة الاتصال المستخدمة لإرسال إشعار عند إضافة إدخال "خدمة نظام أسماء النطاقات (DNS)/SRP" إلى بيانات شبكة Thread أو إزالتها منها.
otNetDataPrefixPublisherCallback)(otNetDataPublisherEvent aEvent, const otIp6Prefix *aPrefix, void *aContext) typedef
void(*
يحدّد نوع المؤشر معاودة الاتصال المستخدمة لإرسال إشعار عند إضافة بادئة (شبكة داخلية أو مسار خارجي) إلى بيانات شبكة Thread أو إزالتها منها.
otNetDataPublisherEvent typedef
تمثل الأحداث التي تم الإبلاغ عنها من استدعاءات الناشرين.
otNetworkDataIterator typedef
uint32_t
يُستخدم للتكرار من خلال معلومات بيانات الشبكة.
otNetworkDiagChildEntry typedef
يمثّل إدخال جدول تشخيصي للأطفال على الشبكة.
otNetworkDiagConnectivity typedef
تمثل قيمة الاتصال التشخيصي بالشبكة.
otNetworkDiagIterator typedef
uint16_t
يُستخدَم وتكرارًا من خلال TLV تشخيص الشبكة.
otNetworkDiagMacCounters typedef
تمثل قيمة العدّادات في أداة تشخيص البرامج في الشبكة.
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(*
يتم استدعاء المؤشر في كل مرة يتم فيها تلقّي رسالة رد من أحد الوالدَين.
otThreadParentResponseInfo typedef
يمثّل بيانات ردّ الوالدَين 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)
الحصول على معرّف الواجهة المحدّد يدويًا لعنوان 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)
عرض مؤشر للبادئة المحلية للشبكة المتداخلة.
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
أماكن إقامة
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 الموسّع TLV

OT_NETWORK_DIAGNOSTIC_TLV_IP6_ADDR_LIST

قائمة عناوين IPv6 TLV.

OT_NETWORK_DIAGNOSTIC_TLV_LEADER_DATA

بيانات القائد TLV

OT_NETWORK_DIAGNOSTIC_TLV_MAC_COUNTERS

عدّادات MAC TLV

OT_NETWORK_DIAGNOSTIC_TLV_MAX_CHILD_TIMEOUT

الحد الأقصى لمهلة الجهاز الفرعي للأطفال

OT_NETWORK_DIAGNOSTIC_TLV_MODE

وضع TLV

OT_NETWORK_DIAGNOSTIC_TLV_NETWORK_DATA

بيانات شبكة TLV

OT_NETWORK_DIAGNOSTIC_TLV_ROUTE

Route64 TLV.

OT_NETWORK_DIAGNOSTIC_TLV_SHORT_ADDRESS

العنوان 16 TLV.

OT_NETWORK_DIAGNOSTIC_TLV_SUPPLY_VOLTAGE

توفير الجهد الكهربائي للتيار الكهربائي

OT_NETWORK_DIAGNOSTIC_TLV_THREAD_STACK_VERSION

إصدار TLV من حزمة سلاسل المحادثات.

OT_NETWORK_DIAGNOSTIC_TLV_TIMEOUT

مهلة وصول طلب البحث (الحد الأقصى لفترة الاقتراع إلى SED)

OT_NETWORK_DIAGNOSTIC_TLV_TYPE_LIST

اكتب قائمة TLV.

OT_NETWORK_DIAGNOSTIC_TLV_VENDOR_MODEL

طراز المورّد TLV:

OT_NETWORK_DIAGNOSTIC_TLV_VENDOR_NAME

اسم المورّد TLV

OT_NETWORK_DIAGNOSTIC_TLV_VENDOR_SW_VERSION

إصدار TLV للمورّد

OT_NETWORK_DIAGNOSTIC_TLV_VERSION

الإصدار TLV

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)

تُبلغ عملية معاودة الاتصال هذه التطبيق بانتهاء عملية فصل البيانات.

التفاصيل
المَعلمات
[in] aContext
مؤشر للسياق الخاص بالتطبيق.

otExternalPathConfig

struct otExternalRouteConfig otExternalRouteConfig

يمثل إعدادات مسار خارجي.

عدّاد OtIpCounts

struct otIpCounters otIpCounters

يعرض العدادات على مستوى عنوان IP.

otLeaderData

struct otLeaderData otLeaderData

يمثل بيانات Lead في سلسلة المحادثات.

otLinkModeConfig

struct otLinkModeConfig otLinkModeConfig

يمثّل إعداد "وضع رابط MLE"

otlowpanContextInfo

struct otLowpanContextInfo otLowpanContextInfo

تمثل معلومات معرّف سياق 6LoWPAN المرتبطة ببادئة في بيانات الشبكة.

OotMleCounts

struct otMleCounters otMleCounters

بالنسبة إلى عدّادات Thread MLE.

otNeighborInfoIterator

int16_t otNeighborInfoIterator

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

otNetDataDnsSrpServicePublisherCallback

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

يحدّد نوع المؤشر معاودة الاتصال المستخدمة لإرسال إشعار عند إضافة إدخال "خدمة نظام أسماء النطاقات (DNS)/SRP" إلى بيانات شبكة Thread أو إزالتها منها.

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

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

otNetDataبادئةPublisherCallback

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

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

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

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

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

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

otNetworkDiagTlv

struct otNetworkDiagTlv otNetworkDiagTlv

يمثل TLV لبيانات تشخيص الشبكة.

otReceivedDignGetCallback

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
مؤشر للسياق الخاص بالتطبيق.

المسار المفضّل

enum otRoutePreference otRoutePreference

تعريف القيم الصالحة لـ mPreference في otExternalRouteConfig وotBorderRouterConfig

otServerConfig

struct otServerConfig otServerConfig

تمثل إعدادات الخادم.

otServiceConfig

struct otServiceConfig otServiceConfig

يمثّل إعداد خدمة.

otThreadAndcastLocatorCallback

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

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

التفاصيل
المَعلمات
[in] aContext
مؤشر إلى سياق عشوائي (يتم تقديمه عند تسجيل معاودة الاتصال)
[in] aError
حدث خطأ أثناء معالجة الطلب. يشير OT_ERROR_NONE إلى النجاح. يشير OT_ERROR_RESPONSE_WINDOW إلى تعذُّر العثور على وجهة. تشير OT_ERROR_ABORT إلى أنّه تم إلغاء الطلب.
[in] aMeshLocalAddress
مؤشر إلى معرّف EID المحلي المحلي لأقرب وجهة لعنوان nocast عندما تكون 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)

يتم استدعاء المؤشر في كل مرة يتم فيها تلقّي رسالة رد من أحد الوالدَين.

يتم استخدام هذا في otThreadRegisterParentResponseCallback().

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

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.

التفاصيل
المَعلمات
[in] aDuration
فترة زمنية بالثواني
[out] aBuffer
يشير إلى صفيف من خلال حرف "إخراج" لإخراج السلسلة.
[in] aSize
حجم aBuffer (بالبايت) ننصح باستخدام OT_DURATION_STRING_SIZE.

otNetDataContainsOmrبادئة

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
)

تقديم نسخة كاملة أو ثابتة من بيانات شبكة Thread الخاصة بالقسم

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

otNetDataGetLength

uint8_t otNetDataGetLength(
  otInstance *aInstance
)

احصل على الطول الحالي (عدد وحدات البايت) لبيانات شبكة Thread ضمن القسم.

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

otNetDataGetMaxLength

uint8_t otNetDataGetMaxLength(
  otInstance *aInstance
)

يمكنك الحصول على الحد الأقصى المسموح به لطول بيانات شبكة Thread منذ بدء إعداد مكدّس OT أو منذ آخر استدعاء لـ otNetDataResetMaxLength().

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

otNetDataGetNextlowpanContextInfo

otError otNetDataGetNextLowpanContextInfo(
  otInstance *aInstance,
  otNetworkDataIterator *aIterator,
  otLowpanContextInfo *aContextInfo
)

احصل على معلومات رقم تعريف سياق 6LoWPAN التالية في بيانات الشبكة للقسم.

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

otNetDataGetNextOnMeshبادئة

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.

otNetDataGetNextPath

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
لا يتوفّر إدخال مسار خارجي لاحق في بيانات شبكة Thread.

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
)

يشير هذا الحقل إلى ما إذا كان قد تمت إضافة الإدخال "خدمة نظام أسماء النطاقات (DNS)/SRP" إلى بيانات شبكة Thread أم لا.

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

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

otNetDataIsبادئة المضافة

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

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

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

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

otNetDataPublishDnsSrpServiceAndcast

void otNetDataPublishDnsSrpServiceAnycast(
  otInstance *aInstance,
  uint8_t aSequenceNUmber
)

يطلب هذا الخيار نشر "عنوان نظام أسماء النطاقات/نظام أسماء نطاقات الخدمة" ليتم نشره في بيانات شبكة 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
)

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

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

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

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

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

otNetDataPublishDnsSrpServiceUnicastMeshLocalEid

void otNetDataPublishDnsSrpServiceUnicastMeshLocalEid(
  otInstance *aInstance,
  uint16_t aPort
)

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

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

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

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

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

otNetDataPublishExternalPath

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

تطلب هذه السياسة إضافة بادئة مسار خارجي إلى بيانات Thread Network.

تتطلب هذه الميزة تفعيل 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_NO_BUFS
تعذّر تخصيص إدخال للطلب الجديد. يتيح الناشر عددًا محدودًا من الإدخالات (تتم مشاركتها بين البادئة المتداخلة والمسار الخارجي) التي يتم تحديدها من خلال عملية الإعداد OPENTHREAD_CONFIG_NETDATA_PUBLISHER_MAX_PREFIX_ENTRIES.

otNetDataPublishOnMishPrefix

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

تطلب هذه البادئة منشورًا في بيانات Thread Network.

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

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

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

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

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 ولكن لن تتم إضافتها على الفور. وبدلاً من ذلك، ستبدأ عملية نشره في بيانات الشبكة (مراقبة بيانات الشبكة لتحديد الوقت الذي يتم فيه إضافة البادئة أو في حال إضافتها)، وذلك بناءً على عدد البادئات المشابهة الواردة في بيانات الشبكة).

التفاصيل
المَعلمات
[in] aPrefix
بادئة المسار الخارجي المنشورة سابقًا لاستبدالها.
[in] aConfig
ضبط المسار الخارجي للنشر.
[in] aRequester
مقدِّم الطلب (وحدة kFromUser أو kFromRoutingManager)
قيم الإرجاع
OT_ERROR_NONE
تم نشر المسار الخارجي بنجاح.
OT_ERROR_INVALID_ARGS
إنّ السمة aConfig غير صالحة (بادئة غير صالحة أو تركيبات علامات غير صالحة أو غير ثابتة).
OT_ERROR_NO_BUFS
تعذّر تخصيص إدخال للطلب الجديد. يتيح الناشر عددًا محدودًا من الإدخالات (تتم مشاركتها بين البادئة المتداخلة والمسار الخارجي) التي يتم تحديدها من خلال عملية الإعداد OPENTHREAD_CONFIG_NETDATA_PUBLISHER_MAX_PREFIX_ENTRIES.

otNetDataResetMaxLength

void otNetDataResetMaxLength(
  otInstance *aInstance
)

إعادة ضبط الحد الأقصى لطول بيانات شبكة Thread المتتبّعة.

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

otNetDataSetDnsSrpServicePublisherCallback

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

تُحدِّد معاودة الاتصال للإشعار عندما تتم إضافة "خدمة نظام أسماء النطاقات (DNS)/SRP" المنشورة إلى بيانات شبكة Thread أو إزالتها منها.

يحلّ استدعاء لاحق لهذه الدالة محل أي دالة رد اتصال تم ضبطها في السابق.

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

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

otNetDataSetPrefixPublisherCallback

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

تُحدِّد استدعاءً للإشعار عند إضافة إدخال بادئة منشورة إلى بيانات شبكة Thread أو إزالتها منه.

يحلّ استدعاء لاحق لهذه الدالة محل أي دالة رد اتصال تم ضبطها في السابق.

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

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

otNetDataSteeringDataCheckChecker

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

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

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

otNetDataSteeringDataCheckLinkerWithDiscerner

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
)

يؤدي ذلك إلى إلغاء نشر أي إدخال في خدمة نظام أسماء النطاقات (DNS) أو بروتوكول SRP (أي البث أو Unicast) سبق إضافته من بيانات Thread Network.

يجب تفعيل OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE.

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

otNetDataUnpublishبادئة

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
تعذّر العثور على البادئة في القائمة المنشورة.

otThreadSendChild

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
سلسلة المحادثات غير مفعّلة.

otThreadDetachGracely

otError otThreadDetachGracefully(
  otInstance *aInstance,
  otDetachGracefullyCallback aCallback,
  void *aContext
)

يرسل إشعارًا إلى العُقد الأخرى في الشبكة (إن وجدت) ثم يوقف تشغيل بروتوكول سلسلة المحادثات.

ويتم إرسال إصدار "العنوان" إذا كان جهاز توجيه، أو ضبط مهلة الطفل على 0 إذا كان طفلاً.

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

otThreadDeviceRoleToString

const char * otThreadDeviceRoleToString(
  otDeviceRole aRole
)

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

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

اكتشاف

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

يبدأ البحث عن Thread Discovery.

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

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
يعمل الجهاز حاليًا كقائد سلسلة محادثات.

otThreadGetPermission

const char * otThreadGetDomainName(
  otInstance *aInstance
)

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

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

otThreadGetExtendedPanId

const otExtendedPanId * otThreadGetExtendedPanId(
  otInstance *aInstance
)

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

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

otThreadGetFixedDuaInterfaceId

const otIp6InterfaceIdentifier * otThreadGetFixedDuaInterfaceIdentifier(
  otInstance *aInstance
)

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

متاحة عند تفعيل OPENTHREAD_CONFIG_DUA_ENABLE.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
مؤشر إلى معرِّف الواجهة الذي تم ضبطه يدويًا، أو إلى NULL إذا لم يتم ضبط أي منهما.
يمكنك أيضًا الاطّلاع على ما يلي:
otThreadSetededuuInterfaceIdentifier

عدّاد في ما يخص سلسلة المحادثات

const otIpCounters * otThreadGetIp6Counters(
  otInstance *aInstance
)

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

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

otThreadGetKeyStringCount

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
)

الحصول على بيانات قائد سلسلة المحادثات

التفاصيل
المَعلمات
[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.
المرتجعات
رقم تعريف جهاز التوجيه للقائد

otThreadGetLeaderوزن الوزن

uint8_t otThreadGetLeaderWeight(
  otInstance *aInstance
)

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

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

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.

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

otThreadGetLinkLocalIp6العنوان

const otIp6Address * otThreadGetLinkLocalIp6Address(
  otInstance *aInstance
)

الحصول على عنوان IPv6 المحلي لرابط الرابط.

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

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

otThreadGetLinkMode

otLinkModeConfig otThreadGetLinkMode(
  otInstance *aInstance
)

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

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

otThreadGetMeshLocalEid

const otIp6Address * otThreadGetMeshLocalEid(
  otInstance *aInstance
)

الحصول على عنوان معرّف EID المحلي للشبكة المتداخلة

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

otThreadGetMishLocalPrefix

const otMeshLocalPrefix * otThreadGetMeshLocalPrefix(
  otInstance *aInstance
)

عرض مؤشر للبادئة المحلية للشبكة المتداخلة.

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

otThreadGetMleCounters

const otMleCounters * otThreadGetMleCounters(
  otInstance *aInstance
)

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

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

otThreadGetNetworkKey

void otThreadGetNetworkKey(
  otInstance *aInstance,
  otNetworkKey *aNetworkKey
)

الحصول على مفتاح شبكة Thread

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

otThreadGetNetworkKeyref

otNetworkKeyRef otThreadGetNetworkKeyRef(
  otInstance *aInstance
)

الحصول على otNetworkKeyRef لمفتاح شبكة Thread

تتطلّب هذه الميزة تفعيل إصدار OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE.

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

otThreadGetNetworkName

const char * otThreadGetNetworkName(
  otInstance *aInstance
)

الحصول على اسم شبكة Thread.

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

otThreadGetNextDignTlv

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

الحصول على TLV تشخيص التشخيص التالي في الرسالة.

يتطلب OPENTHREAD_CONFIG_TMF_NETDIAG_CLIENT_ENABLE.

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

التفاصيل
المَعلمات
[in] aMessage
يشير إلى رسالة.
[in,out] aIterator
مؤشر إلى سياق مكرّر لأداة تشخيص الشبكة. للحصول على أول شبكة تشخيصية للشبكة، يجب ضبطها على 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 فارغة.

otThreadGetParentAvgRssi

otError otThreadGetParentAverageRssi(
  otInstance *aInstance,
  int8_t *aParentRssi
)

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

التفاصيل
المَعلمات
[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 للحزمة الأخيرة من العنصر الرئيسي Thread.

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

otThreadGetPartitionId

uint32_t otThreadGetPartitionId(
  otInstance *aInstance
)

الحصول على معرّف القسم.

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

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.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
مؤشر إلى عنوان البث المتعدد لعُقد Thread Realm-Local All Threads

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
مؤشر لإخراج OCOC من الخدمة يجب ألا يكون فارغًا.
قيم الإرجاع
OT_ERROR_NONE
تم استرداد الخدمة ALOC بنجاح.
OT_ERROR_DETACHED
واجهة سلسلة المحادثات غير مرتبطة حاليًا بجزء سلسلة محادثات.

otThreadGetSellerModel

const char * otThreadGetVendorModel(
  otInstance *aInstance
)

الحصول على سلسلة طراز المورِّد

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

otThreadGetSellerName

const char * otThreadGetVendorName(
  otInstance *aInstance
)

الحصول على سلسلة اسم المورِّد

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

otThreadGetSellerSwVersion

const char * otThreadGetVendorSwVersion(
  otInstance *aInstance
)

الحصول على سلسلة الإصدار الخاصة بميزة المورِّد

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

otThreadGetVersion

uint16_t otThreadGetVersion(
  void
)

للحصول على إصدار بروتوكول Thread

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

otThreadIsAndcastLocateInProgress

bool otThreadIsAnycastLocateInProgress(
  otInstance *aInstance
)

تشير إلى ما إذا كان طلب تحديد موقع أي بث قيد التقدم حاليًا.

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

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

otThreadIsDiscoverInProgress

bool otThreadIsDiscoverInProgress(
  otInstance *aInstance
)

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

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

OotThreadIsأغنية فردية

bool otThreadIsSingleton(
  otInstance *aInstance
)

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

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

otThreadLocateAncastDestination

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

يطلب أقرب وجهة لعنوان بث مباشر محدد.

لا يتوفّر هذا الإعداد إلا عند تفعيل 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 ليست عنوان بث مباشر أو أنّ aCallback غير صحيح.
OT_ERROR_NO_BUFS
خارج المخزن المؤقت لإعداد رسالة الطلب وإرسالها.

otThreadRecordParentResponseCallback

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

تسجيل معاودة الاتصال لتلقّي بيانات ردّ MLE Parent

يتطلب OPENTHREAD_CONFIG_MLE_PARENT_RESPONSE_CALLBACK_API_ENABLE.

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

عدّادات

void otThreadResetIp6Counters(
  otInstance *aInstance
)

إعادة ضبط عدّادات IPv6.

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

otThreadResetMleCounters

void otThreadResetMleCounters(
  otInstance *aInstance
)

يؤدي هذا الخيار إلى إعادة ضبط عدّادات MLE Threads.

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

otThreadSearchForBetterParent

otError otThreadSearchForBetterParent(
  otInstance *aInstance
)

لبدء عملية البحث عن أحد الوالدَين بشكل أفضل مع البقاء على تواصل مع أحد الوالدَين الحالي

يجب استخدام هذه الميزة عندما يكون الجهاز متصلاً بجهاز طفل.

التفاصيل
قيم الإرجاع
OT_ERROR_NONE
تم بدء العملية بنجاح للبحث عن أحد الوالدَين بشكل أفضل.
OT_ERROR_INVALID_STATE
دور الجهاز ليس فرعيًا.

otThreadSendAddressإشعار

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

يتم إرسال رسالة إشعار استباقية بشأن العنوان (userName_NTF.ntf).

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

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

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.

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

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

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

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

يتطلب OPENTHREAD_CONFIG_TMF_NETDIAG_CLIENT_ENABLE.

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

otThreadSendProactiveBackbackNotification

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
في حال عدم توفّر المخزن المؤقت الكافي للرسائل

otThreadSetChildTimeout

void otThreadSetChildTimeout(
  otInstance *aInstance,
  uint32_t aTimeout
)

لضبط مهلة السلسلة الفرعية (بالثواني) المستخدمة عند العمل في الدور الفرعي.

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

otThreadSetSetyRequestCallback

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
)

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

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

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

otThreadSetEnabled

otError otThreadSetEnabled(
  otInstance *aInstance,
  bool aEnabled
)

يبدأ تشغيل بروتوكول Thread.

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

ويؤدي استدعاء هذه الدالة التي تم ضبط aEnabled على "خطأ" إلى إيقاف أي عمليات فصل جارية بدءًا من otThreadDetachGraceful(). وسيتم طلب معاودة الاتصال بها.

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

otThreadSetSetPanId

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

إعداد معرّف IEEE 802.15.4 الموسّع رقم PAN

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

otThreadSetededuuInterInterface

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

تُحدِّد هذه السياسة معرّف الواجهة الذي يتم تحديده يدويًا لعنوان Thread لنطاق Unicast أو يمحوه.

متاحة عند تفعيل OPENTHREAD_CONFIG_DUA_ENABLE.

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

otThreadSetSeterالإعلان

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

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

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

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

otThreadSetKeySerialCount

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 (بالساعات).
يُرجى الاطّلاع أيضًا على:
otThreadGetKeyGuardGuardTime

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
)

ضبط مفتاح شبكة Thread

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

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

otThreadSetNetworkKeyref

otError otThreadSetNetworkKeyRef(
  otInstance *aInstance,
  otNetworkKeyRef aKeyRef
)

اضبط مفتاح شبكة Thread كـ otNetworkKeyRef.

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

تتطلّب هذه الميزة تفعيل إصدار OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE.

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

otThreadSetNetworkName

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

ضبط اسم شبكة Thread

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

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aNetworkName
مؤشر إلى اسم شبكة Thread.
قيم الإرجاع
OT_ERROR_NONE
تم ضبط اسم شبكة Thread بنجاح.
OT_ERROR_INVALID_STATE
بروتوكولات سلاسل المحادثات مفعَّلة.
يُرجى الاطّلاع أيضًا على:
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 الفارغ.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aVendorModel
سلسلة طراز المورِّد.
قيم الإرجاع
OT_ERROR_NONE
تم إعداد نموذج المورِّد بنجاح.
OT_ERROR_INVALID_ARGS
قيمة aVendorModel غير صالحة (طويلة جدًا أو ليست UTF8).

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 الفارغ.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aVendorName
سلسلة اسم المورِّد.
قيم الإرجاع
OT_ERROR_NONE
تم ضبط اسم المورّد بنجاح.
OT_ERROR_INVALID_ARGS
قيمة aVendorName غير صالحة (طويلة جدًا أو ليست UTF8).

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 الفارغ.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aVendorSwVersion
سلسلة إصدار برنامج المورِّد.
قيم الإرجاع
OT_ERROR_NONE
تم ضبط إصدار برنامج المورّد بنجاح.
OT_ERROR_INVALID_ARGS
قيمة aVendorSwVersion غير صالحة (طويلة جدًا أو ليست UTF8).

وحدات ماكرو

الـ 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. للحصول على مزيد من المعلومات أو للمساهمة في المستندات، يمكنك الاطّلاع على المراجع.