Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Sincronización de las sombras de dispositivo locales con AWS IoT Core

El componente administrador de sombras permite a AWS IoT Greengrass sincronizar los estados de sombra de dispositivo local con AWS IoT Core. Debe modificar la configuración del componente administrador de sombras para incluir el parámetro de configuración synchronization y especificar los nombres de los objetos AWS IoT y las sombras que desea sincronizar.

Al configurar el administrador de sombras para que sincronice las sombras, sincroniza todos los cambios de estado de las sombras especificadas, independientemente de si los cambios se producen en documentos de sombra locales o en documentos de sombra en la nube.

También puede especificar si el componente administrador de sombras sincroniza las sombras en tiempo real o en intervalos periódicos. De forma predeterminada, el componente administrador de sombras sincroniza las sombras en tiempo real, por lo que el dispositivo principal envía y recibe actualizaciones de sombra desde y hacia AWS IoT Core en el momento que se produce cada actualización. Puede configurar intervalos periódicos para reducir el uso de ancho de banda y los cargos.

Requisitos previos

Para sincronizar las sombras locales con AWS IoT Core, debe configurar la política AWS IoT del dispositivo principal de Greengrass para permitir las siguientes acciones de política de sombra AWS IoT Core.

Para obtener más información, consulte los siguientes temas:

Configuración del componente administrador de sombras

El administrador de sombras necesita una lista de asignaciones de nombres de sombras, con el fin de sincronizar la información sobre el estado de las sombras en los documentos de sombras locales con los documentos de sombras en la nube en AWS IoT Core.

Para sincronizar los estados de sombra, cree una implementación que incluya el componente aws.greengrass.ShadowManager y especifique las sombras que desea sincronizar en el parámetro de configuración synchronize de la configuración del administrador de sombras en la implementación.

El siguiente ejemplo de actualización de configuración indica al componente administrador de sombras que sincronice las siguientes sombras con AWS IoT Core:

Esta actualización de configuración especifica sincronizar las sombras con AWS IoT Core en tiempo real. Si utiliza la versión 2.1.0 o posterior del administrador de sombras, puede configurar el componente administrador de sombras para que sincronice las sombras a intervalos periódicos. Para configurar esta característica, cambie la estrategia de sincronización a periodic y especifique un delay en segundos para el intervalo. Para obtener más información, consulte el parámetro de configuración de la estrategia del componente administrador de sombras.

Esta actualización de configuración especifica que las sombras se sincronicen en ambas direcciones entre AWS IoT Core y el dispositivo principal. Si utiliza la versión 2.2.0 o posterior del administrador de sombras, puede configurar el componente administrador de sombras para que sincronice las sombras en una dirección. Para configurar esta característica, cambie la sincronización direction a deviceToCloud o cloudToDevice. Para obtener más información, consulte el parámetro de configuración de la dirección del componente administrador de sombras.

{
  "strategy": {
    "type": "realTime"
  },
  "synchronize": {
    "coreThing": {
      "classic": true,
      "namedShadows": [
        "MyCoreShadow"
      ]
    },
    "shadowDocuments": [
      {
        "thingName": "MyDevice1",
        "classic": false,
        "namedShadows": [
          "MyShadowA",
          "MyShadowB"
        ]
      },
      {
        "thingName": "MyDevice2",
        "classic": true,
        "namedShadows": [ ]
      }
    ],
    "direction": "betweenDeviceAndCloud"
  }
}

Sincronización de sombras locales

Cuando el dispositivo principal de Greengrass está conectado a la nube AWS IoT, el administrador de sombras realiza las siguientes tareas para las sombras que especifique en la configuración del componente. El comportamiento depende de la opción de configuración especificada en la dirección de sincronización de sombras. De forma predeterminada, el administrador de sombras usa la opción betweenDeviceAndCloud para sincronizar las sombras en ambas direcciones. Si utiliza la versión 2.2.0 o posterior del administrador de sombras, puede configurar el dispositivo principal para que sincronice las sombras en una dirección, que puede ser cloudToDevice o deviceToCloud.

Comportamiento conflictivo en la combinación de sombras

En algunos casos, por ejemplo, cuando el dispositivo principal está desconectado de Internet, es posible que una sombra cambie en el servicio local y en la nube AWS IoT antes de que el administrador de sombras sincronice los cambios. Como resultado, los estados deseados y notificados difieren entre el servicio de sombras local y en la nube AWS IoT

Cuando el administrador de sombras sincroniza la sombra, fusiona los cambios de acuerdo con el siguiente comportamiento: