Primeiras etapas

Para criar um AWS IoT política

1. Para criar uma política do IAM, você precisa saber sua AWS região e o número AWS da conta.

   Para encontrar o número da sua AWS conta, abra o AWS Management Console, localize e expanda o menu abaixo do nome da sua conta no canto superior direito e escolha Minha conta. O ID da conta é exibido em Account Settings (Configurações da conta).

   Para encontrar a AWS região da sua AWS conta, use AWS Command Line Interface o. Para instalar o AWS CLI, siga as instruções no Guia do AWS Command Line Interface usuário. Depois de instalar o AWS CLI, abra uma janela do prompt de comando e digite o seguinte comando:

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

   O resultado deve ser semelhante ao seguinte:

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

   Neste exemplo, a região é us-west-2.

   nota

   Recomendamos o uso de endpoints do ATS, conforme mostrado no exemplo.

2. Navegue até o console do AWS IoT.

3. No painel de navegação, escolha Secure (Seguro), Policies (Políticas) e Create (Criar).

4. Insira um nome para identificar a política.

5. Na seção Add statements (Adicionar instruções), escolha Advanced mode (Modo avançado). Copie e cole o seguinte JSON na janela do editor de política. Substitua aws-region e aws-account por sua AWS região e ID da conta.

   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:*"
           }
       ]
   }
   

   Essa política concede as seguintes permissões:

   iot:Connect

   Concede ao seu dispositivo a permissão para se conectar ao agente de AWS IoT mensagens com qualquer ID de cliente.

   iot:Publish

   Concede ao dispositivo permissão para publicar uma mensagem MQTT em qualquer tópico MQTT.

   iot:Subscribe

   Concede ao dispositivo permissão para assinar o filtro de tópico MQTT.

   iot:Receive

   Concede ao dispositivo permissão para receber mensagens do agente de mensagem da AWS IoT em qualquer tópico MQTT.

6. Escolha Criar.

Para criar uma coisa do IoT, chave privada e certificado para o dispositivo

1. Navegue até o console do AWS IoT.

2. No painel de navegação, escolha Manage (Gerenciar) e, depois, Things (Coisas).

3. Se você não tiver nada do IoT registrado na sua conta, a página You don't have any things yet (Você não tem coisas ainda) será exibida. Se você visualizar esta página, selecione Register a thing (Registrar uma coisa). Caso contrário, escolha Criar.

4. Na página Criando AWS IoT coisas, escolha Criar uma única coisa.

5. Na página Add your device to the thing registry (Adicionar seu dispositivo ao registro de coisas), insira um nome para a coisa e escolha Next (Próximo).

6. Na página Adicionar um certificado para sua coisa, em Criação de One-click certificado, escolha Criar certificado.

7. Baixe a chave privada e o certificado escolhendo os links Download para cada um deles.

8. Selecione Activate (Ativar) para ativar o certificado. Os certificados devem ser ativados antes do uso.

9. Escolha Anexar uma política para anexar uma política ao seu certificado que conceda ao seu dispositivo acesso às AWS IoT operações.

10. Escolha a política que você acabou de criar e escolha Register thing (Registrar coisa).

Para configurar seu AWS IoT endpoint

Você deve fornecer ao FreeRTOS AWS IoT seu endpoint para que o aplicativo executado em sua placa possa enviar solicitações para o endpoint correto.

1. Navegue até o console do AWS IoT.

2. No painel de navegação à esquerda, escolha Configurações.

   Seu AWS IoT endpoint é exibido em Device data endpoint. Deve ser semelhante a 1234567890123-ats.iot.us-east-1.amazonaws.com. Anote esse endpoint.

3. No painel de navegação, escolha Manage (Gerenciar) e, depois, Things (Coisas).

   Seu dispositivo deve ter um nome de AWS IoT coisa. Anote esse nome.

4. Abra o demos/include/aws_clientcredential.h.

5. Especifique valores para as seguintes constantes:

   • #define clientcredentialMQTT_BROKER_ENDPOINT "Your AWS IoT endpoint";

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

Para configurar seu Wi-Fi

Se sua placa estiver se conectando à Internet por meio de uma Wi-Fi conexão, você deverá fornecer ao FreeRTOS as credenciais para se Wi-Fi conectar à rede. Se sua placa não suportar Wi-Fi, você pode pular essas etapas.

1. demos/include/aws_clientcredential.h.

2. Especifique os valores para as seguintes constantes #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

     Os tipos de segurança válidos são:

     • eWiFiSecurityOpen (Aberto, sem segurança)

     • eWiFiSecurityWEP (segurança WEP)

     • eWiFiSecurityWPA (segurança WPA)

     • eWiFiSecurityWPA2 (segurança WPA2)

Para formatar seu AWS IoT credenciais

Os FreeRTOS devem ter AWS IoT o certificado e as chaves privadas associados à sua coisa registrada e suas políticas de permissões para se comunicar AWS IoT com sucesso em nome do seu dispositivo.

O FreeRTOS é um projeto de linguagem C e o certificado e a chave privada devem ser formatados especialmente para serem adicionados ao projeto.

1. Em uma janela do navegador, abra tools/certificate_configuration/CertificateConfigurator.html.

2. Em Arquivo PEM do certificado, selecione ID-certificate.pem.crt do qual foi feito download no console do AWS IoT .

3. Em Arquivo PEM da chave privada, selecione ID-private.pem.key do qual foi feito download no console do AWS IoT .

4. Selecione Generate and save aws_clientcredential_keys.h (Gerar e salvar aws_clientcredential_keys.h) e salve o arquivo em demos/include. Isso substitui o arquivo existente no diretório.

   nota

   O certificado e a chave privada são codificados apenas para fins de demonstração. Production-level os aplicativos devem armazenar esses arquivos em um local seguro.