Waveshare E-Paper Display

The waveshare_epaper display platform allows you to use some E-Paper displays sold by Waveshare with ESPHome. The 2.13” TTGO module with an ESP32 on the board is supported as well. Depending on your specific revision of the board you might need to try out the -b73 or -b1 version (see below). Similar modules sold by other vendors might also work but not have been tested yet. Currently only single-color E-Ink displays are implemented and of those only a few modules.

../../_images/waveshare_epaper-full.jpg

Waveshare E-Paper 2.9 Inch E-Paper Display.

The communication ESPHome has chosen to use for this integration is 4-wire SPI, as it’s the most stable and high-speed. So you need to make sure your board is set to the 4-wire SPI mode and have an spi: section in your configuration.

E-Paper Pin

ESP Pin

ESPHome Option

VCC

3.3V

N/A

GND

GND

N/A

CLK

Any GPIO

spi.clk_pin

DIN

Any GPIO

spi.mosi_pin

CS

Any GPIO

cs_pin

DC

Any GPIO

dc_pin

BUSY (Optional)

Any GPIO

busy_pin

RESET (Optional)

Any GPIO

reset_pin

../../_images/waveshare_epaper-pins.jpg
# Example configuration entry
font:
  - file: 'fonts/Comic Sans MS.ttf'
    id: font1
    size: 8

spi:
  clk_pin: D0
  mosi_pin: D1

display:
  - platform: waveshare_epaper
    cs_pin: D2
    dc_pin: D3
    busy_pin: D4
    reset_pin: D5
    model: 2.90in
    full_update_every: 30
    lambda: |-
      it.print(0, 0, id(font1), "Hello World!");

Configuration variables:

  • cs_pin (Required, Pin Schema): The CS pin.

  • dc_pin (Required, Pin Schema): The DC pin.

  • model (Required): The model of the E-Paper display. Options are:

    • 1.54in

    • 1.54inv2

    • 2.13in (not tested)

    • 2.13in-ttgo (T5_V2.3 tested. Also works for Wemos D1 Mini ePaper Shield 2.13 1.0.0 “LOLIN”)

    • 2.13in-ttgo-b73 (T5_V2.3 with B73 display tested)

    • 2.13in-ttgo-b1 (T5_V2.3 with B1 display tested)

    • 2.70in (currently not working with the HAT Rev 2.1 version)

    • 2.90in

    • 2.90inv2

    • 2.90in-b (B/W rendering only)

    • 4.20in

    • 5.83in

    • 7.50in

    • 7.50inV2 (Can’t use with an ESP8266 as it runs out of RAM)

  • busy_pin (Optional, Pin Schema): The BUSY pin. Defaults to not connected.

  • reset_pin (Optional, Pin Schema): The RESET pin. Defaults to not connected. Make sure you pull this pin high (by connecting it to 3.3V with a resistor) if not connected to a GPIO pin.

  • rotation (Optional): Set the rotation of the display. Everything you draw in lambda: will be rotated by this option. One of (default), 90°, 180°, 270°.

  • full_update_every (Optional, int): E-Paper displays have two modes of switching to the next image: A partial update that only changes the pixels that have changed and a full update mode that first clears the entire display and then re-draws the image. The former is much quicker and nicer, but every so often a full update needs to happen because artifacts accumulate. On the 1.54in, 1.54inv2, 2.13in, 2.90in and 2.90inv2 models you have the option to switch only do a full-redraw every x-th time using this option. Defaults to 30 on the described models and a full update for all other models.

  • lambda (Optional, lambda): The lambda to use for rendering the content on the display. See Display Rendering Engine for more information.

  • update_interval (Optional, Time): The interval to re-draw the screen. Defaults to 10s, use never to only manually update the screen via component.update.

  • pages (Optional, list): Show pages instead of a single lambda. See Display Pages.

  • spi_id (Optional, ID): Manually specify the ID of the SPI Component if you want to use multiple SPI buses.

  • id (Optional, ID): Manually specify the ID used for code generation.

See Also