تشخیص جم

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

خلاصه

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

Typedefs

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

کارکرد

otJamDetectionGetBusyPeriod ( otInstance *aInstance)
uint8_t
دریافت دوره اشغال جم (در ثانیه)
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 Detection Jam (بر حسب 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
)

دریافت دوره اشغال جم (در ثانیه)

جزئیات
مولفه های
[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.
برمی گرداند
وضعیت Jam Detection (جمع 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 Detection Jam (بر حسب 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 سرچشمه می گیرند. برای اطلاعات بیشتر، یا مشارکت در اسناد ما، به منابع مراجعه کنید.