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á.
# Introdução ao STMicroelectronics STM32 L4 Discovery Kit IoT Node
**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 o STMicroelectronics STM32 L4 Discovery Kit IoT Node. [Se você ainda não tem o STMicroelectronics STM32 L4 Discovery Kit IoT Node, visite AWS o Catálogo de dispositivos do parceiro para comprar um de nosso parceiro.](https://devices.amazonaws.com/detail/a3G0L00000AANsWUAX/STM32L4-Discovery-Kit-IoT-Node)
Certifique-se de que você tenha instalado o firmware Wi-Fi mais recente. Para baixar o firmware Wi-Fi mais recente, consulte [Kit STM32 L4 Discovery, nó IoT, conexão sem fio de baixa potência, Bluetooth Low Energy, NFC, Sub,](https://www.st.com/resource/en/utilities/inventek_fw_updater.zip) Wi-Fi. GHz Em **Binary Resources (Recursos binários)**, escolha **Inventek ISM 43362 Wi-Fi module firmware update (read the readme file for instructions) (Atualização de firmware do módulo Inventek ISM 43362 Wi-Fi (ler o arquivo readme para obter instruções)) **.
Antes de começar, você deve configurar o AWS IoT download do FreeRTOS e o Wi-Fi 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. 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.
## Configuração do ambiente de desenvolvimento
### Instale o System Workbench para STM32
1. Navegue até [STM32Open.org](http://www.openstm32.org/HomePage).
1. Registre-se na STM32 página do Open. Você precisa fazer login para fazer download do System Workbench.
1. Navegue até o [System Workbench para obter o STM32 instalador](http://www.openstm32.org/System%2BWorkbench%2Bfor%2BSTM32) para baixar e instalar o System Workbench.
Se você tiver problemas durante a instalação, consulte o FAQs [site do System Workbench](http://www.openstm32.org/HomePage).
## Compilação e execução do projeto de demonstração do FreeRTOS
### Importe a demonstração do FreeRTOS para o System Workbench STM32
1. Abra o STM32 System Workbench e insira um nome para um novo espaço de trabalho.
1. No menu **File (Arquivo)**, escolha **Import (Importar)**. Expanda **General (Geral)**, escolha **Existing Projects into Workspace (Projetos existentes no espaço de trabalho)** e, em seguida, **Next (Próximo)**.
1. Em **Select Root Directory (Selecionar diretório raiz)**, digite `projects/st/stm32l475_discovery/ac6/aws_demos`.
1. O projeto `aws_demos` deve ser selecionado por padrão.
1. Escolha **Concluir** para importar o projeto para o STM32 System Workbench.
1. No menu **Project (Projeto)**, escolha **Build All (Criar tudo)**. Confirme se o projeto foi compilado sem erros.
### 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.
### Execução do projeto de demonstração do FreeRTOS
1. Use um cabo USB para conectar seu STMicroelectronics STM32 L4 Discovery Kit IoT Node ao seu computador. (Verifique a documentação do fabricante fornecida com sua placa para saber qual é a porta USB correta a ser usada.)
1. No **Project Explorer**, clique com o botão direito do mouse`aws_demos`, escolha **Depurar como** e escolha Aplicativo **Ac6 STM32 ** C/C\$1\$1.
Se um erro de depuração ocorrer na primeira vez que uma sessão de depuração for iniciada, siga estas etapas:
1. No STM32 System Workbench, no menu **Executar**, escolha Configurações de **depuração**.
1. Escolha **aws\$1demos Debug (Depuração de aws\$1demos)**. (Talvez seja necessário expandir a ** STM32 Depuração Ac6**.)
1. Escolha a guia **Debugger (Depurador)**.
1. Em **Configuration Script (Script de configurações)**, escolha **Show Generator Options (Mostrar opções do gerador)**.
1. Em **Mode Setup (Configuração de modo)**, defina **Reset Mode (Modo de redefinição)** como **Software System Reset (Redefinição do sistema de software)**. Escolha **Apply** e selecione **Debug**.
1. Quando o depurador parar no ponto de interrupção em `main()`, no menu **Run (Executar)**, escolha **Resume (Continuar)**.
### Usando CMake com FreeRTOS
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.
Primeiro, crie uma pasta para conter os arquivos de compilação gerados (*build-folder*).
Use o comando a seguir para gerar os arquivos de compilação:
```
cmake -DVENDOR=st -DBOARD=stm32l475_discovery -DCOMPILER=arm-gcc -S freertos -B build-folder
```
Se não `arm-none-eabi-gcc` estiver no caminho do shell, você também precisará definir a `AFR_TOOLCHAIN_PATH` CMake variável. Por exemplo:
```
-D AFR_TOOLCHAIN_PATH=/home/user/opt/gcc-arm-none-eabi/bin
```
Para obter mais informações sobre o uso CMake com FreeRTOS, consulte. [Usando CMake com FreeRTOS](getting-started-cmake.md)
## Solução de problemas
Se você vir o seguinte na saída UART da aplicação de demonstração, precisará atualizar o firmware do módulo Wi-Fi:
```
[Tmr Svc] WiFi firmware version is: xxxxxxxxxxxxx
[Tmr Svc] [WARN] WiFi firmware needs to be updated.
```
Para baixar o firmware Wi-Fi mais recente, consulte [Kit STM32 L4 Discovery, nó IoT, conexão sem fio de baixa potência, Bluetooth Low Energy, NFC, Sub,](https://www.st.com/resource/en/utilities/inventek_fw_updater.zip) Wi-Fi. GHz Em **Binary Resources (Recursos binários)**, escolha o link de download de **Inventek ISM 43362 Wi-Fi module firmware update (Atualização de firmware do módulo Inventek ISM 43362 Wi-Fi)**.
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).