رصد محتوى Jam

تتضمّن هذه الوحدة وظائف خاصة بميزة رصد تشويش الإشارة.

ملخّص

تتوفّر الوظائف في هذه الوحدة عند تفعيل ميزة رصد التشويش (OPENTHREAD_CONFIG_JAM_DETECTION_ENABLE).

تحديدات النوع
otJamDetectionCallback)(bool aJamState, void *aContext) typedef
void(*
يتم استدعاء المؤشر إذا تم تفعيل ميزة رصد ازدحام الإشارة وتم رصد ازدحام المرور.

الدوال
otJamDetectionGetBusyPeriod(otInstance *aInstance)
uint8_t
الحصول على فترة ازدحام رصد محتوى Jam (بالثواني)
otJamDetectionGetHistoryBitmap(otInstance *aInstance)
uint64_t
الحصول على الصورة النقطية الحالية للتاريخ.
otJamDetectionGetRssiThreshold(otInstance *aInstance)
int8_t
احصل على حدّ RSSI لرصد Jam (بالديسيبل بالمللي وات).
otJamDetectionGetState(otInstance *aInstance)
bool
الحصول على حالة رصد محتوى Jam
otJamDetectionGetWindow(otInstance *aInstance)
uint8_t
احصل على نافذة رصد محتوى Jam (بالثواني).
otJamDetectionIsEnabled(otInstance *aInstance)
bool
الحصول على حالة رصد محتوى Jam (مفعَّل/غير مفعَّل)
otJamDetectionSetBusyPeriod(otInstance *aInstance, uint8_t aBusyPeriod)
اضبط فترة انشغال اكتشاف Jam (بالثواني).
otJamDetectionSetRssiThreshold(otInstance *aInstance, int8_t aRssiThreshold)
ضبط حد RSSI لرصد Jam (بالديسيبل بالمللي وات).
otJamDetectionSetWindow(otInstance *aInstance, uint8_t aWindow)
اضبط نافذة رصد محتوى Jam (بالثواني).
otJamDetectionStart(otInstance *aInstance, otJamDetectionCallback aCallback, void *aContext)
شغِّل ميزة "رصد التشويش".
otJamDetectionStop(otInstance *aInstance)
إيقاف رصد محتوى التشويش

تحديدات النوع

otJamDetectionCallback

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

يتم استدعاء المؤشر إذا تم تفعيل ميزة رصد ازدحام الإشارة وتم رصد ازدحام المرور.

التفاصيل
المَعلمات
[in] aJamState
حالة ازدحام المرور الحالية (true في حال رصد ازدحام، false بخلاف ذلك)
[in] aContext
مؤشر إلى السياق الخاص بالتطبيق.

الدوال

otJamDetectionGetBusyPeriod

uint8_t otJamDetectionGetBusyPeriod(
  otInstance *aInstance
)

الحصول على فترة ازدحام رصد محتوى Jam (بالثواني)

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
المرتجعات
فترة رصد محتوى Jam مشغول.

otJamDetectionGetHistoryBitmap

uint64_t otJamDetectionGetHistoryBitmap(
  otInstance *aInstance
)

الحصول على الصورة النقطية الحالية للتاريخ.

تقدّم هذه القيمة معلومات عن الحالة الحالية لوحدة رصد التشويش لأغراض المراقبة أو تصحيح الأخطاء. فهي تقوم بعرض قيمة 64 بت حيث تتجاوب كل وحدة بت مع فاصل زمني مدته ثانية واحدة يبدأ ببت 0 لآخر فاصل زمني والبت 63 للأقدم بين الفترات (قبل 63 ثانية). يتم ضبط البت على 1 إذا تمت ملاحظة/رصد وحدة كشف التشويش خلال ثانية واحدة من الفاصل الزمني المقابل.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
المرتجعات
الصورة النقطية للتاريخ الحالي.

otJamDetectionGetRssiThreshold

int8_t otJamDetectionGetRssiThreshold(
  otInstance *aInstance
)

احصل على حدّ RSSI لرصد Jam (بالديسيبل بالمللي وات).

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
المرتجعات
الحدّ الأدنى لمعيار RSSI لرصد محتوى Jam

otJamDetectionGetState

bool otJamDetectionGetState(
  otInstance *aInstance
)

الحصول على حالة رصد محتوى Jam

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
المرتجعات
حالة رصد محتوى Jam (تم رصد محتوى Jam واحد (true)، أو "خطأ" في الحالات الأخرى)

otJamDetectionGetWindow

uint8_t otJamDetectionGetWindow(
  otInstance *aInstance
)

احصل على نافذة رصد محتوى Jam (بالثواني).

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
المرتجعات
نافذة رصد محتوى Jam

otJamDetectionIsEnabled

bool otJamDetectionIsEnabled(
  otInstance *aInstance
)

الحصول على حالة رصد محتوى Jam (مفعَّل/غير مفعَّل)

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
المرتجعات
حالة رصد محتوى Jam (صحيح في حال تفعيله أو خطأ في الحالات الأخرى)

otJamDetectionSetBusyPeriod

otError otJamDetectionSetBusyPeriod(
  otInstance *aInstance,
  uint8_t aBusyPeriod
)

اضبط فترة انشغال اكتشاف Jam (بالثواني).

عدد الثواني المجمَّعة ضمن نافذة الرصد التي يجب أن يكون فيها RSSI أعلى من الحدّ المعيّن لتشغيل عملية الرصد.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aBusyPeriod
فترة رصد محتوى Jam مشغولة (يجب أن تكون غير صفرية وأقل من أو تساوي "نافذة رصد محتوى Jam")
قيم الإرجاع
OT_ERROR_NONE
تم ضبط النافذة بنجاح.
OT_ERROR_INVALID_ARGS
الإدخال المقدم ليس ضمن النطاق الصالح.

otJamDetectionSetRssiThreshold

otError otJamDetectionSetRssiThreshold(
  otInstance *aInstance,
  int8_t aRssiThreshold
)

ضبط حد RSSI لرصد Jam (بالديسيبل بالمللي وات).

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aRssiThreshold
الحدّ الأدنى لمعيار RSSI
قيم الإرجاع
OT_ERROR_NONE
تم ضبط الحدّ الأدنى بنجاح.

otJamDetectionSetWindow

otError otJamDetectionSetWindow(
  otInstance *aInstance,
  uint8_t aWindow
)

اضبط نافذة رصد محتوى Jam (بالثواني).

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aWindow
نافذة اكتشاف Jam (يتراوح النطاق الصالح من 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
سبق أن تم تفعيل ميزة رصد محتوى Jam.

otJamDetectionStop

otError otJamDetectionStop(
  otInstance *aInstance
)

إيقاف رصد محتوى التشويش

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
قيم الإرجاع
OT_ERROR_NONE
تم إيقاف رصد التشويش بنجاح.
OT_ERROR_ALREADY
سبق أن تم إيقاف ميزة رصد محتوى Jam.

المراجِع

تنشأ المواضيع المرجعية لواجهة برمجة تطبيقات OpenThread من رمز المصدر المتاح على GitHub. للحصول على مزيد من المعلومات أو للمساهمة في مستنداتنا، يمكنك الاطّلاع على المراجع.