Varios

En este módulo, se incluyen abstracciones de plataforma para diversos comportamientos.

Resumen

Enumeraciones

otPlatMcuPowerState{
  OT_PLAT_MCU_POWER_STATE_ON = 0,
  OT_PLAT_MCU_POWER_STATE_LOW_POWER = 1,
  OT_PLAT_MCU_POWER_STATE_OFF = 2
}
enum
Enumeración de los estados de potencia del microcontrolador
otPlatResetReason enum
Enumeración de los posibles códigos de motivo de restablecimiento.

remotas

otPlatAssertFail(const char *aFilename, int aLineNumber)
void
Proporciona una implementación específica de la plataforma para la aserción.
otPlatGetMcuPowerState(otInstance *aInstance)
Obtiene el estado de alimentación actual del MCU deseado.
otPlatGetResetReason(otInstance *aInstance)
Muestra el motivo del último restablecimiento de la plataforma.
otPlatReset(otInstance *aInstance)
void
Realiza un restablecimiento de software en la plataforma, si es compatible.
otPlatResetToBootloader(otInstance *aInstance)
Realiza un restablecimiento de hardware en la plataforma para iniciar el modo de bootloader, si es compatible.
otPlatSetMcuPowerState(otInstance *aInstance, otPlatMcuPowerState aState)
Establece el estado de alimentación del MCU deseado.
otPlatWakeHost(void)
void
Realiza una operación específica de la plataforma para activar el MCU host.

Enumeraciones

otPlatMcuPowerState

 otPlatMcuPowerState

Enumeración de los estados de potencia del microcontrolador

Estos valores se usan para la configuración de NCP cuando OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL está habilitado.

El estado de energía especifica el estado de energía deseado del microcontrolador (MCU) del NCP cuando el sistema operativo de la plataforma subyacente entra en modo inactivo (es decir, todas las tareas o los eventos activos se procesan, y el MCU puede pasar a un estado de ahorro de energía).

El estado de alimentación determina principalmente cómo el host debe interactuar con el NCP y si el host necesita un activador externo (un “poke”) al NCP para poder comunicarse con el NCP o no.

Después de un restablecimiento, el estado de alimentación de la MCU DEBE ser OT_PLAT_POWER_STATE_ON.

Propiedades
OT_PLAT_MCU_POWER_STATE_LOW_POWER

El MCU del NCP puede entrar en el estado de bajo consumo (ahorro de energía).

Cuando el estado de alimentación deseado del NCP se establece en LOW_POWER, se espera que el host "apunte" el NCP (p.ej., un activador externo, como una interrupción) antes de que pueda comunicarse con el NCP (enviar un mensaje al NCP). El mecanismo de "poke" está determinado por el código de la plataforma (según la interfaz del NCP con el host).

Mientras el estado de energía esté establecido en LOW_POWER, el NCP aún puede (en cualquier momento) enviar mensajes al host. Ten en cuenta que recibir un mensaje del NCP NO indica que el estado de energía del NCP cambió, es decir, se espera que el host continúe "probando" cuando quiera comunicarse con el NCP hasta que se cambie el estado de energía de forma explícita (mediante una llamada exitosa a otPlatSetMcuPowerState() que cambia el estado a ON).

OT_PLAT_MCU_POWER_STATE_OFF

El NCP está completamente desactivado.

Es necesario restablecer el hardware del NCP (a través de un pin RESET) para que el NCP vuelva a estar en SPINEL_MCU_POWER_STATE_ON. No se retiene la RAM después del restablecimiento.

OT_PLAT_MCU_POWER_STATE_ON

El MCU del NCP permanece activado todo el tiempo.

Cuando el estado de alimentación deseado del NCP se establece en ON, el host puede enviar mensajes al NCP sin requerir ninguna “poke” ni activadores externos.

otPlatResetReason

 otPlatResetReason

Enumeración de los posibles códigos de motivo de restablecimiento.

Estos están en el mismo orden que los códigos de motivo de restablecimiento de Spinel.

remotas

otPlatAssertFail

void otPlatAssertFail(
  const char *aFilename,
  int aLineNumber
)

Proporciona una implementación específica de la plataforma para la aserción.

Detalles
Parámetros
[in] aFilename
El nombre del archivo en el que se produjo la aserción
[in] aLineNumber
El número de línea del archivo en el que ocurrió la aserción.

otPlatGetMcuPowerState

otPlatMcuPowerState otPlatGetMcuPowerState(
  otInstance *aInstance
)

Obtiene el estado de alimentación actual del MCU deseado.

Solo se aplica y se usa para la configuración de NCP cuando OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL está habilitado.

Después de un restablecimiento, el estado de alimentación DEBE mostrar OT_PLAT_POWER_STATE_ON. Durante el funcionamiento, el estado de energía DEBE cambiar solo a través de una llamada exitosa y explícita a otPlatSetMcuPowerState().

Detalles
Parámetros
[in] aInstance
Un puntero para la instancia de OpenThread.
Qué muestra
El estado actual de la energía.

otPlatGetResetReason

otPlatResetReason otPlatGetResetReason(
  otInstance *aInstance
)

Muestra el motivo del último restablecimiento de la plataforma.

Detalles
Parámetros
[in] aInstance
Estructura de instancias de OpenThread

otPlatReset

void otPlatReset(
  otInstance *aInstance
)

Realiza un restablecimiento de software en la plataforma, si es compatible.

Detalles
Parámetros
[in] aInstance
Estructura de instancias de OpenThread

otPlatResetToBootloader

otError otPlatResetToBootloader(
  otInstance *aInstance
)

Realiza un restablecimiento de hardware en la plataforma para iniciar el modo de bootloader, si es compatible.

Se usa cuando OPENTHREAD_CONFIG_PLATFORM_BOOTLOADER_MODE_ENABLE está habilitado.

Detalles
Parámetros
[in] aInstance
Estructura de instancias de OpenThread
Valores que se muestran
OT_ERROR_NONE
Se restableció correctamente el bootloader.
OT_ERROR_BUSY
No se pudo completar la operación porque hay otra operación en curso.
OT_ERROR_NOT_CAPABLE
No se puede restablecer al bootloader.

otPlatSetMcuPowerState

otError otPlatSetMcuPowerState(
  otInstance *aInstance,
  otPlatMcuPowerState aState
)

Establece el estado de alimentación del MCU deseado.

Solo se aplica y se usa para la configuración de NCP cuando OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL está habilitado.

Detalles
Parámetros
[in] aInstance
Un puntero para la instancia de OpenThread.
[in] aState
El nuevo estado de alimentación de MCU.
Valores que se muestran
OT_ERROR_NONE
Se actualizó correctamente el estado de alimentación.
OT_ERROR_FAILED
El estado de alimentación del MCU determinado no es compatible con la plataforma.

otPlatWakeHost

void otPlatWakeHost(
  void
)

Realiza una operación específica de la plataforma para activar el MCU host.

Solo se usa para configuraciones NCP.

Recursos

Los temas de referencia de la API de OpenThread se originan a partir del código fuente, disponible en GitHub. Para obtener más información o contribuir a nuestra documentación, consulta Recursos.