Diversos

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

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 }`	enum Enumeração dos estados de energia do microcontrolador.
`otPlatResetReason`	enum Enumeração de possíveis códigos de motivo de reinicialização.

Funções
`otPlatAssertFail (const char *aFilename, int aLineNumber)`	`void` Esta função fornece uma implementação específica da plataforma para assert.
`otPlatGetMcuPowerState ( otInstance *aInstance)`	`otPlatMcuPowerState` Esta função obtém o estado de energia MCU desejado atual.
`otPlatGetResetReason ( otInstance *aInstance)`	`otPlatResetReason` Esta função retorna o motivo da última reinicialização da plataforma.
`otPlatReset ( otInstance *aInstance)`	`void` Esta função executa uma reinicialização do software na plataforma, se houver suporte.
`otPlatSetMcuPowerState ( otInstance *aInstance, otPlatMcuPowerState aState)`	`otError` Esta função define o estado de energia MCU desejado.
`otPlatWakeHost (void)`	`void` Esta função executa uma operação específica da plataforma para despertar o MCU host.

Enumerações

otPlatMcuPowerState

 otPlatMcuPowerState

Enumeração dos estados de energia do microcontrolador.

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

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

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

Após uma reinicialização, o estado de energia do MCU DEVE ser OT_PLAT_POWER_STATE_ON .

Propriedades

Propriedades
`OT_PLAT_MCU_POWER_STATE_LOW_POWER`	O MCU do NCP pode entrar no estado de baixa potência (economia de energia). Quando o estado de energia desejado do NCP é definido como `LOW_POWER` , espera-se que o host "cutuque" o NCP (por exemplo, um gatilho externo como uma interrupção) antes que possa se comunicar com o NCP (enviar uma mensagem ao NCP). O mecanismo "poke" é determinado pelo código da plataforma (baseado na interface do NCP com o host). Enquanto o estado de energia está definido como `LOW_POWER` , o NCP ainda pode (a qualquer momento) enviar mensagens para o host. Observe que receber uma mensagem do NCP NÃO indica que o estado de energia do NCP mudou, ou seja, o host deve continuar a "cutucar" quando quiser falar com o NCP até que o estado de energia seja explicitamente alterado (por uma chamada para `otPlatSetMcuPowerState()` alterando o estado para `ON` ). Nota: O estado de energia `LOW_POWER` apenas determina o modo de energia do MCU e não está relacionado ao estado do rádio (o rádio é gerenciado pelo núcleo OpenThread e função do dispositivo, por exemplo, dispositivo adormecido ou não.
`OT_PLAT_MCU_POWER_STATE_OFF`	NCP está totalmente desligado. Uma reinicialização do 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 reinicialização.
`OT_PLAT_MCU_POWER_STATE_ON`	O MCU do NCP permanece ligado e ativo o tempo todo. Quando o estado de energia desejado do NCP é definido como `ON` , o host pode enviar mensagens para o NCP sem exigir qualquer "puxão" ou gatilhos externos. Nota: O estado de energia `ON` apenas determina o modo de energia do MCU e não está relacionado ao estado do rádio.

OT_PLAT_MCU_POWER_STATE_LOW_POWER

O MCU do NCP pode entrar no estado de baixa potência (economia de energia).

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

Enquanto o estado de energia está definido como LOW_POWER , o NCP ainda pode (a qualquer momento) enviar mensagens para o host. Observe que receber uma mensagem do NCP NÃO indica que o estado de energia do NCP mudou, ou seja, o host deve continuar a "cutucar" quando quiser falar com o NCP até que o estado de energia seja explicitamente alterado (por uma chamada para otPlatSetMcuPowerState() alterando o estado para ON ).

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

OT_PLAT_MCU_POWER_STATE_OFF

NCP está totalmente desligado.

Uma reinicialização do 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 reinicialização.

OT_PLAT_MCU_POWER_STATE_ON

O MCU do NCP permanece ligado e ativo o tempo todo.

Quando o estado de energia desejado do NCP é definido como ON , o host pode enviar mensagens para o NCP sem exigir qualquer "puxão" ou gatilhos externos.

Nota: O estado de energia ON apenas determina o modo de energia do MCU e não está relacionado ao estado do rádio.

otPlatResetReason

 otPlatResetReason

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

Eles estão na mesma ordem dos códigos de motivo de reinicialização do Spinel.

Funções

otPlatAssertFail

void otPlatAssertFail(
  const char *aFilename,
  int aLineNumber
)

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

Detalhes

Parâmetros

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

otPlatGetMcuPowerState

otPlatMcuPowerState otPlatGetMcuPowerState(
  otInstance *aInstance
)

Esta função obtém o estado de energia MCU desejado atual.

Isso só é aplicável e usado para configuração NCP quando OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL está habilitado.

Após uma reinicialização, o estado de energia DEVE 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 OpenThread.

Devoluções

O estado de energia atual.

otPlatGetResetReason

otPlatResetReason otPlatGetResetReason(
  otInstance *aInstance
)

Esta função retorna o motivo da última reinicialização da plataforma.

Detalhes

Parâmetros

[in] aInstance

A estrutura da instância OpenThread.

otPlatReset

void otPlatReset(
  otInstance *aInstance
)

Esta função executa uma reinicialização do software na plataforma, se houver suporte.

Detalhes

Parâmetros

[in] aInstance

A estrutura da instância OpenThread.

otPlatSetMcuPowerState

otError otPlatSetMcuPowerState(
  otInstance *aInstance,
  otPlatMcuPowerState aState
)

Esta função define o estado de energia MCU desejado.

Isso só é aplicável e usado para configuração NCP quando OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL está habilitado.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para a instância OpenThread.
`[in] aState`	O novo estado de energia MCU.

Valores Retornados

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

otPlatWakeHost

void otPlatWakeHost(
  void
)

Esta função executa uma operação específica da plataforma para despertar o MCU host.

Isso é usado apenas para configurações NCP.