Skip to content

Commercial edition

The Commercial edition adds to the Evaluation edition the use of external SPI SRAM memory for the frame-buffer and external SPI Flash memory for the fonts. It provides the source code for commercial usage.

This edition is platform-agnostic. The provided version targets the Arduino and compatible SDKs, and could easily be adapted to other SDKs and APIs by editing the peripherals library.

Configure

Warning

Ensure the hardware and software configuration meets the requirements listed at the Used environment page.

Install the drivers

Different procedures are available to install the drivers: using the Arduino IDE, using Arduino CLI, or downloading from the GitHub repository.

  • Launch the Arduino IDE;

  • Call the menu Sketch > Include library > Manage libraries…;

  • Search for Driver_EPD;

  • Select the Pervasive_Wide_Small library for monochrome screens with wide temperature and embedded fast update, small size;

  • Select the Pervasive_Wide_Medium library for monochrome screens with wide temperature and embedded fast update, medium size;
  • Select the Pervasive_Wide_Large library for monochrome screens with wide temperature and embedded fast update, large size;
  • Select the Pervasive_BWRY_Small library for colour black-white-red-yellow screens, small size;

  • Select the Pervasive_Touch_Small library for touch monochrome screens, small size;

  • Click on Install to install it.

  • Open a terminal window;

  • Launch for the Pervasive_Wide_Small driver:

$




arduino-cli lib install Pervasive_Wide_Small
Downloading Pervasive_Wide_Small@9.0.2...
Downloaded Pervasive_Wide_Small@9.0.2
Installing Pervasive_Wide_Small@9.0.2...
Installed Pervasive_Wide_Small@9.0.2
  • Perform the same procedure for the other drivers.
Driver Content
Pervasive_Wide_Small Monochrome screens with wide temperature and embedded fast update,
small size
Pervasive_Wide_Medium Monochrome screens with wide temperature and embedded fast update,
medium size
Pervasive_Wide_Large Monochrome screens with wide temperature and embedded fast update,
large size
Pervasive_BWRY_Small Colour black-white-red-yellow screens,
small size
Pervasive_Touch_Small Touch monochrome screens,
small size

Install the PDLS library

The PDLS_Advanced library is available as packages with code and header files.

Screen Content
PDLS_Advanced Text and graphic primitives, advanced edition
Font Content
hV_Font_DejaVu_Flash DejaVu fonts on external SPI Flash memory
hV_Font_DejaVu_Header DejaVu fonts on internal MCU Flash memory
hV_Font_Terminal Terminal fonts on internal MCU Flash memory
Application Content
hV_Graphics Advanced graphics
hV_GUI GUI with touch and haptic feed-back
hV_Code Bar- and QR-code
hV_File BMP and header file on SD-card
hV_Serial Header file on serial console
Legacy
Screen Content
PDLS_EXT3_Advanced_Global All monochrome and colour black-white-red screens, normal update mode
PDLS_EXT3_Advanced_Fast Monochrome screens with embedded fast update, normal and fast update modes
PDLS_EXT3_Advanced_Wide Monochrome screens with wide temperature and embedded fast update, normal and fast update modes
PDLS_EXT3_Advanced_Touch Touch monochrome screens, normal and fast update modes
PDLS_EXT3_Advanced_BWRY Colour black-white-red-yellow screens, normal update mode
Screen Content
PDLS_EXT3_Advanced_Global All monochrome and colour black-white-red screens, normal update mode
PDLS_EXT3_Advanced_Fast Monochrome screens with embedded fast update, normal and fast update modes
PDLS_EXT3_Advanced_Touch Touch monochrome screens, normal and fast update modes
Screen Content
PDLS_EXT3_Advanced_Global All monochrome and colour screens, normal update mode
PDLS_EXT3_Advanced_Fast Monochrome screens with embedded fast update, normal and fast update modes
PDLS_EXT3_Advanced_Touch Touch monochrome screens, normal and fast update modes
Screen Content
PDLS_EXT3_Advanced_Global All monochrome and colour screens, normal update mode
PDLS_EXT3_Advanced_Fast_Large Large monochrome screens, fast and partial update modes
PDLS_EXT3_Advanced_Fast_Medium Medium monochrome screens, fast and partial update modes
PDLS_EXT3_Advanced_Fast_Small Small monochrome screens, fast and partial update modes
PDLS_EXT3_Advanced_Fast_Touch Touch monochrome screens, fast and partial update modes

Use

  • Launch the Arduino IDE.

  • Call the menu Tools > Boards… to select a board.

Fast update for the monochrome screens with wide temperature and embedded fast update,

  • Call the menu File > Examples > PDLS_Advanced > Common > Common_WhoAmI.

  • Ensure the two libraries, driver and PDLS, are included.

#include "Pervasive_Wide_Small.h"
#include "PDLS_Advanced.h"
  • Ensure the two libraries, driver and PDLS, are included.
Pervasive_Wide_Small myDriver(eScreen_EPD_271_PS_09, boardRaspberryPiPico_RP2040);
Screen_EPD myScreen(&myDriver);

Normal update for colour black-white-red-yellow screens,

  • Call the menu File > Examples > PDLS_Advanced > BWRY > BWRY_Colours.

  • Ensure the two libraries, driver and PDLS, are included.

#include "Pervasive_BWRY_Small.h"
#include "PDLS_Advanced.h"
  • Edit the line and set the correct screen and board.
Pervasive_BWRY_Small myDriver(eScreen_EPD_266_QS_0F, boardRaspberryPiPico_RP2040);
Screen_EPD myScreen(&myDriver);

Fast update mode for 2.71” and 3.70” monochrome touch screens,

  • Call the menu File > Examples > PDLS_Advanced > Touch > Touch_Draw.

  • Ensure the two libraries, driver and PDLS, are included.

#include "Pervasive_Touch_Small.h"
#include "PDLS_Advanced.h"
  • Edit the line and set the correct screen and board.
Pervasive_Touch_Small myDriver(eScreen_EPD_370_PS_0C_Touch, boardRaspberryPiPico_RP2040);
Screen_EPD myScreen(&myDriver);
Legacy version 8

Normal update for all monochrome and colour black-white-red screens,

  • Call the menu File > Examples > PDLS_EXT3_Advanced_Global > Common_WhoAmI.

  • Ensure the library is included.

#include "PDLS_EXT3_Advanced_Global.h"
  • Edit the line and set the correct screen and board.
Screen_EPD_EXT3 myScreen(eScreen_EPD_271_CS_09, boardRaspberryPiPico_RP2040);

Fast update for the monochrome screens with embedded fast update,

  • Call the menu File > Examples > PDLS_EXT3_Advanced_Fast > Common_WhoAmI.

  • Ensure the library is included.

#include "PDLS_EXT3_Advanced_Fast.h"
  • Edit the line and set the correct screen and board.
Screen_EPD_EXT3 myScreen(eScreen_EPD_271_PS_09, boardRaspberryPiPico_RP2040);

Fast update for the monochrome screens with wide temperature and embedded fast update,

  • Call the menu File > Examples > PDLS_EXT3_Advanced_Wide > Common_WhoAmI.

  • Ensure the library is included.

#include "PDLS_EXT3_Advanced_Wide.h"
  • Edit the line and set the correct screen and board.
Screen_EPD_EXT3 myScreen(eScreen_EPD_271_PS_09, boardRaspberryPiPico_RP2040);

Normal update for colour black-white-red-yellow screens,

  • Call the menu File > Examples > PDLS_EXT3_Advanced_BWRY > BWRY_Colours.

  • Ensure the library is included.

#include "PDLS_EXT3_Advanced_BWRY.h"
  • Edit the line and set the correct screen and board.
Screen_EPD_EXT3 myScreen(eScreen_EPD_266_QS_0F, boardRaspberryPiPico_RP2040);

Fast update mode for 2.71” and 3.70” monochrome touch screens,

  • Call the menu File > Examples > PDLS_EXT3_Advanced_Touch > Common_WhoAmI.

  • Ensure the library is included.

#include "PDLS_EXT3_Advanced_Touch.h"
  • Edit the line and set the correct screen and board.
Screen_EPD_EXT3_Fast myScreen(eScreen_EPD_370_PS_0C_Touch, boardRaspberryPiPico_RP2040);
  • Click on Verify or Build.

The screen should display

See also