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 Kit de desenvolvimento do Cypress CYW943907AEVAL1F **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 Kit de desenvolvimento do Cypress CYW943907AEVAL1F. Se você não tiver o Kit de desenvolvimento Cypress CYW943907AEVAL1F, acesse o AWS Partner Device Catalog para comprar um com nosso [parceiro](https://devices.amazonaws.com/detail/a3G0L00000AAPg0UAH/CYW943907AEVAL1F). **nota** Este tutorial orienta você a como configurar e executar a demonstração da autenticação mútua da coreMQTT. No momento, a porta do FreeRTOS para esta placa não oferece suporte a demonstrações de cliente e servidor de TCP. 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\!](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**). Conforme observado em[Fazer download do FreeRTOS](freertos-prereqs.md#freertos-download), as portas FreeRTOS para Cypress estão atualmente disponíveis apenas no. [ GitHub](https://github.com/aws/amazon-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. 1. Interagir com o aplicativo em execução na placa em uma conexão serial para fins de monitoramento e depuração. ## Configuração do seu ambiente de desenvolvimento ### Download e instalação do SDK WICED Studio Neste Guia de conceitos básicos, use o SDK Cypress WICED Studio para programar sua placa com a demonstração do FreeRTOS. Visite o site do [WICED Software](https://www.cypress.com/products/wiced-software) para baixar o SDK do WICED Studio do Cypress. Você deve se cadastrar para uma conta gratuita do Cypress para baixar o software. O SDK do WICED Studio é compatível com os sistemas operacionais Windows, macOS e Linux. **nota** Alguns sistemas operacionais requerem etapas de instalações adicionais. Leia e siga todas as instruções de instalação para o sistema operacional e versão do WICED Studio que você está instalando. ### Definição de variáveis de ambiente Antes de usar o WICED Studio para programar sua placa, você deve criar uma variável de ambiente para o diretório de instalação do SDK do WICED Studio. Se o WICED Studio estiver sendo executado enquanto você cria as variáveis, você precisará reiniciar o aplicativo depois de definir as variáveis. **nota** O instalador do WICED Studio cria duas pastas separadas chamadas `WICED-Studio-{{m}}.{{n}}` em sua máquina, onde `m` e `n` são os números das versões principal e secundária, respectivamente. Este documento utiliza um nome de pasta `WICED-Studio-6.2`, mas certifique-se de usar o nome correto para a versão que você instalar. Ao definir a variável de ambiente `WICED_STUDIO_SDK_PATH`, especifique o caminho de instalação completo do SDK do WICED Studio, não o caminho de instalação do IDE do WICED Studio. No Windows e no macOS, a pasta `WICED-Studio-{{m}}.{{n}}` para o SDK é criada na pasta `Documents` por padrão. **Para criar a variável de ambiente no Windows** 1. Abra **Control Panel (Painel de controle)**, escolha **System (Sistema)**, e selecione **Advanced System Settings (Configurações avançadas do sistema)**. 1. Na aba **Avançado**, selecione **Variáveis de ambiente**. 1. Em **User variables (Variáveis do usuário)**, escolha **New (Novo)**. 1. Em **Variable name (Nome da variável)**, insira **WICED\_STUDIO\_SDK\_PATH**. Para **Variable value (Valor da variável)**, insira o diretório de instalação do SDK do WICED Studio. **Para criar a variável de ambiente no Linux ou macOS** 1. Abra o arquivo `/etc/profile` em seu computador e adicione a seguinte última linha do arquivo: ``` export WICED_STUDIO_SDK_PATH={{installation-path}}/WICED-Studio-6.2 ``` 1. Reinicie a máquina. 1. Abra um terminal e execute os seguintes comandos: ``` cd {{freertos}}/vendors/cypress/WICED_SDK ``` ``` perl platform_adjust_make.pl ``` ``` chmod +x make ``` ## Estabelecimento de uma conexão serial **Para estabelecer uma conexão em série entre sua máquina host e sua placa** 1. Conecte a placa ao seu computador host com um Micro-B cabo USB Standard-A . 1. Identifique o número da porta serial USB para a conexão à placa em seu computador host. 1. Inicie um terminal serial 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 Para obter mais informações sobre como instalar um terminal e configurar uma conexão serial, consulte [Instalação de um emulador de terminal](gsg-troubleshooting.md#uart-term). ## 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**. ## Compilação e execução do projeto de demonstração do FreeRTOS Depois de configurar uma conexão serial para sua placa, você poderá compilar o projeto de demonstração do FreeRTOS na placa e executar a demonstração. **Para compilar e executar o projeto de demonstração do FreeRTOS no WICED Studio** 1. Inicie o WICED Studio. 1. No menu **File (Arquivo)**, escolha **Import (Importar)**. Expanda a pasta `General`, selecione **Existing Projects into Workspace (Projetos existentes no Workspace)** e escolha **Next (Próximo)**. 1. Em **Select root directory (Selecionar diretório raiz)**, selecione **Browse... (Procurar...)**, navegue até o caminho `{{freertos}}/projects/cypress/CYW943907AEVAL1F/wicedstudio` e selecione **OK**. 1. Em **Projects (Projetos)**, marque a caixa apenas para o projeto **aws\_demo**. Selecione **Finish (Concluir)** para importar o projeto. O projeto de destino **aws\_demo** deve aparecer na janela **Make Target (Tornar destino)**. 1. Expanda o menu **WICED Platform (Plataforma WICED)** e selecione **WICED Filters off (Filtros do WICED desativados)**. 1. Na janela **Tornar destino**, expanda **aws\_demo**, clique com o botão direito do mouse no arquivo `demo.aws_demo` e selecione **Criar destino** e faça download da demonstração para a placa. A demonstração deve ser executada automaticamente após a criação e download dela para a placa. ## Solução de problemas + Se estiver usando o Windows, você pode receber um erro a seguir quando você cria e executa o projeto demo: ``` : recipe for target 'download_dct' failed make.exe[1]: *** [download_dct] Error 1 ``` Para resolver esse erro, faça o seguinte: 1. Navegue até `{{WICED-Studio-SDK-PATH}}\WICED-Studio-6.2\43xxx_Wi-Fi\tools\OpenOCD\Win32` e clique duas vezes em `openocd-all-brcm-libftdi.exe`. 1. Navegue até `{{WICED-Studio-SDK-PATH}}\WICED-Studio-6.2\43xxx_Wi-Fi\tools\drivers\CYW9WCD1EVAL1` e clique duas vezes em `InstallDriver.exe`. + Se estiver usando o Linux ou macOS, você pode receber um erro a seguir quando você cria e executa o projeto demo: ``` make[1]: *** [download_dct] Error 127 ``` Para solucionar esse erro, use o seguinte comando para atualizar o pacote libusb-dev: ``` sudo apt-get install libusb-dev ``` 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).