Google is committed to advancing racial equity for Black communities. See how.
Esta página foi traduzida pela API Cloud Translation.
Switch to English

Gerente de canal

Este módulo inclui funções para o Channel Manager.

Resumo

As funções neste módulo estão disponíveis quando o recurso Gerenciador de canais ( OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE ) está ativado. O Channel Manager está disponível apenas em uma construção do FTD.

Funções

otChannelManagerGetAutoChannelSelectionEnabled ( otInstance *aInstance)
bool
Esta função indica se a funcionalidade de seleção automática de canal está ativada ou não.
otChannelManagerGetAutoChannelSelectionInterval ( otInstance *aInstance)
uint32_t
Esta função obtém o intervalo de período (em segundos) usado pela funcionalidade de seleção automática de canal.
otChannelManagerGetDelay ( otInstance *aInstance)
uint16_t
Esta função obtém o atraso (em segundos) usado pelo Channel Manager para uma mudança de canal.
otChannelManagerGetFavoredChannels ( otInstance *aInstance)
uint32_t
Esta função obtém a máscara de canal favorita.
otChannelManagerGetRequestedChannel ( otInstance *aInstance)
uint8_t
Esta função obtém o canal da última chamada bem-sucedida para otChannelManagerRequestChannelChange()
otChannelManagerGetSupportedChannels ( otInstance *aInstance)
uint32_t
Esta função obtém a máscara de canal suportada.
otChannelManagerRequestChannelChange ( otInstance *aInstance, uint8_t aChannel)
void
Esta função solicita uma alteração no canal da rede Thread.
otChannelManagerRequestChannelSelect ( otInstance *aInstance, bool aSkipQualityCheck)
Essa função solicita que o ChannelManager verifique e selecione um novo canal e inicie uma alteração de canal.
otChannelManagerSetAutoChannelSelectionEnabled ( otInstance *aInstance, bool aEnabled)
void
Esta função ativa / desativa a funcionalidade de seleção automática de canal.
otChannelManagerSetAutoChannelSelectionInterval ( otInstance *aInstance, uint32_t aInterval)
Esta função define o intervalo do período (em segundos) usado pela funcionalidade de seleção automática de canal.
otChannelManagerSetDelay ( otInstance *aInstance, uint16_t aDelay)
Esta função define o atraso (em segundos) usado para uma mudança de canal.
otChannelManagerSetFavoredChannels ( otInstance *aInstance, uint32_t aChannelMask)
void
Esta função define a máscara de canal favorita.
otChannelManagerSetSupportedChannels ( otInstance *aInstance, uint32_t aChannelMask)
void
Esta função define a máscara de canal suportada.

Funções

otChannelManagerGetAutoChannelSelectionEnabled

bool otChannelManagerGetAutoChannelSelectionEnabled(
  otInstance *aInstance
)

Esta função indica se a funcionalidade de seleção automática de canal está ativada ou não.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para uma instância do OpenThread.
Devoluções
TRUE se ativado, FALSE se desativado.

otChannelManagerGetAutoChannelSelectionInterval

uint32_t otChannelManagerGetAutoChannelSelectionInterval(
  otInstance *aInstance
)

Esta função obtém o intervalo de período (em segundos) usado pela funcionalidade de seleção automática de canal.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para uma instância do OpenThread.
Devoluções
O intervalo em segundos.

otChannelManagerGetDelay

uint16_t otChannelManagerGetDelay(
  otInstance *aInstance
)

Esta função obtém o atraso (em segundos) usado pelo Channel Manager para uma mudança de canal.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para uma instância do OpenThread.
Devoluções
O atraso (em segundos) para a mudança de canal.

otChannelManagerGetFavoredChannels

uint32_t otChannelManagerGetFavoredChannels(
  otInstance *aInstance
)

Esta função obtém a máscara de canal favorita.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para uma instância do OpenThread.
Devoluções
Os canais favoritos como uma máscara de bits.

otChannelManagerGetRequestedChannel

uint8_t otChannelManagerGetRequestedChannel(
  otInstance *aInstance
)

Esta função obtém o canal da última chamada bem-sucedida para otChannelManagerRequestChannelChange()

Detalhes
Devoluções
O último canal solicitado ou zero se ainda não houver solicitação de alteração de canal.

otChannelManagerGetSupportedChannels

uint32_t otChannelManagerGetSupportedChannels(
  otInstance *aInstance
)

Esta função obtém a máscara de canal suportada.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para uma instância do OpenThread.
Devoluções
Os canais suportados como uma máscara de bits.

otChannelManagerRequestChannelChange

void otChannelManagerRequestChannelChange(
  otInstance *aInstance,
  uint8_t aChannel
)

Esta função solicita uma alteração no canal da rede Thread.

A rede muda para o canal especificado após um atraso especificado (consulte otChannelManagerSetDelay () ). A mudança de canal é realizada atualizando o conjunto de dados operacionais pendentes.

Uma chamada subsequente a esta função cancelará uma mudança de canal solicitada anteriormente em andamento.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para uma instância do OpenThread.
[in] aChannel
O novo canal para a rede Thread.

otChannelManagerRequestChannelSelect

 otError otChannelManagerRequestChannelSelect(
  otInstance *aInstance,
  bool aSkipQualityCheck
)

Essa função solicita que o ChannelManager verifique e selecione um novo canal e inicie uma alteração de canal.

Diferentemente do otChannelManagerRequestChannelChange() que o canal deve ser fornecido como parâmetro, essa função solicita ao ChannelManager que selecione um canal sozinho (com base nas informações de qualidade do canal coletadas).

Uma vez chamado, o Channel Manager executará as 3 etapas a seguir:

1) ChannelManager decide se a mudança de canal seria útil. Essa verificação pode ser ignorada se aSkipQualityCheck estiver definido como true (forçando a seleção de um canal e ignorando a verificação de qualidade). Esta etapa usa as métricas de qualidade de link coletadas no dispositivo (como taxa de falha do CCA, taxas de erro de quadro e mensagem por vizinho etc.) para determinar se a qualidade atual do canal está no nível que justifica uma alteração de canal.

2) Se a primeira etapa passar, o ChannelManager seleciona um canal potencialmente melhor. Ele usa os dados de qualidade do canal coletados pelo módulo ChannelMonitor . Os canais suportados e favoritos são usados ​​nesta etapa. (consulte otChannelManagerSetSupportedChannels () e otChannelManagerSetFavoredChannels () ).

3) Se o canal recém-selecionado for diferente do canal atual, o ChannelManager solicitará / iniciará o processo de mudança de canal (invocando internamente um RequestChannelChange() ).

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para uma instância do OpenThread.
[in] aSkipQualityCheck
Indica se a verificação de qualidade (etapa 1) deve ser ignorada.
Retornar valores
OT_ERROR_NONE
Seleção de canal concluída com sucesso.
OT_ERROR_NOT_FOUND
A máscara de canal suportada está vazia, portanto, não foi possível selecionar um canal.

otChannelManagerSetAutoChannelSelectionEnabled

void otChannelManagerSetAutoChannelSelectionEnabled(
  otInstance *aInstance,
  bool aEnabled
)

Esta função ativa / desativa a funcionalidade de seleção automática de canal.

Quando ativado, o ChannelManager invoca periodicamente um RequestChannelSelect(false) . O intervalo do período pode ser definido por SetAutoChannelSelectionInterval() .

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para uma instância do OpenThread.
[in] aEnabled
Indica se é necessário ativar ou desativar essa funcionalidade.

otChannelManagerSetAutoChannelSelectionInterval

 otError otChannelManagerSetAutoChannelSelectionInterval(
  otInstance *aInstance,
  uint32_t aInterval
)

Esta função define o intervalo do período (em segundos) usado pela funcionalidade de seleção automática de canal.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para uma instância do OpenThread.
[in] aInterval
O intervalo em segundos.
Retornar valores
OT_ERROR_NONE
O intervalo foi definido com sucesso.
OT_ERROR_INVALID_ARGS
O aInterval não é válido (zero).

otChannelManagerSetDelay

 otError otChannelManagerSetDelay(
  otInstance *aInstance,
  uint16_t aDelay
)

Esta função define o atraso (em segundos) usado para uma mudança de canal.

O atraso deve, de preferência, ser maior que o intervalo máximo de pesquisa de dados usado por todos os dispositivos sonolentos da rede Thread.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para uma instância do OpenThread.
[in] aDelay
Atraso em segundos.
Retornar valores
OT_ERROR_NONE
O atraso foi atualizado com sucesso.
OT_ERROR_INVALID_ARGS
O atraso especificado aDelay é muito curto.

otChannelManagerSetFavoredChannels

void otChannelManagerSetFavoredChannels(
  otInstance *aInstance,
  uint32_t aChannelMask
)

Esta função define a máscara de canal favorita.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para uma instância do OpenThread.
[in] aChannelMask
Uma máscara de canal.

otChannelManagerSetSupportedChannels

void otChannelManagerSetSupportedChannels(
  otInstance *aInstance,
  uint32_t aChannelMask
)

Esta função define a máscara de canal suportada.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para uma instância do OpenThread.
[in] aChannelMask
Uma máscara de canal.