تشخیص جم

این ماژول شامل توابعی برای ویژگی تشخیص پارازیت سیگنال است.

خلاصه

عملکردهای این ماژول زمانی در دسترس هستند که ویژگی تشخیص جم ( OPENTHREAD_CONFIG_JAM_DETECTION_ENABLE ) فعال باشد.

Typedefs
otJamDetectionCallback )(bool aJamState, void *aContext)	typedef void(* اگر تشخیص پارازیت سیگنال فعال باشد و پارگی تشخیص داده شود، اشاره گر فراخوانی می شود.

کارکرد
otJamDetectionGetBusyPeriod ( otInstance *aInstance)	uint8_t دریافت دوره اشغال Jam Detection (در ثانیه)
otJamDetectionGetHistoryBitmap ( otInstance *aInstance)	uint64_t بیت مپ تاریخ فعلی را دریافت کنید.
otJamDetectionGetRssiThreshold ( otInstance *aInstance)	int8_t آستانه RSSI تشخیص جم (به dBm) را دریافت کنید.
otJamDetectionGetState ( otInstance *aInstance)	bool وضعیت تشخیص جم را دریافت کنید.
otJamDetectionGetWindow ( otInstance *aInstance)	uint8_t پنجره تشخیص Jam Detection را دریافت کنید (در چند ثانیه).
otJamDetectionIsEnabled ( otInstance *aInstance)	bool دریافت وضعیت تشخیص جم (فعال/غیرفعال)
otJamDetectionSetBusyPeriod ( otInstance *aInstance, uint8_t aBusyPeriod)	otError دوره اشغال جم را (بر حسب ثانیه) تنظیم کنید.
otJamDetectionSetRssiThreshold ( otInstance *aInstance, int8_t aRssiThreshold)	otError آستانه تشخیص جمجمه RSSI (بر حسب dBm) را تنظیم کنید.
otJamDetectionSetWindow ( otInstance *aInstance, uint8_t aWindow)	otError پنجره تشخیص Jam Detection را (در چند ثانیه) تنظیم کنید.
otJamDetectionStart ( otInstance *aInstance, otJamDetectionCallback aCallback, void *aContext)	otError تشخیص پارازیت را شروع کنید.
otJamDetectionStop ( otInstance *aInstance)	otError تشخیص پارازیت را متوقف کنید.

Typedefs

otJamDetectionCallback

void(* otJamDetectionCallback)(bool aJamState, void *aContext)

اگر تشخیص پارازیت سیگنال فعال باشد و پارگی تشخیص داده شود، اشاره گر فراخوانی می شود.

جزئیات
مولفه های	[in] aJamState وضعیت جم فعلی (در صورت تشخیص جم true است، در غیر این صورت false ). [in] aContext اشاره‌ای به زمینه خاص برنامه.

کارکرد

otJamDetectionGetBusyPeriod

uint8_t otJamDetectionGetBusyPeriod(
  otInstance *aInstance
)

دریافت دوره اشغال Jam Detection (در ثانیه)

جزئیات
مولفه های	[in] aInstance اشاره گر به یک نمونه OpenThread.
برمی گرداند	دوره پرکاری تشخیص جام.

otJamDetectionGetHistoryBitmap

uint64_t otJamDetectionGetHistoryBitmap(
  otInstance *aInstance
)

بیت مپ تاریخ فعلی را دریافت کنید.

این مقدار اطلاعاتی را در مورد وضعیت فعلی ماژول تشخیص پارازیت به منظور نظارت/اشکال‌زدایی ارائه می‌کند. مقدار 64 بیتی را برمی گرداند که در آن هر بیت مربوط به یک بازه دوم است که با بیت 0 برای آخرین بازه و بیت 63 برای قدیمی ترین بازه ها (63 ثانیه قبل) شروع می شود. در صورتی که ماژول تشخیص پارازیت سطح سیگنال بالایی را در بازه زمانی یک ثانیه ای مربوطه مشاهده کند، بیت روی 1 تنظیم می شود.

جزئیات
مولفه های	[in] aInstance اشاره گر به یک نمونه OpenThread.
برمی گرداند	بیت مپ تاریخ فعلی

otJamDetectionGetRssiThreshold

int8_t otJamDetectionGetRssiThreshold(
  otInstance *aInstance
)

آستانه RSSI تشخیص جم (به dBm) را دریافت کنید.

جزئیات
مولفه های	[in] aInstance اشاره گر به یک نمونه OpenThread.
برمی گرداند	آستانه تشخیص جمجمه RSSI.

otJamDetectionGetState

bool otJamDetectionGetState(
  otInstance *aInstance
)

وضعیت تشخیص جم را دریافت کنید.

جزئیات
مولفه های	[in] aInstance اشاره گر به یک نمونه OpenThread.
برمی گرداند	وضعیت تشخیص جام (جمع true تشخیص داده می شود، در غیر این صورت "نادرست").

otJamDetectionGetWindow

uint8_t otJamDetectionGetWindow(
  otInstance *aInstance
)

پنجره تشخیص Jam Detection را دریافت کنید (در چند ثانیه).

جزئیات
مولفه های	[in] aInstance اشاره گر به یک نمونه OpenThread.
برمی گرداند	پنجره تشخیص جم

otJamDetectionIsEnabled

bool otJamDetectionIsEnabled(
  otInstance *aInstance
)

دریافت وضعیت تشخیص جم (فعال/غیرفعال)

جزئیات
مولفه های	[in] aInstance اشاره گر به یک نمونه OpenThread.
برمی گرداند	وضعیت تشخیص جم (در صورت فعال بودن صحیح، در غیر این صورت نادرست).

otJamDetectionSetBusyPeriod

otError otJamDetectionSetBusyPeriod(
  otInstance *aInstance,
  uint8_t aBusyPeriod
)

دوره اشغال جم را (بر حسب ثانیه) تنظیم کنید.

تعداد ثانیه های مجموع در پنجره تشخیص که در آن RSSI باید بالاتر از آستانه باشد تا تشخیص را راه اندازی کند.

جزئیات
مولفه های	[in] aInstance اشاره گر به یک نمونه OpenThread. [in] aBusyPeriod دوره پرکاری «تشخیص جم» (باید غیر صفر و کمتر یا مساوی پنجره تشخیص جم باشد)
ارزش های بازگشتی	OT_ERROR_NONE پنجره با موفقیت تنظیم شد. OT_ERROR_INVALID_ARGS ورودی داده شده در محدوده معتبر نیست.

otJamDetectionSetRssiThreshold

otError otJamDetectionSetRssiThreshold(
  otInstance *aInstance,
  int8_t aRssiThreshold
)

آستانه تشخیص جمجمه RSSI (بر حسب dBm) را تنظیم کنید.

جزئیات
مولفه های	[in] aInstance اشاره گر به یک نمونه OpenThread. [in] aRssiThreshold آستانه RSSI.
ارزش های بازگشتی	OT_ERROR_NONE آستانه را با موفقیت تنظیم کرد.

otJamDetectionSetWindow

otError otJamDetectionSetWindow(
  otInstance *aInstance,
  uint8_t aWindow
)

پنجره تشخیص Jam Detection را (در چند ثانیه) تنظیم کنید.

جزئیات
مولفه های	[in] aInstance اشاره گر به یک نمونه OpenThread. [in] aWindow پنجره تشخیص جم (محدوده معتبر 1 تا 63 است)
ارزش های بازگشتی	OT_ERROR_NONE پنجره با موفقیت تنظیم شد. OT_ERROR_INVALID_ARGS پارامتر ورودی داده شده در محدوده معتبر نیست (1-63)

otJamDetectionStart

otError otJamDetectionStart(
  otInstance *aInstance,
  otJamDetectionCallback aCallback,
  void *aContext
)

تشخیص پارازیت را شروع کنید.

جزئیات
مولفه های	[in] aInstance اشاره گر به یک نمونه OpenThread. [in] aCallback اشاره گر به تابعی که برای اطلاع از تغییر حالت پارازیت فراخوانی می شود. [in] aContext اشاره‌ای به زمینه خاص برنامه.
ارزش های بازگشتی	OT_ERROR_NONE تشخیص پارازیت با موفقیت شروع شد. OT_ERROR_ALREADY شناسایی جم قبلاً شروع شده است.

otJamDetectionStop

otError otJamDetectionStop(
  otInstance *aInstance
)

تشخیص پارازیت را متوقف کنید.

جزئیات
مولفه های	[in] aInstance اشاره گر به یک نمونه OpenThread.
ارزش های بازگشتی	OT_ERROR_NONE تشخیص پارازیت با موفقیت متوقف شد. OT_ERROR_ALREADY شناسایی جم قبلاً متوقف شده است.

منابع

موضوعات مرجع OpenThread API از کد منبع موجود در GitHub سرچشمه می گیرند. برای اطلاعات بیشتر، یا مشارکت در اسناد ما، به منابع مراجعه کنید.