Aplicación de demostración de detección de AWS IoT Greengrass V1 - FreeRTOS
Amazon EC2

Aplicación de demostración de detección de AWS IoT Greengrass V1

importante

Esta demostración está alojada en el repositorio de Amazon-FreeRTOS, que está en desuso. Recomendamos empezar por aquí al crear un nuevo proyecto. Si ya tiene un proyecto FreeRTOS existente basado en el repositorio Amazon FreeRTOS, ahora obsoleto, consulte Guía de migración del repositorio Github de Amazon-FreeRTOS.

Antes de ejecutar la demostración de detección de AWS IoT Greengrass para FreeRTOS, debe configurar AWS, AWS IoT Greengrass y AWS IoT. Para configurar AWS, siga las instrucciones de Configuración de su cuenta de AWS y los permisos. Para configurar AWS IoT Greengrass, tiene que crear un grupo de Greengrass y, a continuación, añadir un núcleo de Greengrass. Para obtener más información acerca de la configuración de AWS IoT Greengrass, consulte Introducción a AWS IoT Greengrass.

Después de configurar AWS y AWS IoT Greengrass, tiene que configurar algunos permisos adicionales para AWS IoT Greengrass.

Configuración de permisos de AWS IoT Greengrass

  1. Vaya a la consola de IAM.

  2. En el panel de navegación, elija Roles y, a continuación, busque y seleccione Greengrass_ServiceRole.

  3. Elija Attach policies (Asociar políticas), seleccione AmazonS3FullAccess y AWSIoTFullAccess y, a continuación, elija Attach policy (Asociar política).

  4. Vaya a la consola de AWS IoT.

  5. En el panel de navegación, elija Greengrass, elija Groups (Grupos) y, a continuación, elija el grupo de Greengrass que creó con anterioridad.

  6. Elija Settings (Configuración) y, a continuación, elija Add role (Añadir rol).

  7. Elija Greengrass_ServiceRole y, a continuación, elija Save (Guardar).

Conecte la placa a AWS IoT y configure la demostración de FreeRTOS.

  1. Registro de la placa de MCU con AWS IoT

    Después de registrar su placa, tiene que crear y asociar una nueva política de Greengrass al certificado del dispositivo.

    Creación de una nueva política de AWS IoT Greengrass

    1. Vaya a la consola de AWS IoT.

    2. En el panel de navegación, elija Secure (Seguridad), elija Policies (Políticas) y, a continuación, elija Create (Crear).

    3. Especifique un nombre que identifique la política.

    4. En la sección Añadir declaraciones, elija Modo avanzado. Copie y pegue la siguiente política JSON en la ventana del editor de políticas:

      {
      "Effect": "Allow",
      "Action": [
        "greengrass:*"
      ],
      "Resource": "*"
}

      Esta política concede los permisos de AWS IoT Greengrass a todos los recursos.

    5. Seleccione Crear.

    Asociación de la política de AWS IoT Greengrass al certificado de su dispositivo

    1. Vaya a la consola de AWS IoT.

    2. En el panel de navegación, elija Manage (Administrar), elija Things (Objetos) y, a continuación, elija el objeto que creó anteriormente.

    3. Elija Security (Seguridad) y, a continuación, elija el certificado asociado a su dispositivo.

    4. Elija Policies (Políticas), elija Actions (Acciones) y, a continuación, Attach Policy (Asociar política).

    5. Encuentre y elija la política de Greengrass que creó anteriormente y, a continuación, elija Attach (Asociar).

  2. Descarga de FreeRTOS

    nota

    Si va a descargar FreeRTOS desde la consola de FreeRTOS, seleccione Conectar a AWS IoT Greengrass- Plataforma en lugar de Conectar a AWS IoT- Plataforma.

  3. Configuración de las demostraciones de FreeRTOS.

    Abra freertos/vendors/vendor/boards/board/aws_demos/config_files/aws_demo_config.h, comente #define CONFIG_CORE_MQTT_MUTUAL_AUTH_DEMO_ENABLED y defina CONFIG_GREENGRASS_DISCOVERY_DEMO_ENABLED.

Después de configurar AWS IoT y AWS IoT Greengrass y, una vez que haya descargado y configurado FreeRTOS, puede compilar, instalar y ejecutar la demostración de Greengrass en su dispositivo. Para configurar el entorno de desarrollo de hardware y software de la placa, siga las instrucciones que se describen en la Guías de introducción específicas de placas.

La demostración de Greengrass publica una serie de mensajes en el núcleo de Greengrass y en el cliente de MQTT de AWS IoT. Para ver los mensajes en el cliente de MQTT de AWS IoT, abra la consola de AWS IoT, elija Prueba y, a continuación, elija el cliente de prueba MQTT y añada una suscripción a freertos/demos/ggd.

En el cliente de MQTT, debería ver las siguientes cadenas:

Message from Thing to Greengrass Core: Hello world msg #1!
Message from Thing to Greengrass Core: Hello world msg #0!
Message from Thing to Greengrass Core: Address of Greengrass Core found! 123456789012.us-west-2.compute.amazonaws.com

Uso de una instancia de Amazon EC2

Si trabaja con una instancia de Amazon EC2

  1. Busque el DNS público (IPv4) asociado a su instancia de Amazon EC2: vaya a la consola de Amazon EC2 y, en el panel de navegación izquierdo, elija Instancias. Elija su instancia de Amazon EC2 y, a continuación, elija el panel Descripción. Busque la entrada para el DNS público (IPv4) y anótela.

  2. Busque la entrada para Grupos de seguridad y elija el grupo de seguridad asociado con la instancia de Amazon EC2.

  3. Elija la pestaña Reglas de entrada y, a continuación, elija Editar reglas de entrada y agregue las siguientes reglas.

    Reglas de entrada
    Tipo Protocolo Intervalo de puertos Origen Descripción: opcional
    HTTP TCP 80 0.0.0.0/0 -
    HTTP TCP 80 ::/0 -
    SSH TCP 22 0.0.0.0/0 -
    TCP personalizada TCP 8883 0.0.0.0/0 Comunicaciones MQTT
    TCP personalizada TCP 8883 ::/0 Comunicaciones MQTT
    HTTPS TCP 443 0.0.0.0/0 -
    HTTPS TCP 443 ::0/0 -
    Todos ICMP: IPv4 ICMP Todos 0.0.0.0/0 -
    Todos ICMP: IPv4 ICMP Todos ::0/0 -

  4. En la consola de AWS IoT, elija Greengrass y, a continuación, Grupos y elija el grupo Greengrass que creó anteriormente. Seleccione Configuración. Cambie la Detección de conexión local a Administrar manualmente la información de conexión.

  5. En el panel de navegación, elija Núcleos y, a continuación, seleccione el núcleo del grupo.

  6. Elija Conectividad y asegúrese de que solo tiene un punto de enlace principal (elimine el resto) y que no es una dirección IP (porque está sujeta a cambios). La mejor opción es usar el DNS público (IPv4) que anotó en el primer paso.

  7. Agregue el objeto de FreeRTOS IoT que creó en el grupo GG.

    1. Elija la flecha hacia atrás para volver a la página del grupo AWS IoT Greengrass. En el panel de navegación, elija Dispositivos y, a continuación, elija Agregar dispositivo.

    2. Elija Seleccionar un objeto de IoT. Elija su dispositivo y luego elija Finalizar.

  8. Añada las suscripciones necesarias: en la página Grupo de Greengrass, elija Suscripciones y, a continuación, seleccione Añadir suscripción e introduzca la información que se muestra aquí.

    Suscripciones
    Origen Destino Tema
    TIGG1 IoT Cloud (Nube de IoT) freertos/demos/ggd

    Donde “Fuente” es el nombre asignado al objeto de AWS IoT que se creó en la consola de AWS IoT cuando registró la placa (“TIGG1” en el ejemplo que se muestra aquí).

  9. Comience una implementación de su grupo AWS IoT Greengrass y asegúrese de que la implementación tenga éxito. Ahora debería poder ejecutar correctamente la demostración de detección de AWS IoT Greengrass.