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 Nuvoton 487 NuMaker-IoT-M **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). Este tutorial fornece instruções para começar a usar a placa de desenvolvimento Nuvoton NuMaker-IoT-M 487. O microcontrolador da série inclui módulos RJ45 Ethernet e Wi-Fi integrados. Se você não tiver o Nuvoton NuMaker-IoT-M 487, visite o [Catálogo de dispositivos do AWS parceiro](https://devices.amazonaws.com/detail/a3G0h000000Tg9cEAC/NuMaker-IoT-M487) para comprar um de nosso parceiro. Antes de começar, você deve configurar AWS IoT seu software FreeRTOS para conectar sua placa de desenvolvimento à nuvem. AWS Para 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 orienta você pelas seguintes etapas: 1. Instalar software na máquina host para desenvolver e depurar aplicações incorporadas para a placa do microcontrolador. 1. Fazer a compilação cruzada de uma aplicação 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 ambiente de desenvolvimento A edição Keil MDK Nuvoton foi projetada para desenvolver e depurar aplicações para placas Nuvoton M487. A versão Essential, Plus ou Pro do Keil MDK v5 também deve funcionar para o MCU Nuvoton M487 (núcleo Cortex-M4). Você pode baixar a edição Keil MDK Nuvoton com um desconto no preço da série Nuvoton Cortex-M4. MCUs O Keil MDK só é compatível com o Windows. **Para instalar a ferramenta de desenvolvimento para o NuMaker-IoT-M 487** 1. Faça download da [ Edição Keil MDK Nuvoton](https://store.developer.arm.com/store/embedded-iot-software-tools/keil-mdk-nuvoton-edition?edition=1164) no site do Keil MDK. 1. Instale o Keil MDK em sua máquina host usando sua licença. O Keil MDK inclui o Keil µVision IDE, uma cadeia de ferramentas de compilação C/C\$1\$1 e o depurador µVision. Se você tiver problemas durante a instalação, entre em contato com a [Nuvoton](https://www.nuvoton.com/contact-us) para obter assistência. 1. Instale o**Nu-Link\$1Keil\$1Driver\$1V3.06.7215r** (ou versão mais recente), que está na página [Ferramenta de desenvolvimento do Nuvoton](https://www.nuvoton.com/tool-and-software/ide-and-compiler/). ## Compilação e execução do projeto de demonstração do FreeRTOS **Como compilar o projeto de demonstração do FreeRTOS** 1. Abra o IDE Keil µVision. 1. No menu **File (Arquivo)**, escolha **Open (Abrir)**. Na caixa de diálogo **Open file (Abrir arquivo)**, verifique se o seletor de tipo de arquivo está definido como **Project Files (Arquivos de projeto)**. 1. Escolha o projeto de demonstração Wi-Fi ou Ethernet a ser criado. + Para abrir o projeto de demonstração Wi-Fi, escolha o projeto de destino `aws_demos.uvproj` no diretório `freertos\projects\nuvoton\numaker_iot_m487_wifi\uvision\aws_demos`. + Para abrir o projeto de demonstração Ethernet, escolha o projeto de destino `aws_demos_eth.uvproj` no diretório `freertos\projects\nuvoton\numaker_iot_m487_wifi\uvision\aws_demos_eth`. 1. Para garantir que suas configurações estejam corretas para atualizar a placa, clique com o botão direito do mouse no projeto `aws_demo` no IDE e escolha **Options (Opções)**. (Consulte [Solução de problemas](#gsg-nuvoton-m487-troubleshoot) para obter mais detalhes.) 1. Na guia **Utilities (Utilitários)** verifique se **Use Target Driver for Flash Programming (Usar o driver de destino para programação flash)** está selecionado e se **Nuvoton Nu-Link Debugger (Depurador Nuvoton Nu-Link)** está definido como o driver de destino. 1. Na guia **Debug (Depurar)**, ao lado de **Nuvoton Nu-Link Debugger (Depurador Nuvoton Nu-Link)**, escolha **Settings (Configurações)**. 1. Verifique se **Chip Type (Tipo de chip)** está definido como **M480**. 1. No painel de navegação **Project (Projeto)** do IDE do Keil µVision, escolha o projeto `aws_demos`. No menu **Project (Projeto)**, escolha **Build Target (Compilar destino)**. Você pode usar o cliente MQTT no AWS IoT console para monitorar as mensagens que seu dispositivo envia para a AWS nuvem. **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**. **Como executar o projeto de demonstração do FreeRTOS** 1. Conecte sua placa Numaker-IoT-M 487 à sua máquina host (computador). 1. Recrie o projeto. 1. No Keil µVision IDE, no menu **Flash (Atualizar)** escolha **Download (Fazer download)**. 1. No menu **Debug (Depurar)**, escolha **Start/Stop Debug Session (Iniciar/interromper sessão de depuração)**. 1. Quando o depurador parar no ponto de interrupção em `main()`, abra o menu **Run (Executar)** e escolha **Run (F5) (Executar (F5))**. Você deve ver as mensagens MQTT enviadas pelo seu dispositivo no cliente MQTT no AWS IoT console. ## Usando CMake com FreeRTOS Você também pode usar CMake para criar e executar os aplicativos de demonstração do FreeRTOS ou os aplicativos que você desenvolveu usando editores de código e ferramentas de depuração de terceiros. Verifique se você instalou o sistema de CMake compilação. Siga as instruções em [Usando CMake com FreeRTOS](getting-started-cmake.md) e depois siga as etapas nesta seção. **nota** Certifique-se de que o caminho para o local do compilador (Keil) esteja na variável do sistema Path, por exemplo, `C:\Keil_v5\ARM\ARMCC\bin`. Você também pode usar o cliente MQTT no AWS IoT console para monitorar as mensagens que seu dispositivo envia para a AWS nuvem. **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**. **Para gerar arquivos de compilação a partir de arquivos de origem e executar o projeto de demonstração** 1. Na máquina host, abra o prompt de comando e navegue até a pasta *freertos*. 1. Crie uma pasta para conter os arquivos de compilação gerados. Vamos nos referir a essa pasta como *BUILD\$1FOLDER* o. 1. Gere os arquivos de compilação para a demonstração Wi-Fi ou Ethernet. + Para Wi-Fi: Navegue até o diretório que contém os arquivos de origem do projeto de demonstração do FreeRTOS. Depois, gere os arquivos de compilação executando o seguinte comando. ``` cmake -DVENDOR=nuvoton -DBOARD=numaker_iot_m487_wifi -DCOMPILER=arm-keil -S . -B BUILD_FOLDER -G Ninja ``` + Para Ethernet: Navegue até o diretório que contém os arquivos de origem do projeto de demonstração do FreeRTOS. Depois, gere os arquivos de compilação executando o seguinte comando. ``` cmake -DVENDOR=nuvoton -DBOARD=numaker_iot_m487_wifi -DCOMPILER=arm-keil -DAFR_ENABLE_ETH=1 -S . -B BUILD_FOLDER -G Ninja ``` 1. Gere o binário para refletir no M487 executando o seguinte comando. ``` cmake --build BUILD_FOLDER ``` Nesse ponto, o arquivo binário `aws_demos.bin` deve estar na pasta `BUILD_FOLDER/vendors/Nuvoton/boards/numaker_iot_m487_wifi`. 1. Para configurar a placa para o modo intermitente, certifique-se de que o interruptor MSG (nº 4 do ICE) esteja ISW1 ligado. Quando você conecta a placa, uma janela (e unidade) será atribuída. (Consulte [Solução de problemas](#gsg-nuvoton-m487-troubleshoot).) 1. Abra um emulador de terminal para visualizar as mensagens via UART. Siga as instruções em [Instalação de um emulador de terminal](gsg-troubleshooting.md#uart-term). 1. Execute o projeto de demonstração copiando o binário gerado no dispositivo. Se você se inscreveu no tópico MQTT com o cliente AWS IoT MQTT, deverá ver as mensagens MQTT enviadas pelo seu dispositivo no console. AWS IoT ## Solução de problemas + Se o Windows não reconhecer o dispositivo`VCOM`, instale o driver da porta serial do NuMaker Windows a partir do link [Nu-Link USB Driver v1.6](https://www.nuvoton.com/export/resource-files/Nu-Link_USB_Driver_V1.6.zip). + Se você conectar seu dispositivo ao Keil MDK (IDE) por meio do Nu-Link, certifique-se de que o interruptor MSG (nº 4 do ICE) esteja DESLIGADO, ISW1 conforme mostrado. ![\[Placa de circuito impresso com slot para cartão SD, microcontrolador, conexões e conectores de alimentação e reset identificados.\]](http://docs.aws.amazon.com/pt_br/freertos/latest/userguide/images/nuvoton-m487-gsg.png) Se você tiver problemas para configurar seu ambiente de desenvolvimento ou se conectar à placa, entre em contato com a [Nuvoton](http://www.nuvoton.com/contact-us/). ### Depuração de projetos do FreeRTOS no Keil µVision **Para iniciar uma sessão de depuração no Keil µVision** 1. Abra o Keil µVision. 1. Siga as etapas para compilar o projeto de demonstração do FreeRTOS em [Compilação e execução do projeto de demonstração do FreeRTOS](#gsg-nuvoton-m487-build-run). 1. No menu **Debug (Depurar)**, escolha **Start/Stop Debug Session (Iniciar/interromper sessão de depuração)**. A janela **Call Stack\$1Locals (Chamar pilha\$1locais)** é exibida quando você inicia uma sessão de depuração. O μVision exibe a demonstração na placa, executa a demonstração e para no início da função `main()`. 1. Defina os pontos de interrupção no código-fonte do projeto e execute-o. O projeto deve parecer com algo semelhante ao seguinte: ![\[Arquivo de código-fonte principal com inicialização de hardware, agendamento de tarefas e provisionamento de chaves para um projeto de microcontrolador.\]](http://docs.aws.amazon.com/pt_br/freertos/latest/userguide/images/numaker-iot-m487-debug.png) ### Solução de problemas de configurações de depuração do µVision Se você encontrar problemas ao depurar uma aplicação, verifique se as configurações de depuração estão definidas corretamente no Keil µVision. **Para verificar se as configurações de depuração do µVision estão corretas** 1. Abra o Keil µVision. 1. Clique com o botão direito do mouse no projeto `aws_demo` no IDE e escolha **Options (Opções)**. 1. Na guia **Utilities (Utilitários)** verifique se **Use Target Driver for Flash Programming (Usar o driver de destino para programação flash)** está selecionado e se **Nuvoton Nu-Link Debugger (Depurador Nuvoton Nu-Link)** está definido como o driver de destino. ![\[Janela de opções que exibe as configurações de programação flash, depuração e processamento de arquivos de saída.\]](http://docs.aws.amazon.com/pt_br/freertos/latest/userguide/images/nulink-debugger-target.png) 1. Na guia **Debug (Depurar)**, ao lado de **Nuvoton Nu-Link Debugger (Depurador Nuvoton Nu-Link)**, escolha **Settings (Configurações)**. ![\[Caixa de diálogo de configurações do depurador Nu-Link com opções para versão do driver, versão do ICE, família do dispositivo, ID do dispositivo, porta, clock máximo, tipo de chip, modo de conexão, opção de reinicialização e tensões de controle de energia.\]](http://docs.aws.amazon.com/pt_br/freertos/latest/userguide/images/nulink-driver-setup.png) 1. Verifique se **Chip Type (Tipo de chip)** está definido como **M480**.