

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á.

# Conceitos básicos do Microchip ATECC608A Secure Element com o Windows Simulator
<a name="getting_started_atecc608a"></a>

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

Este tutorial fornece instruções para começar a usar o elemento seguro do Microchip ATECC608A com o Windows Simulator.

Você precisa do seguinte hardware:
+ [Placa de clique de elemento seguro do Microchip ATECC608A](https://www.mikroe.com/secure-4-click)
+ [SAMD21 XPlained Pro](https://www.microchipdirect.com/product/ATSAMD21-XPRO?dfw_tracker=64197-ATSAMD21-XPRO&gclid=EAIaIQobChMIn5jIuM3C5QIVk_5kCh1m1Ag4EAQYASABEgLKtfD_BwE)
+ [Adaptador MikroBUS Xplained Pro](https://www.microchip.com/Developmenttools/ProductDetails/ATMBUSADAPTER-XPRO)

Antes de começar, você deve configurar AWS IoT e fazer o download dos FreeRTOS para conectar seu dispositivo à nuvem. AWS Para obter instruções, consulte [Primeiras etapas](freertos-prereqs.md). Neste tutorial, o caminho para o diretório de download do FreeRTOS é chamado {{freertos}}.

## Visão geral do
<a name="gsg-atcc608a-overview"></a>

Este tutorial contém as seguintes etapas:

1. Conectar a placa a uma máquina host.

1. Instalar o software na máquina host para desenvolver e depurar aplicativos incorporados para o microcontrolador.

1. Cross-compile um aplicativo de demonstração do FreeRTOS para uma imagem binária.

1. Carregar a imagem binária do aplicativo em na placa e executar o aplicativo.

## Configuração do hardware do Microchip ATECC608A
<a name="gsg-atcc608a-setup"></a>

Para poder interagir com o seu dispositivo Microchip ATECC608A, primeiro programe o SAMD21.

**Para configurar a placa SAMD21 XPlained Pro**

1. Siga o link [CryptoAuthSSH-XSTK (DM320109) - Latest Firmware](http://ww1.microchip.com/downloads/en/DeviceDoc/ATCRYPTOAUTHSSH-XSTK_v1.0.1.zip) para baixar um arquivo.zip contendo instruções (PDF) e um binário que pode ser programado no D21.

1. Faça download e instale o IDP do [Atmel Studio 7](https://microchipdeveloper.com/atstudio:studio7intro). Certifique-se de selecionar a arquitetura do driver **SMART ARM MCU** durante a instalação.

1. Use um cabo USB 2.0 Micro B para encaixar o conector "Debug USB" ao computador e siga as instruções no PDF. (O conector "Debug USB" é a porta USB mais próxima do LED POWER e dos pinos.)

**Para conectar o hardware**

1. Desconecte o cabo micro USB de Debug USB.

1. Conecte o adaptador mikroBUS XPlained Pro à placa SAMD21 no local EXT1.

1. Conecte a placa de clique do ATECC608A Secure 4 ao adaptador mikroBUSX XPlained Pro. Certifique-se de que o canto entalhado da placa de clique corresponda ao ícone entalhado na placa do adaptador.

1. Conecte o cabo micro USB a Target USB.

Sua configuração deve ser semelhante à seguinte.

![Placa de ensaio com cabo USB etiquetado como "Target USB", conectado a um dispositivo externo etiquetado como "Connected to EXT 1", com entalhes que correspondem às posições padrão dos jumpers.](http://docs.aws.amazon.com/pt_br/freertos/latest/userguide/images/samd21.png)


## Configuração do ambiente de desenvolvimento
<a name="gsg-atecc608a-setup-dev-env"></a>

### Inscreva-se para um Conta da AWS
<a name="sign-up-for-aws"></a>

Para começar AWS, você precisa de um Conta da AWS. Para obter informações sobre como criar um Conta da AWS, consulte [Introdução a um Conta da AWS](https://docs.aws.amazon.com//accounts/latest/reference/getting-started.html) no *Guia de AWS Gerenciamento de contas referência*.

Para conceder acesso, adicione as permissões aos seus usuários, grupos ou perfis:
+ Usuários e grupos em Centro de Identidade do AWS IAM:

  Crie um conjunto de permissões. Siga as instruções em [Criação de um conjunto de permissões](https://docs.aws.amazon.com//singlesignon/latest/userguide/howtocreatepermissionset.html) no *Guia do usuário do Centro de Identidade do AWS IAM *.
+ Usuários gerenciados no IAM com provedor de identidades:

  Crie um perfil para a federação de identidades. Siga as instruções em [Criando um perfil para um provedor de identidades de terceiros (federação)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-idp.html) no *Guia do Usuário do IAM*.
+ Usuários do IAM:
  + Crie um perfil que seu usuário possa assumir. Siga as instruções em [Criação de um perfil para um usuário do IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-user.html) no *Guia do usuário do IAM*.
  + (Não recomendado) Vincule uma política diretamente a um usuário ou adicione um usuário a um grupo de usuários. Siga as instruções em [Adição de permissões a um usuário (console)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console) no *Guia do usuário do IAM*.

**Configurar**

1. [Baixe o repositório FreeRTOS do repositório FreeRTOS. GitHub ](https://github.com/aws/amazon-freertos)

   Para baixar os FreeRTOS em: GitHub

   1. Navegue até o repositório do [FreeRTOS GitHub ](https://github.com/aws/amazon-freertos).

   1. Selecione **Clone or download (Clonar ou fazer download)**.

   1. Na linha de comando do computador, clone o repositório para um diretório na máquina de host.

      ```
      git clone https://github.com/aws/amazon-freertos.git -\-recurse-submodules
      ```
**Importante**  
Neste tópico, o caminho para o diretório de download do FreeRTOS é chamado de `{{freertos}}`.
Caracteres de espaço no caminho `{{freertos}}` podem causar falhas na compilação. Ao clonar ou copiar o repositório, verifique se o caminho criado não contém caracteres de espaço.
O tamanho máximo de um caminho de arquivo no Microsoft Windows é 260 caracteres. Caminhos longos de diretório de download do FreeRTOS podem causar falhas de compilação.
O código-fonte pode conter links simbólicos, por isso se estiver usando o Windows para extrair o arquivo, talvez seja necessário:  
Habilitar o [modo Desenvolvedor](https://docs.microsoft.com/en-us/windows/apps/get-started/enable-your-device-for-development) ou, 
Usar um console com privilégios de administrador.
Dessa forma, o Windows pode criar links simbólicos adequadamente ao extrair o arquivamento. Caso contrário, os links simbólicos serão gravados como arquivos comuns que contêm os caminhos dos links simbólicos como texto ou estão vazios. Para obter mais informações, consulte a entrada no blog [ Symlinks no Windows 10\!](https://blogs.windows.com/windowsdeveloper/2016/12/02/symlinks-windows-10/).  
Se você usa o Git no Windows, você deve habilitar o modo Desenvolvedor ou deve:   
Definir `core.symlinks` como verdadeiro com o seguinte comando:  

          ```
          git config -\-global core.symlinks true
          ```
Use um console com privilégios de administrador sempre que usar um comando git que grava no sistema (por exemplo, **git pull**, **git clone**, e **git submodule update -\\-init -\\-recursive**).

   1. No diretório `{{freertos}}`, confira a ramificação a ser usada.

1. Configure o ambiente de desenvolvimento.

   1. Instale a versão mais recente do [WinPCap](https://www.winpcap.org).

   1. Instale o Microsoft Visual Studio.

      As versões 2017 e 2019 do Visual Studio funcionam. Todas as edições dessas versões do Visual Studio são compatíveis (Community, Professional ou Enterprise).

      Além do IDE, instale o componente Desktop development with C\+\+ (Desenvolvimento de desktop com C\+\+). Em seguida, em **Optional (Opcional)**, instale o SDK do Windows 10 mais recente.

   1. Verifique se você tem uma conexão Ethernet fixa ativa.

## Compilação e execução do projeto de demonstração do FreeRTOS
<a name="gsg-atecc608a-build-and-run"></a>

**Importante**  
O dispositivo Microchip ATECC608A tem uma inicialização única que é bloqueada no dispositivo na primeira vez que um projeto é executado (durante a chamada para `C_InitToken`). No entanto, o projeto de demonstração e o projeto de teste do FreeRTOS têm configurações diferentes. Se o dispositivo estiver bloqueado durante as configurações do projeto de demonstração, não será possível que todos os testes no projeto de teste sejam bem-sucedidos.

**Para compilar e executar o projeto de demonstração do FreeRTOS com o IDE do Visual Studio**

1. Carregue o projeto no Visual Studio.

   No menu **File (Arquivo)**, escolha **Open (Abrir)**. Escolha **File/Solution**, navegue até o `{{freertos}}\projects\microchip\ecc608a_plus_winsim\visual_studio\aws_demos\aws_demos.sln` arquivo e escolha **Abrir**.

1. Defina um novo destino para o projeto de demonstração.

   O projeto de demonstração depende do SDK do Windows, mas ele não tem uma versão do SDK do Windows especificada. Por padrão, o IDE pode tentar compilar a demonstração com uma versão do SDK que não está presente em sua máquina. Para definir a versão do SDK do Windows, clique com o botão direito do mouse em **aws\_demos** e escolha **Retarget Projects (Definir novos destinos para os projetos)**. Isso abre a janela **Review Solution Actions (Revisar ações de solução)**. Escolha uma versão do SDK do Windows que esteja presente no computador (use o valor inicial na lista suspensa) e escolha **OK**.

1. Crie e execute o projeto.

   No menu **Compilar**, escolha **Compilar solução**, e verifique se a solução é compilada sem erros. Escolha **Debug (Depurar), Start Debugging (Começar a depurar)** para executar o projeto. Na primeira execução, você precisa configurar a interface do dispositivo e recompilar. Para obter mais informações, consulte [Configuração da interface de rede](getting_started_windows.md#win-network-interface).

1. Provisione o Microchip ATECC608A.

   A Microchip forneceu várias ferramentas de script para ajudar a configurar as peças do ATECC608A. Navegue até `{{freertos}}\vendors\microchip\secure_elements\app\example_trust_chain_tool` o README.md arquivo e abra-o.

   Siga as instruções no arquivo `README.md` para provisionar seu dispositivo. As etapas incluem o seguinte:

   1. Crie e registre uma autoridade de certificação com AWS.

   1. Gerar suas chaves no Microchip ATECC608A e exportar a chave pública e o número de série do dispositivo.

   1. Gere um certificado para o dispositivo e registre esse certificado com AWS.

   1. Carregar o certificado CA e o certificado de dispositivo no dispositivo.

1. Criar e executar exemplos do FreeRTOS.

   Re-run o projeto de demonstração novamente. Desta vez você deverá se conectar\!

## Solução de problemas
<a name="ecc680a-troubleshooting"></a>

Para obter informações gerais sobre a solução de problemas, consulte [Solução de problemas de conceitos básicos](gsg-troubleshooting.md).