كشف المربى

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

ملخص

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

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

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

النوع

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 لاكتشاف الانحشار (بالديسيبل).

تفاصيل

المعلمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

عائدات

عتبة RSSI لاكتشاف الانحشار.

otJamDetectionGetState

bool otJamDetectionGetState(
  otInstance *aInstance
)

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

تفاصيل

المعلمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

عائدات

حالة اكتشاف الانحشار (تم اكتشاف انحشار true ، وإلا "خطأ").

otJamDetectionGetWindow

uint8_t otJamDetectionGetWindow(
  otInstance *aInstance
)

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

تفاصيل

المعلمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

عائدات

نافذة اكتشاف الانحشار.

otJamDetectionIsEnabled

bool otJamDetectionIsEnabled(
  otInstance *aInstance
)

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

تفاصيل

المعلمات

[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 لاكتشاف الانحشار (بالديسيبل).

تفاصيل

المعلمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aRssiThreshold`	حد RSSI.

إرجاع القيم

OT_ERROR_NONE

تم تعيين العتبة بنجاح.

otJamDetectionSetWindow

otError otJamDetectionSetWindow(
  otInstance *aInstance,
  uint8_t aWindow
)

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

تفاصيل

المعلمات

`[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`	تم إيقاف اكتشاف انحشار الورق بالفعل.