Google is committed to advancing racial equity for Black communities. See how.
Esta página se ha traducido con Cloud Translation API.
Switch to English

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