Varie

Questo modulo include le astrazioni della piattaforma per comportamenti vari.

Riepilogo

Enumerazioni

otPlatMcuPowerState{
  OT_PLAT_MCU_POWER_STATE_ON = 0,
  OT_PLAT_MCU_POWER_STATE_LOW_POWER = 1,
  OT_PLAT_MCU_POWER_STATE_OFF = 2
}
enum
Enumerazione degli stati di alimentazione del microcontroller.
otPlatResetReason enum
Enumerazione dei possibili codici dei motivi di reimpostazione.

Funzioni

otPlatAssertFail(const char *aFilename, int aLineNumber)
void
Fornisce un'implementazione specifica per la piattaforma.
otPlatGetMcuPowerState(otInstance *aInstance)
Visualizza lo stato di alimentazione attuale dell'MCU desiderato.
otPlatGetResetReason(otInstance *aInstance)
Restituisce il motivo dell'ultimo ripristino della piattaforma.
otPlatReset(otInstance *aInstance)
void
Esegue un ripristino del software sulla piattaforma, se supportato.
otPlatSetMcuPowerState(otInstance *aInstance, otPlatMcuPowerState aState)
Imposta lo stato di alimentazione della MCU desiderato.
otPlatWakeHost(void)
void
Esegue un'operazione specifica della piattaforma per riattivare l'MCU dell'host.

Enumerazioni

oTPlatMcuPowerState

 otPlatMcuPowerState

Enumerazione degli stati di alimentazione del microcontroller.

Questi valori vengono utilizzati per la configurazione NCP quando è abilitato OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL.

Lo stato di alimentazione specifica lo stato di alimentazione desiderato del microcontroller (MCU) di NCP quando il sistema operativo della piattaforma sottostante entra in modalità di inattività (ovvero, tutte le attività/eventi attivi vengono elaborati e l'MCU può entrare potenzialmente in uno stato di alimentazione a risparmio energetico).

Lo stato di alimentazione determina principalmente il modo in cui l'host deve interagire con l'NCP e se l'host ha bisogno di un trigger esterno (un "poke") per NCP prima che possa comunicare con l'NCP.

Dopo un ripristino, lo stato di alimentazione della MCU DEVE essere OT_PLAT_POWER_STATE_ON.

Proprietà
OT_PLAT_MCU_POWER_STATE_LOW_POWER

La MCU dell'NCP può entrare in stato di basso consumo energetico (risparmio energetico).

Quando lo stato di alimentazione desiderato dell'NCP è impostato su LOW_POWER, l'host dovrebbe "attivare" l'NCP (ad esempio un attivatore esterno, come un'interruzione) prima di poter comunicare con l'NCP (inviare un messaggio all'NCP). Il meccanismo "poke" è determinato dal codice della piattaforma (basato sull'interfaccia di NCP per l'host).

Quando lo stato di alimentazione è impostato su LOW_POWER, NCP può comunque (in qualsiasi momento) inviare messaggi all'host. Tieni presente che la ricezione di un messaggio dall'NCP NON indica che lo stato di alimentazione dell'NCP è cambiato. Ciò significa che l'host dovrebbe continuare a "poke" quando vuole parlare con l'NCP finché quest'ultimo non viene modificato esplicitamente (mediante una chiamata riuscita a otPlatSetMcuPowerState(), lo stato è cambiato in ON).

OT_PLAT_MCU_POWER_STATE_OFF

L'NCP è completamente disattivato.

È richiesto un ripristino dell'hardware NCP (tramite un pin RESET) per riportare NCP a SPINEL_MCU_POWER_STATE_ON. La RAM non viene mantenuta dopo il ripristino.

OT_PLAT_MCU_POWER_STATE_ON

La MCU di NCP rimane sempre attiva e attiva.

Quando lo stato di alimentazione desiderato dell'NCP è impostato su ON, l'host può inviare messaggi all'NCP senza richiedere alcun "poke" o trigger esterni.

OtPlatReimposta motivo

 otPlatResetReason

Enumerazione dei possibili codici dei motivi di reimpostazione.

Sono nello stesso ordine dei codici motivo del ripristino di Spinel.

Funzioni

Logo AssertFail

void otPlatAssertFail(
  const char *aFilename,
  int aLineNumber
)

Fornisce un'implementazione specifica per la piattaforma.

Dettagli
Parametri
[in] aFilename
Il nome del file in cui si è verificata la dichiarazione.
[in] aLineNumber
Il numero di riga in cui si è verificata l'affermazione.

OtPlatGetMcuPowerState

otPlatMcuPowerState otPlatGetMcuPowerState(
  otInstance *aInstance
)

Visualizza lo stato di alimentazione attuale dell'MCU desiderato.

Questo vale e viene utilizzato solo per la configurazione NCP quando è attivo il criterio OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL.

Dopo un ripristino dello stato di alimentazione, DEVE restituire OT_PLAT_POWER_STATE_ON. Durante il funzionamento, lo stato di alimentazione DEVE cambiare solo tramite una chiamata esplicita riuscita a otPlatSetMcuPowerState().

Dettagli
Parametri
[in] aInstance
Un puntatore sull'istanza di OpenThread.
Restituisce
Lo stato di alimentazione attuale.

OtPlatGetResetReason

otPlatResetReason otPlatGetResetReason(
  otInstance *aInstance
)

Restituisce il motivo dell'ultimo ripristino della piattaforma.

Dettagli
Parametri
[in] aInstance
Struttura dell'istanza OpenThread.

Resetta otPlat

void otPlatReset(
  otInstance *aInstance
)

Esegue un ripristino del software sulla piattaforma, se supportato.

Dettagli
Parametri
[in] aInstance
Struttura dell'istanza OpenThread.

OtPlatSetMcuPowerState

otError otPlatSetMcuPowerState(
  otInstance *aInstance,
  otPlatMcuPowerState aState
)

Imposta lo stato di alimentazione della MCU desiderato.

Questo vale e viene utilizzato solo per la configurazione NCP quando è attivo il criterio OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL.

Dettagli
Parametri
[in] aInstance
Un puntatore sull'istanza di OpenThread.
[in] aState
Il nuovo stato di alimentazione della MCU.
Valori restituiti
OT_ERROR_NONE
Stato di alimentazione aggiornato correttamente.
OT_ERROR_FAILED
Lo stato di alimentazione della MCU specificato non è supportato dalla piattaforma.

Host otPlatWake

void otPlatWakeHost(
  void
)

Esegue un'operazione specifica della piattaforma per riattivare l'MCU dell'host.

Viene utilizzato solo per le configurazioni NCP.

Risorse

Gli argomenti di riferimento per l'API OpenThread provengono dal codice sorgente, disponibile su GitHub. Per maggiori informazioni o per contribuire alla nostra documentazione, consulta Risorse.