وصال
این ماژول شامل توابعی برای نقش Thread Joiner است.
خلاصه
شمارش ها | |
---|---|
otJoinerState | شمارش این شمارش وضعیت Joiner را تعریف می کند. |
Typedefs | |
---|---|
otJoinerCallback )(otError aError, void *aContext) | typedefvoid(* این نشانگر تابع برای اطلاع از اتمام عملیات اتصال فراخوانی می شود. |
otJoinerDiscerner | typedefstruct otJoinerDiscerner این ساختار نشان دهنده Joiner Discerner است. |
otJoinerState | typedefenum otJoinerState این شمارش وضعیت Joiner را تعریف می کند. |
کارکرد | |
---|---|
otJoinerGetDiscerner ( otInstance *aInstance) | const otJoinerDiscerner * این تابع Joiner Discerner را دریافت می کند. |
otJoinerGetId ( otInstance *aInstance) | const otExtAddress * این تابع شناسه Joiner را دریافت می کند. |
otJoinerGetState ( otInstance *aInstance) | این تابع وضعیت Joiner را برمی گرداند. |
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) | این تابع نقش Thread Joiner را فعال می کند. |
otJoinerStateToString ( otJoinerState aState) | const char * این تابع یک مقدار شمارش حالت اتصال دهنده را به یک رشته قابل خواندن توسط انسان تبدیل می کند. |
otJoinerStop ( otInstance *aInstance) | void این تابع نقش Thread Joiner را غیرفعال می کند. |
سازه ها | |
---|---|
otJoinerDiscerner | این ساختار نشان دهنده Joiner Discerner است. |
شمارش ها
otJoinerState
otJoinerState
این شمارش وضعیت Joiner را تعریف می کند.
Typedefs
otJoinerCallback
void(* otJoinerCallback)(otError aError, void *aContext)
این نشانگر تابع برای اطلاع از اتمام عملیات اتصال فراخوانی می شود.
جزئیات | |||||
---|---|---|---|---|---|
مولفه های |
|
otJoinerDiscerner
struct otJoinerDiscerner otJoinerDiscerner
این ساختار نشان دهنده Joiner Discerner است.
کارکرد
otJoinerGetDiscerner
const otJoinerDiscerner * otJoinerGetDiscerner( otInstance *aInstance )
این تابع Joiner Discerner را دریافت می کند.
جزئیات | |||
---|---|---|---|
مولفه های |
| ||
برمی گرداند | یک اشاره گر به Joiner Discerner یا NULL اگر هیچ یک تنظیم نشده باشد. |
otJoinerGetId
const otExtAddress * otJoinerGetId( otInstance *aInstance )
این تابع شناسه Joiner را دریافت می کند.
اگر Joiner Discerner تنظیم نشده باشد، Joiner ID 64 بیت اول از نتیجه محاسبه SHA-256 بر روی IEEE EUI-64 اختصاص داده شده توسط کارخانه است. در غیر این صورت شناسه Joiner از مقدار Joiner Discerner محاسبه می شود.
شناسه Joiner همچنین به عنوان آدرس IEEE 802.15.4 Extended Address در طول فرآیند راه اندازی استفاده می شود.
جزئیات | |||
---|---|---|---|
مولفه های |
| ||
برمی گرداند | اشاره گر به شناسه Joiner. |
otJoinerGetState
otJoinerState otJoinerGetState( otInstance *aInstance )
این تابع وضعیت Joiner را برمی گرداند.
جزئیات | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
مولفه های |
| ||||||||||||
ارزش های بازگشتی |
|
otJoinerSetDiscerner
otError otJoinerSetDiscerner( otInstance *aInstance, otJoinerDiscerner *aDiscerner )
این تابع Joiner Discerner را تنظیم می کند.
Joiner Discerner برای محاسبه Joiner ID مورد استفاده در فرآیند راه اندازی/پیوستن استفاده می شود.
بهطور پیشفرض (زمانی که تشخیصدهنده ارائه نشده یا روی NULL تنظیم شده باشد)، شناسه Joiner بهعنوان 64 بیت اول از نتیجه محاسبه SHA-256 بر روی IEEE EUI-64 اختصاص داده شده توسط کارخانه بهدست میآید. توجه داشته باشید که این رفتار اصلی مورد انتظار مشخصات Thread است.
جزئیات | |||||||
---|---|---|---|---|---|---|---|
مولفه های |
| ||||||
ارزش های بازگشتی |
|
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 )
این تابع نقش Thread Joiner را فعال می کند.
جزئیات | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
مولفه های |
| ||||||||||||||||||
ارزش های بازگشتی |
|
otJoinerStateToString
const char * otJoinerStateToString( otJoinerState aState )
این تابع یک مقدار شمارش حالت اتصال دهنده را به یک رشته قابل خواندن توسط انسان تبدیل می کند.
جزئیات | |||
---|---|---|---|
مولفه های |
| ||
برمی گرداند | یک نمایش رشته ای قابل خواندن توسط انسان از aState . |
otJoinerStop
void otJoinerStop( otInstance *aInstance )
این تابع نقش Thread Joiner را غیرفعال می کند.
جزئیات | |||
---|---|---|---|
مولفه های |
|
ماکروها
OT_JOINER_MAX_DISCERNER_LENGTH
OT_JOINER_MAX_DISCERNER_LENGTH 64
حداکثر طول یک Joiner Discerner بر حسب بیت.
منابع
موضوعات مرجع OpenThread API از کد منبع موجود در GitHub سرچشمه می گیرند. برای اطلاعات بیشتر، یا مشارکت در اسناد ما، به منابع مراجعه کنید.