Skip to content

Parameters

The configuration files list the supported Pervasive Displays screens, provide a repository of the configuration of the main controller 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 main controller boards are defined dynamically at run-time, while the other parameters are set statically 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 main controller boards.

The recommended boards are

  • Adafruit Feather nRF52840;

  • Arduino Nano Matter based on Silicon Labs MGM240S;

  • 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;

  • Raspberry Pi Zero and B;

  • STM32 Nucleo 64, and compatible boards.

The deprecated boards includes

  • Particle Photon and RedBear Duo;

  • Texas Instruments MSP430 and MSP432 LaunchPad, and compatible boards;

  • Texas Instruments CC1352 LaunchPad and CC1352 LPSTK.

The technical note Define a non-listed board explains how to define a non-listed board.

Constants

The hV_List_Constants header file lists the constants used at run-time.

Build-time options

The hV_List_Options header file sets the build-time options.

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.

Info

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.

Info

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.

Info

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, but required by the PDLS_EXT3_Advanced_Touch library;

  • Viewer edition: touch, required by the PDLS_EXT3_Viewer_Touch library.

Info

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

Haptics

Not implemented, for future releases.

Info

The HAPTICS_MODE setting impacts the Common and GUI libraries.

GPIO expander

Not implemented, for future releases.

Info

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.

Info

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.

Info

The STORAGE_MODE setting impacts the Common and Files libraries.

Debug

Debug options print a trace on the serial console for SPI, Wire, panel power, panel OTP memory.

  • Basic edition: none;

  • Evaluation edition: all;

  • Commercial edition: optional;

  • Viewer edition: none.

Info

The DEBUG_SPI_SCREEN, DEBUG_WIRE, DEBUG_POWER and DEBUG_OTP settings impact the Screens, Files libraries.

Board

The board option allows to select between the EXT3 and EXT4 extension boards.

  • Basic edition: EXT3 and EXT4, but PDLS_EXT4_Basic_Matter requires EXT4;

  • Evaluation edition: EXT3 only;

  • Commercial edition: EXT3 only;

  • Viewer edition: none.

Info

The USE_EXT_BOARD setting impacts the Common and Screens libraries.