Esta página foi traduzida pela API Cloud Translation.

Diversos

Este módulo inclui abstrações de plataforma para comportamentos variados.

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 potência do microcontrolador.
`otPlatResetReason`	tipo enumerado Enumeração de possíveis códigos do motivo da redefinição.

Functions
`otPlatAssertFail(const char *aFilename, int aLineNumber)`	`void` Essa função fornece uma implementação específica da plataforma para assert.
`otPlatGetMcuPowerState(otInstance *aInstance)`	`otPlatMcuPowerState` Essa função recebe o estado de energia MCU desejado atual.
`otPlatGetResetReason(otInstance *aInstance)`	`otPlatResetReason` Essa função retorna o motivo da última redefinição da plataforma.
`otPlatReset(otInstance *aInstance)`	`void` Essa função realiza uma redefinição de software na plataforma, se compatível.
`otPlatSetMcuPowerState(otInstance *aInstance, otPlatMcuPowerState aState)`	`otError` Essa função define o estado de energia da MCU desejado.
`otPlatWakeHost(void)`	`void` Essa função executa uma operação específica da plataforma para ativar a MCU do host.

Enumerações

OtPlatMcuPowerState

 otPlatMcuPowerState

Enumeração dos estados de potência 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 de alimentação pretendido do microcontrolador (MCU) da NCP&33; quando o sistema operacional da plataforma subjacente entra no modo de inatividade. Ou seja, todas as tarefas/eventos ativos são processados e a MCU pode entrar em um estado de energia economizadora.

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

Após uma redefinição, o estado da energia da MCU É OT_PLAT_POWER_STATE_ON.

Propriedades

Propriedades
`OT_PLAT_MCU_POWER_STATE_LOW_POWER`	A MCU da NCP pode entrar em um estado de baixo consumo de energia (economia de energia). Quando o estado de energia pretendido do NCP é definido como `LOW_POWER`, o host espera acionar o NCP (por exemplo, um gatilho externo, como uma interrupção) antes de se comunicar com o NCP (enviar uma mensagem ao NCP). O mecanismo "poke" é determinado pelo código da plataforma (com base na interface NCP' do host). Embora o estado de energia esteja 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 foi alterado, ou seja, o host deverá continuar a funcionar. Quando quiser falar com o NCP até que o estado do poder seja explicitamente alterado (por uma chamada bem-sucedida para `otPlatSetMcuPowerState()` alterando o estado para `ON`). Observação:o estado de energia da `LOW_POWER` determina apenas o modo de energia da MCU e não está relacionado ao estado do rádio. O rádio é gerenciado pelo núcleo OpenThread e pela função do dispositivo, por exemplo, dispositivo com sono ou não.
`OT_PLAT_MCU_POWER_STATE_OFF`	O NCP está totalmente desativado. Uma redefinição de hardware NCP (por meio de um pino RESET) é necessária para trazer o NCP de volta para `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 continua ativa e o tempo todo. Quando o estado de energia pretendido do NCP é definido como `ON`, o host pode enviar mensagens ao NCP sem exigir gatilhos "poke" ou externos. Observação:o estado de energia da `ON` determina apenas o modo de alimentação da MCU e não está relacionado ao estado da rádio.

OT_PLAT_MCU_POWER_STATE_LOW_POWER

A MCU da NCP pode entrar em um estado de baixo consumo de energia (economia de energia).

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

Embora o estado de energia esteja 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 foi alterado, ou seja, o host deverá continuar a funcionar. Quando quiser falar com o NCP até que o estado do poder seja explicitamente alterado (por uma chamada bem-sucedida para otPlatSetMcuPowerState() alterando o estado para ON).

Observação:o estado de energia da LOW_POWER determina apenas o modo de energia da MCU e não está relacionado ao estado do rádio. O rádio é gerenciado pelo núcleo OpenThread e pela função do dispositivo, por exemplo, dispositivo com sono ou não.

OT_PLAT_MCU_POWER_STATE_OFF

O NCP está totalmente desativado.

Uma redefinição de hardware NCP (por meio de um pino RESET) é necessária para trazer o NCP de volta para 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 continua ativa e o tempo todo.

Quando o estado de energia pretendido do NCP é definido como ON, o host pode enviar mensagens ao NCP sem exigir gatilhos "poke" ou externos.

Observação:o estado de energia da ON determina apenas o modo de alimentação da MCU e não está relacionado ao estado da rádio.

OtPlatResetReason

 otPlatResetReason

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

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

Functions

OtPlatAssertFailed

void otPlatAssertFail(
  const char *aFilename,
  int aLineNumber
)

Essa função fornece uma implementação específica da plataforma para assert.

Detalhes

Parâmetros

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

OtPlatGetMcuPowerState

otPlatMcuPowerState otPlatGetMcuPowerState(
  otInstance *aInstance
)

Essa função recebe o estado de energia MCU desejado atual.

Aplicável apenas e usado para a configuração 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 somente durante uma chamada bem-sucedida explícita para otPlatSetMcuPowerState().

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para a instância do OpenThread.

Retorna

O estado atual da potência.

OtPlatGetResetReason

otPlatResetReason otPlatGetResetReason(
  otInstance *aInstance
)

Essa função retorna o motivo da última redefinição da plataforma.

Detalhes

Parâmetros

[in] aInstance

A estrutura da instância do OpenThread

OtPlatReset

void otPlatReset(
  otInstance *aInstance
)

Essa função realiza 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
)

Essa função define o estado de energia da MCU desejado.

Aplicável apenas e usado para a configuração 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 de alimentação da MCU.

Valores de retorno

`OT_ERROR_NONE`	O estado de energia foi atualizado.
`OT_ERROR_FAILED`	O estado de energia da MCU fornecido não é compatível com a plataforma.

OtPlatWakeHost

void otPlatWakeHost(
  void
)

Essa função 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 saber mais ou contribuir com nossa documentação, consulte Recursos.