Primeros pasos

Para crear un AWS IoT policy

1. Para crear una política de IAM, debes conocer tu AWS región y tu número de AWS cuenta.

   Para encontrar tu número de AWS cuenta, abre la consola AWS de administración, busca y expande el menú que hay debajo del nombre de tu cuenta, en la esquina superior derecha, y selecciona Mi cuenta. El ID de su cuenta se muestra en Account Settings (Configuración de cuenta).

   Para buscar la AWS región de tu AWS cuenta, usa el. AWS Command Line Interface Para instalarlo AWS CLI, sigue las instrucciones de la Guía del AWS Command Line Interface usuario. Tras instalarlo AWS CLI, abra una ventana de línea de comandos e introduzca el siguiente comando:

   aws iot describe-endpoint --endpoint-type=iot:Data-ATS

   La salida debe tener el siguiente aspecto:

   {
       "endpointAddress": "xxxxxxxxxxxxxx-ats.iot.us-west-2.amazonaws.com"
   }

   En este ejemplo, la región es us-west-2.

   nota

   Recomendamos utilizar los puntos de conexión de ATS, tal y como se muestra en el ejemplo.

2. Vaya a la consola de AWS IoT.

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

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

5. 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. Sustituya aws-region y aws-account por su AWS región e identificador de cuenta.

   JSON

   {
       "Version":"2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Action": "iot:Connect",
               "Resource": "arn:aws:iot:us-east-1:123456789012:*"
           },
           {
               "Effect": "Allow",
               "Action": "iot:Publish",
               "Resource": "arn:aws:iot:us-east-1:123456789012:*"
           },
           {
               "Effect": "Allow",
               "Action": "iot:Subscribe",
               "Resource": "arn:aws:iot:us-east-1:123456789012:*"
           },
           {
               "Effect": "Allow",
               "Action": "iot:Receive",
               "Resource": "arn:aws:iot:us-east-1:123456789012:*"
           }
       ]
   }
   

   Esta política le concede los siguientes permisos:

   iot:Connect

   Otorga a tu dispositivo el permiso para conectarse al intermediario de AWS IoT mensajes con cualquier ID de cliente.

   iot:Publish

   Concede a su dispositivo permiso para publicar un mensaje de MQTT en cualquier tema de MQTT.

   iot:Subscribe

   Concede a su dispositivo permiso para suscribirse a cualquier filtro de temas de MQTT.

   iot:Receive

   Concede a su dispositivo permiso para recibir mensajes del agente de mensajes de AWS IoT acerca de cualquier tema de MQTT.

6. Seleccione Crear.

Creación de un objeto de IoT, clave privada y certificado para su dispositivo

1. Vaya a la consola de AWS IoT.

2. En el panel de navegación, elija Manage (Administrar) y, a continuación, Things (Cosas).

3. Si no tiene ningún objeto de IoT registrado en su cuenta, se muestra la página Aún no tiene ningún objeto. Si ve esta página, elija Registrar un objeto. De lo contrario, seleccione Crear.

4. En la página Crear AWS IoT cosas, elige Crear una sola cosa.

5. En la página Añadir su dispositivo al registro de objetos, escriba un nombre para su objeto y, a continuación, haga clic en Siguiente.

6. En la página Añadir un certificado para lo tuyo, en la sección Creación de One-click certificados, selecciona Crear certificado.

7. Descargue su clave privada y certificado eligiendo los enlaces Descargar para cada uno de ellos.

8. Elija Activar para activar su certificado. Los certificados deben activarse para poder usarlos.

9. Selecciona Adjuntar una política para adjuntar una política a tu certificado que permita a tu dispositivo acceder a AWS IoT las operaciones.

10. Elija la política que acaba de crear y elija Registrar objeto.

Para configurar su AWS IoT punto de conexión

Debes proporcionar a FreeRTOS tu AWS IoT terminal para que la aplicación que se ejecuta en tu placa pueda enviar solicitudes al punto final correcto.

1. Vaya a la consola de AWS IoT.

2. En el panel de navegación izquierdo, elija Configuración.

   Tu AWS IoT punto final se muestra en el punto final de datos del dispositivo. Debe tener un aspecto similar al siguiente: 1234567890123-ats.iot.us-east-1.amazonaws.com. Tome nota de este punto de enlace.

3. En el panel de navegación, elija Manage (Administrar) y, a continuación, Things (Cosas).

   El dispositivo debe tener un nombre para la AWS IoT cosa. Anote este nombre.

4. Abra demos/include/aws_clientcredential.h.

5. Especifique valores para las siguientes constantes:

   • #define clientcredentialMQTT_BROKER_ENDPOINT "Your AWS IoT endpoint";

   • #define clientcredentialIOT_THING_NAME "The AWS IoT thing name of your board"

Para configurar su Wi-Fi

Si tu placa se conecta a Internet a través de una Wi-Fi conexión, debes proporcionar a FreeRTOS Wi-Fi las credenciales para conectarse a la red. Si tu placa no es compatible Wi-Fi, puedes saltarte estos pasos.

1. demos/include/aws_clientcredential.h.

2. Especifique valores para las siguientes constantes de #define:

   • #define clientcredentialWIFI_SSID "The SSID for your Wi-Fi network"

   • #define clientcredentialWIFI_PASSWORD "The password for your Wi-Fi network"

   • #define clientcredentialWIFI_SECURITY The security type of your Wi-Fi network

     Los tipos de seguridad válidos son:

     • eWiFiSecurityOpen (abierta, sin seguridad)

     • eWiFiSecurityWEP (seguridad WEP)

     • eWiFiSecurityWPA (seguridad WPA)

     • eWiFiSecurityWPA2 (seguridad WPA2)

Para formatear tu AWS IoT credentials

FreeRTOS debe tener el AWS IoT certificado y las claves privadas asociados a tu dispositivo registrado y sus políticas de permisos para poder comunicarte correctamente con ellos AWS IoT en nombre de tu dispositivo.

FreeRTOS es un proyecto en lenguaje C, y el certificado y la clave privada deben tener un formato específico para que se puedan añadir al proyecto.

1. En una ventana del navegador, abra tools/certificate_configuration/CertificateConfigurator.html.

2. En Archivo PEM del certificado, elija el archivo ID-certificate.pem.crt que ha descargado desde la consola de AWS IoT .

3. En Archivo PEM de clave privada, elija el archivo ID-private.pem.key que ha descargado desde la consola de AWS IoT .

4. Elija Generate and save aws_clientcredential_keys.h (Generar y guardar aws_clientcredential_keys.h) y después guarde el archivo en demos/include. Esto sobrescribe el archivo existente en el directorio.

   nota

   El certificado y la clave privada están codificados de forma rígida únicamente con fines de demostración. Production-level las aplicaciones deben almacenar estos archivos en una ubicación segura.