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

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

ملخّص

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

الدوال
otThreadBecomeLeader(otInstance *aInstance)
كُن قائدًا وابدأ قسمًا جديدًا.
otThreadBecomeRouter(otInstance *aInstance)
حاول أن تصبح موجهًا.
otThreadGetAdvertisementTrickleIntervalMax(otInstance *aInstance)
uint32_t
للحصول على القيمة الحالية للفاصل الزمني الأقصى الذي يستخدمه موقت تدفق الإعلانات.
otThreadGetChildInfoById(otInstance *aInstance, uint16_t aChildId, otChildInfo *aChildInfo)
الحصول على معلومات تشخيصية لطفل مرفق من خلال رقم تعريف الطفل أو RLOC16.
otThreadGetChildInfoByIndex(otInstance *aInstance, uint16_t aChildIndex, otChildInfo *aChildInfo)
تحتفظ الدالة بمعلومات تشخيصية لعنصر تابع مرفق بواسطة فهرس الجدول الداخلي.
otThreadGetChildNextIp6Address(otInstance *aInstance, uint16_t aChildIndex, otChildIp6AddressIterator *aIterator, otIp6Address *aAddress)
الحصول على عنوان IPv6 التالي (باستخدام مُكرّر) لطفل معيّن.
otThreadGetChildRouterLinks(otInstance *aInstance)
uint8_t
احصل على معلمة MLE_CHILD_ROUTER_LINKS المستخدمة في دور REED.
otThreadGetContextIdReuseDelay(otInstance *aInstance)
uint32_t
احصل على مَعلمة CONTEXT_ID_REUSE_REASON المستخدَمة في دور القائد.
otThreadGetDeviceProperties(otInstance *aInstance)
الحصول على خصائص الجهاز الحالية
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)
يحصل على الإدخال التالي لذاكرة التخزين المؤقت لرقم 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)
الحصول على مرجع المفتاح لـ 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)
تحتفظ الدالة بمعلومات التشخيص لجهاز توجيه سلسلة محادثات معيّن.
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)
تحرير رقم تعريف جهاز التوجيه الذي خصصه الجهاز في دور القائد.
otThreadSetCcmEnabled(otInstance *aInstance, bool aEnabled)
void
تحدِّد هذه السياسة ما إذا كان قد تم تفويض الجهاز باستخدام "إدارة السحابة الإلكترونية من Firebase".
otThreadSetChildRouterLinks(otInstance *aInstance, uint8_t aChildRouterLinks)
يمكنك تعيين معلمة 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)
لضبط منفذ UDP لـ Join.
otThreadSetLocalLeaderWeight(otInstance *aInstance, uint8_t aWeight)
void
لضبط وزن قائد سلسلة المحادثات المستخدَم عند العمل في دور القائد.
otThreadSetMaxAllowedChildren(otInstance *aInstance, uint16_t aMaxChildren)
ضبط الحدّ الأقصى لعدد الأطفال المسموح به حاليًا
otThreadSetMaxChildIpAddresses(otInstance *aInstance, uint8_t aMaxIpAddresses)
تُستخدم هذه السياسة في ضبط أو استعادة الحد الأقصى لعدد عناوين IP التي قد يسجّلها كل طفل في MTD باستخدام هذا الجهاز بصفته أحد الوالدَين.
otThreadSetNetworkIdTimeout(otInstance *aInstance, uint8_t aTimeout)
void
اضبط المعلَمة NETWORK_ID_TIMEOUT.
otThreadSetParentPriority(otInstance *aInstance, int8_t aParentPriority)
ضبط أولوية العنصر الرئيسي.
otThreadSetPreferredLeaderPartitionId(otInstance *aInstance, uint32_t aPartitionId)
void
يمكنك ضبط معرِّف قسم قائد سلسلة المحادثات المفضّل المُستخدَم عند العمل في دور القائد.
otThreadSetPreferredRouterId(otInstance *aInstance, uint8_t aRouterId)
ضبط رقم تعريف جهاز التوجيه المفضّل.
otThreadSetPskc(otInstance *aInstance, const otPskc *aPskc)
قم بتعيين Thread PSKc.
otThreadSetPskcRef(otInstance *aInstance, otPskcRef aKeyRef)
قم بتعيين مرجع المفتاح إلى Thread PSKc.
otThreadSetRouterDowngradeThreshold(otInstance *aInstance, uint8_t aThreshold)
void
يمكنك ضبط المعلمة ROUTER_DOWNRESULTS_LIMIT المستخدَمة في دور القائد.
otThreadSetRouterEligible(otInstance *aInstance, bool aEligible)
تحدد ما إذا كان الجهاز مؤهلاً لجهاز التوجيه أم لا.
otThreadSetRouterIdRange(otInstance *aInstance, uint8_t aMinRouterId, uint8_t aMaxRouterId)
يضبط نطاق معرفات جهاز التوجيه التي يُسمح بتعيينها للعُقد داخل شبكة سلسلة المحادثات.
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
)

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

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

otThreadBecomeRouter

otError otThreadBecomeRouter(
  otInstance *aInstance
)

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

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

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.

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

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

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

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

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

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aEnabled
TRUE إذا تم تفويض الجهاز باستخدام CCM، أو FALSE في الحالات الأخرى. 
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 المستخدمة في دور القائد.

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

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

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

otThreadSetParentPriority

otError otThreadSetParentPriority(
  otInstance *aInstance,
  int8_t aParentPriority
)

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

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

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

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

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

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

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

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

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

otThreadSetRouterUpgradeThreshold

void otThreadSetRouterUpgradeThreshold(
  otInstance *aInstance,
  uint8_t aThreshold
)

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

التفاصيل
المَعلمات
[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 لسياسة الأمان للتوجيه (حقل الواقع الافتراضي).

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

وحدات ماكرو

OT_CHILD_IP6_ADDRESS_ITERATOR_INIT

 OT_CHILD_IP6_ADDRESS_ITERATOR_INIT 0

مُهيئ لـ otChildIP6AddressIterator.

المراجِع

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