Introdução ao ESP32 Espressif -WROOM-32SE

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 ligação ou mensagem de texto 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 recursos 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 a 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. Habilite a autenticação multifator (MFA) para o usuário-raiz.

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

Criar um usuário com acesso administrativo

1. Habilita o Centro de Identidade do IAM.

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

2. No Centro de Identidade do IAM, conceda o 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 fazer login com o seu usuário do Centro de Identidade do IAM, use o URL de login enviado ao seu endereço de e-mail quando o usuário do Centro de Identidade do IAM foi criado.

  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 Centro de Identidade do IAM, crie um conjunto de permissões que siga as práticas recomendadas de aplicação de permissões com privilégio mínimo.

   Para obter instruções, consulte Criar um conjunto de permissões 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 Adicionar grupos no Guia do usuário do AWS IAM Identity Center .

1. Para estabelecer uma conexão serial entre sua máquina host e o ESP32 -WROOM-32SE, instale os drivers CP21 0x USB para UART Bridge VCP. Você pode fazer download desses drivers no Silicon Labs.

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ê precisará dela durante a compilação da demonstração.

1. Configure o projeto de demonstração do FreeRTOS seguindo as etapas em Configuração das demonstrações do FreeRTOS. Pule a última etapa Para formatar as credenciais da AWS IoT e siga as etapas abaixo.

2. A Microchip forneceu várias ferramentas de script para ajudar na configuração das peças ATECC6 08A. Navegue até o diretório freertos/vendors/microchip/secure_elements/app/example_trust_chain_tool e abra o arquivo README.md.

3. Siga as instruções no arquivo README.md para provisionar seu dispositivo. As etapas incluem o seguinte:

   1. Crie e registre uma autoridade de certificação com AWS

   2. Gere suas chaves no ATECC6 08A e exporte a chave pública e o número de série do dispositivo

   3. Gere um certificado para o dispositivo e registre esse certificado com AWS

4. Carregar o certificado CA e o certificado de dispositivo no dispositivo seguindo as instruções para Provisionamento de chaves no modo de desenvolvedor.

Para gerar os arquivos de compilação do aplicativo de demonstração com CMake

1. Navegue até a raiz do diretório de downloads do FreeRTOS.

2. Em uma janela de linha de comando, digite o seguinte comando para gerar os arquivos de compilação.

   cmake -DVENDOR=espressif -DBOARD=esp32_plus_ecc608a_devkitc -DCOMPILER=xtensa-esp32 -S . -B your-build-directory

   Observações

   Para criar o aplicativo para depuração, adicione o sinalizador -DCMAKE_BUILD_TYPE=Debug.

   Para gerar os arquivos de compilação do aplicativo de teste, adicione o sinalizador -DAFR_ENABLE_TESTS=1.

   O código fornecido pelo Espressif usa a pilha de IP leve (lwIP) como a pilha de rede padrão. Para usar a pilha de rede FreeRTOS+TCP em vez disso, adicione o sinalizador ao comando. –DAFR_ESP_FREERTOS_TCP CMake

   Para adicionar a dependência do LWIP para código não fornecido pelo fornecedor, adicione as linhas a seguir ao arquivo CMakeLists.txt de dependência,, para seu CMake componente Wi-Fi personalizado.

   # Add a dependency on the bluetooth espressif component to the common component
   set(COMPONENT_REQUIRES lwip)

Para criar o aplicativo com Make

1. Navegue até o diretório build.

2. Em uma janela de linha de comando, digite o seguinte comando para compilar o aplicativo com Make.

   make all -j4

   nota

   Você deve gerar os arquivos de compilação com o comando cmake toda vez que alternar entre o projeto aws_demos e o projeto aws_tests.

Para gerar os arquivos de compilação do aplicativo de demonstração com CMake

1. Navegue até a raiz do diretório de downloads do FreeRTOS.

2. Em uma janela de linha de comando, digite o seguinte comando para gerar os arquivos de compilação.

   cmake -DVENDOR=espressif -DBOARD=esp32_plus_ecc608a_devkitc -DCOMPILER=xtensa-esp32 -GNinja -S . -B your-build-directory

   nota

   Para criar o aplicativo para depuração, adicione o sinalizador -DCMAKE_BUILD_TYPE=Debug.

   Para gerar os arquivos de compilação do aplicativo de teste, adicione o sinalizador -DAFR_ENABLE_TESTS=1.

   O código fornecido pelo Espressif usa a pilha de IP leve (lwIP) como a pilha de rede padrão. Para usar a pilha de rede FreeRTOS+TCP em vez disso, adicione o sinalizador ao comando. –DAFR_ESP_FREERTOS_TCP CMake

   Para adicionar a dependência do LWIP para código não fornecido pelo fornecedor, adicione as linhas a seguir ao arquivo CMakeLists.txt de dependência,, para seu CMake componente Wi-Fi personalizado.

   # Add a dependency on the bluetooth espressif component to the common component
   set(COMPONENT_REQUIRES lwip)

Para o build do aplicativo

1. Navegue até o diretório build.

2. Em uma janela de linha de comando, insira o seguinte comando para invocar o Ninja para compilar o aplicativo.

   ninja

   Ou use a CMake interface genérica para criar o aplicativo.

   cmake --build your-build-directory

   nota

   Você deve gerar os arquivos de compilação com o comando cmake toda vez que alternar entre o projeto aws_demos e o projeto aws_tests.

1. Para estabelecer uma conexão serial entre sua máquina host e o ESP32 -WROOM-32SE, instale os drivers CP21 0x USB para UART Bridge VCP. Você pode fazer download desses drivers no Silicon Labs.

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ê precisará dela durante a compilação da demonstração.

1. Configure o projeto de demonstração do FreeRTOS seguindo as etapas em Configuração das demonstrações do FreeRTOS. Ao chegar à última etapa Para formatar as credenciais da AWS IoT , execute as etapas a seguir.

2. A Microchip forneceu várias ferramentas de script para ajudar na configuração das peças ATECC6 08A. Navegue até o diretório freertos/vendors/microchip/secure_elements/app/example_trust_chain_tool e abra o arquivo README.md.

3. Siga as instruções no arquivo README.md para provisionar seu dispositivo. As etapas incluem o seguinte:

   1. Crie e registre uma autoridade de certificação com AWS

   2. Gere suas chaves no ATECC6 08A e exporte a chave pública e o número de série do dispositivo

   3. Gerar um certificado para o dispositivo e registrar esse certificado na AWS

4. Carregar o certificado CA e o certificado de dispositivo no dispositivo seguindo as instruções para Provisionamento de chaves no modo de desenvolvedor.

Como compilar e instalar o projeto

1. Navegue até a raiz do diretório de downloads do FreeRTOS.

2. Na janela da linha de comando, insira o comando a seguir para adicionar as ferramentas de ESP-IDF ao PATH do seu terminal:

   Windows

   vendors\espressif\esp-idf\export.bat

   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_ecc608a_devkitc -DCOMPILER=xtensa-esp32 build 

   A saída deverá ser parecida com a do exemplo a seguir.

   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

Como compilar e instalar o projeto

1. Em uma janela da linha de comando, navegue até o diretório raiz de downloads do FreeRTOS.

2. Execute o script a seguir para adicionar as ferramentas ESP-IDF ao PATH do shell.

   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_plus_ecc608a_devkitc -DCOMPILER=xtensa-esp32 -S . -B ./YOUR_BUILD_DIRECTORY -DAFR_ENABLE_ALL_MODULES=1 -DAFR_ENABLE_TESTS=0
   

   Com Ninja

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

4. 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 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.