Pervasive Displays Library Suite

Table of contents

• Getting started

• Shared libraries

• Screen libraries

• Application libraries

• Appendixes

---

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

• The EPD Extension Kit Gen 3 (EXT3 or EXT3-1) and Touch Expansion Board for EXT3 (EXT3-Touch) boards;

• The iTC monochrome , monochrome with embedded fast update , monochrome with touch screens;

• The iTC colour black-white-red and colour black-white-red-yellow screens;

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

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

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.

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