Introdução ao Espressif ESP32 - DevKit C e ao ESP-WROVER-KIT

Para se inscrever em um Conta da AWS

1. Abra a https://portal.aws.amazon.com/billing/inscrição.

2. Siga as instruções online.

   Parte do procedimento de inscrição envolve receber uma chamada telefônica e inserir um código de verificação no teclado do telefone.

   Quando você se inscreve em um Conta da AWS, um Usuário raiz da conta da AWSé criado. O usuário-raiz tem acesso a todos os Serviços da AWS e atributos na conta. Como prática recomendada de segurança, atribua o acesso administrativo a um usuário e use somente o usuário-raiz para executar tarefas que exigem acesso de usuário-raiz.

Proteja seu Usuário raiz da conta da AWS

1. Faça login AWS Management Consolecomo proprietário da conta escolhendo Usuário raiz e inserindo seu endereço de Conta da AWS e-mail. Na próxima página, insira sua senha.

   Para obter ajuda ao fazer login usando o usuário raiz, consulte Fazer login como usuário raiz no Guia do usuário do Início de Sessão da AWS .

2. Ative a autenticação multifator (MFA) para seu usuário root.

   Para obter instruções, consulte Habilitar um MFA dispositivo virtual para seu usuário Conta da AWS root (console) no Guia IAM do usuário.

Criar um usuário com acesso administrativo

1. Ative o IAM Identity Center.

   Para obter instruções, consulte Habilitar AWS IAM Identity Center no Guia do usuário do AWS IAM Identity Center .

2. No IAM Identity Center, conceda acesso administrativo a um usuário.

   Para ver um tutorial sobre como usar o Diretório do Centro de Identidade do IAM como fonte de identidade, consulte Configurar o acesso do usuário com o padrão Diretório do Centro de Identidade do IAM no Guia AWS IAM Identity Center do usuário.

Iniciar sessão como o usuário com acesso administrativo

• Para entrar com seu usuário do IAM Identity Center, use o login URL que foi enviado ao seu endereço de e-mail quando você criou o usuário do IAM Identity Center.

  Para obter ajuda para fazer login usando um usuário do IAM Identity Center, consulte Como fazer login no portal de AWS acesso no Guia Início de Sessão da AWS do usuário.

Atribuir acesso a usuários adicionais

1. No IAM Identity Center, crie um conjunto de permissões que siga as melhores práticas de aplicação de permissões com privilégios mínimos.

   Para obter instruções, consulte Create a permission set no Guia do usuário do AWS IAM Identity Center .

2. Atribua usuários a um grupo e, em seguida, atribua o acesso de autenticação única ao grupo.

   Para obter instruções, consulte Add groups no Guia do usuário do AWS IAM Identity Center .

1. Configuração de hardware da Espressif.

   • Para obter informações sobre como configurar o hardware da placa de desenvolvimento ESP32 - DevKit C, consulte o Guia de introdução ESP32 - DevKit C V4.

   • Para obter informações sobre como configurar o hardware da placa de ESP-WROVER-KIT desenvolvimento, consulte o Guia de introdução da ESP-WROVER-KIT V4.1.

   Importante

   Ao chegar na seção Começar a usar dos guias do Espressif, pare e retorne para as instruções desta página.

2. Baixe Amazon gratuitamente RTOS em GitHub. (Para obter instruções, consulte o READMEarquivo.md.)

3. Configure o ambiente de desenvolvimento.

   Para se comunicar com sua placa, você deve instalar uma cadeia de ferramentas. A Espressif fornece o ESP - IDF para desenvolver software para suas placas. Como o ESP - IDF tem sua própria versão do Free RTOS Kernel integrada como um componente, o Amazon Free RTOS inclui uma versão personalizada do ESP - IDF v4.2 que tem o Free RTOS Kernel removido. Isso corrige problemas com arquivos duplicados durante a compilação. Para usar a versão personalizada do ESP - IDF v4.2 incluída no Amazon FreeRTOS, siga as instruções abaixo para o sistema operacional da sua máquina host.

   Windows

   1. Baixe ESP - IDF é o Universal Online Installer para Windows.

   2. Execute o Instalador online universal.

   3. Ao chegar à etapa Baixar ou usar ESP - IDF, selecione Usar um IDF diretório existente ESP - e defina Escolher IDF diretório existente ESP - comofreertos/vendors/espressif/esp-idf.

   4. Concluir a instalação.

   macOS

   1. Siga as instruções na Configuração padrão dos pré-requisitos do Toolchain (ESP- IDF v4.2) para macOS.

      Importante

      Ao acessar as instruções “Obter ESP -IDF” em Próximas etapas, pare e retorne às instruções nesta página.

   2. Abra a janela de linha de comando.

   3. Navegue até o diretório de RTOS download gratuito e, em seguida, execute o script a seguir para baixar e instalar o conjunto de ferramentas espressif em sua plataforma.

      vendors/espressif/esp-idf/install.sh

   4. Adicione as IDF ferramentas ESP - toolchain ao caminho do seu terminal com o comando a seguir.

      source vendors/espressif/esp-idf/export.sh

   Linux

   1. Siga as instruções na Configuração padrão dos pré-requisitos do Toolchain (ESP- IDF v4.2) para Linux.

      Importante

      Ao acessar as instruções “Obter ESP -IDF” em Próximas etapas, pare e retorne às instruções nesta página.

   2. Abra a janela de linha de comando.

   3. Navegue até o diretório de RTOS download gratuito e, em seguida, execute o script a seguir para baixar e instalar o conjunto de ferramentas Espressif em sua plataforma.

      vendors/espressif/esp-idf/install.sh

   4. Adicione as IDF ferramentas ESP - toolchain ao caminho do seu terminal com o comando a seguir.

      source vendors/espressif/esp-idf/export.sh

4. Estabelecimento de uma conexão serial.

   1. Para estabelecer uma conexão serial entre sua máquina host e o ESP32 - DevKit C, você deve instalar os VCP drivers CP21 0x USB no UART Bridge. Você pode fazer download desses drivers no Silicon Labs.

      Para estabelecer uma conexão serial entre sua máquina host e o ESP32 - WROVER -KIT, você deve instalar o driver da COM porta FTDI virtual. Você pode baixar esse driver em FTDI.

   2. Siga as etapas para estabelecer uma conexão serial com ESP32.

   3. Depois de estabelecer uma conexão serial, anote a porta serial da conexão de sua placa. Você precisa disso para instalar a demonstração.

1. Se você estiver executando macOS ou Linux, abra um prompt de terminal. Se você estiver executando o Windows, abra o aplicativo "ESP- IDF 4.xCMD" (se você incluiu essa opção ao instalar o conjunto de IDF ferramentas ESP -) ou o aplicativo “Prompt de comando”, caso contrário.

2. Para verificar se você tem o Python3 instalado, execute

   python --version

   A versão instalada é exibida. Se você não tiver o Python 3.0.1 ou posterior instalado, poderá instalá-lo a partir do site do Python.

3. Você precisa da interface de linha de AWS comando (CLI) para executar AWS IoT comandos. Se você estiver executando o Windows, use o easy_install awscli comando para instalar o AWS CLI no aplicativo “Command” ou "ESP- IDF 4.xCMD”.

   Se você estiver executando o macOS ou o Linux, consulte Instalando o. AWS CLI

4. Executar

   aws configure

   e configure-o AWS CLI com seu ID de chave de AWS acesso, chave de acesso secreta e AWS região padrão. Para obter mais informações, consulte Configurando o. AWS CLI

5. Use o comando a seguir para instalar o AWS SDK for Python (boto3):

   • No Windows, no aplicativo “Command” ou "ESP- IDF 4.xCMD", execute

     pip install boto3 --user

     nota

     Consulte os detalhes na documentação do boto3.

   • No macOS ou Linux, execute

     pip install tornado nose --user

     e depois execute

     pip install boto3 --user

   Gratuito RTOS inclui o SetupAWS.py script para facilitar a configuração da sua placa Espressif à qual se conectar. AWS IoT Para configurar o script, abra freertos/tools/aws_config_quick_start/configure.json e defina os seguintes atributos:

   afr_source_dir

   O caminho completo para o diretório freertos no computador. Certifique-se de usar barras para especificar esse caminho.

   thing_name

   O nome que você deseja atribuir à AWS IoT coisa que representa seu quadro.

   wifi_ssid

   O SSID da sua rede Wi-Fi.

   wifi_password

   A senha da rede Wi-Fi.

   wifi_security

   O tipo de segurança da rede Wi-Fi.

   Os tipos de segurança válidos estão a seguir:

   • eWiFiSecurityOpen (Aberto, sem segurança)

   • eWiFiSecurityWEP(WEPsegurança)

   • eWiFiSecurityWPA(WPAsegurança)

   • eWiFiSecurityWPA2(WPA2segurança)

6. Executar o script de configuração.

   1. Se você estiver executando macOS ou Linux, abra um prompt de terminal. Se você estiver executando o Windows, abra o aplicativo "ESP- IDF 4.xCMD" ou “Command”.

   2. Navegue até o diretório freertos/tools/aws_config_quick_start e execute

      python SetupAWS.py setup

      O script faz o seguinte:

      • Cria uma coisa, um certificado e uma política de IoT.

      • Anexa a política de IoT ao certificado e o certificado à coisa do AWS IoT .

      • Preenche o aws_clientcredential.h arquivo com seu AWS IoT endpointSSID, Wi-Fi e credenciais.

      • Formata o certificado e a chave privada e os grava no arquivo de cabeçalho aws_clientcredential_keys.h.

      nota

      O certificado é codificado apenas para fins de demonstração. Por este motivo, as aplicações devem armazenar esses arquivos em um local seguro.

      Para obter mais informações sobre SetupAWS.py, consulte README.md no diretório freertos/tools/aws_config_quick_start.

Para assinar o MQTT tópico com o AWS IoT MQTT cliente

1. Navegue até o console do AWS IoT.

2. No painel de navegação, escolha Teste e, em seguida, escolha Cliente MQTT de teste.

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

Crie e atualize gratuitamente RTOS no Windows, Linux e macOS (ESP- IDF v4.2)

1. Navegue até a raiz do seu diretório de RTOS download gratuito.

2. Em uma janela de linha de comando, digite o seguinte comando para adicionar as IDF ferramentas ESP - às do seu terminalPATH.

   Windows (aplicação "Comando")

   vendors\espressif\esp-idf\export.bat

   Windows (aplicativo” ESP - IDF 4.xCMD”)

   (Isso já foi feito quando você abriu a aplicação.)

   Linux / macOS

   source vendors/espressif/esp-idf/export.sh

3. Configure o cmake no diretório build e compile a imagem do firmware com o comando a seguir.

   idf.py -DVENDOR=espressif -DBOARD=esp32_wrover_kit -DCOMPILER=xtensa-esp32 build

   O resultado deverá ser parecido com o que segue.

      Running cmake in directory /path/to/hello_world/build
      Executing "cmake -G Ninja --warn-uninitialized /path/to/hello_world"...
      Warn about uninitialized values.
      -- Found Git: /usr/bin/git (found version "2.17.0")
      -- Building empty aws_iot component due to configuration
      -- Component names: ...
      -- Component paths: ...
   
      ... (more lines of build system output)
   
      [527/527] Generating hello-world.bin
      esptool.py v2.3.1
   
      Project build complete. To flash, run this command:
      ../../../components/esptool_py/esptool/esptool.py -p (PORT) -b 921600 write_flash --flash_mode dio --flash_size detect --flash_freq 40m 0x10000 build/hello-world.bin  build 0x1000 build/bootloader/bootloader.bin 0x8000 build/partition_table/partition-table.bin
      or run 'idf.py -p PORT flash' 

   Se não houver erros, a compilação gerará os arquivos .bin binários do firmware.

4. Apague a memória instalada da placa de desenvolvimento com o comando a seguir.

   idf.py erase_flash

5. Use o script idf.py para instalar o binário da aplicação na placa.

   idf.py flash

6. Monitore a saída da porta serial da placa com o comando a seguir.

   idf.py monitor

   nota

   Você pode combinar esses comandos, como no exemplo a seguir.

   idf.py erase_flash flash monitor

   Para determinadas configurações da máquina host, você deve especificar a porta ao instalar a placa, como no exemplo a seguir.

   idf.py erase_flash flash monitor -p /dev/ttyUSB1

Como compilar e instalar o projeto

1. Em uma janela de linha de comando, navegue até a raiz do seu diretório de RTOS download gratuito.

2. Execute o script a seguir para adicionar as IDF ferramentas ESP - ao seu shellPATH.

   Windows

   vendors\espressif\esp-idf\export.bat

   Linux / macOS

   source vendors/espressif/esp-idf/export.sh

3. Insira o comando a seguir para gerar os arquivos de compilação.

   Com Makefiles da Unix

   cmake -DVENDOR=espressif -DBOARD=esp32_wrover_kit -DCOMPILER=xtensa-esp32 -S . -B ./YOUR_BUILD_DIRECTORY -DAFR_ENABLE_ALL_MODULES=1 -DAFR_ENABLE_TESTS=0

   Com Ninja

   cmake -DVENDOR=espressif -DBOARD=esp32_wrover_kit -DCOMPILER=xtensa-esp32 -S . -B ./YOUR_BUILD_DIRECTORY -DAFR_ENABLE_ALL_MODULES=1 -DAFR_ENABLE_TESTS=0 -GNinja

4. Crie o projeto.

   Com Makefiles da Unix

   make -C ./YOUR_BUILD_DIRECTORY -j8 

   Com Ninja

   ninja -C ./YOUR_BUILD_DIRECTORY -j8

5. Apague a instalada e depois instale a placa.

   Com Makefiles da Unix

   make -C ./YOUR_BUILD_DIRECTORY erase_flash

   make -C ./YOUR_BUILD_DIRECTORY flash

   Com Ninja

   ninja -C ./YOUR_BUILD_DIRECTORY erase_flash

   ninja -C ./YOUR_BUILD_DIRECTORY flash

Para configurar o aplicativo de SDK demonstração móvel gratuito RTOS Bluetooth Low Energy

1. Siga as instruções SDKs móveis para dispositivos Bluetooth do FreeRTOS para baixar e instalar o SDK para sua plataforma móvel em seu computador host.

2. Siga as instruções em aplicação de demonstração do SDK móvel de Bluetooth Low Energy do FreeRTOS para configurar a aplicação móvel de demonstração no dispositivo móvel.