Conceitos básicos do simulador de dispositivo do Windows - FreeRTOS
Configuração do ambiente de desenvolvimentoCompilação e execução do projeto de demonstração do FreeRTOSSolução de problemas

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 simulador de dispositivo do Windows

Importante

Esta é uma versão arquivada do Guia do usuário do FreeRTOS para usar com a versão 202012.00 do FreeRTOS. Para obter a versão mais recente deste documento, consulte o Guia do usuário do FreeRTOS.

Este tutorial fornece instruções para começar a usar o simulador de dispositivos do Windows com o 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. Neste tutorial, o caminho para o diretório de download do FreeRTOS é chamado freertos.

O FreeRTOS é liberado como um arquivo zip que contém as bibliotecas e aplicações de exemplo para a plataforma especificada. Para executar os exemplos em uma máquina Windows, faça download das bibliotecas e dos exemplos migrados para executar no Windows. Esse conjunto de arquivos é conhecido como simulador do FreeRTOS para Windows.

nota

Este tutorial não pode ser executado com sucesso em instâncias EC2 do Amazon Windows.

Configuração do ambiente de desenvolvimento

  1. Instale a versão mais recente do Win PCap.

  2. Instale o Microsoft Visual Studio.

    As versões 2017 e 2019 do Visual Studio funcionam. Todas as edições dessas versões do Visual Studio são compatíveis (Community, Professional ou Enterprise).

    Além do IDE, instale o componente Desktop development with C++ (Desenvolvimento de desktop com C++).

    Instale a versão mais recente do SDK do Windows 10. Você pode escolher isso na seção Optional (Opcional) do componente Desktop development with C++ (Desenvolvimento de desktop com C++).

  3. Verifique se você tem uma conexão Ethernet fixa ativa.

  4. (Opcional) Se você quiser usar o sistema de compilação CMake baseado para criar seus projetos FreeRTOS, instale a versão mais recente do. CMake O FreeRTOS CMake requer a versão 3.13 ou posterior.

Compilação e execução do projeto de demonstração do FreeRTOS

Você pode usar o Visual Studio ou CMake criar projetos do FreeRTOS.

Compilação e execução do projeto de demonstração do FreeRTOS com o IDE do Visual Studio

  1. Carregue o projeto no Visual Studio.

    No Visual Studio, no menu File (Arquivo), escolha Open (Abrir). Escolha File/Solution (Arquivo/solução), navegue até o arquivo projects/pc/windows/visual_studio/aws_demos/aws_demos.sln e escolha Open (Abrir).

  2. Defina um novo destino para o projeto de demonstração.

    O projeto de demonstração fornecido depende do SDK do Windows, mas ele não tem uma versão do SDK do Windows especificada. Por padrão, o IDE pode tentar compilar a demonstração com uma versão do SDK que não está presente em sua máquina. Para definir a versão do SDK do Windows, clique com o botão direito do mouse em aws_demos e escolha Retarget Projects (Definir novos destinos para os projetos). Isso abre a janela Review Solution Actions (Revisar ações de solução). Escolha uma versão do SDK do Windows que esteja presente em sua máquina (o valor inicial na lista suspensa está bom) e escolha OK.

  3. Crie e execute o projeto.

    No menu Build (Criar), escolha Build Solution (Criar solução) e certifique-se de que a solução seja criada sem erros ou avisos. Escolha Debug (Depurar), Start Debugging (Começar a depurar) para executar o projeto. Na primeira execução, será necessário selecionar uma interface de rede.

Construindo e executando o projeto de demonstração do FreeRTOS com CMake

Recomendamos que você use a CMake GUI em vez da ferramenta de CMake linha de comando para criar o projeto de demonstração para o Simulador do Windows.

Depois de instalar CMake, abra a CMake GUI. No Windows, você pode encontrar isso no menu Iniciar CMake, em CMake (cmake-gui).

  1. Defina o diretório de código-fonte do FreeRTOS.

    Na GUI, defina o diretório de código-fonte do FreeRTOS (freertos) como No qual está o código-fonte.

    Defina freertos/build como Where to build the binaries (Onde compilar os binários).

  2. Configure o CMake projeto.

    Na CMake GUI, escolha Adicionar entrada e, na janela Adicionar entrada de cache, defina os seguintes valores:

    Name

    AFR_BOARD

    Tipo

    STRING

    Valor

    pc.windows

    Descrição

    (Opcional)

  3. Selecione Configurar. Se for CMake solicitado que você crie o diretório de compilação, escolha Sim e selecione um gerador em Especificar o gerador para este projeto. Recomendamos usar o Visual Studio como gerador, mas o Ninja também é compatível. (Observe que, ao usar o Visual Studio 2019, a plataforma deve ser definida como Win32, em vez de sua configuração padrão.) Deixe as outras opções de gerador inalteradas e escolha Finish (Concluir).

  4. Gere e abra o CMake projeto.

    Depois de configurar o projeto, a CMake GUI mostra todas as opções disponíveis para o projeto gerado. Para os fins deste tutorial, você pode deixar as opções com seus valores padrão.

    Escolha Generate (Gerar) para criar uma solução do Visual Studio e escolha Open Project (Abrir projeto) para abrir o projeto no Visual Studio.

    No Visual Studio, clique com o botão direito do mouse no aws_demos projeto e escolha Definir como StartUp projeto. Isso permite que você crie e execute o projeto. Na primeira execução, será necessário selecionar uma interface de rede.

Para obter mais informações sobre o uso CMake com FreeRTOS, consulte. Usando CMake com FreeRTOS

Configuração da interface de rede

Na primeira execução do projeto de demonstração, você deve selecionar a interface de rede a ser usada. O programa enumera as interfaces de rede. Encontre o número da interface Ethernet fixa. O resultado deve ser semelhante ao seguinte:

0 0 [None] FreeRTOS_IPInit
1 0 [None] vTaskStartScheduler
1. rpcap://\Device\NPF_{AD01B877-A0C1-4F33-8256-EE1F4480B70D}
(Network adapter 'Intel(R) Ethernet Connection (4) I219-LM' on local host)

2. rpcap://\Device\NPF_{337F7AF9-2520-4667-8EFF-2B575A98B580}
(Network adapter 'Microsoft' on local host)

The interface that will be opened is set by "configNETWORK_INTERFACE_TO_USE", which
should be defined in FreeRTOSConfig.h

ERROR:  configNETWORK_INTERFACE_TO_USE is set to 0, which is an invalid value.
Please set configNETWORK_INTERFACE_TO_USE to one of the interface numbers listed above,
then re-compile and re-start the application.  Only Ethernet (as opposed to Wi-Fi)
interfaces are supported.

Depois de identificar o número da interface Ethernet fixa, feche a janela da aplicação. No exemplo acima, o número a ser usado é 1.

Abra FreeRTOSConfig.h e defina configNETWORK_INTERFACE_TO_USE como o número que corresponde à sua interface de rede fixa.

Importante

Somente interfaces Ethernet são compatíveis. Não há suporte para Wi-Fi. Para obter mais informações, consulte a entrada de WinPcap perguntas frequentes Q-16: Quais adaptadores de rede são compatíveis? WinPcap .

Monitoramento de mensagens MQTT na nuvem

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.

  2. No painel de navegação, escolha Test (Teste) para abrir o cliente MQTT.

  3. Em Tópico de inscrição, insira your-thing-name/example/topic e selecione Inscreva-se no tópico.

Solução de problemas

Solução de problemas comuns no Windows

Você poderá encontrar o seguinte erro ao tentar criar o projeto de demonstração com o Visual Studio:

Error "The Windows SDK version X.Y was not found" when building the provided Visual Studio solution.

O projeto deve ser direcionado a uma versão do SDK do Windows presente no seu computador.

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.