ESP8266 PlatformIO

O PlatformIO

O ambiente de desenvolvimento recomendado pelo fabricante Expressif é o PlatformIO que facilita a criar e manter os projetos provendo scripts para automatizar as tarefas de desenvolvimento e também provê recursos para agilizar a codificação.

O link para o PlatformIO é https://github.com/platformio/platform-espressif8266/tree/master

Este tutorial está baseado no tutorial de https://docs.platformio.org/en/latest/ide/vscode.html#quick-start

Link para SDKs e Demos da Espressif https://www.espressif.com/en/products/hardware/esp8266ex/resources

Instalação do VSCode

O PlatformIO atualmente é implementado em cima do VSCode como extensão.

Para configurar PlatformIO no Windows, temos que instalar o editor de textos VSCode que pode ser baixado no site https://code.visualstudio.com/.

Na página principal, temos o botão "Download" para baixar a versão compatível com o seu sistema operacional (o site detecta o seu sistema operacional automaticamente). Basta baixar e instalar como qualquer outro aplicativo simples. Pronto!!! Seu VSCode está instalado.

Instalação alternativa

Apesar da página principal, temos a página de download para prover diferentes instaladores do Windows. Verificamos que há versão do VSCode em arquivos *.zip que é um aplicativo que pode ser instalado apenas descompactando o arquivo instalador em um diretório específico. Este é o meu modo preferido pois eu gosto muito de poder ter um ambiente de desenvolvimento completo guardado em um diretório, dentro da própria pasta de cada projeto. Assim, se no futuro eu tiver que voltar a dar manutenção neste projeto, já tenho o ambiente correto disponível em poucos minutos. Além de poder guardar a versão exata do ambiente em que o projeto é desenvolvido, o VSCode não interferirá no funcionamento normal do Sistema Operacional enquanto não estiver sendo utilizado e não provocará problemas irreversíveis.

Para baixar a versão compactada ao invés do instalador, basta seguir o link "Other platforms", que no caso atual está apontando para os arquivos da versão estável.

Baixe o .zip para 32 bits ou para 64 bits. Crie um diretório para conter o VSCode, no meu caso ficou dentro de C:\PortableApps\OtherApps\VSCode\VSCode-1.30.2-64

Salve e descompacte o arquivo baixado dentro da pasta e execute o arquivo Code.exe

O seu VSCode está instalado!!!

Instalação do PlatformIO no VSCode

As instruções no site do PlatformIO, as instruções são simples (orientem-se pela figura abaixo):

1. Na barra lateral, clique no ícone Extensions (Crtl+Shift+X);
2. Na barra de pesquisa, entre com a palavra "platformio-ide";
3. No conteúdo apresentado após a pesquisa, clique no botão "Install", referente ao PlatformIO IDE;
4. Após um tempo, vai perceber que no sino, embaixo a direita, há uma notificação solicitando para reiniciar o VSCode (Restart the window);
5. Ao reiniciar, será adicionado o ícone do PlatformIO embaixo do ícone do Extensions.

Pronto!!! PlatformIO instalado.

Agora, recomenda-se consultar o guia de início rápido (inglês) para ter um ótima referência.

No meu caso, eu já tinha uma versão do PlatformIO instalado quando usei na IDE Atom e ao abrir o VSCode pela primeira vez, o PlatformIO já se instalou sozinho automaticamente.

Primeiro, ele instalou a extensão C/C++. Segue o log abaixo:

June 2018 Update

Thank you for installing the C/C++ extension. In the June update, we focused on workspace configuration improvements.

We dramatically improved the performance of recursive includes (e.g. using ${workspaceFolder}/** in your includePath), we will prompt you to use compile_commands.json if it is found in your workspace, and we made the browse.path setting optional in the case that it is identical to your includePath.

Depois na aba Outputs, apareceu o seguinte log:

Installing PlatformIO Core...

Please do not close this window and do not open other folders until this process is completed.

PlatformIO IDE installed successfully.

Instalação do MSYS2

1. Consultar a página da Espressif https://docs.espressif.com/projects/esp-idf/en/latest/get-started/windows-setup.html e baixar o instalador do MSYS2 no link desta página: https://dl.espressif.com/dl/esp32_win32_msys2_environment_and_toolchain-20181001.zip.
2. Descompactar e salvar em C:\.
3. Rodar o mingw32.exe para entrar no ambiente do ming.
4. Criar o diretório esp: mkdir -p ~/esp e ir para dentro dela: cd esp.
5. Verifique qual é o último release do esp-dif em https://github.com/espressif/esp-idf/releases
6. Baixar o esp-idf com o comando: git clone -b v3.1.3 --recursive https://github.com/espressif/esp-idf.git.
7. Encerrar o ambiente com o comando: exit.
8. Criar em C:/msys32/etc/profile.d/ o arquivo export_idf_path.sh. Escrever: export IDF_PATH="C:\msys32\home\<usuario>\esp\esp-idf" e salvar.
9. Rodar o mingw32.exe e testar usando o comando: printenv IDF_PATH.
10. Verificar a versão do phyton: python --version.
11. Execute o comando para atualizar: python -m pip install --upgrade pip
12. ==> pacman -R catgets
13. ==> pacman -R libcatgets
14. ==> $IDF_PATH/tools/windows/windows_install_prerequisites.sh
15. ?==> pacman -Syu
16. ?==> pacman -Su
17. Executar o comando: python2.7 -m pip install --user -r $IDF_PATH/requirements.txt. Pode haver problemas com a versão do pip, então,
18. Copie o projeto exemplo hello_world de C:\msys32\home\<usuario>\esp\esp-idf\examples\get-started para C:\msys32\home\<usuario>\esp
19. Dentro da pasta do projeto: cd ~/esp/hello_world, execute o comando: make menuconfig Config Serial. Ao sair do aplicativo do menu, espere a execução do script de instalação de pendências.
20. Execute o comando: make flash