GxEPD2 : Display Library for SPI E-Paper Displays available for Particle


It supports SPI e-paper displays from Dalian Good Display and the display boards from Waveshare that use these display panels.

This library replaces the GxEPD2_PP variant of GxEPD2, as the GxEPD2 library for Arduino is suitable for Particle also, just the examples need to be different.

This topic is intended for asking questions, reporting problems and issues, and hopefully telling your successful use of these displays. But the preferred place to ask questions to the author is in the Arduino Forum Displays topics:



The library is published for Particle and its repository is on GitHub:


The examples for Particle are in this folder on GitHub:


These examples replace the Arduino examples in the published library for Particle.
Do the same if you want to upload a private copy, as the published version may lag behind the Arduino version on GitHub.

Note that this library may not be usable with the Particle WEB-IDE, most likely because of too many files contained.

GxEPD2_PP : Particle Display Library for SPI E-Paper Displays

Thanks for your support here @ZinggJM !!!


I am wondering: Is it normal, that it takes forever, when I click the Library in the Web IDE after search? Is there something broken? Or is it, because the library is so big?

I waited more than 15 minutes and still the page is empty and says “loading”. I tried with Chrome, Firefox and Edge. All the same! Other libraries load like a charm. But GXEPD2 and the older GXEPD_PP do not load!

Please help on resolving this. Or give me an alternative.


@Coding_Lizard, I have seen this happens with libraries with a large number of files. Try and hit refresh on your browser to see if it loads. Another approach is to use the Particle Workbench and “install” the library to your project.


Thanks for the quick help!

I installed Workbench an managed to compile the provided example locally. Will now have to verify that it actually works on my Xenon and is able to control my 7.5 inch display. Will post an update here soon.