Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

Supervisión del canal

Este módulo incluye funciones para la función de supervisión del canal.

Resumen

Las funciones de este módulo están disponibles cuando la función de supervisión de canal (OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE) está habilitada.

La supervisión de canales supervisa periódicamente todos los canales para ayudar a determinar los canales más limpios (canales con menos interferencia).

Cuando está activa la supervisión de canales, se realiza un escaneo de energía de duración cero en el que se recopila una sola muestra de RSSI en cada canal por intervalo de muestra. Las muestras de RSSI se comparan con un umbral de RSSI especificado previamente. Como indicador de la calidad del canal, el módulo de supervisión del canal mantiene y proporciona el porcentaje/porcentaje promedio de las muestras de RSSI que están por encima del umbral dentro de (aproximadamente) una ventana de muestra especificada (denominada ocupación del canal).

Functions

otChannelMonitorGetChannelOccupancy(otInstance *aInstance, uint8_t aChannel)
uint16_t
Obtiene la ocupación actual de un canal determinado.
otChannelMonitorGetRssiThreshold(otInstance *aInstance)
int8_t
Obtén el umbral de RSSI de supervisión del canal en Dataflow.
otChannelMonitorGetSampleCount(otInstance *aInstance)
uint32_t
Obtén la cantidad total de muestras de supervisión del canal de las RSSI (por canal).
otChannelMonitorGetSampleInterval(otInstance *aInstance)
uint32_t
Obtén el intervalo de muestra de supervisión del canal en milisegundos.
otChannelMonitorGetSampleWindow(otInstance *aInstance)
uint32_t
Obtención de un promedio de supervisión del canal en la longitud de la ventana de muestra (cantidad de muestras).
otChannelMonitorIsEnabled(otInstance *aInstance)
bool
Esta función indica si la operación de supervisión del canal está habilitada y en ejecución.
otChannelMonitorSetEnabled(otInstance *aInstance, bool aEnabled)
Esta función habilita o inhabilita la operación de supervisión del canal.

Functions

OtChannelMonitorGetChannelOccupancy

uint16_t otChannelMonitorGetChannelOccupancy(
  otInstance *aInstance,
  uint8_t aChannel
)

Obtiene la ocupación actual de un canal determinado.

El valor de ocupación del canal representa la tasa o el porcentaje promedio de las muestras de RSSI que superaron el umbral de RSSI (ejemplos de RSSI).

En la primera ventana de muestra, el promedio se mantiene como el porcentaje real (es decir, la proporción entre la cantidad de muestras "insuficientes" y la cantidad total de muestras). Después de muestras, el promedio utiliza una media móvil ponderada de forma exponencial. En la práctica, esto significa que el promedio es representativo de hasta 3 * window últimas muestras con el peso más alto según las kSampleWindow muestras más recientes.

El valor máximo de 0xffff indica que todas las muestras de RSSI superaron el umbral de RSSI (es decir, el 100% de las muestras no eran buenas).

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aChannel
Indica el canal en el que se llenará el vínculo.
Qué muestra
Ocupación actual del canal seleccionado

CanalCanalMonitorGetRssiThreshold

int8_t otChannelMonitorGetRssiThreshold(
  otInstance *aInstance
)

Obtén el umbral de RSSI de supervisión del canal en Dataflow.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
Qué muestra
El umbral de RSSI en dBm.

otChannelMonitorGetSampleCount

uint32_t otChannelMonitorGetSampleCount(
  otInstance *aInstance
)

Obtén la cantidad total de muestras de supervisión del canal de las RSSI (por canal).

El recuento indica la cantidad total de muestras por canal por módulo de supervisión de canales desde su inicio (desde que se habilitó la interfaz de red de Thread).

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
Qué muestra
Cantidad total de muestras de RSSI (por canal) tomadas hasta el momento.

otChannelMonitorGetSampleInterval

uint32_t otChannelMonitorGetSampleInterval(
  otInstance *aInstance
)

Obtén el intervalo de muestra de supervisión del canal en milisegundos.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
Qué muestra
El canal supervisa el intervalo de muestra en milisegundos.

otChannelMonitorGetSampleWindow

uint32_t otChannelMonitorGetSampleWindow(
  otInstance *aInstance
)

Obtención de un promedio de supervisión del canal en la longitud de la ventana de muestra (cantidad de muestras).

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
Qué muestra
Ventana de muestra promedio

OtChannelMonitorIsEnabled

bool otChannelMonitorIsEnabled(
  otInstance *aInstance
)

Esta función indica si la operación de supervisión del canal está habilitada y en ejecución.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
Qué muestra
VERDADERO si la operación de Supervisión del canal está habilitada, de lo contrario, aparecerá FALSO.

CanalDeMonitor configurado

otError otChannelMonitorSetEnabled(
  otInstance *aInstance,
  bool aEnabled
)

Esta función habilita o inhabilita la operación de supervisión del canal.

Una vez que comience la operación, se borrarán todos los datos recopilados anteriormente. Sin embargo, después de inhabilitar la operación, los datos recopilados anteriormente seguirán siendo válidos y se podrán leer.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aEnabled
TRUE para habilitar o iniciar la operación de supervisión del canal y FALSE para inhabilitarla o detenerla.
Valores que se muestran
OT_ERROR_NONE
Se cambió correctamente el estado de la supervisión del canal
OT_ERROR_ALREADY
La supervisión del canal ya está en el mismo estado.

Recursos

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