As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# aplicação de demonstração do AWS IoT Greengrass Discovery V1
<a name="gg-demov1"></a>

**Importante**  <a name="deprecation-message-demo"></a>
Essa demonstração está hospedada no repositório Amazon-FreeRTOS, que está preterido. Recomendamos [começar aqui](freertos-getting-started-modular.md) ao criar um novo projeto. Se você já tem um projeto FreeRTOS existente baseado no repositório Amazon-FreeRTOS que está preterido, consulte o [Guia de migração do repositório Github do Amazon FreeRTOS](github-repo-migration.md).

Antes de executar a demonstração do AWS IoT Greengrass Discovery para FreeRTOS, é necessário configurar a AWS, o AWS IoT Greengrass, e o AWS IoT. Paga configurar a AWS, siga as instruções em [Configurando sua AWS conta e permissões](freertos-prereqs.md#freertos-account-and-permissions). Para configurar o AWS IoT Greengrass, é necessário criar um grupo do Greengrass e adicionar um núcleo do Greengrass. Para obter mais informações sobre a configuração do AWS IoT Greengrass, consulte [Conceitos básicos do AWS IoT Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-gs.html). 

Depois de configurar a AWS e o AWS IoT Greengrass, será necessário configurar algumas permissões adicionais para o AWS IoT Greengrass.

**Para configurar permissões do AWS IoT Greengrass**

1. Navegue até o [console do IAM](https://console.aws.amazon.com/iam/home).

1. No painel de navegação, selecione **Roles (Funções\$1** e, então, procure e selecione **Greengrass\$1ServiceRole**.

1. Selecione **Attach policies (Anexar políticas)**, selecione **AmazonS3FullAccess** e **AWSIoTFullAccess** e selecione **Attach policy (Anexar política)**.

1. Navegue até o [console do AWS IoT](https://console.aws.amazon.com/iotv2/).

1. No painel de navegação, selecione **Greengrass**, selecione **Groups (Grupos)** e selecione o grupo do Greengrass criado anteriormente.

1. Selecione **Settings (Configurações)** e **Add role (Adicionar função)**.

1. Selecione **Greengrass\$1ServiceRole** e **Save (Salvar)**.

Conecte a placa do AWS IoT e configure a demonstração do FreeRTOS.

1. [Registrando sua placa MCU com AWS IoT](freertos-prereqs.md#get-started-freertos-thing)

   Depois de registrar a placa, será necessário criar e anexar uma nova política do Greengrass ao certificado do dispositivo.

**Para criar uma política do AWS IoT Greengrass**

   1. Navegue até o [console do AWS IoT](https://console.aws.amazon.com/iotv2/).

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

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

   1. 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:

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

      Essa política concede permissões ao AWS IoT Greengrass para todos os recursos.

   1. Escolha **Criar**.

**Para anexar a política do AWS IoT Greengrass ao certificado do dispositivo**

   1. Navegue até o [console do AWS IoT](https://console.aws.amazon.com/iotv2/).

   1. No painel de navegação, selecione **Manage (Gerenciar)**, selecione **Things (Coisas)** e selecione a coisa criada anteriormente.

   1. Selecione **Security (Segurança)** e selecione o certificado anexado ao dispositivo.

   1. Selecione **Policies (Políticas)**, selecione **Actions (Ações)** e selecione **Attach Policy (Anexar política)**.

   1. Encontre e selecione a política do Greengrass criada anteriormente e selecione **Attach (Anexar)**.

1. [Fazer download do FreeRTOS](freertos-prereqs.md#freertos-download)
**nota**  
Se você estiver fazendo download do FreeRTOS, a partir do console dele, escolha **Conectar-se ao AWS IoT Greengrass – *Plataforma*** em vez de **Conectar-se ao AWS IoT – *Plataforma***.

1. [Configuração das demonstrações do FreeRTOS](freertos-prereqs.md#freertos-configure).

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

Depois de configurar a AWS IoT e o AWS IoT Greengrass, fazer o download e configurar o FreeRTOS, você poderá compilar, instalar e executar a demonstração do Greengrass no seu dispositivo. Para configurar o ambiente de desenvolvimento de hardware e software da placa, siga as instruções no [Guias de conceitos básicos específicos da placa](getting-started-guides.md).

A demonstração do Greengrass publica uma série de mensagens no núcleo do Greengrass e no cliente MQTT da AWS IoT. Para visualizar as mensagens no cliente MQTT do AWS IoT, abra o [console AWS IoT](https://console.aws.amazon.com/iotv2/), selecione **Testar**, escolha **cliente de teste MQTT** e adicione uma assinatura a `freertos/demos/ggd`.

No cliente MQTT, você deve ver estas strings:

```
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 uma instância do Amazon EC2
<a name="gg-demo-ec2"></a>

**Se você estiver trabalhando com uma instância do Amazon EC2**

1. Localize o DNS público (IPv4) associado à sua instância do Amazon EC2 – acesse o console do Amazon EC2 e, no painel de navegação esquerdo, escolha **Instâncias**. Escolha sua instância do Amazon EC2 e escolha o painel **Descrição**. Procure a entrada para o **DNS público (IPv4)** e anote-o.

1. Localize a entrada para **Grupos de segurança** e escolha o grupo de segurança anexado à sua instância do Amazon EC2.

1. Escolha a guia **Regras de entrada** e escolha **Editar regras de entrada** e adicione as seguintes regras.  
**Regras de entrada**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/freertos/latest/userguide/gg-demov1.html)

1. No console do AWS IoT, escolha **Greengrass**, **Grupos** e escolha o grupo do Greengrass criado anteriormente. Escolha **Settings**. Altere a **Detecção de conexão local** para **Gerenciar manualmente as informações de conexão**.

1. No painel de navegação, escolha **Núcleos** e selecione o núcleo do grupo.

1. Escolha **Conectividade** e verifique se você tem somente um endpoint principal (exclua todos os outros) e se ele não é um endereço IP (porque está sujeito a alterações). A melhor opção é usar o DNS público (IPv4) anotado na primeira etapa.

1. Adicione a coisa da IoT do FreeRTOS criada para o grupo do GG.

   1. Escolha a seta para trás para retornar à página do grupo do AWS IoT Greengrass. No painel de navegação, escolha **Dispositivos** e **Adicionar dispositivo**.

   1. Escolha **Selecionar uma coisa da IoT**. Escolha o dispositivo e escolha **Concluir**.

1. Adicione as assinaturas necessárias na página **Grupo do Greengrass**, escolha **Assinaturas**, escolha **Adicionar assinatura** e insira as informações conforme mostrado aqui.  
**Assinaturas**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/freertos/latest/userguide/gg-demov1.html)

   Onde "Fonte" é o nome dado à coisa do AWS IoT criada no console do AWS IoT quando você registrou sua placa - "TIGG1" no exemplo dado aqui.

1. Inicie uma implantação do seu grupo do AWS IoT Greengrass e verifique se a implantação foi bem-sucedida. Agora, você deve conseguir executar com êxito a demonstração do AWS IoT Greengrass Discovery.