الموجه/القائد

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

ملخّص

عمليات التعداد
otCacheEntryState	تعداد تُحدِّد حالة إدخال ذاكرة التخزين المؤقت لمعرّف شريحة SIM المضمّنة (EID).
otNeighborTableEvent{   OT_NEIGHBOR_TABLE_EVENT_CHILD_ADDED,   OT_NEIGHBOR_TABLE_EVENT_CHILD_REMOVED,   OT_NEIGHBOR_TABLE_EVENT_CHILD_MODE_CHANGED,   OT_NEIGHBOR_TABLE_EVENT_ROUTER_ADDED,   OT_NEIGHBOR_TABLE_EVENT_ROUTER_REMOVED }	تعداد تحدد الثوابت المستخدمة في otNeighborTableCallback للإشارة إلى التغيّرات في جدول مجاور.
otPowerSupply{   OT_POWER_SUPPLY_BATTERY = 0,   OT_POWER_SUPPLY_EXTERNAL = 1,   OT_POWER_SUPPLY_EXTERNAL_STABLE = 2,   OT_POWER_SUPPLY_EXTERNAL_UNSTABLE = 3 }	تعداد تمثل خاصية مصدر الطاقة على الجهاز.

تحديدات النوع
otCacheEntryInfo	typedef struct otCacheEntryInfo يمثِّل إدخال ذاكرة التخزين المؤقت لمعرّف شريحة SIM المضمّنة (EID).
otCacheEntryIterator	typedef struct otCacheEntryIterator تمثّل هذه السمة مكرِّرًا يُستخدم للتكرار في إدخالات جدول ذاكرة التخزين المؤقت لمعرّف شريحة SIM المضمّنة (EID).
otCacheEntryState	typedef enum otCacheEntryState تُحدِّد حالة إدخال ذاكرة التخزين المؤقت لمعرّف شريحة SIM المضمّنة (EID).
otChildIp6AddressIterator	typedef uint16_t يُستخدم للتكرار عبر عناوين IPv6 لإدخال Thread ثانوي.
otDeviceProperties	typedef struct otDeviceProperties تمثل خصائص الجهاز المستخدمة لاحتساب وزن العميل الرائد المحلي على أحد الأجهزة.
otNeighborTableCallback)(otNeighborTableEvent aEvent, const otNeighborTableEntryInfo *aEntryInfo)	typedef void(* يتم استدعاء المؤشر للتنبيه بحدوث تغيير في جدول مجاور.

الدوال
otThreadBecomeLeader(otInstance *aInstance)	otError كُن قائدًا وابدأ قسمًا جديدًا.
otThreadBecomeRouter(otInstance *aInstance)	otError حاول أن تصبح موجهًا.
otThreadGetAdvertisementTrickleIntervalMax(otInstance *aInstance)	uint32_t للحصول على القيمة الحالية للفاصل الزمني الأقصى الذي يستخدمه موقت تدفق الإعلانات.
otThreadGetChildInfoById(otInstance *aInstance, uint16_t aChildId, otChildInfo *aChildInfo)	otError الحصول على معلومات تشخيصية لطفل مرفق من خلال رقم تعريف الطفل أو RLOC16.
otThreadGetChildInfoByIndex(otInstance *aInstance, uint16_t aChildIndex, otChildInfo *aChildInfo)	otError تحتفظ الدالة بمعلومات تشخيصية لعنصر تابع مرفق بواسطة فهرس الجدول الداخلي.
otThreadGetChildNextIp6Address(otInstance *aInstance, uint16_t aChildIndex, otChildIp6AddressIterator *aIterator, otIp6Address *aAddress)	otError الحصول على عنوان IPv6 التالي (باستخدام مُكرّر) لطفل معيّن.
otThreadGetChildRouterLinks(otInstance *aInstance)	uint8_t احصل على معلمة MLE_CHILD_ROUTER_LINKS المستخدمة في دور REED.
otThreadGetContextIdReuseDelay(otInstance *aInstance)	uint32_t احصل على مَعلمة CONTEXT_ID_REUSE_REASON المستخدَمة في دور القائد.
otThreadGetDeviceProperties(otInstance *aInstance)	const otDeviceProperties * الحصول على خصائص الجهاز الحالية
otThreadGetJoinerUdpPort(otInstance *aInstance)	uint16_t الحصول على منفذ UDP لـ Join.
otThreadGetLocalLeaderWeight(otInstance *aInstance)	uint8_t الحصول على وزن قائد سلسلة المحادثات المستخدَم عند العمل في دور القائد
otThreadGetMaxAllowedChildren(otInstance *aInstance)	uint16_t الوصول إلى الحدّ الأقصى لعدد الأطفال المسموح به حاليًا
otThreadGetMaxChildIpAddresses(otInstance *aInstance)	uint8_t الحصول على الحد الأقصى لعدد عناوين IP التي قد يسجِّلها كل طفل MTD باستخدام هذا الجهاز بصفته أحد الوالدَين.
otThreadGetMaxRouterId(otInstance *aInstance)	uint8_t تعرض الدالة الحد الأقصى المسموح به لمعرّف جهاز التوجيه.
otThreadGetNetworkIdTimeout(otInstance *aInstance)	uint8_t احصل على المَعلمة NETWORK_ID_TIMEOUT.
otThreadGetNextCacheEntry(otInstance *aInstance, otCacheEntryInfo *aEntryInfo, otCacheEntryIterator *aIterator)	otError يحصل على الإدخال التالي لذاكرة التخزين المؤقت لرقم EID (باستخدام مكرّر).
otThreadGetNextHopAndPathCost(otInstance *aInstance, uint16_t aDestRloc16, uint16_t *aNextHopRloc16, uint8_t *aPathCost)	void للحصول على تكلفة القفزة التالية والمسار باتجاه وجهة RLOC16 معيّنة.
otThreadGetParentPriority(otInstance *aInstance)	int8_t الحصول على الأولوية الرئيسية الممنوحة
otThreadGetPreferredLeaderPartitionId(otInstance *aInstance)	uint32_t يمكنك الحصول على رقم تعريف قسم قائد سلسلة المحادثات المفضّل عند العمل في دور القائد.
otThreadGetPskc(otInstance *aInstance, otPskc *aPskc)	void احصل على Thread PSKc.
otThreadGetPskcRef(otInstance *aInstance)	otPskcRef الحصول على مرجع المفتاح لـ Thread PSKc مخزّن.
otThreadGetRouterDowngradeThreshold(otInstance *aInstance)	uint8_t يمكنك الحصول على معلَمة ROUTER_DOWNRESULTS_LIMIT المستخدَمة في دور جهاز التوجيه.
otThreadGetRouterIdRange(otInstance *aInstance, uint8_t *aMinRouterId, uint8_t *aMaxRouterId)	void الحصول على نطاق أرقام تعريف جهاز التوجيه المسموح لها بتعيينها للعُقد ضمن شبكة سلسلة التعليمات.
otThreadGetRouterIdSequence(otInstance *aInstance)	uint8_t احصل على تسلسل رقم تعريف جهاز التوجيه الحالي.
otThreadGetRouterInfo(otInstance *aInstance, uint16_t aRouterId, otRouterInfo *aRouterInfo)	otError تحتفظ الدالة بمعلومات التشخيص لجهاز توجيه سلسلة محادثات معيّن.
otThreadGetRouterSelectionJitter(otInstance *aInstance)	uint8_t احصل على معلمة ROUTER_setting_JITTER المستخدمة في دور REED/جهاز توجيه.
otThreadGetRouterUpgradeThreshold(otInstance *aInstance)	uint8_t يمكنك الحصول على معلَمة ROUTER_UPupgrade_variable المستخدَمة في دور REED.
otThreadIsRouterEligible(otInstance *aInstance)	bool تشير إلى ما إذا كان الجهاز مؤهلاً لجهاز التوجيه أم لا.
otThreadIsRouterIdAllocated(otInstance *aInstance, uint8_t aRouterId)	bool يشير إلى ما إذا كان تم تخصيص رقم تعريف جهاز التوجيه حاليًا أم لا.
otThreadRegisterNeighborTableCallback(otInstance *aInstance, otNeighborTableCallback aCallback)	void يتم تسجيل دالة استدعاء جدول مجاور.
otThreadReleaseRouterId(otInstance *aInstance, uint8_t aRouterId)	otError تحرير رقم تعريف جهاز التوجيه الذي خصصه الجهاز في دور القائد.
otThreadSetCcmEnabled(otInstance *aInstance, bool aEnabled)	void تحدِّد هذه السياسة ما إذا كان قد تم تفويض الجهاز باستخدام "إدارة السحابة الإلكترونية من Firebase".
otThreadSetChildRouterLinks(otInstance *aInstance, uint8_t aChildRouterLinks)	otError يمكنك تعيين معلمة MLE_CHILD_ROUTER_LINKS المستخدمة في دور REED.
otThreadSetContextIdReuseDelay(otInstance *aInstance, uint32_t aDelay)	void يمكنك ضبط المعلمة CONTEXT_ID_REUSE_AGENT المستخدمة في دور القائد.
otThreadSetDeviceProperties(otInstance *aInstance, const otDeviceProperties *aDeviceProperties)	void حدِّد خصائص الجهاز التي تُستخدَم بعد ذلك لتحديد وزن القائد وضبطه.
otThreadSetJoinerUdpPort(otInstance *aInstance, uint16_t aJoinerUdpPort)	otError لضبط منفذ UDP لـ Join.
otThreadSetLocalLeaderWeight(otInstance *aInstance, uint8_t aWeight)	void لضبط وزن قائد سلسلة المحادثات المستخدَم عند العمل في دور القائد.
otThreadSetMaxAllowedChildren(otInstance *aInstance, uint16_t aMaxChildren)	otError ضبط الحدّ الأقصى لعدد الأطفال المسموح به حاليًا
otThreadSetMaxChildIpAddresses(otInstance *aInstance, uint8_t aMaxIpAddresses)	otError تُستخدم هذه السياسة في ضبط أو استعادة الحد الأقصى لعدد عناوين IP التي قد يسجّلها كل طفل في MTD باستخدام هذا الجهاز بصفته أحد الوالدَين.
otThreadSetNetworkIdTimeout(otInstance *aInstance, uint8_t aTimeout)	void اضبط المعلَمة NETWORK_ID_TIMEOUT.
otThreadSetParentPriority(otInstance *aInstance, int8_t aParentPriority)	otError ضبط أولوية العنصر الرئيسي.
otThreadSetPreferredLeaderPartitionId(otInstance *aInstance, uint32_t aPartitionId)	void يمكنك ضبط معرِّف قسم قائد سلسلة المحادثات المفضّل المُستخدَم عند العمل في دور القائد.
otThreadSetPreferredRouterId(otInstance *aInstance, uint8_t aRouterId)	otError ضبط رقم تعريف جهاز التوجيه المفضّل.
otThreadSetPskc(otInstance *aInstance, const otPskc *aPskc)	otError قم بتعيين Thread PSKc.
otThreadSetPskcRef(otInstance *aInstance, otPskcRef aKeyRef)	otError قم بتعيين مرجع المفتاح إلى Thread PSKc.
otThreadSetRouterDowngradeThreshold(otInstance *aInstance, uint8_t aThreshold)	void يمكنك ضبط المعلمة ROUTER_DOWNRESULTS_LIMIT المستخدَمة في دور القائد.
otThreadSetRouterEligible(otInstance *aInstance, bool aEligible)	otError تحدد ما إذا كان الجهاز مؤهلاً لجهاز التوجيه أم لا.
otThreadSetRouterIdRange(otInstance *aInstance, uint8_t aMinRouterId, uint8_t aMaxRouterId)	otError يضبط نطاق معرفات جهاز التوجيه التي يُسمح بتعيينها للعُقد داخل شبكة سلسلة المحادثات.
otThreadSetRouterSelectionJitter(otInstance *aInstance, uint8_t aRouterJitter)	void يمكنك تعيين المعلمة ROUTER_Cancel_JITTER المستخدمة في دور REED/جهاز التوجيه.
otThreadSetRouterUpgradeThreshold(otInstance *aInstance, uint8_t aThreshold)	void يمكنك ضبط معلَمة ROUTER_UPupgrade_LIMIT المستخدَمة في دور "القائد".
otThreadSetSteeringData(otInstance *aInstance, const otExtAddress *aExtAddress)	void اضبط بيانات التوجيه خارج الإطار.
otThreadSetThreadVersionCheckEnabled(otInstance *aInstance, bool aEnabled)	void تحدِّد هذه السياسة ما إذا كان قد تم تفعيل حد إصدار TLV لسياسة الأمان للتوجيه (حقل الواقع الافتراضي).

الهياكل
otCacheEntryInfo	يمثِّل إدخال ذاكرة التخزين المؤقت لمعرّف شريحة SIM المضمّنة (EID).
otCacheEntryIterator	تمثّل هذه السمة مكرِّرًا يُستخدم للتكرار في إدخالات جدول ذاكرة التخزين المؤقت لمعرّف شريحة SIM المضمّنة (EID).
otChildInfo	يتضمن معلومات تشخيصية لـ Thread Child.
otDeviceProperties	تمثل خصائص الجهاز المستخدمة لاحتساب وزن العميل الرائد المحلي على أحد الأجهزة.
otNeighborTableEntryInfo	تمثل معلومات إدخال جدول مجاور (التابع أو جهاز التوجيه) ويتم استخدامها كمَعلمة في استدعاء جدول مجاور otNeighborTableCallback.

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

otCacheEntryState

 otCacheEntryState

تُحدِّد حالة إدخال ذاكرة التخزين المؤقت لمعرّف شريحة SIM المضمّنة (EID).

otNeighborTableEvent

 otNeighborTableEvent

تحدد الثوابت المستخدمة في otNeighborTableCallback للإشارة إلى التغيّرات في جدول مجاور.

أماكن إقامة
OT_NEIGHBOR_TABLE_EVENT_CHILD_ADDED	جارٍ إضافة حساب طفل.
OT_NEIGHBOR_TABLE_EVENT_CHILD_MODE_CHANGED	تغيير الوضع الحالي للطفل
OT_NEIGHBOR_TABLE_EVENT_CHILD_REMOVED	جارٍ إزالة طفل
OT_NEIGHBOR_TABLE_EVENT_ROUTER_ADDED	جارٍ إضافة جهاز توجيه.
OT_NEIGHBOR_TABLE_EVENT_ROUTER_REMOVED	جارٍ إزالة جهاز توجيه.

otPowerSupply

 otPowerSupply

تمثل خاصية مصدر الطاقة على الجهاز.

تُستخدَم هذه السمة كخاصية في otDeviceProperties لاحتساب قيمة الوزن الرائد.

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

تحديدات النوع

otCacheEntryInfo

struct otCacheEntryInfo otCacheEntryInfo

يمثِّل إدخال ذاكرة التخزين المؤقت لمعرّف شريحة SIM المضمّنة (EID).

otCacheEntryIterator

struct otCacheEntryIterator otCacheEntryIterator

تمثّل هذه السمة مكرِّرًا يُستخدم للتكرار في إدخالات جدول ذاكرة التخزين المؤقت لمعرّف شريحة SIM المضمّنة (EID).

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

otCacheEntryState

enum otCacheEntryState otCacheEntryState

تُحدِّد حالة إدخال ذاكرة التخزين المؤقت لمعرّف شريحة SIM المضمّنة (EID).

otChildIp6AddressIterator

uint16_t otChildIp6AddressIterator

يُستخدم للتكرار عبر عناوين IPv6 لإدخال Thread ثانوي.

otDeviceProperties

struct otDeviceProperties otDeviceProperties

تمثل خصائص الجهاز المستخدمة لاحتساب وزن العميل الرائد المحلي على أحد الأجهزة.

ويتم تعيين المعلمات استنادًا إلى قدرة الجهاز، سواء كان يعمل كجهاز توجيه حدودي، أو تكوين مصدر الطاقة، وما إلى ذلك.

تشير السمة mIsUnstable إلى الاستقرار التشغيلي للجهاز، ويتم تحديدها من خلال آلية خاصة بالمورّد. يمكن أن يشمل الحالات التالية:

• يرصد الجهاز داخليًا أنّه يفقد مصدر الطاقة الخارجي مرات أكثر من المعتاد. ما هو المعتاد الذي يحدده البائع.
• رصد الجهاز داخليًا أنّه تتم إعادة تشغيله بمعدل أكبر من المعتاد. ما هو المعتاد الذي يحدده البائع.

otNeighborTableCallback

void(* otNeighborTableCallback)(otNeighborTableEvent aEvent, const otNeighborTableEntryInfo *aEntryInfo)

يتم استدعاء المؤشر للتنبيه بحدوث تغيير في جدول مجاور.

التفاصيل
المَعلمات	[in] aEvent علامة حدث. [in] aEntryInfo مؤشر يشير إلى معلومات إدخال الجدول.

الدوال

otThreadBecomeLeader

otError otThreadBecomeLeader(
  otInstance *aInstance
)

كُن قائدًا وابدأ قسمًا جديدًا.

ملاحظة: إنّ واجهة برمجة التطبيقات هذه مخصّصة لأغراض الاختبار والعرض فقط. سيؤدي تغيير الإعدادات باستخدام واجهة برمجة التطبيقات هذه إلى عرض تطبيق الإنتاج غير المتوافق مع مواصفات Thread.

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

otThreadBecomeRouter

otError otThreadBecomeRouter(
  otInstance *aInstance
)

حاول أن تصبح موجهًا.

ملاحظة: إنّ واجهة برمجة التطبيقات هذه مخصّصة لأغراض الاختبار والعرض فقط. سيؤدي تغيير الإعدادات باستخدام واجهة برمجة التطبيقات هذه إلى عرض تطبيق الإنتاج غير المتوافق مع مواصفات Thread.

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

otThreadGetAdvertisementTrickleIntervalMax

uint32_t otThreadGetAdvertisementTrickleIntervalMax(
  otInstance *aInstance
)

للحصول على القيمة الحالية للفاصل الزمني الأقصى الذي يستخدمه موقت تدفق الإعلانات.

تتطلّب واجهة برمجة التطبيقات هذه استخدام OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE، وهي مخصّصة للاختبار فقط.

التفاصيل
المرتجعات	موقّت الفاصل الزمني الأقصى للإعلان بالمللي ثانية

otThreadGetChildInfoById

otError otThreadGetChildInfoById(
  otInstance *aInstance,
  uint16_t aChildId,
  otChildInfo *aChildInfo
)

الحصول على معلومات تشخيصية لطفل مرفق من خلال رقم تعريف الطفل أو RLOC16.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aChildId رقم تعريف الطفل أو RLOC16 التابع للطفل المرفق. [out] aChildInfo مؤشر يشير إلى المكان الذي يتم فيه وضع المعلومات الفرعية.
قيم الإرجاع	OT_ERROR_NONE تم تعديل aChildInfo بنجاح باستخدام معلومات رقم التعريف المقدَّم. OT_ERROR_NOT_FOUND ما مِن طفل صالح يحمل معرّف الطفل هذا. OT_ERROR_INVALID_ARGS إذا كانت قيمة aChildInfo فارغة.

otThreadGetChildInfoByIndex

otError otThreadGetChildInfoByIndex(
  otInstance *aInstance,
  uint16_t aChildIndex,
  otChildInfo *aChildInfo
)

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

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

راجِع أيضًا:
otGetMaxAllowedChildren

otThreadGetChildNextIp6Address

otError otThreadGetChildNextIp6Address(
  otInstance *aInstance,
  uint16_t aChildIndex,
  otChildIp6AddressIterator *aIterator,
  otIp6Address *aAddress
)

الحصول على عنوان IPv6 التالي (باستخدام مُكرّر) لطفل معيّن.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aChildIndex الفهرس الفرعي. [in,out] aIterator مؤشر يشير إلى المكرّر. عند إتمام العملية بنجاح، سيتم تعديل المكرّر للإشارة إلى الإدخال التالي في القائمة. للحصول على أول عنوان IPv6، ينبغي تعيين المكرر على OT_CHILD_IP6_ADDRESS_ITERATOR_INIT. [out] aAddress يشير هذا المصطلح إلى عنوان IPv6 الذي يوضع فيه العنوان التالي للطفل (عند النجاح).
قيم الإرجاع	OT_ERROR_NONE تم العثور على عنوان IPv6 التالي (تم تعديل aAddress بنجاح). OT_ERROR_NOT_FOUND ليس لدى الطفل أي إدخال لاحق لعنوان IPv6. OT_ERROR_INVALID_ARGS aIterator أو aAddress فارغة، أو العناصر الثانوية في aChildIndex غير صالحة.

راجِع أيضًا:
otThreadGetChildInfoByIndex

otThreadGetChildRouterLinks

uint8_t otThreadGetChildRouterLinks(
  otInstance *aInstance
)

احصل على معلمة MLE_CHILD_ROUTER_LINKS المستخدمة في دور REED.

تحدد هذه المعلمة الحد الأقصى لعدد أجهزة التوجيه المجاورة التي سيحاول الجهاز (بصفته FED) إنشاء رابط.

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

راجِع أيضًا:
otThreadSetChildRouterLinks

otThreadGetContextIdReuseDelay

uint32_t otThreadGetContextIdReuseDelay(
  otInstance *aInstance
)

احصل على مَعلمة CONTEXT_ID_REUSE_REASON المستخدَمة في دور القائد.

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

راجِع أيضًا:
otThreadSetContextIdReuseDelay

otThreadGetDeviceProperties

const otDeviceProperties * otThreadGetDeviceProperties(
  otInstance *aInstance
)

الحصول على خصائص الجهاز الحالية

يجب توفّر OPENTHREAD_CONFIG_MLE_DEVICE_PROPERTY_LEADER_WEIGHT_ENABLE.

التفاصيل
المرتجعات	خصائص الجهاز otDeviceProperties.

otThreadGetJoinerUdpPort

uint16_t otThreadGetJoinerUdpPort(
  otInstance *aInstance
)

الحصول على منفذ UDP لـ Join.

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

راجِع أيضًا:
otThreadSetJoinerUdpPort

otThreadGetLocalLeaderWeight

uint8_t otThreadGetLocalLeaderWeight(
  otInstance *aInstance
)

الحصول على وزن قائد سلسلة المحادثات المستخدَم عند العمل في دور القائد

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

يُرجى الاطّلاع أيضًا على:
otThreadSetLeaderWeight
otThreadSetDeviceProperties

otThreadGetMaxAllowedChildren

uint16_t otThreadGetMaxAllowedChildren(
  otInstance *aInstance
)

الوصول إلى الحدّ الأقصى لعدد الأطفال المسموح به حاليًا

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

يمكنك الاطّلاع أيضًا على:
otThreadSetMaxAllowedChildren

otThreadGetMaxChildIpAddresses

uint8_t otThreadGetMaxChildIpAddresses(
  otInstance *aInstance
)

الحصول على الحد الأقصى لعدد عناوين IP التي قد يسجِّلها كل طفل MTD باستخدام هذا الجهاز بصفته أحد الوالدَين.

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

يُرجى الاطّلاع أيضًا على:
otThreadSetMaxChildIpAddresses

otThreadGetMaxRouterId

uint8_t otThreadGetMaxRouterId(
  otInstance *aInstance
)

تعرض الدالة الحد الأقصى المسموح به لمعرّف جهاز التوجيه.

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

otThreadGetNetworkIdTimeout

uint8_t otThreadGetNetworkIdTimeout(
  otInstance *aInstance
)

احصل على المَعلمة NETWORK_ID_TIMEOUT.

ملاحظة: إنّ واجهة برمجة التطبيقات هذه مخصّصة لأغراض الاختبار والعرض فقط. سيؤدي تغيير الإعدادات باستخدام واجهة برمجة التطبيقات هذه إلى عرض تطبيق الإنتاج غير المتوافق مع مواصفات Thread.

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

راجِع أيضًا:
otThreadSetNetworkIdTimeout

otThreadGetNextCacheEntry

otError otThreadGetNextCacheEntry(
  otInstance *aInstance,
  otCacheEntryInfo *aEntryInfo,
  otCacheEntryIterator *aIterator
)

يحصل على الإدخال التالي لذاكرة التخزين المؤقت لرقم EID (باستخدام مكرّر).

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [out] aEntryInfo مؤشر يشير إلى مكان وضع معلومات إدخال ذاكرة التخزين المؤقت لمعرّف شريحة SIM المضمّنة (EID). [in,out] aIterator مؤشر يشير إلى مكرّر. سيتم تعديلها للإشارة إلى الإدخال التالي بشأن النجاح. للحصول على الإدخال الأول، قم بتهيئة المكرر عن طريق تعيين جميع حقوله على صفر (على سبيل المثال، memset بنية المكرّر على صفر).
قيم الإرجاع	OT_ERROR_NONE تمت تعبئة aEntryInfo بنجاح لإدخال ذاكرة التخزين المؤقت التالي لمعرّف شريحة SIM المضمّنة (EID). OT_ERROR_NOT_FOUND ليس هناك المزيد من الإدخالات في جدول ذاكرة التخزين المؤقت للعناوين.

otThreadGetNextHopAndPathCost

void otThreadGetNextHopAndPathCost(
  otInstance *aInstance,
  uint16_t aDestRloc16,
  uint16_t *aNextHopRloc16,
  uint8_t *aPathCost
)

للحصول على تكلفة القفزة التالية والمسار باتجاه وجهة RLOC16 معيّنة.

يمكن استخدام القيمة aNextHopRloc16 أو aPathCost فارغة للإشارة إلى أنّ المتصل لا يريد الحصول على القيمة.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aDestRloc16 RLOC16 للوجهة. [out] aNextHopRloc16 مؤشر لإرجاع RLOC16 في القفزة التالية، 0xfffe إذا لم يكن هناك القفزة التالية. [out] aPathCost مؤشر يشير إلى تكلفة مسار الإرجاع للوصول إلى الوجهة

otThreadGetParentPriority

int8_t otThreadGetParentPriority(
  otInstance *aInstance
)

الحصول على الأولوية الرئيسية الممنوحة

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
المرتجعات	قيمة الأولوية الرئيسية التي تم تحديدها، -2 تعني أنه لم يتم تعيينها.

يُرجى الاطّلاع أيضًا على:
otThreadSetParentPriority

otThreadGetPreferredLeaderPartitionId

uint32_t otThreadGetPreferredLeaderPartitionId(
  otInstance *aInstance
)

يمكنك الحصول على رقم تعريف قسم قائد سلسلة المحادثات المفضّل عند العمل في دور القائد.

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

otThreadGetPskc

void otThreadGetPskc(
  otInstance *aInstance,
  otPskc *aPskc
)

احصل على Thread PSKc.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [out] aPskc مؤشر يشير إلى otPskc لعرض سلسلة PSKc التي تم استردادها.

راجِع أيضًا:
otThreadSetPskc

otThreadGetPskcRef

otPskcRef otThreadGetPskcRef(
  otInstance *aInstance
)

الحصول على مرجع المفتاح لـ Thread PSKc مخزّن.

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

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

راجِع أيضًا:
otThreadSetPskcRef

otThreadGetRouterDowngradeThreshold

uint8_t otThreadGetRouterDowngradeThreshold(
  otInstance *aInstance
)

يمكنك الحصول على معلَمة ROUTER_DOWNRESULTS_LIMIT المستخدَمة في دور جهاز التوجيه.

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

يُرجى الاطّلاع أيضًا على:
otThreadSetRouterDowngradeThreshold

otThreadGetRouterIdRange

void otThreadGetRouterIdRange(
  otInstance *aInstance,
  uint8_t *aMinRouterId,
  uint8_t *aMaxRouterId
)

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

ملاحظة: تتطلب واجهة برمجة التطبيقات هذه OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE، وتُستخدم لأغراض الاختبار فقط. يُسمح بجميع أرقام تعريف جهاز التوجيه في النطاق [aMinRouterId, aMaxRouterId].

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [out] aMinRouterId تمثّل هذه السمة الحد الأدنى لرقم تعريف جهاز التوجيه. [out] aMaxRouterId الحد الأقصى لرقم تعريف جهاز التوجيه.

راجِع أيضًا:
otThreadSetRouterIdRange

otThreadGetRouterIdSequence

uint8_t otThreadGetRouterIdSequence(
  otInstance *aInstance
)

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

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

otThreadGetRouterInfo

otError otThreadGetRouterInfo(
  otInstance *aInstance,
  uint16_t aRouterId,
  otRouterInfo *aRouterInfo
)

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

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aRouterId رقم تعريف جهاز التوجيه أو RLOC16 لجهاز توجيه معيّن. [out] aRouterInfo مؤشر يشير إلى المكان الذي يتم فيه وضع معلومات جهاز التوجيه.
قيم الإرجاع	OT_ERROR_NONE تم استرداد معلومات جهاز التوجيه لرقم التعريف المحدد بنجاح. OT_ERROR_NOT_FOUND لم يتم إدخال جهاز توجيه برقم التعريف المقدم. OT_ERROR_INVALID_ARGS aRouterInfo فارغ.

otThreadGetRouterSelectionJitter

uint8_t otThreadGetRouterSelectionJitter(
  otInstance *aInstance
)

احصل على معلمة ROUTER_setting_JITTER المستخدمة في دور REED/جهاز توجيه.

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

راجِع أيضًا:
otThreadSetRouterSelectionJitter

otThreadGetRouterUpgradeThreshold

uint8_t otThreadGetRouterUpgradeThreshold(
  otInstance *aInstance
)

يمكنك الحصول على معلَمة ROUTER_UPupgrade_variable المستخدَمة في دور REED.

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

راجِع أيضًا:
otThreadSetRouterUpgradeThreshold

otThreadIsRouterEligible

bool otThreadIsRouterEligible(
  otInstance *aInstance
)

تشير إلى ما إذا كان الجهاز مؤهلاً لجهاز التوجيه أم لا.

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

otThreadIsRouterIdAllocated

bool otThreadIsRouterIdAllocated(
  otInstance *aInstance,
  uint8_t aRouterId
)

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

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

otThreadRegisterNeighborTableCallback

void otThreadRegisterNeighborTableCallback(
  otInstance *aInstance,
  otNeighborTableCallback aCallback
)

يتم تسجيل دالة استدعاء جدول مجاور.

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

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

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

otThreadReleaseRouterId

otError otThreadReleaseRouterId(
  otInstance *aInstance,
  uint8_t aRouterId
)

تحرير رقم تعريف جهاز التوجيه الذي خصصه الجهاز في دور القائد.

ملاحظة: إنّ واجهة برمجة التطبيقات هذه مخصّصة لأغراض الاختبار والعرض فقط. سيؤدي تغيير الإعدادات باستخدام واجهة برمجة التطبيقات هذه إلى عرض تطبيق الإنتاج غير المتوافق مع مواصفات Thread.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aRouterId رقم تعريف جهاز التوجيه المطلوب إطلاقه. النطاق الصالح هو [0، 62].
قيم الإرجاع	OT_ERROR_NONE تم إصدار معرّف جهاز التوجيه بنجاح. OT_ERROR_INVALID_ARGS القيمة "aRouterId" ليست ضمن النطاق [0، 62]. OT_ERROR_INVALID_STATE لا يعمل الجهاز حاليًا كقائد. OT_ERROR_NOT_FOUND رقم تعريف جهاز التوجيه غير مخصص في الوقت الحالي.

otThreadSetCcmEnabled

void otThreadSetCcmEnabled(
  otInstance *aInstance,
  bool aEnabled
)

تحدِّد هذه السياسة ما إذا كان قد تم تفويض الجهاز باستخدام "إدارة السحابة الإلكترونية من Firebase".

ملاحظة: تتطلّب واجهة برمجة التطبيقات هذه توفُّر OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE، ولا يتم استخدامها إلا من خلال Thread Test Harness للإشارة إلى ما إذا كان هذا الجهاز قد تم تشغيله باستخدام "إدارة السحابة الإلكترونية من Firebase".

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aEnabled TRUE إذا تم تفويض الجهاز باستخدام CCM، أو FALSE في الحالات الأخرى.

otThreadSetChildRouterLinks

otError otThreadSetChildRouterLinks(
  otInstance *aInstance,
  uint8_t aChildRouterLinks
)

يمكنك تعيين معلمة MLE_CHILD_ROUTER_LINKS المستخدمة في دور REED.

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

راجِع أيضًا:
otThreadGetChildRouterLinks

otThreadSetContextIdReuseDelay

void otThreadSetContextIdReuseDelay(
  otInstance *aInstance,
  uint32_t aDelay
)

يمكنك ضبط المعلمة CONTEXT_ID_REUSE_AGENT المستخدمة في دور القائد.

ملاحظة: إنّ واجهة برمجة التطبيقات هذه مخصّصة لأغراض الاختبار والعرض فقط. سيؤدي تغيير الإعدادات باستخدام واجهة برمجة التطبيقات هذه إلى عرض تطبيق الإنتاج غير المتوافق مع مواصفات Thread.

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

راجِع أيضًا:
otThreadGetContextIdReuseDelay

otThreadSetDeviceProperties

void otThreadSetDeviceProperties(
  otInstance *aInstance,
  const otDeviceProperties *aDeviceProperties
)

حدِّد خصائص الجهاز التي تُستخدَم بعد ذلك لتحديد وزن القائد وضبطه.

يجب توفّر OPENTHREAD_CONFIG_MLE_DEVICE_PROPERTY_LEADER_WEIGHT_ENABLE.

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

otThreadSetJoinerUdpPort

otError otThreadSetJoinerUdpPort(
  otInstance *aInstance,
  uint16_t aJoinerUdpPort
)

لضبط منفذ UDP لـ Join.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aJoinerUdpPort رقم منفذ UDP لـ Join.
قيم الإرجاع	OT_ERROR_NONE تم بنجاح ضبط منفذ UDP لـ Join.

يمكنك الاطّلاع أيضًا على:
otThreadGetJoinerUdpPort

otThreadSetLocalLeaderWeight

void otThreadSetLocalLeaderWeight(
  otInstance *aInstance,
  uint8_t aWeight
)

لضبط وزن قائد سلسلة المحادثات المستخدَم عند العمل في دور القائد.

لضبط وزن القائد مباشرةً على القيمة الجديدة، مع استبدال قيمته السابقة (التي ربما تم تحديدها من قيمة otDeviceProperties الحالية).

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aWeight قيمة وزن قائد سلسلة المحادثات.

راجِع أيضًا:
otThreadGetLeaderWeight

otThreadSetMaxAllowedChildren

otError otThreadSetMaxAllowedChildren(
  otInstance *aInstance,
  uint16_t aMaxChildren
)

ضبط الحدّ الأقصى لعدد الأطفال المسموح به حاليًا

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

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

يمكنك الاطّلاع أيضًا على:
otThreadGetMaxAllowedChildren

otThreadSetMaxChildIpAddresses

otError otThreadSetMaxChildIpAddresses(
  otInstance *aInstance,
  uint8_t aMaxIpAddresses
)

تُستخدم هذه السياسة في ضبط أو استعادة الحد الأقصى لعدد عناوين IP التي قد يسجّلها كل طفل في MTD باستخدام هذا الجهاز بصفته أحد الوالدَين.

عليك تمرير 0 لمحو الإعدادات واستعادة الإعدادات التلقائية.

تتوفّر هذه الميزة عندما تكون ميزة "OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE" مفعّلة.

ملاحظة: لا تُستخدَم إلا من خلال Thread Test Harness لتقييد عمليات تسجيل العنوان للعنصر الرئيسي المرجعي من أجل اختبار تفاعل MTD DUT.

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

راجِع أيضًا:
otThreadGetMaxChildIpAddresses

otThreadSetNetworkIdTimeout

void otThreadSetNetworkIdTimeout(
  otInstance *aInstance,
  uint8_t aTimeout
)

اضبط المعلَمة NETWORK_ID_TIMEOUT.

ملاحظة: إنّ واجهة برمجة التطبيقات هذه مخصّصة لأغراض الاختبار والعرض فقط. سيؤدي تغيير الإعدادات باستخدام واجهة برمجة التطبيقات هذه إلى عرض تطبيق الإنتاج غير المتوافق مع مواصفات Thread.

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

راجِع أيضًا:
otThreadGetNetworkIdTimeout

otThreadSetParentPriority

otError otThreadSetParentPriority(
  otInstance *aInstance,
  int8_t aParentPriority
)

ضبط أولوية العنصر الرئيسي.

ملاحظة: إنّ واجهة برمجة التطبيقات هذه مخصّصة لأغراض الاختبار والعرض فقط. سيؤدي تغيير الإعدادات باستخدام واجهة برمجة التطبيقات هذه إلى عرض تطبيق الإنتاج غير المتوافق مع مواصفات Thread.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aParentPriority قيمة الأولوية الرئيسية.
قيم الإرجاع	OT_ERROR_NONE تم ضبط الأولوية الرئيسية بنجاح. OT_ERROR_INVALID_ARGS إذا لم تكن قيمة الأولوية الرئيسية بين 1 و0 و-1 و-2.

يُرجى الاطّلاع أيضًا على:
otThreadGetParentPriority

otThreadSetPreferredLeaderPartitionId

void otThreadSetPreferredLeaderPartitionId(
  otInstance *aInstance,
  uint32_t aPartitionId
)

يمكنك ضبط معرِّف قسم قائد سلسلة المحادثات المفضّل المُستخدَم عند العمل في دور القائد.

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

otThreadSetPreferredRouterId

otError otThreadSetPreferredRouterId(
  otInstance *aInstance,
  uint8_t aRouterId
)

ضبط رقم تعريف جهاز التوجيه المفضّل.

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

ملاحظة: إنّ واجهة برمجة التطبيقات هذه مخصّصة لأغراض الاختبار والعرض فقط. سيؤدي تغيير الإعدادات باستخدام واجهة برمجة التطبيقات هذه إلى عرض تطبيق الإنتاج غير المتوافق مع مواصفات Thread.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aRouterId رقم تعريف جهاز التوجيه المفضّل.
قيم الإرجاع	OT_ERROR_NONE تم بنجاح ضبط رقم تعريف جهاز التوجيه المفضّل. OT_ERROR_INVALID_STATE تعذر التعيين (لم يتم فصل الدور أو إيقافه)

otThreadSetPskc

otError otThreadSetPskc(
  otInstance *aInstance,
  const otPskc *aPskc
)

قم بتعيين Thread PSKc.

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

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

راجِع أيضًا:
otThreadGetPskc

otThreadSetPskcRef

otError otThreadSetPskcRef(
  otInstance *aInstance,
  otPskcRef aKeyRef
)

قم بتعيين مرجع المفتاح إلى Thread PSKc.

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

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

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

راجِع أيضًا:
otThreadGetPskcRef

otThreadSetRouterDowngradeThreshold

void otThreadSetRouterDowngradeThreshold(
  otInstance *aInstance,
  uint8_t aThreshold
)

يمكنك ضبط المعلمة ROUTER_DOWNRESULTS_LIMIT المستخدَمة في دور القائد.

ملاحظة: إنّ واجهة برمجة التطبيقات هذه مخصّصة لأغراض الاختبار والعرض فقط. سيؤدي تغيير الإعدادات باستخدام واجهة برمجة التطبيقات هذه إلى عرض تطبيق الإنتاج غير المتوافق مع مواصفات Thread.

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

يُرجى الاطّلاع أيضًا على:
otThreadGetRouterDowngradeThreshold

otThreadSetRouterEligible

otError otThreadSetRouterEligible(
  otInstance *aInstance,
  bool aEligible
)

تحدد ما إذا كان الجهاز مؤهلاً لجهاز التوجيه أم لا.

في حال كانت القيمة aEligible خاطئة وكان الجهاز يعمل حاليًا كجهاز توجيه، سيؤدي هذا الاتصال إلى فصل الجهاز ومحاولة إعادة إرفاقه كجهاز طفل.

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

otThreadSetRouterIdRange

otError otThreadSetRouterIdRange(
  otInstance *aInstance,
  uint8_t aMinRouterId,
  uint8_t aMaxRouterId
)

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

ملاحظة: تتطلب واجهة برمجة التطبيقات هذه OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE، وتُستخدم لأغراض الاختبار فقط. يُسمح بجميع أرقام تعريف جهاز التوجيه في النطاق [aMinRouterId, aMaxRouterId].

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aMinRouterId تمثّل هذه السمة الحد الأدنى لرقم تعريف جهاز التوجيه. [in] aMaxRouterId الحد الأقصى لرقم تعريف جهاز التوجيه.
قيم الإرجاع	OT_ERROR_NONE تم بنجاح تعيين النطاق. OT_ERROR_INVALID_ARGS aMinRouterId > aMaxRouterId، أو النطاق لا يغطّيه [0، 62].

يُرجى الاطّلاع أيضًا على:
otThreadGetRouterIdRange

otThreadSetRouterSelectionJitter

void otThreadSetRouterSelectionJitter(
  otInstance *aInstance,
  uint8_t aRouterJitter
)

يمكنك تعيين المعلمة ROUTER_Cancel_JITTER المستخدمة في دور REED/جهاز التوجيه.

ملاحظة: إنّ واجهة برمجة التطبيقات هذه مخصّصة لأغراض الاختبار والعرض فقط. سيؤدي تغيير الإعدادات باستخدام واجهة برمجة التطبيقات هذه إلى عرض تطبيق الإنتاج غير المتوافق مع مواصفات Thread.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aRouterJitter قيمة ROUTER_ِيلْ_JITTER.

راجِع أيضًا:
otThreadGetRouterSelectionJitter

otThreadSetRouterUpgradeThreshold

void otThreadSetRouterUpgradeThreshold(
  otInstance *aInstance,
  uint8_t aThreshold
)

يمكنك ضبط معلَمة ROUTER_UPupgrade_LIMIT المستخدَمة في دور "القائد".

ملاحظة: إنّ واجهة برمجة التطبيقات هذه مخصّصة لأغراض الاختبار والعرض فقط. سيؤدي تغيير الإعدادات باستخدام واجهة برمجة التطبيقات هذه إلى عرض تطبيق الإنتاج غير المتوافق مع مواصفات Thread.

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

راجِع أيضًا:
otThreadGetRouterUpgradeThreshold

otThreadSetSteeringData

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

اضبط بيانات التوجيه خارج الإطار.

يجب ضبط خيار الضبط OPENTHREAD_CONFIG_MLE_STEERING_DATA_SET_OOB_ENABLE لتفعيل إعدادات توجيه البيانات خارج الإطار.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aExtAddress العنوان المُستخدَم لتعديل بيانات التوجيه جميع الأصفار لمحو بيانات التوجيه (ما مِن بيانات عن التوجيه). جميع 0xFF لضبط فلتر بيانات التوجيه/زر التفتح على قبول الكل أو السماح به. نموذج EUI64 محدّد تتم إضافته بعد ذلك إلى فلتر بيانات/مؤشرات التوجيه الحالية.

otThreadSetThreadVersionCheckEnabled

void otThreadSetThreadVersionCheckEnabled(
  otInstance *aInstance,
  bool aEnabled
)

تحدِّد هذه السياسة ما إذا كان قد تم تفعيل حد إصدار TLV لسياسة الأمان للتوجيه (حقل الواقع الافتراضي).

ملاحظة: تتطلّب واجهة برمجة التطبيقات هذه استخدام OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE فقط، ولا يتم استخدامها إلا من خلال Thread Test Harness للإشارة إلى ضرورة تخطّي فحص إصدار بروتوكول سلسلة المحادثات من خلال الواقع الافتراضي.

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

وحدات ماكرو

OT_CHILD_IP6_ADDRESS_ITERATOR_INIT

 OT_CHILD_IP6_ADDRESS_ITERATOR_INIT 0

مُهيئ لـ otChildIP6AddressIterator.

المراجِع

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