Guia aberto · Runtime
ESP32 no Windows: instalar o Runtime com WSL2
Instale o bundle ESP32 em um computador Windows usando WSL2 e Docker Desktop, sem configurar Runner manualmente.
- 01Prepare WSL2 e habilite a integração da distribuição Ubuntu no Docker Desktop.
- 02Valide o checksum do bundle, extraia-o no disco Linux e execute o instalador com o perfil esp32.
- 03Cadastre o administrador local, importe a licença e conecte a placa por USB somente quando for gravar.
1. Preparar Windows e WSL2
Abra o PowerShell como Administrador. Instale o Ubuntu apenas se WSL2 ainda não estiver disponível. Após concluir, abra o aplicativo Ubuntu pelo Menu Iniciar e crie o usuário Linux.
wsl --install -d Ubuntu-24.04
wsl --status2. Habilitar Docker Desktop
Instale e inicie o Docker Desktop. Em Settings > Resources > WSL Integration, habilite Ubuntu-24.04 e aplique as alterações. No terminal Ubuntu, confirme que o daemon está acessível.
docker info
docker compose version
sudo apt update
sudo apt install -y ca-certificates curl openssl tar git3. Validar o bundle baixado
No PowerShell, compare o valor SHA-256 com o checksum exibido no Download Center. Não prossiga se forem diferentes.
Get-FileHash "$env:USERPROFILE\Downloads\firmwareops-runtime_<versao>_linux_amd64_esp32.tar.gz" -Algorithm SHA2564. Extrair e instalar o perfil ESP32
Copie o arquivo para o disco Linux antes de extrair. Substitua <usuario-windows>, <versao> e o e-mail pelo seu ambiente. Não use sudo para instalar o Runtime.
mkdir -p ~/Downloads/firmwareops
cp /mnt/c/Users/<usuario-windows>/Downloads/firmwareops-runtime_<versao>_linux_amd64_esp32.tar.gz ~/Downloads/firmwareops/
cd ~/Downloads/firmwareops
tar -xzf firmwareops-runtime_<versao>_linux_amd64_esp32.tar.gz
cd firmwareops-runtime_*
./install.sh --admin-email voce@empresa.com --targets esp325. Primeiro acesso e licença
Ao terminar, abra http://localhost:5173 no navegador Windows. Cadastre o administrador local usando o mesmo e-mail informado acima. Importe uma licença assinada na aba License antes de usar Gateway e flash.
export PATH="$HOME/.local/bin:$PATH"
firmwareops status
firmwareops doctor6. Conectar USB quando for usar a placa
Apenas para Hardware Lab e flash. No PowerShell como Administrador, instale usbipd-win, use o BUSID atual da placa e anexe-a ao WSL. Após reconectar a placa ou reiniciar o Windows, faça o attach novamente.
winget install --interactive --exact dorssel.usbipd-win
usbipd list
$esp32BusId = "2-2"
usbipd bind --busid $esp32BusId
usbipd attach --wsl --busid $esp32BusIdOs comandos detalhados de cada fluxo permanecem versionados junto ao Runtime para evitar instruções divergentes.