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

نجار

تتضمن هذه الوحدة وظائف لدور رابط الموضوع.

ملخص

التعداد

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)
تتيح هذه الوظيفة دور رابط مؤشر الترابط.
otJoinerStop ( otInstance *aInstance)
void
تعمل هذه الوظيفة على تعطيل دور رابط مؤشر الترابط.

الهياكل

otJoinerDiscerner

يمثل هذا الهيكل المميز نجار.

التعداد

otJoinerState

 otJoinerState

يحدد هذا التعداد الدولة المنضم.

النوع

otJoiner رد الاتصال

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

يتم استدعاء مؤشر الوظيفة هذا لإخطار اكتمال عملية الربط.

تفاصيل
المعلمات
[in] aError
OT_ERROR_NONE إذا نجحت عملية الانضمام. OT_ERROR_SECURITY إذا فشلت عملية الانضمام بسبب بيانات اعتماد الأمان. OT_ERROR_NOT_FOUND في حالة عدم اكتشاف أي شبكة قابلة للانضمام. OT_ERROR_RESPONSE_TIMEOUT إذا انتهت مهلة الرد.
[in] aContext
مؤشر إلى سياق خاص بالتطبيق.

otJoinerDiscerner

struct otJoinerDiscerner otJoinerDiscerner

يمثل هذا الهيكل المميز نجار.

otJoinerState

enum otJoinerState otJoinerState

يحدد هذا التعداد الدولة المنضم.

المهام

otJoinerGetDiscerner

const otJoinerDiscerner * otJoinerGetDiscerner(
  otInstance *aInstance
)

هذه الطريقة تحصل على المميز النجار.

تفاصيل
المعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
عائدات
مؤشر لـ Joiner Discerner أو NULL إذا لم يتم تعيين أي شيء.

otJoinerGetId

const otExtAddress * otJoinerGetId(
  otInstance *aInstance
)

هذه الطريقة تحصل على معرف النجار.

إذا لم يتم تعيين Joiner Discerner ، فإن معرف Joiner هو أول 64 بت من نتيجة حساب SHA-256 عبر IEEE EUI-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
)

تقوم هذه الطريقة بتعيين المميز المميز.

يتم استخدام برنامج Joiner Discerner لحساب معرّف النجار المستخدم أثناء عملية التكليف / الانضمام.

بشكل افتراضي (عندما لا يتم توفير أداة تمييز أو تعيينها على NULL) ، يتم اشتقاق معرف الموصل كأول 64 بت من نتيجة حساب SHA-256 عبر IEEE EUI-64 المعين من المصنع. لاحظ أن هذا هو السلوك الرئيسي الذي تتوقعه مواصفات سلسلة الرسائل.

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

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
)

تتيح هذه الوظيفة دور رابط مؤشر الترابط.

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

otJoinerStop

void otJoinerStop(
  otInstance *aInstance
)

تعمل هذه الوظيفة على تعطيل دور رابط مؤشر الترابط.

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

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

OT_JOINER_MAX_DISCERNER_LENGTH

 OT_JOINER_MAX_DISCERNER_LENGTH 64

الحد الأقصى لطول أداة تمييز النجار بالبتات.