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

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
[in] aInstance
Un puntero para una instancia de OpenThread.
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
[in] aInstance
Un puntero para una instancia de OpenThread.
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
[in] aInstance
Un puntero para una instancia de OpenThread.
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
[in] aInstance
Un puntero para una instancia de OpenThread.
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
[in] aInstance
Un puntero para una instancia de OpenThread.
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
[in] aInstance
Un puntero para una instancia de OpenThread.
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
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aChannel
El nuevo canal de la red Thread.

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
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aSkipQualityCheck
Indica si se debe omitir el control de calidad (paso 1).
Valores que se muestran
OT_ERROR_NONE
Se completó correctamente la selección de canales.
OT_ERROR_NOT_FOUND
La máscara de canal compatible está vacía, por lo que no se pudo seleccionar un canal.

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
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aEnabled
Indica si se debe habilitar o inhabilitar esta funcionalidad.

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
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aInterval
El intervalo expresado en segundos
Valores que se muestran
OT_ERROR_NONE
Se configuró correctamente el intervalo.
OT_ERROR_INVALID_ARGS
El aInterval no es válido (cero).

otChannelManagerSetCcaFailureRateThreshold

void otChannelManagerSetCcaFailureRateThreshold(
  otInstance *aInstance,
  uint16_t aThreshold
)

Esta función establece el umbral de tasa de fallas de CCA.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aThreshold
Un umbral de tasa de fallas de CCA. El valor 0 se asigna al 0% y el 0xffff se asigna al 100%.

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
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aDelay
El retraso se expresa en segundos.
Valores que se muestran
OT_ERROR_NONE
La demora se actualizó correctamente.
OT_ERROR_INVALID_ARGS
El retraso determinado de aDelay es demasiado corto.

Canal OtChannelManagerSetFavoredChannels

void otChannelManagerSetFavoredChannels(
  otInstance *aInstance,
  uint32_t aChannelMask
)

Esta función establece la máscara de canal preferida.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aChannelMask
Una máscara de canal

otChannelManagerSetSupportedChannels

void otChannelManagerSetSupportedChannels(
  otInstance *aInstance,
  uint32_t aChannelMask
)

Esta función establece la máscara de canal compatible.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aChannelMask
Una máscara de canal

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.