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 thecstring
library; - Commercial edition: a
String
object provided by the Arduino SDK or a C-standardchar array
supported by thecstring
library.
The STRING_MODE
setting impacts the Common, Fonts, Screens, Code, File, Graphics and GUI libraries.
Storage¶
Storage options include SD-card and external Flash. Storage is implemented
- Basic edition: none;
- Advanced edition: none;
- Commercial edition: option.
The STORAGE_MODE
setting impacts the Common and File libraries.