Skip to content

emCode

Pervasive Displays Library Suite —
User guide

Table of contents

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

the boards

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