Se usó la API de Cloud Translation para traducir esta página.

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)`	`otError` 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)`	`otError` 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)`	`otError` 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.