Skip to content

Parameters

The configuration file lists the supported Pervasive Displays screens and the configuration of the boards, and provides system-wide options for the frame-buffer, the fonts, the type of strings and other features.

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

Run-time parameters

Screens

The extensive list is provided on the hV_Configuration.h file.

The option for the screen update are

  • Basic edition: global update;
  • Evaluation and Commercial editions: global update, fast update and partial update.

Some restrictions apply: see the list for more details.

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

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, File 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.

The STRING_MODE setting impacts the Common, Fonts, Screens, Code, File, 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.

The STORAGE_MODE setting impacts the Common and File libraries.