نجّار

تتضمّن هذه الوحدة وظائف دور "رابط سلسلة المحادثات".

ملخّص

التعدادات
otJoinerState تعداد
يحدّد حالة الانضمام.

أنواع المحددات
otJoinerCallback)(otError aError, void *aContext) typedef
void(*
يتم استدعاء المؤشر لإبلاغه باكتمال عملية انضمام.
otJoinerDiscerner typedef
يمثّل موزع فِرق
otJoinerState typedef
يحدّد حالة الانضمام.

الدوال
otJoinerGetDiscerner(otInstance *aInstance)
الحصول على الشخص الذي يكشف عن الصدمة
otJoinerGetId(otInstance *aInstance)
const otExtAddress *
الحصول على رقم تعريف المشترك
otJoinerGetState(otInstance *aInstance)
للحصول على حالة الانضمام.
otJoinerSetDiscerner(otInstance *aInstance, otJoinerDiscerner *aDiscerner)
لضبط الشخص الذي يكشف النقاب
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

يحدّد حالة الانضمام.

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

OTJOINerCallCall

void(* otJoinerCallback)(otError aError, void *aContext)

يتم استدعاء المؤشر لإبلاغه باكتمال عملية انضمام.

التفاصيل
المَعلمات
[in] aError
OT_ERROR_NONE في حال نجاح عملية الانضمام OT_ERROR_security إذا تعذّر إتمام عملية الانضمام بسبب بيانات اعتماد الأمان. OT_ERROR_NOT_FOUND في حال عدم رصد شبكة يمكن الانضمام إليها OT_ERROR_RESPONSE_ {8/} إذا انتهت مهلة الرد.
[in] aContext
مؤشر للسياق الخاص بالتطبيق.

otالانضمامerDiscerner

struct otJoinerDiscerner otJoinerDiscerner

يمثّل موزع فِرق

OTJOINerState

enum otJoinerState otJoinerState

يحدّد حالة الانضمام.

الدوال

otjoinerGetDiscerner

const otJoinerDiscerner * otJoinerGetDiscerner(
  otInstance *aInstance
)

الحصول على الشخص الذي يكشف عن الصدمة

لمزيد من المعلومات، يُرجى الرجوع إلى otjoinerSetDiscerner.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
المرتجعات
مؤشر إلى المشارك "لم ير" أو خالٍ من الأخطاء إذا لم يتم ضبط أي منهما.

otjoinerGetId

const otExtAddress * otJoinerGetId(
  otInstance *aInstance
)

الحصول على رقم تعريف المشترك

في حال عدم ضبط أحد المُسجّلين على أول 64 بت من نتيجة حوسبة SHA-256 على الخوارزمية المُخصَّصة للمصنع، IEEEEUI-64. بخلاف ذلك، يتم احتساب "رقم تعريف المجمّع" من قيمة ميزة "المشارِك".

يتم أيضًا استخدام رقم تعريف الوحدة التنظيمية كعنوان IEEE 802.15.4 الموسَّع أثناء عملية التفويض.

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

otJOINerGetState

otJoinerState otJoinerGetState(
  otInstance *aInstance
)

للحصول على حالة الانضمام.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
قيم الإرجاع
OT_JOINER_STATE_IDLE
OT_JOINER_STATE_DISCOVER
OT_JOINER_STATE_CONNECT
OT_JOINER_STATE_CONNECTED
OT_JOINER_STATE_ENTRUST
OT_JOINER_STATE_JOINED

otjoinerSetDiscerner

otError otJoinerSetDiscerner(
  otInstance *aInstance,
  otJoinerDiscerner *aDiscerner
)

لضبط الشخص الذي يكشف النقاب

يتم استخدام أداة تجميع اللحوم لاحتساب قيمة معرِّف الناقل أثناء عملية تفويض سلسلة المحادثات. لمعرفة مزيد من المعلومات، يُرجى الاطّلاع على otjoinerGetId.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aDiscerner
هي إشارة إلى أحد مميّصي المقاطع. إذا محوت NULL أي محدد سابق.
قيم الإرجاع
OT_ERROR_NONE
تم بنجاح تحديث The Disker Discerner.
OT_ERROR_INVALID_ARGS
aDiscerner غير صالح (الطول المحدد ليس ضمن نطاق صالح).
OT_ERROR_INVALID_STATE
هناك عملية انضمام جارية، لذا تعذّر تغيير أداة الانضمام إلى الشريك.

otبدء الانضمام

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
)

تعمل هذه السياسة على تفعيل دور رابط سلسلة المحادثات.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aPskd
مؤشر على PSKd
[in] aProvisioningUrl
مؤشر إلى عنوان URL تزويد الحسابات (قد يكون فارغًا).
[in] aVendorName
مؤشر إلى اسم المورّد (قد يكون فارغًا).
[in] aVendorModel
مؤشر إلى نموذج المورّد (قد يكون فارغًا).
[in] aVendorSwVersion
إشارة إلى إصدار المورِّد (قد تكون القيمة فارغة).
[in] aVendorData
مؤشر إلى بيانات المورّد (قد يكون فارغًا).
[in] aCallback
مؤشر لدالة يتم استدعاؤها عند اكتمال عملية الانضمام.
[in] aContext
مؤشر للسياق الخاص بالتطبيق.
قيم الإرجاع
OT_ERROR_NONE
تم بدء دور المشترك بنجاح.
OT_ERROR_BUSY
لا تزال المحاولة السابقة مستمرة.
OT_ERROR_INVALID_ARGS
قيمة aPskd أو aProvisioningUrl غير صالحة.
OT_ERROR_INVALID_STATE
لم يتم تفعيل حِزم IPv6 أو تكدس سلسلة المحادثات بالكامل.

otjoinerStateToString

const char * otJoinerStateToString(
  otJoinerState aState
)

تحوِّل قيمة تعداد حالة رابط معيّنة إلى سلسلة يمكن للمستخدم قراءتها.

التفاصيل
المَعلمات
[in] aState
حالة الانضمام.
المرتجعات
تمثيل سلسلة قابل للقراءة من قِبل aState لـ

ot اختيار الانضمام

void otJoinerStop(
  otInstance *aInstance
)

لإيقاف دور رابط سلسلة المحادثات

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.

وحدات ماكرو

الوقت الإضافي: OT_JOINER_MAX_DISCERNER_LENGTH

 OT_JOINER_MAX_DISCERNER_LENGTH 64

الحد الأقصى لطول الشخص الذي يرصد اللحية بالبايت

الموارد

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