تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

أسئلة عامة

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

ملخّص

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

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

ملاحظة: تتطلب الدوال في هذه الوحدة OPENTHREAD_FTD=1 أو OPENTHREAD_MTD=1.

التعدادات
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 `struct otBorderRouterConfig` يمثل إعدادًا لجهاز توجيه الحدود.
`otDetachGracefullyCallback)(void *aContext)`	typedef `void(*` تُبلغ عملية معاودة الاتصال هذه التطبيق بانتهاء عملية فصل البيانات.
`otExternalRouteConfig`	typedef `struct otExternalRouteConfig` يمثل إعدادات مسار خارجي.
`otIpCounters`	typedef `struct otIpCounters` يعرض العدادات على مستوى عنوان IP.
`otLeaderData`	typedef `struct otLeaderData` يمثل بيانات Lead في سلسلة المحادثات.
`otLinkModeConfig`	typedef `struct otLinkModeConfig` يمثّل إعداد "وضع رابط MLE"
`otLowpanContextInfo`	typedef `struct otLowpanContextInfo` تمثل معلومات معرّف سياق 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 `enum otNetDataPublisherEvent` تمثل الأحداث التي تم الإبلاغ عنها من استدعاءات الناشرين.
`otNetworkDataIterator`	typedef `uint32_t` يُستخدم للتكرار من خلال معلومات بيانات الشبكة.
`otNetworkDiagChildEntry`	typedef `struct otNetworkDiagChildEntry` يمثّل إدخال جدول تشخيصي للأطفال على الشبكة.
`otNetworkDiagConnectivity`	typedef `struct otNetworkDiagConnectivity` تمثل قيمة الاتصال التشخيصي بالشبكة.
`otNetworkDiagIterator`	typedef `uint16_t` يُستخدَم وتكرارًا من خلال TLV تشخيص الشبكة.
`otNetworkDiagMacCounters`	typedef `struct otNetworkDiagMacCounters` تمثل قيمة العدّادات في أداة تشخيص البرامج في الشبكة.
`otNetworkDiagRoute`	typedef `struct otNetworkDiagRoute` يمثل قيمة TLV في مسار تشخيص الشبكة.
`otNetworkDiagRouteData`	typedef `struct otNetworkDiagRouteData` يمثل بيانات مسار تشخيص الشبكة.
`otNetworkDiagTlv`	typedef `struct otNetworkDiagTlv` يمثل TLV لبيانات تشخيص الشبكة.
`otReceiveDiagnosticGetCallback)(otError aError, otMessage aMessage, const otMessageInfo aMessageInfo, void *aContext)`	typedef `void(*` يتم استدعاء المؤشر عند تلقّي استجابة الحصول على بيانات تشخيص الشبكة.
`otRoutePreference`	typedef `enum otRoutePreference` تعريف القيم الصالحة لـ `mPreference` في `otExternalRouteConfig` و`otBorderRouterConfig`
`otServerConfig`	typedef `struct otServerConfig` تمثل إعدادات الخادم.
`otServiceConfig`	typedef `struct otServiceConfig` يمثّل إعداد خدمة.
`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 `struct otThreadDiscoveryRequestInfo` يمثل بيانات طلب اكتشاف سلسلة المحادثات.
`otThreadParentResponseCallback)(otThreadParentResponseInfo aInfo, void aContext)`	typedef `void(*` يتم استدعاء المؤشر في كل مرة يتم فيها تلقّي رسالة رد من أحد الوالدَين.
`otThreadParentResponseInfo`	typedef `struct otThreadParentResponseInfo` يمثّل بيانات ردّ الوالدَين MLE.

الدوال
`otConvertDurationInSecondsToString(uint32_t aDuration, char *aBuffer, uint16_t aSize)`	`void` تحوِّل مدة `uint32_t` (بالثواني) إلى سلسلة يمكن للمستخدم قراءتها.
`otNetDataContainsOmrPrefix(otInstance aInstance, const otIp6Prefix aPrefix)`	`bool` تحقَّق مما إذا كانت بادئة معيّنة يمكن أن تعمل كبادئة OMR صالحة ومن أن بيانات الشبكة الخاصة بالقائد تحتوي على هذه البادئة.
`otNetDataGet(otInstance aInstance, bool aStable, uint8_t aData, uint8_t *aDataLength)`	`otError` تقديم نسخة كاملة أو ثابتة من بيانات شبكة Thread الخاصة بالقسم
`otNetDataGetLength(otInstance *aInstance)`	`uint8_t` احصل على الطول الحالي (عدد وحدات البايت) لبيانات شبكة Thread ضمن القسم.
`otNetDataGetMaxLength(otInstance *aInstance)`	`uint8_t` يمكنك الحصول على الحد الأقصى المسموح به لطول بيانات شبكة Thread منذ بدء إعداد مكدّس OT أو منذ آخر استدعاء لـ `otNetDataResetMaxLength()`.
`otNetDataGetNextLowpanContextInfo(otInstance aInstance, otNetworkDataIterator aIterator, otLowpanContextInfo *aContextInfo)`	`otError` احصل على معلومات رقم تعريف سياق 6LoWPAN التالية في بيانات الشبكة للقسم.
`otNetDataGetNextOnMeshPrefix(otInstance aInstance, otNetworkDataIterator aIterator, otBorderRouterConfig *aConfig)`	`otError` احصل على بادئة "الشبكة المتداخلة" التالية في بيانات الشبكة للقسم.
`otNetDataGetNextRoute(otInstance aInstance, otNetworkDataIterator aIterator, otExternalRouteConfig *aConfig)`	`otError` يمكنك الحصول على المسار الخارجي التالي في بيانات الشبكة للقسم.
`otNetDataGetNextService(otInstance aInstance, otNetworkDataIterator aIterator, otServiceConfig *aConfig)`	`otError` احصل على الخدمة التالية في بيانات الشبكة للقسم.
`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)`	`otError` تطلب هذه السياسة إضافة بادئة مسار خارجي إلى بيانات Thread Network.
`otNetDataPublishOnMeshPrefix(otInstance aInstance, const otBorderRouterConfig aConfig)`	`otError` تطلب هذه البادئة منشورًا في بيانات Thread Network.
`otNetDataReplacePublishedExternalRoute(otInstance aInstance, const otIp6Prefix aPrefix, const otExternalRouteConfig *aConfig)`	`otError` لاستبدال مسار خارجي تم نشره سابقًا في بيانات شبكة 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)`	`otError` تحقّق مما إذا كانت بيانات التوجيه مزوّدة برابط.
`otNetDataSteeringDataCheckJoinerWithDiscerner(otInstance aInstance, const struct otJoinerDiscerner aDiscerner)`	`otError` تحقّق مما إذا كانت بيانات التوجيه تتضمّن رابطًا مع قيمة مميّزة.
`otNetDataUnpublishDnsSrpService(otInstance *aInstance)`	`void` يؤدي ذلك إلى إلغاء نشر أي إدخال في خدمة نظام أسماء النطاقات (DNS) أو بروتوكول SRP (أي البث أو Unicast) سبق إضافته من بيانات Thread Network.
`otNetDataUnpublishPrefix(otInstance aInstance, const otIp6Prefix aPrefix)`	`otError` إلغاء نشر بادئة "مسار على الشبكة" أو نشر بادئة خارجية تم نشرها سابقًا
`otThreadBecomeChild(otInstance *aInstance)`	`otError` محاولة إعادة إرفاقه كطفل.
`otThreadBecomeDetached(otInstance *aInstance)`	`otError` فصل عن شبكة Thread.
`otThreadDetachGracefully(otInstance aInstance, otDetachGracefullyCallback aCallback, void aContext)`	`otError` يرسل إشعارًا إلى العُقد الأخرى في الشبكة (إن وجدت) ثم يوقف تشغيل بروتوكول سلسلة المحادثات.
`otThreadDeviceRoleToString(otDeviceRole aRole)`	`const char *` تحويل دور الجهاز إلى سلسلة يمكن للمستخدم قراءتها
`otThreadDiscover(otInstance aInstance, uint32_t aScanChannels, uint16_t aPanId, bool aJoiner, bool aEnableEui64Filtering, otHandleActiveScanResult aCallback, void aCallbackContext)`	`otError` يبدأ البحث عن Thread Discovery.
`otThreadGetChildTimeout(otInstance *aInstance)`	`uint32_t` الحصول على مهلة المهلة الثانوية (بالثواني) المستخدمة عند العمل في دور الطفل.
`otThreadGetDeviceRole(otInstance *aInstance)`	`otDeviceRole` الحصول على دور الجهاز
`otThreadGetDomainName(otInstance *aInstance)`	`const char *` الحصول على اسم نطاق سلسلة المحادثات
`otThreadGetExtendedPanId(otInstance *aInstance)`	`const otExtendedPanId *` الحصول على رقم تعريف PAN وفقًا لمعيار IEEE 802.15.4 الموسَّع
`otThreadGetFixedDuaInterfaceIdentifier(otInstance *aInstance)`	`const otIp6InterfaceIdentifier *` الحصول على معرّف الواجهة المحدّد يدويًا لعنوان Unicast لنطاق سلسلة المحادثات
`otThreadGetIp6Counters(otInstance *aInstance)`	`const otIpCounters *` الحصول على عدّادات IPv6.
`otThreadGetKeySequenceCounter(otInstance *aInstance)`	`uint32_t` للحصول على thrKeySerialCounter.
`otThreadGetKeySwitchGuardTime(otInstance *aInstance)`	`uint32_t` تحصل على thrKeySwitchGuardTime (بالساعات).
`otThreadGetLeaderData(otInstance aInstance, otLeaderData aLeaderData)`	`otError` الحصول على بيانات قائد سلسلة المحادثات
`otThreadGetLeaderRloc(otInstance aInstance, otIp6Address aLeaderRloc)`	`otError` لعرض مؤشر على 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)`	`otLinkModeConfig` احصل على إعدادات وضع رابط MLE.
`otThreadGetMeshLocalEid(otInstance *aInstance)`	`const otIp6Address *` الحصول على عنوان معرّف EID المحلي للشبكة المتداخلة
`otThreadGetMeshLocalPrefix(otInstance *aInstance)`	`const otMeshLocalPrefix *` عرض مؤشر للبادئة المحلية للشبكة المتداخلة.
`otThreadGetMleCounters(otInstance *aInstance)`	`const otMleCounters *` للحصول على عدّادات Thread MLE
`otThreadGetNetworkKey(otInstance aInstance, otNetworkKey aNetworkKey)`	`void` الحصول على مفتاح شبكة Thread
`otThreadGetNetworkKeyRef(otInstance *aInstance)`	`otNetworkKeyRef` الحصول على `otNetworkKeyRef` لمفتاح شبكة Thread
`otThreadGetNetworkName(otInstance *aInstance)`	`const char *` الحصول على اسم شبكة Thread.
`otThreadGetNextDiagnosticTlv(const otMessage aMessage, otNetworkDiagIterator aIterator, otNetworkDiagTlv *aNetworkDiagTlv)`	`otError` الحصول على TLV تشخيص التشخيص التالي في الرسالة.
`otThreadGetNextNeighborInfo(otInstance aInstance, otNeighborInfoIterator aIterator, otNeighborInfo *aInfo)`	`otError` الحصول على معلومات الجيران التالية
`otThreadGetParentAverageRssi(otInstance aInstance, int8_t aParentRssi)`	`otError` تسترد الدالة متوسط RSSI للعنصر الرئيسي في سلسلة المحادثات.
`otThreadGetParentInfo(otInstance aInstance, otRouterInfo aParentInfo)`	`otError` تسترد الدالة معلومات التشخيص لجهاز توجيه سلاسل المحادثات كعنصر رئيسي.
`otThreadGetParentLastRssi(otInstance aInstance, int8_t aLastRssi)`	`otError` تسترد الدالة 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)`	`otError` لاسترداد 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)`	`otError` يطلب أقرب وجهة لعنوان بث مباشر محدد.
`otThreadRegisterParentResponseCallback(otInstance aInstance, otThreadParentResponseCallback aCallback, void aContext)`	`void` تسجيل معاودة الاتصال لتلقّي بيانات ردّ MLE Parent
`otThreadResetIp6Counters(otInstance *aInstance)`	`void` إعادة ضبط عدّادات IPv6.
`otThreadResetMleCounters(otInstance *aInstance)`	`void` يؤدي هذا الخيار إلى إعادة ضبط عدّادات MLE Threads.
`otThreadSearchForBetterParent(otInstance *aInstance)`	`otError` لبدء عملية البحث عن أحد الوالدَين بشكل أفضل مع البقاء على تواصل مع أحد الوالدَين الحالي
`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)`	`otError` إرسال طلب الحصول على بيانات تشخيصية للشبكة.
`otThreadSendDiagnosticReset(otInstance aInstance, const otIp6Address aDestination, const uint8_t aTlvTypes[], uint8_t aCount)`	`otError` إرسال طلب إعادة ضبط بيانات تشخيص الشبكة
`otThreadSendProactiveBackboneNotification(otInstance aInstance, otIp6Address aTarget, otIp6InterfaceIdentifier *aMlIid, uint32_t aTimeSinceLastTransaction)`	`otError` يُرسِل هذا الإشعار إشعارًا استباقيًا حول الخلفية (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)`	`otError` ضبط اسم نطاق سلسلة المحادثات
`otThreadSetEnabled(otInstance *aInstance, bool aEnabled)`	`otError` يبدأ تشغيل بروتوكول Thread.
`otThreadSetExtendedPanId(otInstance aInstance, const otExtendedPanId aExtendedPanId)`	`otError` إعداد معرّف IEEE 802.15.4 الموسّع رقم PAN
`otThreadSetFixedDuaInterfaceIdentifier(otInstance aInstance, const otIp6InterfaceIdentifier aIid)`	`otError` تُحدِّد هذه السياسة معرّف الواجهة الذي يتم تحديده يدويًا لعنوان Thread لنطاق Unicast أو يمحوه.
`otThreadSetJoinerAdvertisement(otInstance aInstance, uint32_t aOui, const uint8_t aAdvData, uint8_t aAdvDataLength)`	`otError` لضبط إعلان سلسلة المحادثات عند اكتشاف شبكة Thread.
`otThreadSetKeySequenceCounter(otInstance *aInstance, uint32_t aKeySequenceCounter)`	`void` لضبط thrKeySerialCounter.
`otThreadSetKeySwitchGuardTime(otInstance *aInstance, uint32_t aKeySwitchGuardTime)`	`void` لضبط thrKeySwitchGuardTime (بالساعات).
`otThreadSetLinkMode(otInstance *aInstance, otLinkModeConfig aConfig)`	`otError` ضبط إعدادات "وضع رابط MLE"
`otThreadSetMeshLocalPrefix(otInstance aInstance, const otMeshLocalPrefix aMeshLocalPrefix)`	`otError` لضبط البادئة المحلية لشبكة متشابكة.
`otThreadSetNetworkKey(otInstance aInstance, const otNetworkKey aKey)`	`otError` ضبط مفتاح شبكة Thread
`otThreadSetNetworkKeyRef(otInstance *aInstance, otNetworkKeyRef aKeyRef)`	`otError` اضبط مفتاح شبكة Thread كـ `otNetworkKeyRef`.
`otThreadSetNetworkName(otInstance aInstance, const char aNetworkName)`	`otError` ضبط اسم شبكة Thread
`otThreadSetVendorModel(otInstance aInstance, const char aVendorModel)`	`otError` أدخِل سلسلة نموذج المورِّد.
`otThreadSetVendorName(otInstance aInstance, const char aVendorName)`	`otError` ضبط سلسلة اسم المورّد
`otThreadSetVendorSwVersion(otInstance aInstance, const char aVendorSwVersion)`	`otError` حدِّد سلسلة إصدار برنامج المورِّد.

هياكل
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 صالحة ومن أن بيانات الشبكة الخاصة بالقائد تحتوي على هذه البادئة.

ملاحظة: لا تتوفّر واجهة برمجة التطبيقات هذه إلا عند استخدام OPENTHREAD_CONFIG_BORDER_ROUTING_ENABLE.

التفاصيل

المَعلمات

`[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.

يتم نشر "عنوان 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.

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

أسئلة عامة

ملخّص

التعدادات

أنواع المحددات

الدوال

هياكل

التعدادات

تعداد مجهول

otDeviceRole

otNetDataPublisherEvent

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

أنواع المحددات

otBorderrouterConfig

otDetachGracefulCallback

otExternalPathConfig

عدّاد OtIpCounts

otLeaderData

otLinkModeConfig

otlowpanContextInfo

OotMleCounts

otNeighborInfoIterator

otNetDataDnsSrpServicePublisherCallback

otNetDataبادئةPublisherCallback

otNetDataPublisherEvent

otNetworkDataIterator

إدخال otNetworkDiagChild

otNetworkDiagConnectionivity

otNetworkDiagIterator

OotNetworkDiagMacCounters

مسار الشبكة الإعلانية

otNetworkDiagrouteData

otNetworkDiagTlv

otReceivedDignGetCallback

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

otServerConfig

otServiceConfig

otThreadAndcastLocatorCallback

otThreadDiscoveryRequestCallback

otThreadDiscoveryRequestInfo

otThreadParentResponseCallback

otThreadParentResponseInfo

الدوال

otConvertDurationInSecondsToString

otNetDataContainsOmrبادئة

otNetDataGet

otNetDataGetLength

otNetDataGetMaxLength

otNetDataGetNextlowpanContextInfo

otNetDataGetNextOnMeshبادئة

otNetDataGetNextPath

otNetDataGetNextService

otNetDataGetStableVersion

otNetDataGetVersion

otNetDataIsDnsSrpServiceتمت الإضافة

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

otNetDataPublishDnsSrpServiceAndcast

otNetDataPublishDnsSrpServiceUnicast

otNetDataPublishDnsSrpServiceUnicastMeshLocalEid

otNetDataPublishExternalPath

otNetDataPublishOnMishPrefix

otNetDataباد تم نشره خارجيًا

otNetDataResetMaxLength

otNetDataSetDnsSrpServicePublisherCallback

otNetDataSetPrefixPublisherCallback

otNetDataSteeringDataCheckChecker

otNetDataSteeringDataCheckLinkerWithDiscerner

otNetDataUnpublishDnsSrpService

otNetDataUnpublishبادئة

otThreadSendChild

otThreadGetDetached

otThreadDetachGracely

otThreadDeviceRoleToString

اكتشاف

otThreadGetChildTimeout

otThreadGetDeviceRole

otThreadGetPermission

otThreadGetExtendedPanId

otThreadGetFixedDuaInterfaceId

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

otThreadGetKeyStringCount