O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

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