Ferramenta de linha de comando multiplataforma e sistema de build para desenvolvimento embarcado, com gerenciamento de bibliotecas, suporte a várias placas e frameworks, depuração e testes unitários.
espressif/esp-idf
Framework oficial de desenvolvimento da Espressif para criar firmware para ESP32 e outros SoCs da Espressif no Windows, Linux e macOS.
- Estrelas
- 19,453
- Forks
- 8,586
- Issues abertas
- 1,807
- Último commit
- há 20 horas
O que é?
O ESP-IDF é o framework oficial de desenvolvimento para os microcontroladores system-on-chip (SoC) da Espressif, usado para escrever, configurar, compilar e gravar firmware em dispositivos IoT. Ele roda no Windows, Linux e macOS e oferece a toolchain, as bibliotecas e o sistema de build necessários para desenvolver aplicações para os chips compatíveis.
Os desenvolvedores trabalham com a ferramenta de linha de comando idf.py. Entre as etapas mais comuns estão selecionar o chip de destino com set-target, ajustar opções no menuconfig em modo texto, compilar o app, o bootloader e a tabela de partições com build e gravar o dispositivo pela porta serial com flash. O comando idf.py monitor exibe a saída serial e pode decodificar crash dumps.
O repositório inclui projetos de exemplo no diretório examples, e há um template de projeto disponível separadamente. Cada série de SoC e cada versão têm sua própria documentação, e o ESP8266 é abordado em um RTOS SDK separado.
Recursos principais
- 01Compila a aplicação, o bootloader e a tabela de partições com um único comando idf.py build.
- 02Oferece o menuconfig para configurar projetos de forma interativa.
- 03Grava firmware pela porta serial e monitora a saída do dispositivo.
- 04Inclui projetos de exemplo para os chips Espressif compatíveis.
- 05Roda no Windows, Linux e macOS, com scripts de instalação e exportação.
Casos de uso
- Desenvolvimento de firmware para dispositivos IoT com Wi-Fi e Bluetooth da série ESP32.
- Prototipagem de aplicações embarcadas em placas de desenvolvimento Espressif.
- Compilação e gravação de firmware atualizável via OTA com tabelas de partições.
Início rápido
- 1
Configure o ambiente de compilação com o script de instalação do seu shell
./install.sh - 2
Carregue o ambiente em cada shell antes de usar o ESP-IDF
source export.sh - 3
Defina o chip de destino e compile o projeto
idf.py set-target <chip_name> && idf.py build - 4
Grave o firmware na placa e abra o monitor serial
idf.py -p PORT flash monitor
Antes de usar
- A configuração exige instalar as dependências de compilação do host e executar o script de instalação primeiro.
- Não oferece suporte ao ESP8266 nem ao ESP8285, que usam um SDK RTOS separado.
Em coleções
Tópicos
Perguntas frequentes
- O que é esp-idf?
- Framework oficial de desenvolvimento da Espressif para criar firmware para ESP32 e outros SoCs da Espressif no Windows, Linux e macOS. O ESP-IDF é o framework oficial de desenvolvimento para os microcontroladores system-on-chip (SoC) da Espressif, usado para escrever, configurar, compilar e gravar firmware em dispositivos IoT. Ele roda no Windows, Linux e macOS e oferece a toolchain, as bibliotecas e o sistema de build necessários para desenvolver aplicações para os chips compatíveis.
- esp-idf é gratuito? Qual é a licença?
- esp-idf é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
- esp-idf ainda é mantido?
- Manutenção ativa. O último commit de esp-idf foi em 6 de nov. de 2026.
- Para que posso usar esp-idf?
- Desenvolvimento de firmware para dispositivos IoT com Wi-Fi e Bluetooth da série ESP32. Prototipagem de aplicações embarcadas em placas de desenvolvimento Espressif. Compilação e gravação de firmware atualizável via OTA com tabelas de partições.
- Como instalar esp-idf?
- Configure o ambiente de compilação com o script de instalação do seu shell: ./install.sh Carregue o ambiente em cada shell antes de usar o ESP-IDF: source export.sh Defina o chip de destino e compile o projeto: idf.py set-target <chip_name> && idf.py build Grave o firmware na placa e abra o monitor serial: idf.py -p PORT flash monitor
- Onde consigo esp-idf?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/espressif/esp-idf
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Uma implementação enxuta de Python 3 que roda em microcontroladores e outros dispositivos com recursos limitados, com módulos para acesso ao hardware.
Firmware open source para ESP32 que controla fitas de LED RGB endereçáveis, matrizes 2D e painéis HUB75 via Wi-Fi.
Firmware alternativo para placas ESP8266 e ESP32, com configuração via web, atualizações OTA, automação local e controle por MQTT, HTTP, Serial ou KNX.
SDKs e firmware open source para criar seus próprios gadgets Muse em placas ESP32 e dispositivos Linux, como o Raspberry Pi.
Um emulador open source de ESP32 em Rust que executa firmware real no computador ou no navegador, sem precisar de hardware.