Pervasive Displays Library Suite —
User guide

Table of contents

• Getting started

• Shared libraries

• Screen libraries

• Application libraries

• Notes and designs

• Appendixes

---

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

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 the screens

• iTC monochrome with global update ,

• iTC monochrome with touch ,

• iTC monochrome with embedded fast update ,

• iTC monochrome with wide temperature and embedded fast update ,

• iTC colour black-white-red ,

• iTC colour black-white-red-yellow ;

the boards

• EPD Extension Kit Gen 3 (EXT3 and EXT3.1) ,

• Touch Expansion Board for EXT3 (EXT3-Touch) ,

• EPD Extension Kit Gen 4 (EXT4) ;

and the kits

• EPD Pico Kit (EPDK-266) , which includes a Raspberry Pi Pico RP2040, an EXT3.1 extension board and a 2.66” monochrome panel,

• EPD Pico Kit Touch (EPDK-271-Touch) , which includes a an EXT3.1 extension board and an EXT3-Touch expansion board, and a 2.71”-Touch monochrome panel with embedded fast update and capacitive touch, and

• E-Paper Development Kit for Matter (EPDK-Matter) , which bundles an Arduino Nano Matter, an EXT4 extension board and a 2.90” high-definition monochrome panel with wide temperature and embedded fast update.

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 provide 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 notes and designs section contains technical notes and reference designs.

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

Documentation

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.

Conventions

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.

Danger

Warning

Info

Note

Example

• 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