Questa pagina è stata tradotta dall'API Cloud Translation.

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)`	`otPlatMcuPowerState` Visualizza lo stato di alimentazione attuale dell'MCU desiderato.
`otPlatGetResetReason(otInstance *aInstance)`	`otPlatResetReason` 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)`	`otError` 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à

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`). Nota: lo stato dell'alimentazione di `LOW_POWER` determina solo la modalità di alimentazione dell'MCU e non è correlato allo stato della radio (la radio è gestita dal core OpenThread e dal ruolo del dispositivo, ad esempio quando il dispositivo è inattivo o meno).
`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. Nota: lo stato di alimentazione di `ON` determina soltanto la modalità di alimentazione dell'MCU e non è correlato allo stato della radio.

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

Nota: lo stato dell'alimentazione di LOW_POWER determina solo la modalità di alimentazione dell'MCU e non è correlato allo stato della radio (la radio è gestita dal core OpenThread e dal ruolo del dispositivo, ad esempio quando il dispositivo è inattivo o meno).

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.

Nota: lo stato di alimentazione di ON determina soltanto la modalità di alimentazione dell'MCU e non è correlato allo stato della radio.

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.