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 Microchip Curiosity PIC32 MZ EF
**Importante**
Essa integração de referência 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).
**nota**
De acordo com a Microchip, estamos removendo o Curiosity PIC32 MZEF () DM320104 da ramificação principal do repositório de Integração de Referência do FreeRTOS e não o carregaremos mais em novas versões. A Microchip emitiu um [aviso oficial](https://www.microchip.com/DevelopmentTools/ProductDetails/PartNO/DM320104) de que o PIC32 MZEF (DM320104) não é mais recomendado para novos designs. Os projetos e o código-fonte do PIC32 MZEF ainda podem ser acessados por meio das tags de lançamento anteriores. A Microchip recomenda que os clientes usem a [placa de desenvolvimento Curiosity PIC32 MZ-EF-2.0 (](https://devices.amazonaws.com/detail/a3G0h0000077I69EAE/Curiosity-PIC32MZ-EF-2-0-Development-Board)) para novos designs. DM320209 A PIC32 MZv1 plataforma ainda pode ser encontrada na versão [v202012.00 do repositório de integração de referência do](https://github.com/aws/amazon-freertos/tree/202012.00) FreeRTOS. No entanto, não há mais suporte para a plataforma não na versão [v202107.00](https://github.com/aws/amazon-freertos/tree/202107.00) da Referência do FreeRTOS.
Este tutorial fornece instruções para começar a usar o Microchip Curiosity PIC32 MZ EF. [Se você não tiver o pacote Microchip Curiosity PIC32 MZ EF, visite o Catálogo de dispositivos do AWS parceiro para comprar um de nosso parceiro.](https://devices.amazonaws.com/detail/a3G0L00000AANscUAH/Curiosity-PIC32MZ-EF-Amazon-FreeRTOS-Bundle)
O pacote inclui os seguintes itens:
+ [Placa de desenvolvimento do Curiosity PIC32 MZ EF](https://www.microchip.com/Developmenttools/ProductDetails/DM320104)
+ [MikroElectronika Placa de clique USB UART](https://www.mikroe.com/usb-uart-click)
+ [MikroElectronika WiFi 7 cliques em Board](https://www.mikroe.com/wifi-7-click)
+ [PIC32 LAN8720 Placa filha PHY](http://www.microchip.com/DevelopmentTools/ProductDetails.aspx?PartNO=ac320004-3)
Você também precisa os seguintes itens para depuração:
+ [Depurador MPLAB Snap In-Circuit](https://www.microchip.com/Developmenttools/ProductDetails/PG164100)
+ [Kit de PICkit 3 cabos de programação](https://www.microchip.com/TPROG001) (opcional)
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).
**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\$1](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**).
## 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.
1. Interagir com o aplicativo em execução na placa em uma conexão serial para fins de monitoramento e depuração.
## Configurar o hardware Microchip Curiosity PIC32 MZ EF
1. Conecte a placa MikroElectronika USB UART click ao conector MicroBUS 1 no Microchip PIC32 Curiosity MZ EF.
1. Conecte a placa-filha PIC32 LAN8720 PHY ao conector J18 no Microchip Curiosity PIC32 MZ EF.
1. Conecte a placa de clique MikroElectronika USB UART ao seu computador usando um cabo USB A para USB mini-B.
1. Para conectar a placa à Internet, use uma das seguintes opções:
+ Para usar o **Wi-Fi**, conecte a placa de clique MikroElectronika Wi-Fi 7 ao conector MicroBus 2 no Microchip Curiosity PIC32 MZ EF. Consulte [Configuração das demonstrações do FreeRTOS](freertos-prereqs.md#freertos-configure).
+ Para usar a **Ethernet** para conectar a placa Microchip Curiosity PIC32 MZ EF à Internet, conecte a placa-filha PIC32 LAN8720 PHY ao conector J18 no Microchip Curiosity MZ EF. PIC32 Conecte uma extremidade de um cabo Ethernet à placa-filha LAN8720 PHY. Conecte a outra extremidade ao roteador ou outra porta da Internet. Você também deve definir a macro `PIC32_USE_ETHERNET` do pré-processador.
1. Se ainda não tiver feito isso, solde o conector angular ao conector ICSP no Microchip Curiosity PIC32 MZ EF.
1. Conecte uma extremidade do cabo ICSP do kit de PICkit 3 cabos de programação ao Microchip Curiosity PIC32 MZ EF.
Se você não tiver o kit de PICkit 3 cabos de programação, você pode usar jumpers de fio M-F Dupont para conectar a conexão. Observe que o círculo branco indica a posição do Pino 1.
1. Conecte a outra extremidade do cabo ICSP (ou jumpers) ao Depurador MPLAB Snap. O Pino 1 do Conector de programação SIL de 8 pinos está marcado com um triângulo preto na parte inferior direita da placa.
Certifique-se de que qualquer cabeamento para o Pino 1 no Microchip Curiosity PIC32 MZ EF, representado pelo círculo branco, esteja alinhado com o Pino 1 no MPLAB Snap Debugger.
Para obter mais informações sobre o Depurador MPLAB Snap, consulte [Ficha de informações do depurador no circuito MPLAB Snap](http://ww1.microchip.com/downloads/en/DeviceDoc/MPLAB%20Snap%20In-Circuit%20Debugger%20IS%20DS50002787A.pdf).
## Configure o hardware Microchip Curiosity PIC32 MZ EF usando o PICkit On Board (PKOB)
Recomendamos seguir o procedimento de configuração na seção anterior. No entanto, você pode avaliar e executar demonstrações do FreeRTOS com depuração básica usando o On Board PICkit integrado (PKOB) seguindo estas etapas. programmer/debugger
1. Conecte a placa MikroElectronika USB UART click ao conector MicroBUS 1 no Microchip PIC32 Curiosity MZ EF.
1. Para conectar a placa à Internet, siga um destes procedimentos:
+ Para usar o **Wi-Fi**, conecte a placa de clique MikroElectronika Wi-Fi 7 ao conector MicroBus 2 no Microchip Curiosity PIC32 MZ EF. (Siga as etapas em “Como configurar seu Wi-Fi” em [Configuração das demonstrações do FreeRTOS](freertos-prereqs.md#freertos-configure)).
+ Para usar a **Ethernet** para conectar a placa Microchip Curiosity PIC32 MZ EF à Internet, conecte a placa-filha PIC32 LAN8720 PHY ao conector J18 no Microchip Curiosity MZ EF. PIC32 Conecte uma extremidade de um cabo Ethernet à placa-filha LAN8720 PHY. Conecte a outra extremidade ao roteador ou outra porta da Internet. Você também deve definir a macro `PIC32_USE_ETHERNET` do pré-processador.
1. Conecte a porta USB micro-B chamada “USB DEBUG” na placa Microchip Curiosity PIC32 MZ EF ao seu computador usando um cabo USB tipo A para USB micro-B.
1. Conecte a placa de clique MikroElectronika USB UART ao seu computador usando um cabo USB A para USB mini-B.
## Configuração do ambiente de desenvolvimento
**nota**
O projeto do FreeRTOS para esse dispositivo é baseado no MPLAB Harmony v2. Para criar o projeto, você precisa usar versões das ferramentas MPLAB que sejam compatíveis com o Harmony v2, como a v2.10 do XC32 compilador MPLAB e as versões 2.X.X do MPLAB Harmony Configurator (MHC).
1. Instale o [Python versão 3.x](https://www.python.org/downloads/) ou posterior.
1. Instale o MPLAB X IDE:
**nota**
Atualmente, o AWS FreeRTOS Reference Integrations v202007.00 é suportado somente no 3.5. MPLabv5 As versões anteriores das Integrações de Referência do AWS FreeRTOS são suportadas na versão 4.0. MPLabv5
**MPLabv53.5 transferências**
+ [ MPLAB X Integrated Development Environment para Windows](http://ww1.microchip.com/downloads/en/DeviceDoc/MPLABX-v5.35-windows-installer.exe)
+ [ MPLAB X Integrated Development Environment para macOS](http://ww1.microchip.com/downloads/en/DeviceDoc/MPLABX-v5.35-osx-installer.dmg)
+ [ MPLAB X Integrated Development Environment para Linux](http://ww1.microchip.com/downloads/en/DeviceDoc/MPLABX-v5.35-linux-installer.tar)
**MPLab Downloads mais recentes (MPLabv5.40)**
+ [MPLAB X Integrated Development Environment para Windows](http://www.microchip.com/mplabx-ide-windows-installer)
+ [MPLAB X Integrated Development Environment para macOS](http://www.microchip.com/mplabx-ide-osx-installer)
+ [MPLAB X Integrated Development Environment para Linux](http://www.microchip.com/mplabx-ide-linux-installer)
1. Instale o compilador MPLAB XC32 :
+ [Compilador MPLAB XC32 /32\$1\$1 para Windows](http://www.microchip.com/mplabxc32windows)
+ [Compilador MPLAB XC32 /32\$1\$1 para macOS](http://www.microchip.com/mplabxc32osx)
+ [Compilador MPLAB XC32 /32\$1\$1 para Linux](http://www.microchip.com/mplabxc32linux)
1. Inicie um emulador de terminal UART e abra uma conexão com as seguintes configurações:
+ Taxa de baud: 115200
+ Dados: 8 bits
+ Paridade: nenhum
+ Bits de parada: 1
+ Controle de fluxo: nenhum
## 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 MQTT com o cliente AWS IoT 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**.
Quando o projeto de demonstração for executado com êxito em seu dispositivo, você verá "Olá, mundo\$1". enviado várias vezes para o tópico em que você assinou.
## Compilação e execução do projeto de demonstração do FreeRTOS
### Abrir a demonstração do FreeRTOS no IDE do MPLAB
1. Abra o MPLAB IDE. Se você tiver mais de uma versão do compilador instalado, você precisa selecionar o compilador que você deseja usar de dentro do IDE.
1. No menu **File (Arquivo)**, escolha **Open project (Abrir projeto)**.
1. Navegue e abre `projects/microchip/curiosity_pic32mzef/mplab/aws_demos`.
1. Selecione **Open project (Abrir projeto)**.
**nota**
Quando você abre o projeto pela primeira vez, pode aparecer uma mensagem de erro sobre o compilador. No IDE, navegue até **Tools (Ferramentas)**, **Options (Opções)**, **Embedded (Incorporado)** e selecione o compilador que você está usando para seu projeto.
Para usar a Ethernet para se conectar, você deve definir a macro do pré-processador `PIC32_USE_ETHERNET`.
**Como usar Ethernet para se conectar usando o IDE do MPLAB**
1. No IDE do MPLAB, clique com o botão direito do mouse no projeto e escolha **Propriedades**.
1. Na caixa de diálogo **Propriedades do projeto**, escolha ***compiler-name*(Opções globais)** para expandi-la e selecione ***compiler-name*-gcc**.
1. Em **categorias de Opções**, escolha **Pré-processamento e mensagens e**, em seguida, adicione a string `PIC32_USE_ETHERNET` às macros do **pré-processador**.
### Execução do projeto de demonstração do FreeRTOS
1. Compile o projeto novamente.
1. Na guia **Projects (Projetos)**, clique com o botão direito do mouse na pasta de nível superior `aws_demos` e, em seguida, escolha **Debug (Depurar)**.
1. Quando o depurador parar no ponto de interrupção em `main()`, no menu **Run (Executar)**, escolha **Resume (Continuar)**.
### Crie a demonstração do FreeRTOS com CMake
Se você preferir não usar um IDE para o desenvolvimento de Freertos, você pode CMake usar como alternativa para criar e executar os aplicativos de demonstração ou os aplicativos que você desenvolveu usando editores de código e ferramentas de depuração de terceiros.
**Para criar a demonstração do FreeRTOS com CMake**
1. Crie um diretório para conter os arquivos de compilação gerados, como*build-directory*.
1. Use o comando a seguir para gerar arquivos de compilação do código-fonte.
```
cmake -DVENDOR=microchip -DBOARD=curiosity_pic32mzef -DCOMPILER=xc32 -DMCHP_HEXMATE_PATH=path/microchip/mplabx/version/mplab_platform/bin -DAFR_TOOLCHAIN_PATH=path/microchip/xc32/version/bin -S freertos -B build-folder
```
**nota**
Você deve especificar os caminhos corretos para os binários da cadeia de ferramentas e do Hexmate, como os caminhos `C:\Program Files (x86)\Microchip\MPLABX\v5.35\mplab_platform\bin` e `C:\Program Files\Microchip\xc32\v2.40\bin`.
1. Altere os diretórios para o diretório de compilação (*build-directory*) e, em seguida, execute `make` a partir desse diretório.
Para obter mais informações, consulte [Usando CMake com FreeRTOS](getting-started-cmake.md).
Para usar a Ethernet para se conectar, você deve definir a macro do pré-processador `PIC32_USE_ETHERNET`.
## Solução de problemas
Para obter informações sobre a solução de problemas, consulte [Solução de problemas de conceitos básicos](gsg-troubleshooting.md).