Skip to content

Basic edition

The Basic edition support normal update and fast update, according to the screens. It provides all the functions for shapes and text. It is shared under Creative Commons - Attribution ShareAlike (summmary , legal code ).

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

Different procedures are available to install the library: 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 PDLS;

  • Select the PDLS_Basic library;

  • Click on Install to install it.

  • Open a terminal window;

Install the PDLS library.

  • Launch
$



arduino-cli lib install PDLS_Basic
Downloading PDLS_Basic@9.0.2...
Downloaded PDLS_Basic@9.0.2
Installing PDLS_Basic@9.0.2...
Installed PDLS_Basic@9.0.2

Install the PDLS library.

Legacy version 8

Legacy release 8 does not require the installation of the drivers, as the PDLS library already includes them.

  • Launch the Arduino IDE and call the menu Sketch > Include library > Manage libraries…;

  • Search for PDLS;

  • Select the PDLS_EXT3_Basic_Global library ;

  • Click on Install to install it.

  • Perform the same procedure for all the variants, PDLS_EXT3_Basic_Global, PDLS_EXT3_Basic_Wide, PDLS_EXT3_Basic_Fast, PDLS_EXT3_Basic_Touch, PDLS_EXT3_Basic_BWRY and PDLS_EXT4_Basic_Matter.
  • Launch the Arduino IDE and call the menu Sketch > Include library > Manage libraries…;

  • Search for PDLS;

  • Select the PDLS_EXT3_Basic_Global library ;

  • Click on Install to install it.

Legacy version 8
  • Perform the same procedure for all the variants, PDLS_EXT3_Basic_Global, PDLS_EXT3_Basic_Wide, PDLS_EXT3_Basic_Fast, PDLS_EXT3_Basic_Touch, PDLS_EXT3_Basic_BWRY and PDLS_EXT4_Basic_Matter.
  • Open a terminal window;

  • Launch

$



arduino-cli lib install PDLS_EXT3_Basic_Wide
Downloading PDLS_EXT3_Basic_Wide@9.0.2...
Downloaded PDLS_EXT3_Basic_Wide@9.0.2
Installing PDLS_EXT3_Basic_Wide@9.0.2...
Installed PDLS_EXT3_Basic_Wide@9.0.2
* Perform the same procedure for all the variants, PDLS_EXT3_Basic_Global, PDLS_EXT3_Basic_Wide, PDLS_EXT3_Basic_Fast, PDLS_EXT3_Basic_Touch, PDLS_EXT3_Basic_BWRY and PDLS_EXT4_Basic_Matter.

Use

  • Launch the Arduino IDE.

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

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

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

#include "Pervasive_Touch_Small.h"
#include "PDLS_Advanced.h"
  • Edit the lines and set the correct screen and board.
Pervasive_Wide_Small myDriver(eScreen_EPD_271_KS_09, boardRaspberryPiPico_RP2040);
Screen_EPD myScreen(&myDriver);
Legacy version 8
  • Launch the Arduino IDE.

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

  • 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);
  • Click on Verify or Build.

The screen should display


See also

  • Select one of the boards;

  • Set the configuration of the screen;

  • Use the different graphics and text functions;

  • Refer to the reference manual for an exhaustive list of the functions with details of the parameters and returned values.