Detección de atascos

Este módulo incluye funciones para la detección de interferencia de señal.

Resumen

Las funciones de este módulo están disponibles cuando está habilitada la función de detección de jam (OPENTHREAD_CONFIG_JAM_DETECTION_ENABLE).

Typedefs
otJamDetectionCallback)(bool aJamState, void *aContext) typedef
void(*
Se llamará al puntero si la detección de atasco de señal está habilitada y se detecta un atasco.

remotas
otJamDetectionGetBusyPeriod(otInstance *aInstance)
uint8_t
Obtener el período de inactividad para la detección de embotellamientos (en segundos)
otJamDetectionGetHistoryBitmap(otInstance *aInstance)
uint64_t
Obtén el mapa de bits del historial actual.
otJamDetectionGetRssiThreshold(otInstance *aInstance)
int8_t
Obtén el umbral de RSSI de la detección de Jams (en dBm).
otJamDetectionGetState(otInstance *aInstance)
bool
Obtén el estado de detección de Jam.
otJamDetectionGetWindow(otInstance *aInstance)
uint8_t
Obtén la ventana de detección de Jams (en segundos).
otJamDetectionIsEnabled(otInstance *aInstance)
bool
Obtener el estado de la detección de Jams (habilitado o inhabilitado)
otJamDetectionSetBusyPeriod(otInstance *aInstance, uint8_t aBusyPeriod)
Establezca el período ocupado para la detección de Jams (en segundos).
otJamDetectionSetRssiThreshold(otInstance *aInstance, int8_t aRssiThreshold)
Establece el umbral de RSSI de la detección de Jams (en dBm).
otJamDetectionSetWindow(otInstance *aInstance, uint8_t aWindow)
Configurar la ventana de detección de Jams (en segundos).
otJamDetectionStart(otInstance *aInstance, otJamDetectionCallback aCallback, void *aContext)
Inicia la detección de bloqueos.
otJamDetectionStop(otInstance *aInstance)
Detén la detección de bloqueos.

Typedefs

otJamDetectionCallback

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

Se llamará al puntero si la detección de atasco de señal está habilitada y se detecta un atasco.

Detalles
Parámetros
[in] aJamState
Estado actual del atasco (true si se detecta el atasco, de lo contrario, false).
[in] aContext
Un puntero para el contexto específico de la aplicación.

remotas

otJamDetectionGetBusyPeriod

uint8_t otJamDetectionGetBusyPeriod(
  otInstance *aInstance
)

Obtener el período de inactividad para la detección de embotellamientos (en segundos)

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
Qué muestra
El período de inactividad para la detección de embotellamientos.

otJamDetectionGetHistoryBitmap

uint64_t otJamDetectionGetHistoryBitmap(
  otInstance *aInstance
)

Obtén el mapa de bits del historial actual.

Este valor proporciona información sobre el estado actual del módulo de detección de bloqueos con fines de supervisión y depuración. Muestra un valor de 64 bits en el que cada bit corresponde a un intervalo de un segundo que comienza con el bit 0 para el intervalo más reciente y el bit 63 para los intervalos más antiguos (63 segundos antes). El bit se establece en 1 si el módulo de detección de bloqueos observa/detecta un nivel de señal alto durante el intervalo correspondiente de un segundo.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
Qué muestra
El mapa de bits del historial actual.

otJamDetectionGetRssiThreshold

int8_t otJamDetectionGetRssiThreshold(
  otInstance *aInstance
)

Obtén el umbral de RSSI de la detección de Jams (en dBm).

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
Qué muestra
Es el umbral de RSSI de detección de Jams.

otJamDetectionGetState

bool otJamDetectionGetState(
  otInstance *aInstance
)

Obtén el estado de detección de Jam.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
Qué muestra
El estado de la detección de Jams (se detectó true jam; de lo contrario, se muestra "false").

otJamDetectionGetWindow

uint8_t otJamDetectionGetWindow(
  otInstance *aInstance
)

Obtén la ventana de detección de Jams (en segundos).

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
Qué muestra
La ventana de detección de atascos

otJamDetectionIsEnabled

bool otJamDetectionIsEnabled(
  otInstance *aInstance
)

Obtener el estado de la detección de Jams (habilitado o inhabilitado)

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
Qué muestra
El estado de la detección de Jams (verdadero si está habilitada, falso de lo contrario).

otJamDetectionSetBusyPeriod

otError otJamDetectionSetBusyPeriod(
  otInstance *aInstance,
  uint8_t aBusyPeriod
)

Establezca el período ocupado para la detección de Jams (en segundos).

La cantidad de segundos agregados dentro de la ventana de detección en los que el RSSI debe superar el umbral para activar la detección.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aBusyPeriod
El período de actividad de la Detección de Jams (debe ser distinto de cero y menor o igual que la Ventana de detección de Jams)
Valores que se muestran
OT_ERROR_NONE
Se configuró correctamente la ventana.
OT_ERROR_INVALID_ARGS
La entrada proporcionada no está dentro del rango válido.

otJamDetectionSetRssiThreshold

otError otJamDetectionSetRssiThreshold(
  otInstance *aInstance,
  int8_t aRssiThreshold
)

Establece el umbral de RSSI de la detección de Jams (en dBm).

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aRssiThreshold
El umbral de RSSI.
Valores que se muestran
OT_ERROR_NONE
Se configuró correctamente el umbral.

otJamDetectionSetWindow

otError otJamDetectionSetWindow(
  otInstance *aInstance,
  uint8_t aWindow
)

Configurar la ventana de detección de Jams (en segundos).

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aWindow
La ventana de detección de Jams (el rango válido es de 1 a 63)
Valores que se muestran
OT_ERROR_NONE
Se configuró correctamente la ventana.
OT_ERROR_INVALID_ARGS
El parámetro de entrada especificado no está dentro de un rango válido (1-63)

otJamDetectionStart

otError otJamDetectionStart(
  otInstance *aInstance,
  otJamDetectionCallback aCallback,
  void *aContext
)

Inicia la detección de bloqueos.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aCallback
Un puntero a una función llamada para notificar un cambio de estado de bloqueo.
[in] aContext
Un puntero para el contexto específico de la aplicación.
Valores que se muestran
OT_ERROR_NONE
Se inició correctamente la detección de bloqueos.
OT_ERROR_ALREADY
La detección de Jams se inició anteriormente.

otJamDetectionStop

otError otJamDetectionStop(
  otInstance *aInstance
)

Detén la detección de bloqueos.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
Valores que se muestran
OT_ERROR_NONE
Se detuvo correctamente la detección de bloqueos.
OT_ERROR_ALREADY
Ya se detuvo la detección de Jams.

Recursos

Los temas de referencia de la API de OpenThread se originan a partir del código fuente, disponible en GitHub. Para obtener más información o contribuir a nuestra documentación, consulta Recursos.