Select the libraries

The driver and screen libraries come in different versions, based on the screen film and size, and the edition.

Only screens with an iTC driver are supported.

There are two libraries to select.

• The driver library manages the panel and the board. It sends the content of the frame-buffer to the screen and refreshes the panel. It is based on the film and the size of the screen.

• The screen library generates the images on the frame-buffer and calls the driver to display them. It is used by all the application libraries.

Legacy release 8

Legacy release 8 uses the screen library only.

Driver library

The name of the driver library starts with Pervasive_, then includes the name of the film and ends with the family based on the size of the screen.

The film defines the features of the screen, with the associated library.

Letter	Film	Feature	Update
Q	BWRY	Black, white, red, yellow	Normal
K	Wide	Monochrome with wide temperature and embedded fast update	Fast
	Touch	Monochrome with touch	Fast

The screens are grouped into families according to the size of the diagonal.

Family	Suffix	Diagonal
Small	_small	1.52” 1.54” 2.06” 2.13” 2.66” 2.71” 2.87” 2.90” 3.70” 4.17” 4.37”
Medium	_medium	3.40” 5.65” 5.81” 7.41”
Large	_large	9.69” 11.98”

The available driver libraries are

Film	Family	Library	Class
BWRY	Small	Pervasive_BWRY_Small	Pervasive_BWRY_Small
Wide	Small	Pervasive_Wide_Small	Pervasive_Wide_Small
Wide	Medium	Pervasive_Wide_Medium	Pervasive_Wide_Medium
Wide	Large	Pervasive_Wide_Large	Pervasive_Wide_Large

The exposed class has the same name as the driver library.

Example

#include "Pervasive_Wide_Small.h"
Pervasive_Wide_Small myDriver(eScreen_EPD_271_KS_09, boardRaspberryPiPico_RP2040);

All the libraries support the EXT3, EXT3.1 and EXT4 extension boards. The Pervasive_Touch_Small library requires the additional EXT3-Touch expansion board.

PDLS library

Basic edition

For the Basic edition, the library is PDLS_Basic and the screen object Screen_EPD. The PDLS library can use any of the drivers.

Example

#include "Pervasive_Wide_Small.h"
Pervasive_Wide_Small myDriver(eScreen_EPD_271_PS_09, boardRaspberryPiPico_RP2040);

#include "PDLS_Basic.h"
Screen_EPD myScreen(&myDriver);

Evaluation edition

For the Evaluation edition, the library is PDLS_Advanced and the screen object Screen_EPD. The PDLS library can use any of the drivers.

Example

#include "Pervasive_Wide_Small.h"
Pervasive_Wide_Small myDriver(eScreen_EPD_271_PS_09, boardRaspberryPiPico_RP2040);

#include "PDLS_Advanced.h"
Screen_EPD myScreen(&myDriver);

Commercial edition

For the Commercial edition, the library is PDLS_Advanced and the screen object Screen_EPD. The PDLS library can use any of the drivers.

Example

#include "Pervasive_Wide_Small.h"
Pervasive_Wide_Small myDriver(eScreen_EPD_271_PS_09, boardRaspberryPiPico_RP2040);

#include "PDLS_Advanced.h"
Screen_EPD myScreen(&myDriver);

Viewer edition

For the Viewer edition used for simulation of monochrome 2.71”-T and 3.70”-T screens with touch, the library is PDLS_Viewer_Touch and the screen object Screen_EPD.

The Viewer edition is the only case with a dedicated driver, Driver_EPD_Viewer_Touch.

Example

#include "Driver_EPD_Viewer_Touch.h"
Driver_EPD_Viewer_Touch myDriver(eScreen_EPD_370_KS_0C_Touch, boardNone);

#include "PDLS_Viewer_Touch.h"
Screen_EPD myScreen(&myDriver);

Other cases

Legacy release 8 support the films and sizes not listed above.

Legacy release 8

The library comes in different versions, based on the edition and the screen size.

Only screens with an iTC controller are supported.

The film defines the features of the screen, with the associated library.

Film	Feature	Update	Library
C	Monochrome	Normal	PDLS_EXT3_Advanced_Global
H	Monochrome with freezer temperature	Normal	PDLS_EXT3_Advanced_Global
J	Black, white, red	Normal	PDLS_EXT3_Advanced_Global
Q	Black, white, red, yellow	Normal	PDLS_EXT3_Advanced_BWRY
P	Monochrome with embedded fast update	Fast	PDLS_EXT3_Advanced_Fast
K	Monochrome with wide temperature and embedded fast update	Fast	PDLS_EXT3_Advanced_Wide
	Monochrome with touch	Fast	PDLS_EXT3_Advanced_Touch

All the libraries support the EXT3, EXT3.1 and EXT4 extension boards. The PDLS_EXT3_Advanced_Touch library requires the additional EXT3-Touch expansion board.

Basic edition

For all monochrome and black-white-red colour screens

• Films C and J

• Normal update

• Library PDLS_EXT3_Basic_Global

• Class Screen_EPD_EXT3

Legacy version 6

Previous version of PDLS_EXT3_Basic_Global was named PDLS_EXT3_Basic.

For monochrome screens with embedded fast update

• Film P

• Fast update

• Library PDLS_EXT3_Basic_Fast

• Class Screen_EPD_EXT3_Fast

For monochrome screens with wide temperature and embedded fast update

• Film K

• Fast update

• Library PDLS_EXT3_Basic_Wide

• Class Screen_EPD_EXT3_Fast

For monochrome 2.71”-T and 3.70”-T screens with touch

• Fast update

• Library PDLS_EXT3_Basic_Touch

• Class Screen_EPD_EXT3_Fast

For black-white-red-yellow colour screens

• Film Q

• Normal update

• Library PDLS_EXT3_Basic_BWRY

• Class Screen_EPD_EXT3

For EXT4 extension board and monochrome screens with wide temperature and embedded fast update

• Film K

• Fast update

• Library PDLS_EXT4_Basic_Matter

• Class Screen_EPD_EXT4_Fast

Note

The Basic edition features a dedicated variant, PDLS_EXT4_Basic_Matter, aimed at the E-Paper Development Kit for Matter (EPDK-Matter) and monochrome screens with wide temperature and embedded fast update. It includes a specific board definition for the EXT4 which lists all the GPIOs.

The other previously listed variants aimed at the EXT3 Extension Board can also be used, with one adaptation of the board definition, as described in the technical note Use PDLS with the EXT4 extension board. This is the recommended option for the black-white-red-yellow colour screens.

Evaluation edition

For all monochrome and black-white-red colour screens

• Films C, J and H

• Normal update

• Library PDLS_EXT3_Advanced_Global

• Class Screen_EPD_EXT3

For monochrome screens with embedded fast update

• Film P

• normal and fast update

• Library PDLS_EXT3_Advanced_Fast

• Class Screen_EPD_EXT3_Fast

For monochrome screens with wide temperature and embedded fast update

• Film K

• normal and fast update

• Library PDLS_EXT3_Advanced_Wide

• Class Screen_EPD_EXT3_Fast

For monochrome 2.71”-T and 3.70”-T screens with touch

• normal and fast update

• Library PDLS_EXT3_Advanced_Touch

• Class Screen_EPD_EXT3_Fast

For black-white-red-yellow colour screens

• Film Q

• Normal update

• Library PDLS_EXT3_Advanced_BWRY

• Class Screen_EPD_EXT3

Note

The technical note Use PDLS with the EXT4 extension board details how to drive the EXT4 Extension Board.

Commercial edition

Same as evaluation edition.

Viewer edition

For simulation of monochrome 2.71”-T and 3.70”-T screens with touch

• normal and fast update

• Library PDLS_EXT3_Viewer_Touch

• Class Screen_EPD_EXT3_Fast

---

See also

• Driver object
• Screen object