نجّار
تتضمّن هذه الوحدة وظائف دور "سلسلة المحادثات المرتبطة".
الملخّص
التعدادات |
|
---|---|
otJoinerState
|
تعداد تحدّد هذه القائمة العدد حالة ضمّ المشتركين. |
مواقد الخط |
|
---|---|
otJoinerCallback)(otError aError, void *aContext)
|
مَعلمة typetypevoid(*
يُطلق على مؤشر الدالة هذا إشعار باكتمال عملية انضمام. |
otJoinerDiscerner
|
مَعلمة typetypestruct otJoinerDiscerner
تمثّل هذه البنية مشتركًا مشتركًا. |
otJoinerState
|
مَعلمة typetypeenum otJoinerState
تحدّد هذه القائمة العدد حالة ضمّ المشتركين. |
الدوال |
|
---|---|
otJoinerGetDiscerner(otInstance *aInstance)
|
const otJoinerDiscerner *
تحصل هذه الدالة على Joiner Discerner.
|
otJoinerGetId(otInstance *aInstance)
|
const otExtAddress *
تحصل هذه الدالة على معرّف المشارك.
|
otJoinerGetState(otInstance *aInstance)
|
تعرض هذه الدالة حالة الانضمام.
|
otJoinerSetDiscerner(otInstance *aInstance, otJoinerDiscerner *aDiscerner)
|
تعمل هذه الدالة على ضبط تطبيق Joiner Discerner.
|
otJoinerStart(otInstance *aInstance, const char *aPskd, const char *aProvisioningUrl, const char *aVendorName, const char *aVendorModel, const char *aVendorSwVersion, const char *aVendorData, otJoinerCallback aCallback, void *aContext)
|
تتيح هذه الدالة تفعيل دور "سلسلة المحادثات".
|
otJoinerStateToString(otJoinerState aState)
|
const char *
تحوِّل هذه الدالة قيمة تعداد نمط ضمّ معيّنة إلى سلسلة يمكن للمستخدمين قراءتها.
|
otJoinerStop(otInstance *aInstance)
|
void
توقِف هذه الدالة دور "سلسلة المحادثات".
|
التشريعات |
|
---|---|
otJoinerDiscerner |
تمثّل هذه البنية مشتركًا مشتركًا. |
التعدادات
otJoinerState
otJoinerState
تحدّد هذه القائمة العدد حالة ضمّ المشتركين.
مواقد الخط
otJoinerCallback
void(* otJoinerCallback)(otError aError, void *aContext)
يُطلق على مؤشر الدالة هذا إشعار باكتمال عملية انضمام.
التفاصيل | |||||
---|---|---|---|---|---|
المعلَمات |
|
الدوال
otJoinerGetDiscerner
const otJoinerDiscerner * otJoinerGetDiscerner( otInstance *aInstance )
تحصل هذه الدالة على Joiner Discerner.
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
||
طلبات الإرجاع |
مؤشر إلى Joiner Discerner أو False إذا لم يتم ضبط أي نوع.
|
otJoinerGetId
const otExtAddress * otJoinerGetId( otInstance *aInstance )
تحصل هذه الدالة على معرّف المشارك.
إذا لم يتم ضبط Joiner Discerner، يكون رقم تعريف المشارك هو أول 64 بت من نتيجة احتساب SHA-256 على الإعدادات الأصلية التي تم تخصيصها حسب الإعدادات الأصلية في IEEE-64. بخلاف ذلك، يتم حساب رقم تعريف المشارك من قيمة تطبيق Disnerner.
ويُستخدَم رقم تعريف المشارك أيضًا على أنه "العنوان IEEE 802.15.4 الموسَّع" للجهاز أثناء عملية العمولة.
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
||
طلبات الإرجاع |
مؤشر إلى معرّف المشارك
|
otJoinerGetState
otJoinerState otJoinerGetState( otInstance *aInstance )
تعرض هذه الدالة حالة الانضمام.
التفاصيل | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||||||||
قيم الإرجاع |
|
otJoinerSetDiscerner
otError otJoinerSetDiscerner( otInstance *aInstance, otJoinerDiscerner *aDiscerner )
تعمل هذه الدالة على ضبط تطبيق Joiner Discerner.
يُستخدَم رابط الانضمام لحساب معرّف المشارك أثناء عملية التكليف/الانضمام.
تلقائيًا (عندما لا يتم توفير خاتم فروق أو ضبطه على القيمة "خالٍ")، يتم اشتقاق رقم تعريف المشارك على أنه أول 64 بت من نتيجة احتساب SHA-256 على المصنع IEEE EU-64 الذي تم ضبطه على الإعدادات الأصلية. لاحظ أن هذا هو السلوك الرئيسي المتوقع في مواصفات سلسلة المحادثات.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||
قيم الإرجاع |
|
otJoinerStart
otError otJoinerStart( otInstance *aInstance, const char *aPskd, const char *aProvisioningUrl, const char *aVendorName, const char *aVendorModel, const char *aVendorSwVersion, const char *aVendorData, otJoinerCallback aCallback, void *aContext )
تتيح هذه الدالة تفعيل دور "سلسلة المحادثات".
التفاصيل | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||||||||||||||
قيم الإرجاع |
|
otJoinerStateToString
const char * otJoinerStateToString( otJoinerState aState )
تحوِّل هذه الدالة قيمة تعداد نمط ضمّ معيّنة إلى سلسلة يمكن للمستخدمين قراءتها.
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
||
طلبات الإرجاع |
تمثّل هذه الخاصية سلسلة نصية مقروءة يسهل على
aState قراءتها. |
otJoinerStop
void otJoinerStop( otInstance *aInstance )
توقِف هذه الدالة دور "سلسلة المحادثات".
التفاصيل | |||
---|---|---|---|
المعلَمات |
|
وحدات ماكرو
OT_JoinER_MAX_DISCERNER_LENGTH
OT_JOINER_MAX_DISCERNER_LENGTH 64
الحد الأقصى لطول جهاز الانضمام عبر وحدات البت.
المراجع
تنشأ مواضيع واجهة برمجة التطبيقات المرجعية لـ OpenThread من رمز المصدر، المتوفر على GitHub. للاطّلاع على مزيد من المعلومات أو للمساهمة في مستنداتنا، يُرجى الرجوع إلى المراجع.