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 Nó de IoT do kit STMicroelectronics STM32L4 Discovery
**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 Nó de IoT do kit STMicroelectronics STM32L4 Discovery. [Se você ainda não tem o nó IoT do kit STMicroelectronics STM32L4 Discovery, visite o Catálogo de dispositivos AWS do parceiro para comprar um de nosso parceiro.](https://devices.amazonaws.com/detail/a3G0L00000AANsWUAX/STM32L4-Discovery-Kit-IoT-Node)
Verifique se você instalou o Wi-Fi firmware mais recente. Para baixar o Wi-Fi firmware mais recente, consulte [Nó IoT do kit STM32L4 Discovery, sem fio de baixa potência, Bluetooth Low Energy, NFC, subGHz,](https://www.st.com/resource/en/utilities/inventek_fw_updater.zip). Wi-Fi Em **Recursos binários**, escolha **Atualização do firmware do Wi-Fi módulo Inventek ISM 43362 (leia o arquivo readme para obter instruções**).
Antes de começar, você deve configurar AWS IoT seus Freertos baixados Wi-Fi e 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
### Instalar o System Workbench para STM32
1. Navegue para [OpenSTM32.org](http://www.openstm32.org/HomePage).
1. Registre-se na página da Web do OpenSTM32. Você precisa fazer login para fazer download do System Workbench.
1. Navegue até o [instalador do System Workbench para STM32](http://www.openstm32.org/System%2BWorkbench%2Bfor%2BSTM32) para fazer download e instalar o System Workbench.
Se você tiver problemas durante a instalação, consulte as perguntas frequentes no [site do System Workbench](http://www.openstm32.org/HomePage).
## Compilação e execução do projeto de demonstração do FreeRTOS
### Importação da demonstração do FreeRTOS para o STM32 System Workbench
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 **Finish (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 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**.
Quando o projeto de demonstração for executado com êxito em seu dispositivo, você verá "Olá, mundo\!". 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 o Nó de IoT do kit STMicroelectronics STM32L4 Discovery ao 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 C/C STM32** \+\+.
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 **Run (Executar)**, escolha **Debug Configurations (Configurações de depuração)**.
1. Escolha **aws\_demos Debug (Depuração de aws\_demos)**. Você talvez precise expandir **Ac6 STM32 Debugging (Depuração de Ac6 STM32)**.
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)**.
### Uso da CMake com o FreeRTOS
Se você preferir não usar um IDE para desenvolvimento do FreeRTOS, também é possível usar o CMake para compilar e executar as aplicações de demonstração ou aplicações 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 `arm-none-eabi-gcc` não estiver no caminho do shell, você também precisará definir a variável `AFR_TOOLCHAIN_PATH` CMake. Por exemplo:
```
-D AFR_TOOLCHAIN_PATH=/home/user/opt/gcc-arm-none-eabi/bin
```
Para obter mais informações sobre o uso do CMake com o FreeRTOS, consulte [Uso da CMake com o FreeRTOS](getting-started-cmake.md).
## Solução de problemas
Se você ver o seguinte na saída UART do aplicativo de demonstração, precisará atualizar o firmware do Wi-Fi módulo:
```
[Tmr Svc] WiFi firmware version is: xxxxxxxxxxxxx
[Tmr Svc] [WARN] WiFi firmware needs to be updated.
```
Para baixar o Wi-Fi firmware mais recente, consulte [Nó IoT do kit STM32L4 Discovery, sem fio de baixa potência, Bluetooth Low Energy, NFC, subGHz,](https://www.st.com/resource/en/utilities/inventek_fw_updater.zip). Wi-Fi Em **Recursos binários**, escolha o link de download para a atualização do firmware do ** Wi-Fi módulo Inventek ISM 43362**.
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).