Google is committed to advancing racial equity for Black communities. See how.
Esta página se ha traducido con Cloud Translation API.
Switch to English

Monitoreo de canales

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

Resumen

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

supervisando el canal controlará periódicamente todos los canales para ayudar a determinar los canales limpios (canales con menos interferencia).

Cuando el monitoreo canal está activo, una energía Scan cero duración se realiza, la recogida de una sola muestra de RSSI en cada canal por intervalo de muestra. Las muestras de RSSI se comparan con un umbral de RSSI pre-especificado. Como un indicador de calidad de canal, el canal de módulo de supervisión mantiene y proporciona la tasa / porcentaje promedio de las muestras de RSSI que están por encima del umbral dentro de una ventana de muestra especificado (aproximadamente) (referido como ocupación del canal).

funciones

otChannelMonitorGetChannelOccupancy ( otInstance *aInstance, uint8_t aChannel)
uint16_t
Obtiene la ocupación del canal actual para un canal dado.
otChannelMonitorGetRssiThreshold ( otInstance *aInstance)
int8_t
Obtener canales de monitoreo de umbral de RSSI en dBm.
otChannelMonitorGetSampleCount ( otInstance *aInstance)
uint32_t
Obtener canal de vigilancia número total de muestras de RSSI (por canal).
otChannelMonitorGetSampleInterval ( otInstance *aInstance)
uint32_t
Obtener canal de vigilancia intervalo de muestra en milisegundos.
otChannelMonitorGetSampleWindow ( otInstance *aInstance)
uint32_t
Obtener el seguimiento de canal promedio longitud de la ventana de muestra (número de muestras).
otChannelMonitorIsEnabled ( otInstance *aInstance)
bool
Esta función indica si la operación de monitoreo del canal está activado y funcionando.
otChannelMonitorSetEnabled ( otInstance *aInstance, bool aEnabled)
Esta función se activa / desactiva el funcionamiento de monitoreo del canal.

funciones

otChannelMonitorGetChannelOccupancy

uint16_t otChannelMonitorGetChannelOccupancy(
  otInstance *aInstance,
  uint8_t aChannel
)

Obtiene la ocupación del canal actual para un canal dado.

El valor de ocupación del canal representa la tasa / porcentaje promedio de las muestras de RSSI que estaban por encima del umbral RSSI ( "malo" muestras de RSSI).

Para las primeras muestras "ventana de muestra", el promedio se mantiene como el porcentaje real (es decir, relación del número de "malos" muestras por el número total de muestras). Después de muestras "ventana", el promediador utiliza un promedio móvil ponderado exponencialmente. En la práctica, esto significa que el promedio es representativo de hasta 3 * window últimas muestras de mayor peso dado a las últimas kSampleWindow muestras.

Valor Max de 0xffff indica todas las muestras de RSSI estaban por encima del umbral RSSI (es decir, 100% de las muestras eran "malo").

detalles
parámetros
[in] aInstance
Un puntero a una instancia OpenThread.
[in] aChannel
El canal para el que para obtener el enlace de ocupación.
Devoluciones
La ocupación del canal actual para el canal dado.

otChannelMonitorGetRssiThreshold

int8_t otChannelMonitorGetRssiThreshold(
  otInstance *aInstance
)

Obtener canales de monitoreo de umbral de RSSI en dBm.

detalles
parámetros
[in] aInstance
Un puntero a una instancia OpenThread.
Devoluciones
El umbral de RSSI en dBm.

otChannelMonitorGetSampleCount

uint32_t otChannelMonitorGetSampleCount(
  otInstance *aInstance
)

Obtener canal de vigilancia número total de muestras de RSSI (por canal).

El recuento indica muestras número total por canal por módulo de monitoreo desde su inicio (desde el interfaz de red de rosca se habilitó) canal.

detalles
parámetros
[in] aInstance
Un puntero a una instancia OpenThread.
Devoluciones
Número total de muestras de RSSI (por canal) tomada hasta ahora.

otChannelMonitorGetSampleInterval

uint32_t otChannelMonitorGetSampleInterval(
  otInstance *aInstance
)

Obtener canal de vigilancia intervalo de muestra en milisegundos.

detalles
parámetros
[in] aInstance
Un puntero a una instancia OpenThread.
Devoluciones
El intervalo de muestra de monitor de canal en milisegundos.

otChannelMonitorGetSampleWindow

uint32_t otChannelMonitorGetSampleWindow(
  otInstance *aInstance
)

Obtener el seguimiento de canal promedio longitud de la ventana de muestra (número de muestras).

detalles
parámetros
[in] aInstance
Un puntero a una instancia OpenThread.
Devoluciones
La ventana de muestra de promediado.

otChannelMonitorIsEnabled

bool otChannelMonitorIsEnabled(
  otInstance *aInstance
)

Esta función indica si la operación de monitoreo del canal está activado y funcionando.

detalles
parámetros
[in] aInstance
Un puntero a una instancia OpenThread.
Devoluciones
TRUE si se habilita la operación de monitoreo del canal, de lo contrario.

otChannelMonitorSetEnabled

 otError otChannelMonitorSetEnabled(
  otInstance *aInstance,
  bool aEnabled
)

Esta función se activa / desactiva el funcionamiento de monitoreo del canal.

Una vez que se inicia la operación, se borra cualquier dato recogido previamente. Sin embargo, después de la operación está desactivada, los datos recogidos anterior sigue siendo válida y se puede leer.

detalles
parámetros
[in] aInstance
Un puntero a una instancia OpenThread.
[in] aEnabled
TRUE para habilitar / iniciar la operación del Canal, FALSO Monitoreo para desactivar / detenerlo.
Valores devueltos
OT_ERROR_NONE
Canal de seguimiento de los Estados cambiado correctamente
OT_ERROR_ALREADY
Monitoreo de canal ya está en el mismo estado.