Paperdeck

A Zephyr-powered ePaper dashboard for Home Assistant, weather, calendar, and other glanceable home info.

Mockup of the dashboard.

Setup

Clone this repo inside an existing Zephyr workspace:

cd </path/to/zephyrproject>

git clone https://github.com/ikajdan/paperdeck.git

Configuration

cd </path/to/zephyrproject>

west build \
  -d build/paperdeck \
  -b xiao_esp32c3/esp32c3 \
  paperdeck -- \
    -DEXTRA_CONF_FILE=prj.local.conf

west build -d build/paperdeck -t menuconfig

Keep persistent local settings in prj.local.conf. menuconfig updates the generated build config under build/.

Build

cd </path/to/zephyrproject>

west build \
  -d build/paperdeck \
  -b xiao_esp32c3/esp32c3 \
  paperdeck -- \
    -DUSER_CACHE_DIR=/tmp/zephyr-cache \
    -DEXTRA_CONF_FILE=prj.local.conf

Flash

cd </path/to/zephyrproject>

west flash -d build/paperdeck

Device References

• Product name: XIAO 7.5 inch ePaper Panel
• MCU: Seeed Studio XIAO ESP32-C3
• Wiki: https://wiki.seeedstudio.com/xiao_075inch_epaper_panel/

Display Panel Specifications

Datasheet: https://files.seeedstudio.com/wiki/Other_Display/750-epaper/7.5_inch_Monochrome_ePaper_Display_Datasheet.pdf

Parameter	Details
Driver IC	UC8179
Type	Dot Matrix
Size	7.5 inch
Active Area (mm)	163.2 x 97.72
Resolution	800 x 480 pixels
Pixel Pitch (mm)	0.204 x 0.204
Display Color	Black, White
Max Grayscale	4
Interface	SPI
Connector	24 Pin FPC, 0.5mm Pitch
Viewing Angle	>170°
Operating Voltage	3.3V
Operating Temperature	0-50°C
Power Consumption	26.4mW (typ.)
Standby Consumption	0.0165mW
Outline Dimension (mm)	170.2 x 111.2 x 1.25
Weight (g)	3.2

Driver References

The UC8179 driver was developed using the following references:

• Seeed_GFX UC8179 driver files: https://github.com/Seeed-Studio/Seeed_GFX
• GxEPD2 GxEPD2_750_GDEY075T7: https://github.com/ZinggJM/GxEPD2
• ESPHome waveshare_epaper: Model 7.50inv2

Pinout

Function	Pin	Notes
SPI SCK / CLK	GPIO8	Hardware SPI SCK on XIAO ESP32-C3
SPI MOSI	GPIO10	Hardware SPI MOSI on XIAO ESP32-C3
SPI MISO	GPIO9	Not used by the ePaper examples
Display CS	GPIO3	Chip select
Display DC	GPIO5	Data/command select
Display BUSY	GPIO4	ESPHome marks this as inverted
Display RESET	GPIO2	Display reset

License

This project is licensed under the MIT License. See the LICENSE file for details.

Paperdeck uses the ModeNine font, listed by its author as free to use, and Lucide icons, released under the ISC License.