Page:
Setup ESP32
Clone
This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This guide should help you set up the ESP board for programming the E-ink display with the code provided by this repo.
1. Install Arduino IDE
- Download and install the Arduino IDE (1.x is easiest for beginners) from arduino.cc.
- On Windows/macOS/Linux, just grab it and run the installer and follow the prompts and agree to install any USB driver offered.
2. Add ESP32 & ESP8266 Boards
-
Open File -> Preferences in the Arduino IDE.
-
In Additional Boards Manager URLs add:
https://dl.espressif.com/dl/package_esp32_index.json http://arduino.esp8266.com/stable/package_esp8266com_index.json(Separate each URL with a comma or newline)
3. Install Board Packages
-
Go to Tools -> Board -> Boards Manager…
-
Search and install:
- ESP32 by Espressif Systems
- ESP8266 by ESP8266 Community
4. Ensure Packages Folder Exists
- Arduino creates a folder at
~/Arduino15/packages(%APPDATA%\Arduino15\packageson Windows). - Confirm it contains the
hardware/espressif/esp32(and potentiallyesp8266) folders after installation.
5. Add Waveshare Libraries
- Download the Waveshare demo code and libraries -> Download.
- Locate your sketchbook folder via File -> Preferences.
- Inside that folder, open/create
libraries/. - Unzip and place the Waveshare
.zipcontents there and each library should be in its own folder.
6. Load a Demo Sketch
-
Connect your ESP32/ESP8266-based Waveshare driver board by USB.
-
In Arduino IDE, choose your board:
- For ESP32: Tools -> Board -> ESP32 Dev Module
- For ESP8266: choose NodeMCU 1.0 or similar
-
Select the correct Tools -> Port.
-
Open a Waveshare example (WiFi demo sketch).
-
Click Upload.
7. Run a Demo
- WiFi demo: modify WiFi credentials in
srvr.h, upload, open Serial Monitor (115200 baud), find IP, then view the web interface in a browser on the same network.
8. Troubleshooting Tips
- If upload fails with “Failed to connect…”, press and hold BOOT (GPIO0) button on ESP board while uploading.
- USB drivers missing -> install CP210x or CH340
- Port missing -> try a different USB cable or port
- Unstable power -> ensure USB provides a full 5 V
- Wrong board selected -> double-check Tools -> Board and Port
Summary Checklist:
| Step | Action |
|---|---|
| 1 | Install Arduino IDE |
| 2 | Add ESP32/ESP8266 board URLs |
| 3 | Install board packages |
| 4 | Ensure packages folders exist |
| 5 | Add Waveshare libraries to libraries/ |
| 6 | Choose board, port, and upload a demo |
| 7 | Run Bluetooth/WiFi demo |
| 8 | Use troubleshooting tips if needed |