E-paper conference name badge
Build it step by step
0 of 7 doneTest the panel
Run the GxEPD2 example for your 1.54 inch model.
Show your name
Pick the text size that fits.
Make a QR code
Use a short address.
Add the button
Wake and switch pages.
Add deep sleep
Sleep after drawing.
Power from the battery
Check a refresh works from the cell.
Make the badge
Add a clip and a thin case.
How do you build an e-paper conference name badge?
A small e-paper badge shows your name and a QR code, and keeps it with the battery removed. You need Seeed XIAO ESP32C3, 1.54 inch e-paper display, CR2032 coin cell, CR2032 coin cell holder and Tactile push button 6 mm. It takes 7 steps and about 90 minutes.
- Level
- Beginner
- Time
- About 90 min
- Parts
- 5
Wiring
| From | To | Why |
|---|---|---|
| E-paper VCC and GND | XIAO 3V3 and GND | Power |
| E-paper DIN | XIAO D10 (GPIO10) | SPI data |
| E-paper CLK | XIAO D8 (GPIO8) | SPI clock |
| E-paper CS | XIAO D0 (GPIO2) | Chip select |
| E-paper DC | XIAO D1 (GPIO3) | Data or command |
| E-paper RST | XIAO D2 (GPIO4) | Reset |
| E-paper BUSY | XIAO D3 (GPIO5) | Busy flag |
| Button | XIAO D4 (GPIO6) and GND | Next page |
| Battery | XIAO 3V3 and GND through the holder (or a small LiPo on the BAT pads) | Power |
Code
The panel keeps its picture without power, so the badge only draws when you press the button and then sleeps. Put your own name, role and web address in the constants. Keep the QR text short: a version 3 code holds about 50 characters at low error correction. A CR2032 cannot supply the brief current of a refresh well, so use a small LiPo through the XIAO's battery pads for frequent updates, and a coin cell only for rare changes. The XIAO ESP32C3 can wake from deep sleep on the button pin; if yours does not, wake on a timer instead. Choose the GxEPD2 class that matches your exact 1.54 inch panel. Arduino IDE with the ESP32 boards package, board "XIAO_ESP32C3".
Runs on a virtual Seeed XIAO ESP32-C3 in your browser, with sliders for the sensors. Happy with it? Verify and upload to your real board from the same page (Chrome or Edge on a computer).
// E-paper name badge: name page and QR page. Libraries: GxEPD2, Adafruit GFX, QRCodeGenerator (the QRCode library under a name that does not clash with the ESP32 core).
#include <GxEPD2_BW.h>
#include <QRCodeGenerator.h>
#include <SPI.h>
GxEPD2_BW<GxEPD2_154_D67, GxEPD2_154_D67::HEIGHT> display(GxEPD2_154_D67(/*CS*/ 2, /*DC*/ 3, /*RST*/ 4, /*BUSY*/ 5));
const char* NAME = "Your Name";
const char* ROLE = "Electronics student";
const char* QR_TEXT = "https://example.com/your-profile"; // change to your own address
const int BTN = 6;
RTC_DATA_ATTR int page = 0; // remembered through deep sleep
void drawName() {
display.setFullWindow(); display.firstPage();
do {
display.fillScreen(GxEPD_WHITE); display.setTextColor(GxEPD_BLACK);
display.setTextSize(3); display.setCursor(10, 80); display.print(NAME);
display.setTextSize(1); display.setCursor(10, 120); display.print(ROLE);
} while (display.nextPage());
}
void drawQR() {
QRCode qr; uint8_t data[qrcode_getBufferSize(3)];
qrcode_initText(&qr, data, 3, ECC_LOW, QR_TEXT);
const int scale = 5, off = (200 - qr.size * scale) / 2;
display.setFullWindow(); display.firstPage();
do {
display.fillScreen(GxEPD_WHITE);
for (int y = 0; y < qr.size; y++) for (int x = 0; x < qr.size; x++)
if (qrcode_getModule(&qr, x, y)) display.fillRect(off + x * scale, off + y * scale, scale, scale, GxEPD_BLACK);
} while (display.nextPage());
}
void setup() {
pinMode(BTN, INPUT_PULLUP);
SPI.begin(8, 9, 10, 2); // SCK, MISO, MOSI, SS
display.init(115200);
esp_sleep_wakeup_cause_t why = esp_sleep_get_wakeup_cause();
if (why == ESP_SLEEP_WAKEUP_GPIO) page = (page + 1) % 2; // button wake changes the page
if (page == 0) drawName(); else drawQR();
display.hibernate();
esp_deep_sleep_enable_gpio_wakeup(1ULL << BTN, ESP_GPIO_WAKEUP_GPIO_LOW);
esp_deep_sleep_start();
}
void loop() {}Test checklist
What you should see at each check. If a reading is far off, stop and use the troubleshooting list.
| Check | Expected |
|---|---|
| Power on | Name appears |
| Button press | QR page appears |
| Phone camera | Opens the address |
| Battery removed | Picture stays |
If it does not work
Garbled picture
Choose the right GxEPD2 class for your panel.
QR will not scan
Shorten the text or enlarge each square.
Button does not wake
Use a GPIO that supports wake-up on your board.
Resets during refresh
Use a LiPo, not a coin cell.
Still stuck? Find the fault step by step with your multimeter →
Common questions
What parts do I need for the e-paper conference name badge?
Seeed XIAO ESP32C3, 1.54 inch e-paper display, CR2032 coin cell, CR2032 coin cell holder and Tactile push button 6 mm. CR2032 coin cell: Use a small Li-po for frequent updates.
How long does the e-paper conference name badge take to build?
About 90 minutes for a beginner maker, in 7 steps.
How do I know the e-paper conference name badge works?
Power on: Name appears. Button press: QR page appears. Phone camera: Opens the address.
Garbled picture: what should I check?
Choose the right GxEPD2 class for your panel.
QR will not scan: what should I check?
Shorten the text or enlarge each square.
Button does not wake: what should I check?
Use a GPIO that supports wake-up on your board.
Resets during refresh: what should I check?
Use a LiPo, not a coin cell.
