Esta página foi traduzida pela API Cloud Translation.

Gerente de canal

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

Resumo

As funções deste módulo são disponível quando a função Channel Manager ( OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE ) está habilitado. O Channel Manager está disponível apenas em uma construção FTD.

Funções
`otChannelManagerGetAutoChannelSelectionEnabled ( otInstance *aInstance)`	`bool` Esta função indica se a funcionalidade de seleção automática de canal está habilitada 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.
`otChannelManagerGetCcaFailureRateThreshold ( otInstance *aInstance)`	`uint16_t` Esta função obtém o limite da taxa de falha CCA.
`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 preferida.
`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 com suporte.
`otChannelManagerRequestChannelChange ( otInstance *aInstance, uint8_t aChannel)`	`void` Esta função requer uma mudança de canal de rede Thread.
`otChannelManagerRequestChannelSelect ( otInstance *aInstance, bool aSkipQualityCheck)`	`otError` Esta função solicita que `ChannelManager` cheques e seleciona um novo canal e inicia uma mudança 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)`	`otError` Esta função define o intervalo de período (em segundos) usado pela funcionalidade de seleção automática de canal.
`otChannelManagerSetCcaFailureRateThreshold ( otInstance *aInstance, uint16_t aThreshold)`	`void` Esta função define o limite da taxa de falha CCA.
`otChannelManagerSetDelay ( otInstance *aInstance, uint16_t aDelay)`	`otError` 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 preferida.
`otChannelManagerSetSupportedChannels ( otInstance *aInstance, uint32_t aChannelMask)`	`void` Esta função define a máscara de canal com suporte.

Funções

otChannelManagerGetAutoChannelSelectionEnabled

bool otChannelManagerGetAutoChannelSelectionEnabled(
  otInstance *aInstance
)

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

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

TRUE se habilitado, FALSE se desabilitado.

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

Devoluções

O intervalo em segundos.

otChannelManagerGetCcaFailureRateThreshold

uint16_t otChannelManagerGetCcaFailureRateThreshold(
  otInstance *aInstance
)

Esta função obtém o limite da taxa de falha CCA.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

O limite da taxa de falha CCA. O valor 0 mapeia para 0% e 0xffff mapeia para 100%.

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

Devoluções

O atraso (em segundos) para mudança de canal.

otChannelManagerGetFavoredChannels

uint32_t otChannelManagerGetFavoredChannels(
  otInstance *aInstance
)

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

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

Os canais preferidos como 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 mudança de canal.

otChannelManagerGetSupportedChannels

uint32_t otChannelManagerGetSupportedChannels(
  otInstance *aInstance
)

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

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

Os canais suportados como uma máscara de bits.

otChannelManagerRequestChannelChange

void otChannelManagerRequestChannelChange(
  otInstance *aInstance,
  uint8_t aChannel
)

Esta função requer uma mudança de canal de rede Thread.

A rede comuta para o canal dado depois de um atraso especificado (ver otChannelManagerSetDelay () ). A mudança de canal é realizada por meio da atualização do Conjunto de dados operacionais pendentes.

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

Detalhes

Parâmetros

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

otChannelManagerRequestChannelSelect

otError otChannelManagerRequestChannelSelect(
  otInstance *aInstance,
  bool aSkipQualityCheck
)

Esta função solicita que ChannelManager cheques e seleciona um novo canal e inicia uma mudança de canal.

Ao contrário do otChannelManagerRequestChannelChange() , onde o canal tem de ser dado como um paretro, esta função faz a ChannelManager para seleccionar um canal por si só (base de recolhido canal de informação de qualidade).

Uma vez chamado, o gerente de canal executará as 3 etapas a seguir:

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

2) Se o primeiro passo passa, em seguida, ChannelManager selecciona um canal potencialmente melhor. Ele utiliza os dados de qualidade de canal recolhido por ChannelMonitor módulo. Os canais com suporte e favorecidos são usados nesta etapa. (veja otChannelManagerSetSupportedChannels () e otChannelManagerSetFavoredChannels () ).

3) Se o novo canal seleccionado é diferente do canal de corrente, ChannelManager solicitações / inicia o processo de mudança de canal (invocando internamente um RequestChannelChange() ).

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aSkipQualityCheck`	Indica se a verificação de qualidade (etapa 1) deve ser ignorada.

Valores Retornados

`OT_ERROR_NONE`	A seleção do canal foi concluída com sucesso.
`OT_ERROR_NOT_FOUND`	A máscara de canal compatível 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, ChannelManager periodicamente chamar um RequestChannelSelect(false) . O período de intervalo pode ser definido por SetAutoChannelSelectionInterval() .

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aEnabled`	Indica se deseja ativar ou desativar esta funcionalidade.

otChannelManagerSetAutoChannelSelectionInterval

otError otChannelManagerSetAutoChannelSelectionInterval(
  otInstance *aInstance,
  uint32_t aInterval
)

Esta função define 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 OpenThread.
`[in] aInterval`	O intervalo em segundos.

Valores Retornados

`OT_ERROR_NONE`	O intervalo foi definido com sucesso.
`OT_ERROR_INVALID_ARGS`	O `aInterval` não é válido (zero).

otChannelManagerSetCcaFailureRateThreshold

void otChannelManagerSetCcaFailureRateThreshold(
  otInstance *aInstance,
  uint16_t aThreshold
)

Esta função define o limite da taxa de falha CCA.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aThreshold`	Um limite de taxa de falha CCA. O valor 0 mapeia para 0% e 0xffff mapeia para 100%.

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 ser preferencialmente maior do que o intervalo máximo de pesquisa de dados usado por todos os dispositivos terminais adormecidos na rede Thread.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aDelay`	Atraso em segundos.

Valores Retornados

`OT_ERROR_NONE`	O atraso foi atualizado com sucesso.
`OT_ERROR_INVALID_ARGS`	O dado atraso `aDelay` é muito curto.

otChannelManagerSetFavoredChannels

void otChannelManagerSetFavoredChannels(
  otInstance *aInstance,
  uint32_t aChannelMask
)

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

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância 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 com suporte.

Detalhes

Parâmetros

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

Recursos

Tópicos OpenThread API Referência originam a partir do código fonte, disponível no GitHub . Para mais informações, ou para contribuir para a nossa documentação, consulte Recursos .