رصد محتوى Jam

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

الملخّص

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

مواقد الخط
otJamDetectionCallback)(bool aJamState, void *aContext) مَعلمة typetype
void(*
يتم استدعاء مؤشر الدالة هذا إذا تم تفعيل رصد إشارات Jam وتم رصد محتوى Jam.

الدوال
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)
ابدأ رصد محتوى Jam.
otJamDetectionStop(otInstance *aInstance)
إيقاف رصد محتوى Jam

مواقد الخط

otJamDetectionCallback

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

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

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

الدوال

otJamDetectionGetBusyPeriod

uint8_t otJamDetectionGetBusyPeriod(
  otInstance *aInstance
)

الحصول على فترة مشغول لكشف Jam (بالثواني)

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
طلبات الإرجاع
"انشغال اكتشاف Jam"

otJamDetectionGetHistoryBitmap

uint64_t otJamDetectionGetHistoryBitmap(
  otInstance *aInstance
)

احصل على الصورة النقطية للسجل الحالي.

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

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

otJamDetectionGetRssi الحد الأدنى

int8_t otJamDetectionGetRssiThreshold(
  otInstance *aInstance
)

احصل على الحدّ الأدنى RSSI لاكتشاف Jam (بالديسيبل ميلي واط).

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

otJamDetectionGetState

bool otJamDetectionGetState(
  otInstance *aInstance
)

احصل على حالة اكتشاف Jam.

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

otJamDetectionGetWindow

uint8_t otJamDetectionGetWindow(
  otInstance *aInstance
)

احصل على نافذة اكتشاف Jam (بالثواني).

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

otJamDetectionIsEnabled

bool otJamDetectionIsEnabled(
  otInstance *aInstance
)

الحصول على حالة اكتشاف Jam (مفعّلة/موقوفة)

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

otJamDetectionSetBusyPeriod

otError otJamDetectionSetBusyPeriod(
  otInstance *aInstance,
  uint8_t aBusyPeriod
)

إعداد "فترة انشغال Jam" (بالثواني).

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

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

otJamDetectionSetRssi الحد الأدنى

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
)

ابدأ رصد محتوى Jam.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aCallback
مؤشر إلى وظيفة تُسمى للإشعار بتغيير حالة التشويش.
[in] aContext
مؤشر للسياق الخاص بالتطبيق.
قيم الإرجاع
OT_ERROR_NONE
تم بدء رصد محتوى Jam بنجاح.
OT_ERROR_ALREADY
تم بدء رصد محتوى Jam من قبل.

otJamDetectionStop

otError otJamDetectionStop(
  otInstance *aInstance
)

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

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

المراجع

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