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á.
# Começando com o kit de IoT industrial Xilinx Avnet MicroZed
**Importante**
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 kit de IoT MicroZed industrial Xilinx Avnet. [Se você não tiver o kit de IoT MicroZed industrial Xilinx Avnet, visite o Catálogo de dispositivos AWS do parceiro para comprar um de nosso parceiro.](https://devices.amazonaws.com/detail/a3G0L00000AANtqUAH/MicroZed-IIoT-Bundle-with-Amazon-FreeRTOS)
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
Este tutorial contém instruções para as seguintes etapas iniciais:
1. Conectar sua placa a uma máquina host.
1. Instalar software na máquina host para desenvolver e depurar aplicativos incorporados para seu microcontrolador.
1. Compilar uma aplicação de demonstração do FreeRTOS de forma cruzada para uma imagem binária.
1. Carregar a imagem binária do aplicativo em sua placa e executar o aplicativo.
## Configurar o MicroZed hardware
O diagrama a seguir pode ser útil ao configurar o MicroZed hardware:
**Para configurar o MicroZed quadro**
1. Conecte seu computador à USB-UART porta da sua MicroZed placa.
1. Conecte seu computador à porta de acesso JTAG em sua MicroZed placa.
1. Conecte um roteador ou porta Ethernet conectada à Internet à Ethernet e USB-Host à porta da sua placa. MicroZed
## Configuração do ambiente de desenvolvimento
Para definir as configurações do FreeRTOS para o kit, você deve usar MicroZed o Xilinx Software Development Kit (XSDK). O XSDK é compatível com Windows e Linux.
### Download e instalação do XSDK
Para instalar o software Xilinx, é necessário uma conta do Xilinx gratuita.
**Para fazer download do XSDK**
1. Acesse a página de download do [Software Development Kit Standalone WebInstall Client](https://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/embedded-design-tools/2019-1.html).
1. Escolha a opção adequada para o seu sistema operacional.
1. Você será direcionado para uma página de login do Xilinx.
Se você tem uma conta do Xilinx, insira suas credenciais de login e, em seguida, **faça login**.
Se você não tiver uma conta, escolha **Create your account**. Depois de se registrar, você receberá um e-mail com um link para ativar a conta do Xilinx.
1. Na página **Name and Address Verification**, insira suas informações e, em seguida, selecione **Next**. O download deverá estar pronto para começar.
1. Salve o arquivo `Xilinx_SDK_{{version}}_{{os}}`.
**Para instalar o XSDK**
1. Abra o arquivo `Xilinx_SDK_{{version}}_{{os}}`.
1. Em **Select Edition to Install**, escolha **Xilinx Software Development Kit (XSDK)** e, em seguida, selecione **Next**.
1. Na página seguinte do assistente de instalação, em **Installation Options**, selecione **Install Cable Drivers** e, em seguida, escolha **Next**.
Se o seu computador não detectar a USB-UART conexão, instale os MicroZed drivers VCP do CP210x USB-to-UART Bridge manualmente. Para obter instruções, consulte o Guia de instalação do [Silicon Labs CP210x USB-to-UART ](https://www.xilinx.com/support/documentation/boards_and_kits/install/ug1033-cp210x-usb-uart-install.pdf).
Para obter mais informações sobre o XSDK, consulte [Conceitos básicos do Xilink SDK](https://www.xilinx.com/html_docs/xilinx2018_2/SDK_Doc/index.html) no site do Xilink.
## Monitoramento de mensagens MQTT na nuvem
Antes de executar o projeto de demonstração do FreeRTOS, você pode configurar o cliente MQTT no console para monitorar AWS IoT as mensagens que seu dispositivo envia para a nuvem. AWS
**Para assinar o tópico do MQTT com o AWS IoT Cliente MQTT**
1. Faça login no [console do AWS IoT](https://console.aws.amazon.com/iotv2/).
1. No painel de navegação, escolha **Teste** e, em seguida, escolha **cliente de teste MQTT** para abrir o cliente MQTT.
1. Em **Tópico de inscrição**, insira **{{your-thing-name}}/example/topic** e selecione **Inscreva-se no tópico**.
## Compilação e execução do projeto de demonstração do FreeRTOS
### Abrir a demonstração do FreeRTOS no IDE do XSDK
1. Inicie o IDE do XSDK com o diretório do workspace definido como `{{freertos}}/projects/xilinx/microzed/xsdk`.
1. Feche a página de boas-vindas. No menu, escolha **Project (Projeto)** e, em seguida, desmarque **Build Automatically (Compilar automaticamente)**.
1. No menu, escolha **File (Arquivo)** e, em seguida, selecione **Import (Importar)**.
1. Na página **Select (Selecionar)**, expanda **General (Geral)**, escolha **Existing Projects into Workspace (Projetos existentes no workspace)** e, em seguida, selecione **Next (Próximo)**.
1. Na página **Importar projetos**, escolha **Selecionar diretório raiz** e insira o diretório raiz do projeto de demonstração: `{{freertos}}/projects/xilinx/microzed/xsdk/aws_demos`. Para navegar até o diretório, escolha **Browse (Navegar)**.
Depois de especificar um diretório raiz, os projetos desse diretório aparecerão na página **Import Projects (Importar projetos)**. Todos os projetos disponíveis são selecionados por padrão.
**nota**
Se houver um aviso no topo da página **Import Projects (Importar projetos)** ("Some projects cannot be imported because they already exist in the workspace." (Alguns projetos não podem ser importados pois já existem no workspace.)) ignore-o.
1. Com todos os projetos selecionados, escolha **Finish (Concluir)**.
1. Se você não vir os projetos `aws_bsp`, `fsbl` e `MicroZed_hw_platform_0` no painel de projetos, repita as etapas anteriores a partir de \#3, mas com o diretório raiz definido como `{{freertos}}/vendors/xilinx`, e importe `aws_bsp`, `fsbl` e `MicroZed_hw_platform_0`.
1. No menu, escolha **Window (Janela)** e, em seguida, selecione **Preferences (Preferências)**.
1. **No painel de navegação, expanda **Run/Debug**, escolha **Substituição de cadeia de caracteres** e, em seguida, escolha Novo.**
1. Em **New String Substitution Variable (Nova variável de substituição de strings)**, para **Name (Nome)**, insira **AFR\_ROOT**. Em **Valor**, insira o caminho raiz do `{{freertos}}/projects/xilinx/microzed/xsdk/aws_demos`. Escolha **OK** e, em seguida, selecione **OK** para salvar a variável e feche as **Preferences (Preferências)**.
### Compilação do projeto de demonstração do FreeRTOS
1. No IDE do XSDK, no menu, escolha **Project (Projeto)** e, em seguida, selecione **Clean (Limpar)**.
1. Em **Clean (Limpar)**, mantenha as opções com os valores padrão e escolha **OK**. O XSDK limpa e compilar todos os projetos e, em seguida, gera arquivos `.elf`.
**nota**
Para compilar todos os projetos sem limpá-los, escolha **Project (Projeto)** e, em seguida, selecione **Build All (Compilar todos)**.
Para compilar projetos individuais, selecione o projeto que deseja compilar, escolha **Project (Projeto)** e selecione **Build Project (Compilar projeto)**.
### Geração de imagem de inicialização do projeto de demonstração do FreeRTOS
1. No IDE do XSDK, clique com o botão direito do mouse em **aws\_demos** e escolha **Create Boot Image (Criar imagem de inicialização)**.
1. Em **Create Boot Image (Criar imagem de inicialização)**, escolha **Create new BIF file (Criar novo arquivo BIF)**.
1. Ao lado de **Output BIF file path (Caminho do arquivo BIF de saída)**, escolha **Browse (Procurar)** e selecione o `aws_demos.bif` localizado em `{{}}/vendors/xilinx/microzed/aws_demos/aws_demos.bif`.
1. Escolha **Adicionar**.
1. Em **Add new boot image partition (Adicionar nova partição da imagem de inicialização)**, ao lado de **File path (Caminho do arquivo)**, escolha **Browse (Navegar)** e, em seguida, selecione `fsbl.elf` localizado em `vendors/xilinx/fsbl/Debug/fsbl.elf`.
1. Para o **Partition type (Tipo de partição)**, escolha **bootloader** e selecione **OK**.
1. Em **Create Boot Image (Criar imagem de inicialização)**, escolha **Create Image (Criar imagem)**. Em **Override Files (Substituir arquivos)**, escolha **OK** para substituir o `aws_demos.bif` existente e gerar o arquivo `BOOT.bin` em `projects/xilinx/microzed/xsdk/aws_demos/BOOT.bin`.
### Depuração do JTAG
1. Configure os jumpers do modo de inicialização da sua MicroZed placa para o modo de inicialização JTAG.
1. Insira o cartão microSD no slot para cartão microSD localizado diretamente abaixo da porta. USB-UART
**nota**
Antes de depurar, faça backup de qualquer conteúdo existente no cartão MicroSD.
A placa deverá ser semelhante à seguinte:
1. No IDE do XSDK, clique com o botão direito do mouse em **aws\_demos**, escolha **Debug As (Depurar como)** e, em seguida, selecione **1 Launch on System Hardware (System Debugger) (1 Iniciar no hardware do sistema (depurador do sistema))**.
1. Quando o depurador parar no ponto de interrupção em `main()`, no menu, escolha **Run (Executar)** e, em seguida, selecione **Resume (Continuar)**.
**nota**
Na primeira vez que você executar a aplicação, um novo par de chave-certificado será importado para a memória não volátil. Para execuções subsequentes, você pode comentar `vDevModeKeyProvisioning()` no arquivo `main.c` antes de compilar novamente as imagens e o arquivo `BOOT.bin`. Isso impede a cópia dos certificados e da chave para armazenamento em cada execução.
Você pode optar por inicializar sua MicroZed placa a partir de um cartão microSD ou do flash QSPI para executar o projeto de demonstração do FreeRTOS. Para obter instruções, consulte [Geração de imagem de inicialização do projeto de demonstração do FreeRTOS](#xilinx-build-boot-image) e [Execução do projeto de demonstração do FreeRTOS](#xilinx-run).
### Execução do projeto de demonstração do FreeRTOS
Para executar o projeto de demonstração do FreeRTOS, você pode inicializar MicroZed sua placa a partir de um cartão microSD ou do flash QSPI.
Ao configurar sua MicroZed placa para executar o projeto de demonstração do FreeRTOS, consulte o diagrama em. [Configurar o MicroZed hardware](#xilinx-setup-hardware) Verifique se você conectou sua MicroZed placa ao computador.
#### Inicialização do projeto do FreeRTOS a partir de um cartão MicroSD
Formate o cartão microSD fornecido com o kit de IoT industrial Xilinx MicroZed.
1. Copie o arquivo `BOOT.bin` para o cartão MicroSD.
1. Insira o cartão no slot do cartão microSD diretamente abaixo da USB-UART porta.
1. Defina os jumpers do modo de MicroZed inicialização para o modo de inicialização SD.
1. Pressione o botão RST para redefinir o dispositivo e começar a inicialização da aplicação. Você também pode desconectar o USB-UART cabo da USB-UART porta e reinserir o cabo.
#### Inicialização do projeto de demonstração do FreeRTOS a partir de QSPI flash
1. Configure os jumpers do modo de inicialização da sua MicroZed placa para o modo de inicialização JTAG.
1. Verifique se o computador está conectado às portas de acesso JTAG USB-UART e JTAG. A luz Power Good LED verde deve estar iluminada.
1. No IDE do XSDK, no menu, escolha **Xilinx** e, em seguida, selecione **Program Flash (Programar flash)**.
1. Em **Program Flash Memory (Programar memória flash)**, a plataforma do hardware deverá ser preenchida automaticamente. Em **Conexão**, escolha seu servidor de MicroZed hardware para conectar sua placa ao computador host.
**nota**
Se estiver usando o cabo Xilinx Smart Lync JTAG, é necessário criar um servidor de hardware no IDE do XSDK. Escolha **New (Novo)** e defina o servidor.
1. Em **Image File (Arquivo de imagem)**, insira o caminho de diretório para o arquivo de imagem `BOOT.bin`. Em vez disso, escolha **Browse (Navegar)** para navegar até o arquivo.
1. Em **Offset (Deslocamento)**, insira **0x0**.
1. Em **FSBL File (Arquivo FSBL)**, insira o caminho de diretório para o arquivo `fsbl.elf`. Em vez disso, escolha **Browse (Navegar)** para navegar até o arquivo.
1. Escolha **Program (Programar)** para programar a placa.
1. Depois que a programação do QSPI estiver concluída, remova o USB-UART cabo para desligar a placa.
1. Configure os jumpers do modo de inicialização da sua MicroZed placa para o modo de inicialização QSPI.
1. Insira o cartão no slot para cartão microSD localizado diretamente abaixo da USB-UART porta.
**nota**
Lembre-se de fazer backup de qualquer conteúdo existente no cartão MicroSD.
1. Pressione o botão RST para redefinir o dispositivo e começar a inicialização da aplicação. Você também pode desconectar o USB-UART cabo da USB-UART porta e reinserir o cabo.
## Solução de problemas
Se você encontrar erros de compilação relacionados a caminhos incorretos, tente limpar e compilar o projeto novamente, conforme descrito em [Compilação do projeto de demonstração do FreeRTOS](#xilinx-freertos-build-project).
Se estiver usando o Windows, lembre-se de usar barras ao definir as variáveis de substituição de strings no IDE do Windows XSDK.
Para obter mais informações sobre soluções de problemas gerais sobre os Conceitos básicos do FreeRTOS, consulte [Solução de problemas de conceitos básicos](gsg-troubleshooting.md).