Administrador de canales
Este módulo incluye funciones para el administrador de canales.
Resumen
Las funciones de este módulo están disponibles cuando la función Administrador del canal (OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
) está habilitada. El administrador de canales solo está disponible en una compilación de FTD.
Functions |
|
---|---|
otChannelManagerGetAutoChannelSelectionEnabled(otInstance *aInstance)
|
bool
Esta función indica si la función de selección de canales automática está habilitada o no.
|
otChannelManagerGetAutoChannelSelectionInterval(otInstance *aInstance)
|
uint32_t
Esta función obtiene el intervalo de tiempo (en segundos) que usa la funcionalidad de selección de canales automáticos.
|
otChannelManagerGetCcaFailureRateThreshold(otInstance *aInstance)
|
uint16_t
Esta función obtiene el umbral de la tasa de fallas de CCA.
|
otChannelManagerGetDelay(otInstance *aInstance)
|
uint16_t
Esta función muestra el retraso (en segundos) que usa el administrador de canal para realizar un cambio en un canal.
|
otChannelManagerGetFavoredChannels(otInstance *aInstance)
|
uint32_t
Esta función obtiene la máscara de canal preferida.
|
otChannelManagerGetRequestedChannel(otInstance *aInstance)
|
uint8_t
Esta función obtiene el canal de la última llamada exitosa a
otChannelManagerRequestChannelChange() |
otChannelManagerGetSupportedChannels(otInstance *aInstance)
|
uint32_t
Esta función obtiene la máscara de canal compatible.
|
otChannelManagerRequestChannelChange(otInstance *aInstance, uint8_t aChannel)
|
void
Esta función solicita un cambio de canal de red de Thread.
|
otChannelManagerRequestChannelSelect(otInstance *aInstance, bool aSkipQualityCheck)
|
Esta función solicita que
ChannelManager verifique y seleccione un canal nuevo y, luego, inicie un cambio de canal. |
otChannelManagerSetAutoChannelSelectionEnabled(otInstance *aInstance, bool aEnabled)
|
void
Esta función habilita o inhabilita la funcionalidad de selección de canales automáticos.
|
otChannelManagerSetAutoChannelSelectionInterval(otInstance *aInstance, uint32_t aInterval)
|
Esta función establece el intervalo de tiempo (en segundos) que usa la funcionalidad de selección de canales automáticos.
|
otChannelManagerSetCcaFailureRateThreshold(otInstance *aInstance, uint16_t aThreshold)
|
void
Esta función establece el umbral de tasa de fallas de CCA.
|
otChannelManagerSetDelay(otInstance *aInstance, uint16_t aDelay)
|
Esta función establece el retraso (en segundos) que se usa para un cambio de canal.
|
otChannelManagerSetFavoredChannels(otInstance *aInstance, uint32_t aChannelMask)
|
void
Esta función establece la máscara de canal preferida.
|
otChannelManagerSetSupportedChannels(otInstance *aInstance, uint32_t aChannelMask)
|
void
Esta función establece la máscara de canal compatible.
|
Functions
otChannelManagerGetAutoChannelSelectionEnabled
bool otChannelManagerGetAutoChannelSelectionEnabled( otInstance *aInstance )
Esta función indica si la función de selección de canales automática está habilitada o no.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Qué muestra |
VERDADERO si está habilitado, FALSO si está inhabilitado.
|
OtChannelManagerGetAutoChannelSelectionInterval
uint32_t otChannelManagerGetAutoChannelSelectionInterval( otInstance *aInstance )
Esta función obtiene el intervalo de tiempo (en segundos) que usa la funcionalidad de selección de canales automáticos.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Qué muestra |
El intervalo expresado en segundos
|
otChannelManagerGetCcaFailureRateThreshold
uint16_t otChannelManagerGetCcaFailureRateThreshold( otInstance *aInstance )
Esta función obtiene el umbral de la tasa de fallas de CCA.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Qué muestra |
El umbral de tasa de fallas de CCA El valor 0 se asigna al 0% y el 0xffff se asigna al 100%.
|
OtChannelManagerGetDelay
uint16_t otChannelManagerGetDelay( otInstance *aInstance )
Esta función muestra el retraso (en segundos) que usa el administrador de canal para realizar un cambio en un canal.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Qué muestra |
El retraso (en segundos) del cambio de canal.
|
OtChannelManagerGetFavoredChannels
uint32_t otChannelManagerGetFavoredChannels( otInstance *aInstance )
Esta función obtiene la máscara de canal preferida.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Qué muestra |
Los canales favoritos como máscara de bits.
|
otChannelManagerGetRequestedChannel
uint8_t otChannelManagerGetRequestedChannel( otInstance *aInstance )
Esta función obtiene el canal de la última llamada exitosa a otChannelManagerRequestChannelChange()
Detalles | |
---|---|
Qué muestra |
El último canal solicitado o cero si aún no se ha realizado ninguna solicitud de cambio de canal
|
otChannelManagerGetSupportedChannels
uint32_t otChannelManagerGetSupportedChannels( otInstance *aInstance )
Esta función obtiene la máscara de canal compatible.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Qué muestra |
Los canales admitidos como máscara de bits.
|
OtChannelManagerRequestChannelChange
void otChannelManagerRequestChannelChange( otInstance *aInstance, uint8_t aChannel )
Esta función solicita un cambio de canal de red de Thread.
La red cambia al canal determinado después de un retraso especificado (consulta otChannelManagerSetDelay()). El cambio de canal se realiza mediante la actualización del conjunto de datos operativo pendiente.
Una llamada posterior a esta función cancelará un cambio de canal solicitado anteriormente.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
otChannelManagerRequestChannelSelect
otError otChannelManagerRequestChannelSelect( otInstance *aInstance, bool aSkipQualityCheck )
Esta función solicita que ChannelManager
verifique y seleccione un canal nuevo y, luego, inicie un cambio de canal.
A diferencia del otChannelManagerRequestChannelChange()
en el que se debe proporcionar el canal como parámetro, esta función le pide al ChannelManager
que seleccione un canal por sí mismo (en función de la información de calidad del canal recopilada).
Una vez que se realice la llamada, el administrador de canal realizará los siguientes 3 pasos:
1) ChannelManager
decide si el cambio de canal podría ser útil. Se puede omitir esta verificación si aSkipQualityCheck
está configurado como verdadero (se fuerza la selección de un canal y se omite la verificación de calidad). En este paso, se usan las métricas de calidad de vínculos recopiladas en el dispositivo (como la tasa de fallas de CCA, la de errores de fotogramas y mensajes por vecino, etc.) para determinar si la calidad actual del canal está en el nivel que justifica un cambio de canal.
2) Si se aprueba el primer paso, ChannelManager
seleccionará un canal potencialmente mejor. Usa los datos de calidad del canal recopilados por el módulo ChannelMonitor
. En este paso, se usan los canales compatibles y con preferencia. (consulta otChannelManagerSetSupportedChannels() y otChannelManagerSetFavoredChannels()).
3) Si el canal recién seleccionado es diferente del canal actual, ChannelManager
solicita o inicia el proceso de cambio de canal (invocando internamente un RequestChannelChange()
).
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
||||
Valores que se muestran |
|
otChannelManagerSetAutoChannelSelectionEnabled
void otChannelManagerSetAutoChannelSelectionEnabled( otInstance *aInstance, bool aEnabled )
Esta función habilita o inhabilita la funcionalidad de selección de canales automáticos.
Cuando se habilita, ChannelManager
invoca de forma periódica a RequestChannelSelect(false)
. SetAutoChannelSelectionInterval()
puede establecer el período.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
OtChannelManagerSetAutoChannelSelectionInterval
otError otChannelManagerSetAutoChannelSelectionInterval( otInstance *aInstance, uint32_t aInterval )
Esta función establece el intervalo de tiempo (en segundos) que usa la funcionalidad de selección de canales automáticos.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
||||
Valores que se muestran |
|
otChannelManagerSetCcaFailureRateThreshold
void otChannelManagerSetCcaFailureRateThreshold( otInstance *aInstance, uint16_t aThreshold )
Esta función establece el umbral de tasa de fallas de CCA.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
OtChannelManagerSetDelay
otError otChannelManagerSetDelay( otInstance *aInstance, uint16_t aDelay )
Esta función establece el retraso (en segundos) que se usa para un cambio de canal.
Preferentemente, el retraso debe ser mayor que el intervalo máximo de sondeo de datos que utilizan todos los dispositivos finales de suspensión dentro de la red Thread.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
||||
Valores que se muestran |
|
Canal OtChannelManagerSetFavoredChannels
void otChannelManagerSetFavoredChannels( otInstance *aInstance, uint32_t aChannelMask )
Esta función establece la máscara de canal preferida.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
otChannelManagerSetSupportedChannels
void otChannelManagerSetSupportedChannels( otInstance *aInstance, uint32_t aChannelMask )
Esta función establece la máscara de canal compatible.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
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.