Parameters¶

The configuration files list the supported Pervasive Displays screens, provide a repository of the configuration of the boards, and set system-wide options for the frame-buffer, the fonts, the type of strings and other features.

Note that the screens and the boards are defined dynamically at run-time, while the other parameters are set statistically at build-time.

Run-time parameters¶

Screens¶

The hV_List_Screens header file provides the extensive list of the supported screens.

The option for the screen update are

Basic edition: global update;
Evaluation and Commercial editions: global and fast update;
Viewer editions: global and fast update.

Some restrictions apply: see the list for more details.

Boards¶

The hV_List_Boards header file provides the list of the pre-configured boards.

The recommended boards are

Adafruit Feather nRF52840;
Espressif ESP32-DevKitC;
Raspberry Pi Pico RP2040.

The other boards are

boards compatible with those listed as recommended;
Arduino Zero or M0 Pro, and compatible boards;
Particle Photon and RedBear Duo;
Raspberry Pi Zero and B;
STM32 Nucleo 64, and compatible boards;
Texas Instruments MSP430 and MSP432 LaunchPad, and compatible boards;
Texas Instruments CC1352 LaunchPad and CC1352 LPSTK.

Build-time parameters¶

The hV_List_Constants header file lists the build-time parameters.

Warning

Those parameters are fixed for the pre-compiled Evaluation edition. They can be edited and taken into account for the Commercial edition.

Fonts¶

The Fonts include

Basic edition: the Terminal font, with up to 4 variants;
Evaluation and Commercial editions: the fixed Mono, and the proportional Serif and Sans Serif, with up to 64 variants.

Fonts are located on

Basic edition: internal MCU Flash;
Evaluation edition: internal MCU Flash;
Commercial edition: internal MCU or external SPI Flash.

The FONT_MODE setting impacts the Common, Fonts and Screens libraries.

Frame-buffer¶

Frame-buffer is located on

Basic edition: internal MCU SRAM;
Evaluation edition: internal MCU SRAM;
Commercial edition: internal MCU or external SPI SRAM.

The SRAM_MODE setting impacts the Common, Screens, Files and GUI libraries.

Reference object¶

The reference object is

Basic edition: itself;
Evaluation edition: pure virtual object;
Commercial edition: itself or pure virtual object.

The pure virtual object brings an enhanced compatibility with high level libraries.

The USE_hV_SCREEN setting impacts the Common libraries.

Touch¶

Touch is implemented with

Basic edition: none, except for PDLS_EXT3_Basic_Touch library;
Evaluation edition: none, except for PDLS_EXT3_Advanced_Touch library;
Commercial edition: option.

Legacy version 5

Basic edition: none, except for PDLS_EXT3_Basic_Touch library;
Evaluation edition: only for PDLS_EXT3_Advanced_Fast_Touch library;
Commercial edition: option.

The TOUCH_MODE setting impacts the Common, Screen and GUI libraries.

Haptics¶

Not implemented, for future releases.

The HAPTICS_MODE setting impacts the Common and GUI libraries.

GPIO expander¶

Not implemented, for future releases.

The EXPANDER_MODE setting impacts the Common libraries.

String¶

The string is handled as

Basic edition: a String object from Arduino SDK;
Evaluation edition: a C-standard char array supported by the cstring library;
Commercial edition: a String object provided by the Arduino SDK or a C-standard char array supported by the cstring library;
Viewer edition: a C-standard char array supported by the cstring library.

The STRING_MODE setting impacts the Common, Fonts, Screens, Code, Files, Graphics, GUI and Serial libraries.

Storage¶

Storage options include files saved and read on SD-card, and header files printed on serial console and read from Flash.

Storage is implemented

Basic edition: none;
Evaluation edition: serial console;
Commercial edition: SD-card and serial console;
Viewer edition: Linux file system and serial console.

The STORAGE_MODE setting impacts the Common and Files libraries.