Gerente de Canal

Este módulo incluye funciones de Gestor de canales.

Resumen

Las funciones de este módulo están disponibles cuando la función Gestor de canales ( OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE está activado). Gestor de canales está disponible sólo en una acumulación de FTD.

funciones
`otChannelManagerGetAutoChannelSelectionEnabled ( otInstance *aInstance)`	`bool` Esta función indica si la funcionalidad de canal de selección automática está activada o no.
`otChannelManagerGetAutoChannelSelectionInterval ( otInstance *aInstance)`	`uint32_t` Esta función obtiene el intervalo de tiempo (en segundos) utilizado por la funcionalidad de canal de selección automática.
`otChannelManagerGetDelay ( otInstance *aInstance)`	`uint16_t` Esta función obtiene el retardo (en segundos) utilizado por Gestor de canales para un cambio de canal.
`otChannelManagerGetFavoredChannels ( otInstance *aInstance)`	`uint32_t` Esta función obtiene la máscara de canal favorito.
`otChannelManagerGetRequestedChannel ( otInstance *aInstance)`	`uint8_t` Esta función obtiene el canal de la última llamada con éxito 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 rosca canal de la red.
`otChannelManagerRequestChannelSelect ( otInstance *aInstance, bool aSkipQualityCheck)`	`otError` Esta función peticiones que `ChannelManager` cheques y selecciona un nuevo canal y comienza un cambio de canal.
`otChannelManagerSetAutoChannelSelectionEnabled ( otInstance *aInstance, bool aEnabled)`	`void` Esta función se activa / desactiva la funcionalidad de canal de selección automática.
`otChannelManagerSetAutoChannelSelectionInterval ( otInstance *aInstance, uint32_t aInterval)`	`otError` Esta función establece el intervalo de tiempo (en segundos) utilizado por la funcionalidad de canal de selección automática.
`otChannelManagerSetDelay ( otInstance *aInstance, uint16_t aDelay)`	`otError` Esta función establece el retardo (en segundos) que se utiliza para un cambio de canal.
`otChannelManagerSetFavoredChannels ( otInstance *aInstance, uint32_t aChannelMask)`	`void` Esta función establece la máscara de canal favorecida.
`otChannelManagerSetSupportedChannels ( otInstance *aInstance, uint32_t aChannelMask)`	`void` Esta función establece la máscara de canal compatible.

funciones

otChannelManagerGetAutoChannelSelectionEnabled

bool otChannelManagerGetAutoChannelSelectionEnabled(
  otInstance *aInstance
)

Esta función indica si la funcionalidad de canal de selección automática está activada o no.

detalles

parámetros

[in] aInstance

Un puntero a una instancia OpenThread.

Devoluciones

TRUE si está habilitado, FALSO si es discapacitado.

otChannelManagerGetAutoChannelSelectionInterval

uint32_t otChannelManagerGetAutoChannelSelectionInterval(
  otInstance *aInstance
)

Esta función obtiene el intervalo de tiempo (en segundos) utilizado por la funcionalidad de canal de selección automática.

detalles

parámetros

[in] aInstance

Un puntero a una instancia OpenThread.

Devoluciones

El intervalo en cuestión de segundos.

otChannelManagerGetDelay

uint16_t otChannelManagerGetDelay(
  otInstance *aInstance
)

Esta función obtiene el retardo (en segundos) utilizado por Gestor de canales para un cambio de canal.

detalles

parámetros

[in] aInstance

Un puntero a una instancia OpenThread.

Devoluciones

El retraso (en segundos) para el cambio de canal.

otChannelManagerGetFavoredChannels

uint32_t otChannelManagerGetFavoredChannels(
  otInstance *aInstance
)

Esta función obtiene la máscara de canal favorito.

detalles

parámetros

[in] aInstance

Un puntero a una instancia OpenThread.

Devoluciones

Los canales favorecidos como una máscara de bits.

otChannelManagerGetRequestedChannel

uint8_t otChannelManagerGetRequestedChannel(
  otInstance *aInstance
)

Esta función obtiene el canal de la última llamada con éxito a otChannelManagerRequestChannelChange()

detalles
Devoluciones	El último canal solicitado o cero si no ha habido ninguna petición de cambio de canal todavía.

otChannelManagerGetSupportedChannels

uint32_t otChannelManagerGetSupportedChannels(
  otInstance *aInstance
)

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

detalles

parámetros

[in] aInstance

Un puntero a una instancia OpenThread.

Devoluciones

Los canales soportados como una máscara de bits.

otChannelManagerRequestChannelChange

void otChannelManagerRequestChannelChange(
  otInstance *aInstance,
  uint8_t aChannel
)

Esta función solicita un cambio de rosca canal de la red.

La red cambia al canal dado después de un retardo especificado (ver otChannelManagerSetDelay () ). El cambio de canal se lleva a cabo mediante la actualización de la espera de conjunto de datos operativa.

Las siguientes llamadas a esta función se cancelará un cambio de canal previamente solicitado en curso.

detalles

parámetros

`[in] aInstance`	Un puntero a una instancia OpenThread.
`[in] aChannel`	El nuevo canal para la red de rosca.

otChannelManagerRequestChannelSelect

 otError otChannelManagerRequestChannelSelect(
  otInstance *aInstance,
  bool aSkipQualityCheck
)

Esta función peticiones que ChannelManager cheques y selecciona un nuevo canal y comienza un cambio de canal.

A diferencia de la otChannelManagerRequestChannelChange() en el que el canal debe ser dado como un parámetro, esta función pide al ChannelManager para seleccionar un canal por sí mismo (base de recogida información de calidad de canal).

Una vez que se llama, el Gestor de canales llevará a cabo las siguientes 3 pasos:

1) ChannelManager decide si el cambio de canal sería de gran ayuda. Esta verificación se puede saltar si aSkipQualityCheck se establece en true (forzando una selección de canal a suceder y saltarse el control de calidad). Esta etapa utiliza la métrica de calidad de enlace recogidos en el dispositivo (como CCA tasa de fracaso, el marco y las tasas de error de mensaje por vecino, etc.) para determinar si la calidad del canal actual está en el nivel que justifica un cambio de canal.

2) Si el primer paso pasa, a continuación, ChannelManager selecciona una potencialmente mejor canal. Utiliza los datos de calidad de canal recogidos por ChannelMonitor módulo. Los canales soportados y favorecidos se utilizan en este paso. (ver otChannelManagerSetSupportedChannels () y otChannelManagerSetFavoredChannels () ).

3) Si el canal recién seleccionado es diferente del canal actual, ChannelManager solicitudes / inicia el proceso de cambio de canal (internamente la invocación de una RequestChannelChange() ).

detalles

parámetros

`[in] aInstance`	Un puntero a una instancia OpenThread.
`[in] aSkipQualityCheck`	Indica si el control de calidad (paso 1) debe ser omitida.

Valores devueltos

`OT_ERROR_NONE`	La selección de canales ha finalizado correctamente.
`OT_ERROR_NOT_FOUND`	máscara de canal soportado está vacía, por lo tanto no podría seleccionar un canal.

otChannelManagerSetAutoChannelSelectionEnabled

void otChannelManagerSetAutoChannelSelectionEnabled(
  otInstance *aInstance,
  bool aEnabled
)

Esta función se activa / desactiva la funcionalidad de canal de selección automática.

Cuando está activado, ChannelManager hará periódicamente invocar un RequestChannelSelect(false) . El período de intervalo puede ser ajustado por SetAutoChannelSelectionInterval() .

detalles

parámetros

`[in] aInstance`	Un puntero a una instancia OpenThread.
`[in] aEnabled`	Indica si se debe habilitar o deshabilitar esta funcionalidad.

otChannelManagerSetAutoChannelSelectionInterval

 otError otChannelManagerSetAutoChannelSelectionInterval(
  otInstance *aInstance,
  uint32_t aInterval
)

Esta función establece el intervalo de tiempo (en segundos) utilizado por la funcionalidad de canal de selección automática.

detalles

parámetros

`[in] aInstance`	Un puntero a una instancia OpenThread.
`[in] aInterval`	El intervalo en cuestión de segundos.

Valores devueltos

`OT_ERROR_NONE`	El intervalo se estableció correctamente.
`OT_ERROR_INVALID_ARGS`	El `aInterval` no es válido (cero).

otChannelManagerSetDelay

 otError otChannelManagerSetDelay(
  otInstance *aInstance,
  uint16_t aDelay
)

Esta función establece el retardo (en segundos) que se utiliza para un cambio de canal.

El retardo debe ser preferiblemente más largo que el intervalo máximo de sondeo de datos utilizado por todos los dispositivos de gama-sueño dentro de la red de rosca.

detalles

parámetros

`[in] aInstance`	Un puntero a una instancia OpenThread.
`[in] aDelay`	Retardo en segundos.

Valores devueltos

`OT_ERROR_NONE`	Retraso se ha actualizado correctamente.
`OT_ERROR_INVALID_ARGS`	El retardo dado `aDelay` es demasiado corto.

otChannelManagerSetFavoredChannels

void otChannelManagerSetFavoredChannels(
  otInstance *aInstance,
  uint32_t aChannelMask
)

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

detalles

parámetros

`[in] aInstance`	Un puntero a una instancia 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 a una instancia OpenThread.
`[in] aChannelMask`	Una máscara de canal.