رصد محتوى Jam

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

ملخّص

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

أنواع المحددات

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

الدوال

otJamDetectionGetBusyPeriod(otInstance *aInstance)
uint8_t
الحصول على فترة اكتشاف اكتشاف محتوى Jam (بالثواني)
otJamDetectionGetHistoryBitmap(otInstance *aInstance)
uint64_t
الحصول على الصورة الرمزية الحالية للسجلّ
otJamDetectionGetRssiThreshold(otInstance *aInstance)
int8_t
الحصول على الحد الأدنى لتقنية RSSI الخاصة برصد محتوى Jam (بحد أقصى dBm)
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 Detect Google 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)

يُسمى المؤشر في حال تفعيل ميزة رصد ازدحام الإشارات ورصد نشاط Jam.

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

الدوال

otJamDetectionGetمشغولPeriod

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 (بحد أقصى dBm)

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

otJamDetectionGetState

bool otJamDetectionGetState(
  otInstance *aInstance
)

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

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

otJamDetectionGetWindow

uint8_t otJamDetectionGetWindow(
  otInstance *aInstance
)

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

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

otJamDetectionIsEnabled

bool otJamDetectionIsEnabled(
  otInstance *aInstance
)

الحصول على حالة اكتشاف محتوى Jam (مفعَّل أو غير مفعَّل)

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

otJamDetectionSetمشغول

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 Detect Google 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. للحصول على مزيد من المعلومات أو للمساهمة في المستندات، يمكنك الاطّلاع على المراجع.