Google is committed to advancing racial equity for Black communities. See how.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

نجار

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

ملخص

التعداد

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
مؤشر إلى نموذج البائع (قد يكون NULL).
[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

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