تشخیص جم

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

خلاصه

عملکردهای این ماژول زمانی در دسترس هستند که ویژگی تشخیص جم ( 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)
دوره اشغال جم را (بر حسب ثانیه) تنظیم کنید.
otJamDetectionSetRssiThreshold ( otInstance *aInstance, int8_t aRssiThreshold)
آستانه تشخیص جمجمه RSSI (بر حسب dBm) را تنظیم کنید.
otJamDetectionSetWindow ( otInstance *aInstance, uint8_t aWindow)
پنجره تشخیص Jam Detection را (در چند ثانیه) تنظیم کنید.
otJamDetectionStart ( otInstance *aInstance, otJamDetectionCallback aCallback, void *aContext)
تشخیص پارازیت را شروع کنید.
otJamDetectionStop ( otInstance *aInstance)
تشخیص پارازیت را متوقف کنید.

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 سرچشمه می گیرند. برای اطلاعات بیشتر، یا مشارکت در اسناد ما، به منابع مراجعه کنید.