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 |
| ||||
| 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 |
| ||
| 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 |
| ||
| 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 |
| ||
| 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 |
| ||
| 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 |
| ||
| 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 |
| ||||
| Valores devueltos |
|