Google is committed to advancing racial equity for Black communities. See how.

جهاز التوجيه / القائد

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

ملخص

التعداد

otCacheEntryState تعداد
يحدد هذا التعداد حالة إدخال ذاكرة التخزين المؤقت لـ 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 تشير إلى تغييرات في الجدول الجار.

النوع

otCacheEntryInfo typedef
يمثل هذا الهيكل إدخال ذاكرة التخزين المؤقت EID.
otCacheEntryIterator typedef
يمثل هذا النوع مكررًا يستخدم للتكرار خلال إدخالات جدول ذاكرة التخزين المؤقت لـ EID.
otCacheEntryState typedef
يحدد هذا التعداد حالة إدخال ذاكرة التخزين المؤقت لـ EID.
otChildIp6AddressIterator typedef
uint16_t
يُستخدم للتكرار عبر عناوين IPv6 لإدخال مؤشر ترابط تابع.
otNeighborTableCallback )(otNeighborTableEvent aEvent, const otNeighborTableEntryInfo *aEntryInfo) typedef
void(*
يتم استدعاء مؤشر الوظيفة هذا للإعلام بوجود تغيير في جدول الجوار.

المهام

otThreadBecomeLeader ( otInstance *aInstance)
كن قائدًا وابدأ قسمًا جديدًا.
otThreadBecomeRouter ( otInstance *aInstance)
حاول أن تصبح جهاز توجيه.
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 التالي (باستخدام مكرر) لطفل معين.
otThreadGetContextIdReuseDelay ( otInstance *aInstance)
uint32_t
احصل على المعلمة CONTEXT_ID_REUSE_DELAY المستخدمة في دور القائد.
otThreadGetJoinerUdpPort ( otInstance *aInstance)
uint16_t
احصل على Joiner UDP Port.
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 التالي (باستخدام مكرر).
otThreadGetParentPriority ( otInstance *aInstance)
int8_t
احصل على أولوية الوالدين المعينة.
otThreadGetPreferredLeaderPartitionId ( otInstance *aInstance)
uint32_t
احصل على معرف قسم زعيم الموضوع المفضل المستخدم عند التشغيل في دور القائد.
otThreadGetPskc ( otInstance *aInstance, otPskc *aPskc)
void
احصل على الموضوع PSKc.
otThreadGetPskcRef ( otInstance *aInstance)
احصل على مرجع رئيسي إلى Thread PSKc المخزنة.
otThreadGetRouterDowngradeThreshold ( otInstance *aInstance)
uint8_t
احصل على المعلمة ROUTER_DOWNGRADE_THRESHOLD المستخدمة في دور جهاز التوجيه.
otThreadGetRouterIdSequence ( otInstance *aInstance)
uint8_t
احصل على تسلسل معرف جهاز التوجيه الحالي.
otThreadGetRouterInfo ( otInstance *aInstance, uint16_t aRouterId, otRouterInfo *aRouterInfo)
تحتفظ الوظيفة بالمعلومات التشخيصية لجهاز التوجيه الخيطي المحدد.
otThreadGetRouterSelectionJitter ( otInstance *aInstance)
uint8_t
احصل على المعلمة ROUTER_SELECTION_JITTER المستخدمة في دور REED / جهاز التوجيه.
otThreadGetRouterUpgradeThreshold ( otInstance *aInstance)
uint8_t
احصل على المعلمة ROUTER_UPGRADE_THRESHOLD المستخدمة في دور REED.
otThreadIsRouterEligible ( otInstance *aInstance)
bool
تشير هذه الطريقة إلى ما إذا كان الجهاز مؤهلاً لجهاز التوجيه أم لا.
otThreadRegisterNeighborTableCallback ( otInstance *aInstance, otNeighborTableCallback aCallback)
void
تسجل هذه الوظيفة وظيفة رد اتصال جدول الجوار.
otThreadReleaseRouterId ( otInstance *aInstance, uint8_t aRouterId)
حرر معرف جهاز التوجيه الذي تم تخصيصه بواسطة الجهاز في دور القائد.
otThreadSetCcmEnabled ( otInstance *aInstance, bool aEnabled)
void
تحدد هذه الوظيفة ما إذا كان قد تم تشغيل الجهاز باستخدام CCM.
otThreadSetContextIdReuseDelay ( otInstance *aInstance, uint32_t aDelay)
void
قم بتعيين المعلمة CONTEXT_ID_REUSE_DELAY المستخدمة في دور القائد.
otThreadSetJoinerUdpPort ( otInstance *aInstance, uint16_t aJoinerUdpPort)
اضبط Joiner UDP Port.
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)
اضبط الموضوع PSKc.
otThreadSetPskcRef ( otInstance *aInstance, otPskcRef aKeyRef)
اضبط الموضوع PSKc.
otThreadSetRouterDowngradeThreshold ( otInstance *aInstance, uint8_t aThreshold)
void
قم بتعيين المعلمة ROUTER_DOWNGRADE_THRESHOLD المستخدمة في دور القائد.
otThreadSetRouterEligible ( otInstance *aInstance, bool aEligible)
تحدد هذه الوظيفة ما إذا كان الجهاز مؤهلاً لجهاز التوجيه أم لا.
otThreadSetRouterSelectionJitter ( otInstance *aInstance, uint8_t aRouterJitter)
void
قم بتعيين المعلمة ROUTER_SELECTION_JITTER المستخدمة في دور REED / جهاز التوجيه.
otThreadSetRouterUpgradeThreshold ( otInstance *aInstance, uint8_t aThreshold)
void
قم بتعيين المعلمة ROUTER_UPGRADE_THRESHOLD المستخدمة في دور القائد.
otThreadSetSteeringData ( otInstance *aInstance, const otExtAddress *aExtAddress)
void
ضبط بيانات التوجيه خارج النطاق.

الهياكل

otCacheEntryInfo

يمثل هذا الهيكل إدخال ذاكرة التخزين المؤقت EID.

otCacheEntryIterator

يمثل هذا النوع مكررًا يستخدم للتكرار خلال إدخالات جدول ذاكرة التخزين المؤقت لـ EID.

otChildInfo

تحتوي هذه البنية على معلومات تشخيصية لـ Thread Child.

otNeighborTableEntryInfo

هذا النوع تمثل المعلومات إدخال جدول جار (طفل أو الموجه)، ويستخدم كمعلمة في الجدول جار رد otNeighborTableCallback .

التعداد

otCacheEntryState

 otCacheEntryState

يحدد هذا التعداد حالة إدخال ذاكرة التخزين المؤقت لـ 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

تتم إزالة جهاز توجيه.

النوع

otCacheEntryInfo

struct otCacheEntryInfo otCacheEntryInfo

يمثل هذا الهيكل إدخال ذاكرة التخزين المؤقت EID.

otCacheEntryIterator

struct otCacheEntryIterator otCacheEntryIterator

يمثل هذا النوع مكررًا يستخدم للتكرار خلال إدخالات جدول ذاكرة التخزين المؤقت لـ EID.

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

otCacheEntryState

enum otCacheEntryState otCacheEntryState

يحدد هذا التعداد حالة إدخال ذاكرة التخزين المؤقت لـ EID.

otChildIp6AddressIterator

uint16_t otChildIp6AddressIterator

يُستخدم للتكرار عبر عناوين IPv6 لإدخال مؤشر ترابط تابع.

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
تم تعطيل الموضوع.

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 غير NULL.

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 غير NULL، أو 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 هي NULL، أو طفل في aChildIndex غير صالح.
أنظر أيضا:
otThreadGetChildInfoByIndex

otThreadGetContextIdReuseDelay

uint32_t otThreadGetContextIdReuseDelay(
  otInstance *aInstance
)

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

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
عائدات
قيمة CONTEXT_ID_REUSE_DELAY.
أنظر أيضا:
otThreadSetContextIdReuseDelay

otThreadGetJoinerUdport

uint16_t otThreadGetJoinerUdpPort(
  otInstance *aInstance
)

احصل على Joiner UDP Port.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
عائدات
رقم المنفذ UDP.
أنظر أيضا:
otThreadSetJoinerUdport

otThreadGetLocalLeader الوزن

uint8_t otThreadGetLocalLeaderWeight(
  otInstance *aInstance
)

احصل على وزن زعيم الخيط المستخدم عند العمل في دور القائد.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
عائدات
قيمة وزن زعيم الخيط.
أنظر أيضا:
otThreadSetLeader الوزن

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
مؤشر إلى مكان وضع معلومات إدخال ذاكرة التخزين المؤقت لـ EID.
[in,out] aIterator
مؤشر إلى مكرر. سيتم تحديثه للإشارة إلى الإدخال التالي بشأن النجاح. للحصول على الإدخال الأول، تهيئة مكرر من خلال وضع كافة المجالات إلى الصفر (على سبيل المثال، memset في هيكل مكرر إلى الصفر).
إرجاع القيم
OT_ERROR_NONE
بنجاح بالسكان aEntryInfo للالمقبل الإدخال المؤقت EID.
OT_ERROR_NOT_FOUND
لا يوجد المزيد من الإدخالات في جدول ذاكرة التخزين المؤقت للعنوان.

otThreadGetParent الأولوية

int8_t otThreadGetParentPriority(
  otInstance *aInstance
)

احصل على أولوية الوالدين المعينة.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
عائدات
قيمة الأولوية الأصل المعينة ، -2 تعني عدم تعيينها.
أنظر أيضا:
otThreadSetParent الأولوية

otThreadGetPreferredLeaderPartitionId

uint32_t otThreadGetPreferredLeaderPartitionId(
  otInstance *aInstance
)

احصل على معرف قسم زعيم الموضوع المفضل المستخدم عند التشغيل في دور القائد.

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

otThreadGetPskc

void otThreadGetPskc(
  otInstance *aInstance,
  otPskc *aPskc
)

احصل على الموضوع 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_DOWNGRADE_THRESHOLD المستخدمة في دور جهاز التوجيه.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
عائدات
قيمة ROUTER_DOWNGRADE_THRESHOLD.
أنظر أيضا:
otThreadSetRouterDowngradeThreshold

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 غير NULL.

otThreadGetRouterSelectionJitter

uint8_t otThreadGetRouterSelectionJitter(
  otInstance *aInstance
)

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

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
عائدات
قيمة ROUTER_SELECTION_JITTER.
أنظر أيضا:
otThreadSetRouterSelectionJitter

otThreadGetRouterUpgradeThreshold

uint8_t otThreadGetRouterUpgradeThreshold(
  otInstance *aInstance
)

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

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
عائدات
قيمة ROUTER_UPGRADE_THRESHOLD.
أنظر أيضا:
otThreadSetRouterUpgradeThreshold

otThreadIsRouter مؤهل

bool otThreadIsRouterEligible(
  otInstance *aInstance
)

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

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

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
)

تحدد هذه الوظيفة ما إذا كان قد تم تشغيل الجهاز باستخدام CCM.

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

otThreadSetContextIdReuseDelay

void otThreadSetContextIdReuseDelay(
  otInstance *aInstance,
  uint32_t aDelay
)

قم بتعيين المعلمة CONTEXT_ID_REUSE_DELAY المستخدمة في دور القائد.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aDelay
قيمة CONTEXT_ID_REUSE_DELAY.
أنظر أيضا:
otThreadGetContextIdReuseDelay

otThreadSetJoinerUdport

otError otThreadSetJoinerUdpPort(
  otInstance *aInstance,
  uint16_t aJoinerUdpPort
)

اضبط Joiner UDP Port.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aJoinerUdpPort
رقم منفذ UDP.
إرجاع القيم
OT_ERROR_NONE
نجح في تعيين Joiner UDP Port.
أنظر أيضا:
otThreadGetJoinerUdport

otThreadSetLocalLeader الوزن

void otThreadSetLocalLeaderWeight(
  otInstance *aInstance,
  uint8_t aWeight
)

قم بتعيين وزن زعيم الخيط المستخدم عند التشغيل في دور القائد.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aWeight
قيمة وزن زعيم الخيط.
أنظر أيضا:
otThreadGetLeader الوزن

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 تسجيلها مع هذا الجهاز باعتباره أحد الوالدين.

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

otThreadSetParent الأولوية

otError otThreadSetParentPriority(
  otInstance *aInstance,
  int8_t aParentPriority
)

قم بتعيين أولوية الأصل.

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

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
)

اضبط الموضوع PSKc.

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

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aPskc
مؤشر إلى موضوع PSKc الجديد.
إرجاع القيم
OT_ERROR_NONE
تم بنجاح تعيين مؤشر ترابط PSKc.
OT_ERROR_INVALID_STATE
تم تمكين بروتوكولات الموضوع.
أنظر أيضا:
otThreadGetPskc

otThreadSetPskcRef

otError otThreadSetPskcRef(
  otInstance *aInstance,
  otPskcRef aKeyRef
)

اضبط الموضوع PSKc.

تتطلب هذه الوظيفة لمرة وبناء ميزة OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE إلى تمكين.

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

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aPskcRef
مفتاح مرجع إلى الموضوع الجديد PSKc.
إرجاع القيم
OT_ERROR_NONE
تم بنجاح تعيين مؤشر ترابط PSKc.
OT_ERROR_INVALID_STATE
تم تمكين بروتوكولات الموضوع.
أنظر أيضا:
otThreadGetPskcRef

otThreadSetRouterDowngradeThreshold

void otThreadSetRouterDowngradeThreshold(
  otInstance *aInstance,
  uint8_t aThreshold
)

قم بتعيين المعلمة ROUTER_DOWNGRADE_THRESHOLD المستخدمة في دور القائد.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aThreshold
قيمة ROUTER_DOWNGRADE_THRESHOLD.
أنظر أيضا:
otThreadGetRouterDowngradeThreshold

otThreadSetRouter مؤهل

otError otThreadSetRouterEligible(
  otInstance *aInstance,
  bool aEligible
)

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

إذا aEligible هو زائف والجهاز تعمل حاليا على جهاز توجيه، سيكون لهذه الدعوة يتسبب في الجهاز لفصل ومحاولة أعد عندما كان طفلا.

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

otThreadSetRouterSelectionJitter

void otThreadSetRouterSelectionJitter(
  otInstance *aInstance,
  uint8_t aRouterJitter
)

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

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aRouterJitter
قيمة ROUTER_SELECTION_JITTER.
أنظر أيضا:
otThreadGetRouterSelectionJitter

otThreadSetRouterUpgradeThreshold

void otThreadSetRouterUpgradeThreshold(
  otInstance *aInstance,
  uint8_t aThreshold
)

قم بتعيين المعلمة ROUTER_UPGRADE_THRESHOLD المستخدمة في دور القائد.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aThreshold
قيمة ROUTER_UPGRADE_THRESHOLD.
أنظر أيضا:
otThreadGetRouterUpgradeThreshold

otThreadSetSteeringData

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

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

تكوين الخيار OPENTHREAD_CONFIG_MLE_STEERING_DATA_SET_OOB_ENABLE يجب تعيين لتمكين وضع بيانات التوجيه من الفرقة.

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

وحدات الماكرو

OT_CHILD_IP6_ADDRESS_ITERATOR_INIT

 OT_CHILD_IP6_ADDRESS_ITERATOR_INIT 0

مُهيئ لـ otChildIP6AddressIterator.