Skip to content

Parameters

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

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

Supported screens

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

The option for the screen update are

  • Basic edition: global update;
  • Advanced and commercial editions: global update, fast update and partial update.

Some restrictions apply: see the list for more details.

Pre-configured boards

The pre-configured boards are

  • Adafruit Feather M0 or M4, and compatible boards;
  • Arduino Zero or M0 Pro, and compatible boards;
  • Espressif ESP32-DevKitC, and compatible boards.
  • Particle Photon and RedBear Duo;
  • Raspberry Pi Zero and B;
  • Raspberry Pi Pico RP2040, and compatible boards;
  • STM32 Nucleo 64, and compatible boards;
  • Texas Instruments MSP430 and MSP432 LaunchPad, and compatible boards;
  • Texas Instruments CC1352 LaunchPad and CC1352 LPSTK;

Fonts

The Fonts include

  • Basic edition: the Terminal font, with up to 4 variants;
  • Advanced 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;
  • Advanced edition: internal MCU Flash;
  • Commercial editions: 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;
  • Advanced 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;
  • Advanced 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;
  • Advanced edition: none, except 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;
  • Advanced 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 and GUI 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;
  • Advanced edition: serial console;
  • Commercial edition: SD-card and serial console.

The STORAGE_MODE setting impacts the Common and File libraries.