Skip to content

Pervasive Displays Library Suite

Table of contents

The Pervasive Displays Library Suite is specifically designed for the Pervasive Displays screens and boards.

It provides a high-level interface to drive the e-paper screens with global and fast update, supports capacitive touch and haptic feed-back. It is developed in C++.

Supported screens

The suite supports

General architecture

The suite contains three layers:

  • The application libraries include graphics with clock, gauge and histogram; GUI with label, button, check-box or slider; codes with bar- and QR-codes; Files to save and retrieve BMP files; and serial to generate and print header files on serial console;

  • The screen libraries support additional screen-specific features for the Pervasive Displays e-paper screens;

  • The shared libraries provide the common classes of the primitives for text and graphics; the interface for the peripherals GPIO, UART, SPI and I²C; and the fonts libraries.

The appendixes contain application notes, reference designs, a glossary, details on the used environment, an index, copyright, licence and disclaimer and other documents.


The documentation consists on two documents:

  • This User guide focuses on how to use the different libraries, with commented examples;

  • The Reference manual lists all the objects and functions, with details for their parameters and returned results.

Additionally, the Wiki provides a gradual introduction to the e-paper technology and how to use it.


This website uses the following typographic conventions:

  • Keywords and folders names are in Terminal font:

By default, the files are located under the folder img.

  • Code is displayed with Terminal font in a light grey box:
#include "PDLS_EXT3_Advanced_Global.h";
  • Notes and warnings are displayed inside coloured boxes.






  • Applications are in Sans Serif bold font.

Open a Terminal window.

  • Elements of the interface and menus are presented using Sans Serif bold font.

Call the menu File > Examples > PDLS_EXT3_Advanced_Global > Common_WhoAmI.

  • Keyboard shortcuts and mouse actions are framed.
  • Press H or ? to display or hide the help panel.
  • A mentions an external link to the web.

For more information about the screen model, please refer to the Model name explanation and The different types E Ink imaging film pages on the Pervasive Displays website.

  • Dates are stated as DD MMM YYYY, with DD for day, MMM for month in plain letters, and YYYY for year.

Release Winter 2023

Published 21 Dec 2023