Examples

All the examples share in common the following code, which is not mentioned in the pages of the elements.

The section below includes the SDK and the libraries, and defines the variables.

// SDK and configuration
#include "PDLS_Common.h"

// Set parameters
#define DISPLAY_GRAPHICS_ELEMENT 1

// Define variables and constants
// Driver
#include "Pervasive_Wide_Small.h"
Pervasive_Wide_Small myDriver(eScreen_EPD_271_KS_09, boardRaspberryPiPico_RP2040);

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

#include "hV_Graphics.h"

const uint8_t myOrientation = ORIENTATION_LANDSCAPE;
uint8_t fontExtra, fontLarge, fontMedium, fontSmall;

Legacy release 8

// SDK and configuration
#include "hV_Common.h"

// Screen
#include "PDLS_EXT3_Advanced_Fast.h"
Screen_EPD_EXT3_Fast myScreen(eScreen_EPD_271_PS_09, boardRaspberryPiPico_RP2040);

The function below displays a count-down.

// Utilities
void wait(uint8_t second)
{
    for (uint8_t i = second; i > 0; i--)
    {
        hV_HAL_delayMilliseconds(100);
        hV_HAL_Serial_printf(" > %i  \r", i);
        hV_HAL_delayMilliseconds(900);
    }
    hV_HAL_Serial_printf("         \r");
}

The code below is specific to each element.

// Functions
#if (DISPLAY_GRAPHICS_ELEMENT == 1)

void displayElement()
{
    // Example for element
}

#endif // DISPLAY_GRAPHICS_ELEMENT

The main code initialises the screen and the GUI, then calls the example for the element.

// Add setup code
void setup()
{
    hV_HAL_begin();

    hV_HAL_Serial_crlf();
    hV_HAL_log(LEVEL_INFO, __FILE__);
    hV_HAL_log(LEVEL_INFO, __DATE__ " " __TIME__);
    hV_HAL_Serial_crlf();

    // Initialise screen
    myScreen.begin();
    hV_HAL_Serial_crlf();

    // Add fonts from header files
    fontSmall = myScreen.addFont(Font_DejaVuSans14b);
    fontSmall -= (fontSmall > 0) ? 1 : 0;
    fontMedium = myScreen.addFont(Font_DejaVuSans16);
    fontMedium -= (fontMedium > 0) ? 1 : 0;
    fontLarge = myScreen.addFont(Font_DejaVuSans20);
    fontLarge -= (fontLarge > 0) ? 1 : 0;
    fontExtra = myScreen.addFont(Font_DejaVuSans64b);
    fontExtra -= (fontExtra > 0) ? 1 : 0;

    // Example
#if (DISPLAY_GRAPHICS_ELEMENT == 1)

    hV_HAL_log(LEVEL_INFO, "DISPLAY_GUI_ELEMENT... ");
    myScreen.clear();
    displayElement();
    wait(8);

#endif // DISPLAY_GRAPHICS_ELEMENT

    // Against possible ghosting
    myScreen.regenerate();

    hV_HAL_exit(0);
}

// Add loop code
void loop()
{
    hV_HAL_delayMilliseconds(1000);
}