ESP-Prog

ESP-Prog is one of Espressif’s development and debugging tools, with functions including automatic firmware downloading, serial communication, and JTAG online debugging. ESP-Prog’s automatic firmware downloading and serial communication functions are supported on both the ESP8266 and ESP32 platforms, while the JTAG online debugging is supported only on the ESP32 platform. Official reference can be found here.

Configuration

You can configure debugging tool using debug_tool option in “platformio.ini” (Project Configuration File):

[env:myenv]
platform = ...
board = ...
debug_tool = esp-prog

If you would like to use this tool for firmware uploading, please change upload protocol:

[env:myenv]
platform = ...
board = ...
debug_tool = esp-prog
upload_protocol = esp-prog

More options:

• Debugging options

• Upload options

Drivers

Windows

• Step-by-step guide: Drivers, Zadig, Wiring

• Video tutorial

Mac

macOS contains default FTDIUSBSerialDriver driver which conflicts with debug tools which are based on this chip. FTDI Chip company recommends removing this default driver from a system. Everything should work after system rebooting. See detailed instruction in official application note (Page 16, Section 4: Uninstalling FTDI Drivers on OS X) AN134: FTDI Drivers Installation guide for MAC OS X

Linux

Please install “udev” rules 99-platformio-udev.rules. If you already installed them before, please check that your rules are up-to-date or repeat steps.

Wiring Connections

ESP-Prog JTAG 10-Pin Connector	Board JTAG Pin	Description
1	VDD	Positive Supply Voltage — Power supply for JTAG interface drivers
3	GND	Digital ground
2	ESP_TMS	Test Mode State
4	ESP_TCK	JTAG Return Test Clock
6	ESP_TDO	Test Data Out
8	ESP_TDI	Test Data In

Tutorials

• Use the PlatformIO Debugger on the ESP32 Using an ESP-prog

Platforms

Name	Description
Espressif 32	Espressif Systems is a privately held fabless semiconductor company. They provide wireless communications and Wi-Fi chips which are widely used in mobile devices and the Internet of Things applications.

Frameworks

Name	Description
Arduino	Arduino Wiring-based Framework allows writing cross-platform software to control devices attached to a wide range of Arduino boards to create all kinds of creative coding, interactive objects, spaces or physical experiences
Espressif IoT Development Framework	ESP-IDF is the official development framework for the ESP32 and ESP32-S Series SoCs.
Simba	Simba is an RTOS and build framework with aims to make embedded programming easy and portable

Boards

Note

For more detailed board information please scroll tables below by horizontal.

Name	Platform	Debug	MCU	Frequency	Flash	RAM
AI Thinker ESP32-CAM	Espressif 32	External	ESP32	240MHz	4MB	320KB
ALKS ESP32	Espressif 32	External	ESP32	240MHz	4MB	320KB
AZ-Delivery ESP-32 Dev Kit C V4	Espressif 32	External	ESP32	240MHz	16MB	520KB
Adafruit ESP32 Feather	Espressif 32	External	ESP32	240MHz	4MB	320KB
Adafruit ESP32-S2 Feather Development Board	Espressif 32	External	ESP32S2	240MHz	4MB	320KB
Briki ABC (MBC-WB) - ESP32	Espressif 32	External	ESP32	240MHz	3.25MB	320KB
Briki MBC-WB - ESP32	Espressif 32	External	ESP32	240MHz	3.25MB	320KB
D-duino-32	Espressif 32	External	ESP32	240MHz	4MB	320KB
DOIT ESP32 DEVKIT V1	Espressif 32	External	ESP32	240MHz	4MB	320KB
DOIT ESPduino32	Espressif 32	External	ESP32	240MHz	4MB	320KB
Dongsen Tech Pocket 32	Espressif 32	External	ESP32	240MHz	4MB	320KB
ESP32 FM DevKit	Espressif 32	External	ESP32	240MHz	4MB	320KB
ESP32 Pico Kit	Espressif 32	External	ESP32	240MHz	4MB	320KB
ESP32vn IoT Uno	Espressif 32	External	ESP32	240MHz	4MB	320KB
ESPectro32	Espressif 32	External	ESP32	240MHz	4MB	320KB
ESPino32	Espressif 32	External	ESP32	240MHz	4MB	320KB
Espressif ESP-WROVER-KIT	Espressif 32	On-board	ESP32	240MHz	4MB	320KB
Espressif ESP32 Dev Module	Espressif 32	External	ESP32	240MHz	4MB	320KB
Espressif ESP32-C3-DevKitM-1	Espressif 32	External	ESP32C3	160MHz	4MB	320KB
Espressif ESP32-S2-Kaluga-1 Kit	Espressif 32	External	ESP32S2	240MHz	4MB	320KB
Espressif ESP32-S2-Saola-1	Espressif 32	External	ESP32S2	240MHz	4MB	320KB
FireBeetle-ESP32	Espressif 32	External	ESP32	240MHz	4MB	320KB
Frog Board ESP32	Espressif 32	External	ESP32	240MHz	4MB	320KB
HONEYLemon	Espressif 32	External	ESP32	240MHz	4MB	320KB
Heltec WiFi LoRa 32	Espressif 32	External	ESP32	240MHz	4MB	320KB
Heltec WiFi LoRa 32 (V2)	Espressif 32	External	ESP32	240MHz	8MB	320KB
Heltec Wireless Stick	Espressif 32	External	ESP32	240MHz	8MB	320KB
Hornbill ESP32 Dev	Espressif 32	External	ESP32	240MHz	4MB	320KB
Hornbill ESP32 Minima	Espressif 32	External	ESP32	240MHz	4MB	320KB
IoTaaP Magnolia	Espressif 32	External	ESP32	240MHz	4MB	320KB
LOGISENSES Senses Weizen	Espressif 32	External	ESP32	240MHz	4MB	320KB
MH ET LIVE ESP32DevKIT	Espressif 32	External	ESP32	240MHz	4MB	320KB
MH ET LIVE ESP32MiniKit	Espressif 32	External	ESP32	240MHz	4MB	320KB
Node32s	Espressif 32	External	ESP32	240MHz	4MB	320KB
NodeMCU-32S	Espressif 32	External	ESP32	240MHz	4MB	320KB
OLIMEX ESP32-DevKit-LiPo	Espressif 32	External	ESP32	240MHz	4MB	320KB
OLIMEX ESP32-EVB	Espressif 32	External	ESP32	240MHz	4MB	320KB
OLIMEX ESP32-GATEWAY	Espressif 32	External	ESP32	240MHz	4MB	320KB
Pycom LoPy	Espressif 32	External	ESP32	240MHz	4MB	320KB
Pycom LoPy4	Espressif 32	External	ESP32	240MHz	4MB	1.25MB
SG-O AirMon	Espressif 32	External	ESP32	240MHz	4MB	320KB
Silicognition wESP32	Espressif 32	External	ESP32	240MHz	4MB	320KB
SparkFun ESP32 Thing	Espressif 32	External	ESP32	240MHz	4MB	320KB
SparkFun ESP32 Thing Plus	Espressif 32	External	ESP32	240MHz	16MB	320KB
SparkFun LoRa Gateway 1-Channel	Espressif 32	External	ESP32	240MHz	4MB	320KB
TTGO LoRa32-OLED V1	Espressif 32	External	ESP32	240MHz	4MB	320KB
TTGO LoRa32-OLED V2	Espressif 32	External	ESP32	240MHz	4MB	320KB
TTGO LoRa32-OLED v2.1.6	Espressif 32	External	ESP32	240MHz	4MB	320KB
TTGO T-Beam	Espressif 32	External	ESP32	240MHz	4MB	1.25MB
TTGO T1	Espressif 32	External	ESP32	240MHz	4MB	320KB
TTGO T7 V1.4 Mini32	Espressif 32	External	ESP32	240MHz	4MB	1.25MB
VintLabs ESP32 Devkit	Espressif 32	External	ESP32	240MHz	4MB	320KB
WEMOS LOLIN D32	Espressif 32	External	ESP32	240MHz	4MB	320KB
WEMOS LOLIN D32 PRO	Espressif 32	External	ESP32	240MHz	4MB	320KB
WEMOS LOLIN32	Espressif 32	External	ESP32	240MHz	4MB	320KB
WeMos D1 MINI ESP32	Espressif 32	External	ESP32	240MHz	4MB	320KB
WeMos WiFi and Bluetooth Battery	Espressif 32	External	ESP32	240MHz	4MB	320KB
XinaBox CW02	Espressif 32	External	ESP32	240MHz	4MB	320KB
oddWires IoT-Bus Io	Espressif 32	External	ESP32	240MHz	4MB	320KB
oddWires IoT-Bus Proteus	Espressif 32	External	ESP32	240MHz	4MB	320KB