Diversos

Este módulo inclui abstrações de plataforma para vários comportamentos.

Resumo

Enumerações

otPlatMcuPowerState{
  OT_PLAT_MCU_POWER_STATE_ON = 0,
  OT_PLAT_MCU_POWER_STATE_LOW_POWER = 1,
  OT_PLAT_MCU_POWER_STATE_OFF = 2
}
tipo enumerado
Enumeração dos estados de energia do microcontrolador.
otPlatResetReason tipo enumerado
Enumeração de possíveis códigos de motivo de redefinição.

Funções

otPlatAssertFail(const char *aFilename, int aLineNumber)
void
Fornece uma implementação específica da plataforma para declaração.
otPlatGetMcuPowerState(otInstance *aInstance)
Obtém o estado de energia MCU desejado atual.
otPlatGetResetReason(otInstance *aInstance)
Retorna o motivo da última redefinição de plataforma.
otPlatReset(otInstance *aInstance)
void
Executa uma redefinição de software na plataforma, se compatível.
otPlatSetMcuPowerState(otInstance *aInstance, otPlatMcuPowerState aState)
Define o estado de energia da MCU desejado.
otPlatWakeHost(void)
void
Executa uma operação específica da plataforma para ativar a MCU do host.

Enumerações

OtPlatMcuPowerState

 otPlatMcuPowerState

Enumeração dos estados de energia do microcontrolador.

Esses valores são usados para a configuração do NCP quando OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL está ativado.

O estado de energia especifica o estado desejado do microcontrolador (MCU) da NCP quando o sistema operacional da plataforma subjacente entra no modo ocioso (ou seja, todas as tarefas/eventos ativos são processados e a MCU pode entrar em um estado de energia de economia de energia).

O estado de energia determina principalmente como o host precisa interagir com o NCP e se o host precisa de um acionador externo (um "poke") para o NCP antes de se comunicar com o NCP ou não.

Depois de uma redefinição, o estado de energia da MCU PRECISA ser OT_PLAT_POWER_STATE_ON.

Propriedades
OT_PLAT_MCU_POWER_STATE_LOW_POWER

A MCU do NCP pode entrar no estado de baixo consumo de energia (economia de energia).

Quando o estado de energia pretendido do NCP está definido como LOW_POWER, o host precisa "pegar" o NCP (por exemplo, um gatilho externo, como uma interrupção) antes de se comunicar com o NCP (enviar uma mensagem para o NCP). O mecanismo de "poke" é determinado pelo código da plataforma (com base na interface do NCP para o host).

Enquanto o estado de energia é definido como LOW_POWER, o NCP ainda pode (a qualquer momento) enviar mensagens para o host. O recebimento de uma mensagem do NCP NÃO indica que o estado de energia do NCP mudou, ou seja, espera-se que o host continue “poke” quando quiser se comunicar com o NCP até que o estado de energia seja explicitamente alterado (por uma chamada bem-sucedida para otPlatSetMcuPowerState() alterando o estado para ON).

OT_PLAT_MCU_POWER_STATE_OFF

O NCP está totalmente desativado.

É necessário redefinir o hardware NCP por meio de um pino RESET para que o NCP volte a SPINEL_MCU_POWER_STATE_ON. A RAM não é retida após a redefinição.

OT_PLAT_MCU_POWER_STATE_ON

A MCU da NCP permanece ativa e ativa o tempo todo.

Quando o estado de energia desejado do NCP é definido como ON, o host pode enviar mensagens para o NCP sem precisar de nenhum "poke" ou de acionadores externos.

OpPlatResetReason

 otPlatResetReason

Enumeração de possíveis códigos de motivo de redefinição.

Eles estão na mesma ordem que os códigos de motivo de redefinição do Spinel.

Funções

OpPlatAssertFail

void otPlatAssertFail(
  const char *aFilename,
  int aLineNumber
)

Fornece uma implementação específica da plataforma para declaração.

Detalhes
Parâmetros
[in] aFilename
O nome do arquivo em que a declaração ocorreu.
[in] aLineNumber
O número da linha no arquivo onde a declaração ocorreu.

OtPlatGetMcuPowerState

otPlatMcuPowerState otPlatGetMcuPowerState(
  otInstance *aInstance
)

Obtém o estado de energia MCU desejado atual.

Aplicável apenas e usado para a configuração do NCP quando OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL está ativado.

Após uma redefinição, o estado de energia PRECISA retornar OT_PLAT_POWER_STATE_ON. Durante a operação, o estado de energia DEVE mudar apenas por meio de uma chamada explícita bem-sucedida para otPlatSetMcuPowerState().

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para a instância do OpenThread.
Retorna
O estado atual da potência.

OpPlatGetResetReason

otPlatResetReason otPlatGetResetReason(
  otInstance *aInstance
)

Retorna o motivo da última redefinição de plataforma.

Detalhes
Parâmetros
[in] aInstance
A estrutura da instância do OpenThread.

OtPlatReset

void otPlatReset(
  otInstance *aInstance
)

Executa uma redefinição de software na plataforma, se compatível.

Detalhes
Parâmetros
[in] aInstance
A estrutura da instância do OpenThread.

OtPlatSetMcuPowerState

otError otPlatSetMcuPowerState(
  otInstance *aInstance,
  otPlatMcuPowerState aState
)

Define o estado de energia da MCU desejado.

Aplicável apenas e usado para a configuração do NCP quando OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL está ativado.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para a instância do OpenThread.
[in] aState
O novo estado da potência do MCU.
Valores de retorno
OT_ERROR_NONE
O estado da energia foi atualizado.
OT_ERROR_FAILED
O estado de potência MCU fornecido não é compatível com a plataforma.

OtPlatWakeHost

void otPlatWakeHost(
  void
)

Executa uma operação específica da plataforma para ativar a MCU do host.

Isso é usado apenas para configurações NCP.

Recursos

Os tópicos de referência da API OpenThread são originados do código-fonte, disponível no GitHub. Para mais informações ou para contribuir com nossa documentação, consulte Recursos.