ePaper Driver Board | Seeed Studio Wiki

[giscus[bot]]

ePaper Driver Board | Seeed Studio Wiki

The eInk expansion board For XIAO is a smart module from Seeed Studio designed to display something in epaper screen.

https://wiki.seeedstudio.com/xiao_eink_expansion_board_v2/

[Dav1dyang]

Hello! Is there any schematic & pcb board files for this ePaper Driver Board for reference? Thank you!

[nfs0619]

Hello! We have updated the documentation and provided the relevant files for this board.

[Dav1dyang]

Thank you for the update! This is super helpful!

[Nerdiyde]

Hi Seeed-Team,
Do you mind sharing any 3D CAD files? Would be very helpful at integrating this in CAD.
Thanks in advance and best regards
Fab

[nfs0619]

Hi! We have updated our documentation to include all the available files for this board. Regarding the 3D CAD files, you may check the resources provided here to see if they meet your needs.

[Nerdiyde]

Hi,
thanks for the update. I was refering to the CAD files of the PCB/extension board. I would like to integrate this in my own housing. Having the right dimensions/3d file of the PCB would make this a lot easier. :) Do you mind sharing this?
Thanks in advance

[nfs0619]

We’re sorry, but the files provided in our wiki documentation are the only ones we can share at the moment.

[arunshivaram]

I'm not sure if you are still looking for this. But in case you or anyone are looking for the CAD model, I was able to find it in Seeed's grabcad page .

https://grabcad.com/library/epaper-driver-board-for-seeed-studio-xiao-1

[tomtom13]

So, I can't the file:
ePaper_Breakout_Board_for_XIAO_V2_PCBA.pdf
says "access denied". Would be nice if you guys fixed it, since I would like to implement the battery monitoring.

[nfs0619]

Thank you for your feedback! We have fixed the issue with the link, and you should now be able to access the file.

[tomtom13]

OK, so I've looked through the circuit diagram - am I right to assume that there is no way to measure voltage on connected esp32 board to figure out current battery level ?

[Allenkzl]

Yes, because there are no extra ADC pins available to read the battery level.

[nebelgrau77]

The instructions on using the driver are not very clear:

Step 3. Install Seeed Arduino LCD Library
Download and install the Seeed Arduino LCD library from GitHub.

OK, but there is no "install", it is a repository that gets cloned into a folder. And the instructions in the repo say:

Installation
Download this repository
Install it into your Arduino libraries folder
Select the appropriate setup configuration for your hardware

Then in the instructions here it says "After downloading the library, go to Sketch -> Include Library -> Add .ZIP Library and select the downloaded library." - but there is no ZIP file to select.

Am I supposed to copy the cloned repo into Arduino libraries folder? How can I use this library?

[nfs0619]

Hello,
When you click the link in our documentation to open the GitHub repository, you don’t need to manually git clone it. Instead, click the Code button on the repository page and select Download ZIP (see image below):

After downloading the ZIP file, follow the next step in our tutorial:
Sketch → Include Library → Add .ZIP Library
and select the downloaded ZIP file to install the library into Arduino.

This way, you don’t need to manually copy anything into the libraries folder—Arduino will handle the installation automatically.

[nebelgrau77]

Great, thank you! This worked. It might be worth making it clear like this in the instructions.

One more thing: in the repository README there is a link to a convenient "configuration tool", which generates two lines of code to be placed in driver.h header file, and this file is then supposed to go to the library folder (this could be explained better). The driver.h file, if present, overrides the commenting/uncommenting of various lines. If I understand correctly, it is all based on a code indicating the display, e.g. BOARD_SCREEN_COMBO 508 is 2.13 inch monochrome ePaper Screen. This is easier and "cleaner" than modifying the User_Setup_Select file, maybe could be mentioned here in the setup instructions.

[nfs0619]

Thank you for your valuable feedback!
We’ll take your suggestions into consideration when we review and improve our documentation.

[sysrs]

I'm hoping to use this ePaper Driver board with a XIAO ESP32C6 and a Three-Colour 1.54" E-Ink Raw Display Panel (200x200) (https://www.waveshare.com/w/upload/9/9e/1.54inch-e-paper-b-v2-specification.pdf).

I've managed to run a test script and the screen responds, but is not showing test images and text correctly. It's responding very slowly indeed, and instead of a clear test rectangle for example, I get a lot of red random pixels over the top.

Are these 3 (drive board, ESP32C6, 1.54' 3 colour display) compatible?

[Allenkzl]

A32-GDEM0154Z91-210831.zip
Please try this demo, remember to change the SPI pins~

[sysrs]

Thanks very much. I've gotten a little further but things aren't quite working correctly. Still here was a little video of what happens.

Untitled.mov

As per (https://wiki.seeedstudio.com/xiao_eink_expansion_board_v2/) I changed SPI pins to..

//IO settings
int BUSY_Pin = 2;
int RES_Pin = 0;
int DC_Pin = 21;
int CS_Pin = 1;
int SCK_Pin = 19;
int SDI_Pin = 18;

Any more thoughts?

Do you know of any library that I can use with a function that I was pass a text (like "Hello world") and the display will print the text?

[Allenkzl]

The SPI pins suppose to be:

[sysrs]

The numbers I used are the GPIO numbers, not the 'D' pin numbers, so I think it's correct.

Do you know of a library that I can use to print text on the display?

[Dav1dyang]

Hello! Is there any way I could use the Seeed studio GFX Library with custom eInk display that is not listed in the Online Configuration Generator? I wanted to use this driver board with 10.85 inch ePaper from WaveShare: https://www.waveshare.com/10.85inch-e-paper-hat-plus-g.htm Thanks in advance!

[Allenkzl]

GFX Library not support 10.85 inch ePaper yet. It only support those display listed in the Online Configuration Generator.

[Lliam-Rankins]

How do I use it with the 2.9 in' quadcolor display, its listed as supported, but its not in the online configuration generator

[Dav1dyang]

Just wanted to share a quick follow-up. I used Claude to modify the Waveshare example and added support for the 10.85" display in a forked version of the Seeed_GFX library. This display uses two driver ICs, so I had to add a second CS line on the driver board for it to work properly. The current setup uses Waveshare’s bit-banged SPI instead of hardware SPI, so it’s not fully integrated into Seeed_GFX yet, but it works. If I get more time, I’d like to clean it up and properly integrate dual-CS handling into the official Seeed_GFX repository. Still new to this so would love any guidance. Just wanted to leave this here in case anyone else runs into the same need!

[dewal5]

If your have TRMNL 7.5” (OG) DIY Kit

you can use this library to use 7,5" screen
only diffrence is pinout

#define TFT_SCLK 7
#define TFT_MISO -1
#define TFT_MOSI 9
#define TFT_CS 44
#define TFT_DC 10
#define TFT_BUSY 4
#define TFT_RST 38

UC8179_DRIVER

[Lliam-Rankins]

How can I use the 2.9' Quad Color display GDEY029F51, its supported but it doesn't show up on the online configuration. Using the 2.9 in monochrome version doesn't work and gives me an error saying the "The provided BOARD_SCREEN_COMBO ID is not a valid or supported configuration."

[nfs0619]

Sorry about that. The online configuration tool only supports 2.9inch monochrome epaper, not 2.9' Quad Color display yet.

[lboue]

Could you add the GDEY0213F51 2.13-inch four-color screen to this tutorial?

[grilliiiiii]

Could you add the GDEY0213F51 2.13-inch four-color screen to this tutorial?

Thank you for your valuable feedback. I’ve shared your comments with our product manager. Please look forward to upcoming improvements.

[kim-ras]

Will this also work with a ESP32C6 especially when using it as battery powered, I am planning to build a clock that updates every minutes and then deep sleep. But it needs to be rechargable .

[Lukilyy]

Hello! The physical pin definitions of the XIAO series are universal, and there are usually no issues with hardware connections. However, since ESP32C6 is relatively new, if you encounter compilation errors, you may need to modify the pin definitions. For your clock project, ESP32C6 supports lithium battery charging and has extremely low deep sleep power consumption, making it very suitable for scenarios where it needs to wake up once per minute. We look forward to your feedback after you give it a try.

[kim-ras]

I can confirm that the board works well with ESP32C6, but I have not yet tried the sleep - Got sidetracked by an air quality project :-D

[Borealis70]

I connected an ESP32-S3 to the ePaper Driver Board. However, when the ESP32-S3 is connected to the ePaper Driver Board, it stops responding on the USB port, and I can't access the serial monitor in the Arduino IDE. I also can't upload my sketch to the ESP32-S3. To do so, I have to disconnect the ESP32-S3 from the ePaper Driver Board, and then I can upload my program... which is really inconvenient. How can I fix this?

Furthermore, I connected the 2.9" Quadruple Color eInk / ePaper Display with 128x296 Pixels, SPI interface, XIAO/Arduino/STM32 support (SKU 104990855) to the ePaper driver board, and nothing happens. It's impossible to get it working, even with the "Hello World" example sketch from the gfx library. Would you have a sketch you could send me with all the correct parameters (pin configuration, correct screen, etc.) so I can at least see if the screen works properly before going any further? Thank you.

[Lukilyy]

Our staff have noticed your situation. Could you please send us the SKU and order number of the XIAO ESP32-S3 and the ePaper Driver Board for us to verify?

[Borealis70]

Our staff have noticed your situation. Could you please send us the SKU and order number of the XIAO ESP32-S3 and the ePaper Driver Board for us to verify?

Hi Lukilyy,

Sorry for the delay.

My ESP32 S3 and my 4 epaper driver boards works fine with the 2.9" Monochrome epaper display 296x128 pixel (SKU MOB 250603002 07/29/25). But when i connect one on the two 2.9" Quadruple color ePaper Display 128x296 MOB 251120018 11/26/25 and MOB251208005 12/13/25 nothing happens.

The driver.h on Arduino IDE is
#define BOARD_SCREEN_COMBO 512 // 2.9 inch BWRY ePaper Screen （JD79667）
#define USE_XIAO_EPAPER_DRIVER_BOARD

Where can i find the sku ok the ePaper Driver Board and of the ESP32-S3 ?

Thanks a lot

[Lukilyy]

Thank you for providing the detailed information. Since we need to verify the specific SKU and order number to investigate whether this is a compatibility issue between the driver board and the specific color ink screen, this investigation might take some time. To solve your problem more efficiently, we suggest that you directly contact our official technical support team(techsupport@seeed.io). If you cannot find the SKU, they can help you query through the order record and provide more targeted debugging solutions based on your specific configuration.