ESP32 E-Paper Troubleshooting: Blank Screen & BUSY Timeout
A retained e-paper image does not prove the module has powered up, and a blank panel does not identify one specific fault. Start with the exact panel marking and driver board, then test a static full image before adding networking or partial refresh.
Record the hardware before changing firmware
Write down the panel code, color type, resolution, controller and driver-board revision. Two panels with the same diagonal size may need different initialization or waveforms. A raw FPC panel needs matching drive circuitry; do not attach it directly to ESP32 GPIO or a battery rail.
Symptom checklist
| Symptom | Checks before replacing hardware |
|---|---|
| Old image remains after upload | Use serial output to confirm program execution; retained pixels can remain without panel power |
| Blank panel or no visible update | Check the supply, common ground, connector seating, reset sequence and exact library class |
| BUSY timeout | Match BUSY wiring and active level to the driver; check reset, power and initialization |
| Update starts then ESP32 resets | Capture the reset reason and inspect the supply during radio activity and refresh |
| Image clipped or rotated | Check canvas dimensions, rotation and the matching driver |
| Partial update leaves artifacts | Return to a supported full update and use the panel-specific refresh sequence |
Separate communication from application behavior
- Disconnect power and inspect the FPC contact orientation and latch.
- Check the driver board’s documented supply and logic levels.
- Select the exact supported panel class in the library example.
- Start with a border and text using a full update.
- Capture the initialization log before enabling Wi-Fi, sensors or a more complex UI.
Do not “fix” a BUSY timeout by permanently ignoring BUSY or adding a universal pull-down. BUSY polarity and reset timing depend on the panel and drive circuit. Changing voltages or undocumented waveforms can damage a display.
Use the matching panel guide
- 2.9-inch E-Paper: GDEY029T94 / ESP32
- 4.2-inch E-Paper: GDEY042T81 / ESP32
- 1.54-inch E-Paper: ESP32 Setup & Troubleshooting
For redraw artifacts after a working first image, use the partial-refresh and ghosting guide. For current measurement and battery planning, use the e-paper power-budget guide. There is no universal full-refresh interval, panel lifetime or energy value that applies to every display.
Information to include in a support request
Send the product link and selected option, panel/PCB photos, ESP32 board model, supply, wiring, library version, selected driver class and serial output. Describe whether the problem occurs during initialization, a full update, or only after sleep/partial updates.
