XIAO ePaper Display Board(ESP32-S3) with ESPHome | Seeed Studio Wiki

[giscus[bot]]

XIAO ePaper Display Board(ESP32-S3) with ESPHome | Seeed Studio Wiki

This article explains how to utilize the hardware features of the XIAO ePaper Display Board EE04 in ESPHome and integrate it with Home Assistant.

https://wiki.seeedstudio.com/EE04_with_esphome_advanced/

[lboue]

Should 2.13inv2 or 2.13inv3 be used with ESPHome 2025.11?

INFO Reading configuration /config/esphome/xiao-epaper-display-ee04.yaml...
Failed config

display.waveshare_epaper: [source /config/esphome/xiao-epaper-display-ee04.yaml:61]
  platform: waveshare_epaper
  id: epaper_display
  
  Unknown value '2.13inv', did you mean '2.13inv3', '2.13inv2', '2.13in'?.
  model: 2.13inv
  cs_pin: GPIO44
  dc_pin: GPIO10
  reset_pin: 
    number: GPIO38
    inverted: False
  busy_pin: 
    number: GPIO4
    inverted: True
  update_interval: 300s

[Allenkzl]

Model details you refer to here. https://esphome.io/components/display/waveshare_epaper/

And I have updated the wiki

[lboue]

Could you add ESPHome config for User Buttons?

[lboue]

XIAO EE04 ePaper Display 2.13 Inch Quadruple Color config is not working:

wiki-documents/docs/Sensor/ePaper/XIAO_ePaper_Display_Board_EE04/Application/XIAO_ePaper_Display_Board_EE04_With_ESP-HOME.md

Lines 287 to 289 in 533a75f

	external_components:
	- source: github://xcjk-tofuture/seeed_esphome
	components: [ waveshare_epaper ]

I am facing an issue building ESPHome firmware using this external component:

Compiling .pioenvs/xiao-epaper-display-ee04/src/esphome/components/waveshare_epaper/waveshare_213v3.cpp.o
Compiling .pioenvs/xiao-epaper-display-ee04/src/esphome/components/waveshare_epaper/waveshare_epaper.cpp.o
src/esphome/components/waveshare_epaper/waveshare_213v3.cpp: In member function 'virtual void esphome::waveshare_epaper::WaveshareEPaper2P13InV3::dump_config()':
src/esphome/components/waveshare_epaper/waveshare_213v3.cpp:185:1: error: expected ';' before '}' token
  185 | }
      | ^
*** [.pioenvs/xiao-epaper-display-ee04/src/esphome/components/waveshare_epaper/waveshare_213v3.cpp.o] Error 1
========================= [FAILED] Took 235.04 seconds =========================

[chianti2000]

How can I activate power saving mode or deep sleep for the board in ESP Home?

[Allenkzl]

https://wiki.seeedstudio.com/xiao_075inch_epaper_panel_esphome/#demo2-deep-sleep-mode

You can refer to this wiki. The driver board of this product is same and the MCU is ESP32C3. If your MCU isn't ESP32C3, please remember to change the SPI pins

[kim-ras]

I am unable to referance the external component.

I get the error : Compiling .pioenvs/seeed-epaper-29-quad/src/esphome/components/web_server/ota/ota_web_server.cpp.o
In file included from src/esphome/core/hal.h:4,
                 from src/esphome/core/application.h:12,
                 from src/esphome/components/spi/spi.h:2,
                 from src/esphome/components/waveshare_epaper/waveshare_epaper.h:4,
                 from src/esphome/components/waveshare_epaper/waveshare_213v3.cpp:1:
src/esphome/components/waveshare_epaper/waveshare_213v3.cpp: In member function 'virtual void esphome::waveshare_epaper::WaveshareEPaper2P13InV3::dump_config()':
src/esphome/core/gpio.h:18:30: error: expected ';' before 'log_pin'
   18 | #define LOG_PIN(prefix, pin) log_pin(TAG, prefix, pin)
      |                              ^~~~~~~
src/esphome/components/waveshare_epaper/waveshare_213v3.cpp:181:3: note: in expansion of macro 'LOG_PIN'
  181 |   LOG_PIN("  Reset Pin: ", this->reset_pin_)
      |   ^~~~~~~
*** [.pioenvs/seeed-epaper-29-quad/src/esphome/components/waveshare_epaper/waveshare_213v3.cpp.o] Error 1
========================= [FAILED] Took 78.40 seconds =========================

I have tried a couple of differeferance Links but the one in 2.9 Quad is this on - they all report the same error

external_components:
  - source: github://xcjk-tofuture/esphome@dev
    components: [ waveshare_epaper ]

[Lukilyy]

Hello. May I ask if your problem has been resolved now?

[brainino]

Is the Waveshare 13.3inch model supported (for Esphome)?
https://www.waveshare.com/product/displays/e-paper/13.3inch-e-paper-k.htm?___SID=U