Pervasive Displays Library Suite - Reference Manual 9.0.3
Library for Pervasive Displays e-paper screens, extension boards and development kits
Loading...
Searching...
No Matches
hV_List_Options.h File Reference

List of options for Pervasive Displays Library Suite - Advanced edition. More...

This graph shows which files directly or indirectly include this file:

Macros

#define hV_LIST_OPTIONS_RELEASE   902
 Release.
 
#define MAX_FONT_SIZE   64
 4- Maximum number of fonts
 
3- Set font mode

From header files or from external flash

  • Basic edition: Terminal font
  • Evaluation edition: DejaVu font as header
  • Commercial edition: DejaVu font as either header or external SPI Flash
  • Viewer edition: DejaVu font as header
Note
USE_FONT_HEADER requires addFont()
Font Manager requires USE_FONT_HEADER
Warning
8- and 16-bit MCUs may limit the size of the fonts. Use 32-bit MCUs for optimal performance.
#define USE_FONT_TERMINAL   1
 Use default Terminal fonts.
 
#define USE_FONT_HEADER   2
 Use fonts from header files.
 
#define USE_FONT_FLASH   3
 Use fonts from external SPI Flash memory.
 
#define USE_FONT_INTERNAL   4
 Use fonts from internal CGU.
 
#define FONT_MODE   USE_FONT_HEADER
 Selected option.
 
5- Set SRAM memory

From internal MCU or external SPI

  • Basic edition: MCU internal SRAM
  • Commercial edition: MCU internal SRAM
  • Evaluation edition: MCU internal or SPI external SRAM
  • Viewer edition: MCU internal SRAM
Note
Corresponding type defined at hV_List_Types.h
#define USE_INTERNAL_MCU   1
 Use MCU internal.
 
#define USE_EXTERNAL_SPI   2
 Use SPI External.
 
#define SRAM_MODE   USE_INTERNAL_MCU
 Selected option.
 
6- Use virtual object

From hV_Screen_Virtual.h for extended compability

Note
Declare additional variables if USE_hV_SCREEN_SELF
Virtual object requires ~1 kB bytes.
  • Basic edition: self option
  • Evaluation edition: virtual option
  • Commercial edition: self and virtual options
  • Viewer edition: virtual option
Recommended: USE_hV_SCREEN_VIRTUAL
Warning
Issues with virtual function on arm-none-eabi-g++ 4.9.3: use USE_hV_SCREEN_SELF instead.
#define USE_hV_SCREEN_VIRTUAL   1
 Use virtual object.
 
#define USE_hV_SCREEN_SELF   2
 Do not use virtual object.
 
#define USE_hV_SCREEN   USE_hV_SCREEN_VIRTUAL
 Selected option.
 
7- Set touch mode

Only two screens are ready for touch

  • Basic edition: iTC 2.71 BW and iTC 3.70 BW
  • Evaluation edition: iTC 2.71 BW and iTC 3.70 BW
  • Commercial edition: iTC 2.71 BW and iTC 3.70 BW
  • Viewer edition: iTC 2.71 BW and iTC 3.70 BW
Note
Touch uses I2C and polling over interrupt
#define USE_TOUCH_NONE   0
 Do not use touch.
 
#define USE_TOUCH_YES   1
 Use touch.
 
#define TOUCH_MODE   USE_TOUCH_NONE
 Selected option.
 
8- Set haptic feedback mode
  • Basic edition: no haptic feedback
  • Evaluation edition: ERM or LRA
  • Commercial edition: ERM or LRA
  • Viewer edition: no haptic feedback
#define USE_HAPTICS_NONE   0
 No motor.
 
#define USE_DRV2605L_ERM   1
 DRV2605L with ERM = eccentric rotating mass.
 
#define USE_DRV2605L_LRA   2
 DRV2605L with LRA = linear resonant actuator.
 
#define HAPTICS_MODE   USE_HAPTICS_NONE
 Selected option.
 
9- Set GPIO expander mode
  • Basic edition: no expander
  • Evaluation edition: PCF8574 or PCA9536
  • Commercial edition: PCF8574 or PCA9536
  • Viewer edition: no expander
#define USE_EXPANDER_NONE   0
 No I2C expander.
 
#define USE_I2C_PCF8574   1
 PCF8574 8 ports GPIO I2C 100 kHz expander.
 
#define USE_I2C_PCA9536   2
 PCA9536 4 ports GPIO I2C 400 kHz expander.
 
#define USE_I2C_TCA6408   3
 TCA6408 8 ports GPIO I2C 400 kHz expander.
 
#define EXPANDER_MODE   USE_EXPANDER_NONE
 Selected option.
 
10- Set string mode
  • Basic edition: String object
  • Evaluation edition: char array
  • Commercial edition: String object or char array
  • Viewer edition: char array
Note
Corresponding type defined at hV_List_Types.h
11- Storage mode
  • Basic edition: none
  • Evaluation edition: none
  • Commercial edition: option
  • Viewer edition: option
Note
Options can be combined
#define STORAGE_MODE (USE_SD_CARD | USE_SPI_FLASH)
#define STORAGE_MODE (USE_LINUX_FILES | USE_SERIAL_CONSOLE)
#define USE_NONE   0
 No storage.
 
#define USE_SD_CARD   1
 SD card.
 
#define USE_SPI_FLASH   2
 External SPI Flash.
 
#define USE_SERIAL_CONSOLE   4
 Serial console for writing only.
 
#define USE_LINUX_FILES   8
 For Linux native applications.
 
#define USE_WINDOWS_FILES   16
 For Windows native applications.
 
#define STORAGE_MODE   USE_SERIAL_CONSOLE
 Selected options.
 
12- Debug options
  • Basic edition: none
  • Evaluation edition: all
  • Commercial edition: option
  • Viewer edition: option
Note
Advanced and Viewer editions only
#define DEBUG_CONTINUITY   0
 Continuity mode, 0 = no, 1 = yes; recommended = 0.
 
#define DEBUG_SPI_SCREEN   0
 SPI debugging for screen, 1 = activated, otherwise 0; recommended = 0.
 
#define DEBUG_DELAY   0
 Delay ms and us, 1 = activated, otherwise 0; recommended = 0.
 
#define DEBUG_OTP   0
 Print OTP content, 0 = no, 1 = yes; recommended = 0.
 
#define DEBUG_POWER   0
 Trace power management, 0 = no, 1 = yes; recommended = 0.
 
#define DEBUG_WIRE   0
 Trace Wire, 0 = no, 1 = yes; recommended = 0.
 
13- EXT boards
  • Basic edition: EXT3 and EXT4
  • Evaluation edition: EXT3
  • Commercial edition: EXT3
  • Viewer edition: EXT3
Note
Corresponding boards defined at hV_List_Boards.h
#define BOARD_EXT2   2
 EXT2 board.
 
#define BOARD_EXT3   3
 EXT3 and EXT3.1 boards.
 
#define BOARD_EXT4   4
 EXT4 board.
 
#define USE_EXT_BOARD   BOARD_EXT3
 Selected board.
 

Detailed Description

List of options for Pervasive Displays Library Suite - Advanced edition.

Project Pervasive Displays Library Suite
Based on highView technology


Content

  • 1- List of supported Pervasive Displays screens, deprecated, see drivers
  • 2- List of pre-configured boards, see hV_List_Boards.h
  • 3- Font mode, internal MCU or external SPI Flash
  • 4- Maximum number of fonts
  • 5- SRAM memory, internal MCU or external SPI
  • 6- Use self or virtual object
  • 7- Touch mode, activated or not
  • 8- Haptic feedback mode, activated or not
  • 9. Set GPIO expander mode, activated or not
  • 10. String object of char array options for string
  • 11. Set storage mode, serial console by default
  • 12. Set debug options
  • 13. Select EXT board
Author
Rei Vilo
Date
21 Jan 2025
Version
902
  • Basic edition: for hobbyists and for basic usage
    Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
    See also
    https://creativecommons.org/licenses/by-sa/4.0/

    Consider the Evaluation or Commercial editions for professionals or organisations and for commercial usage
  • Evaluation edition: for professionals or organisations, evaluation only, no commercial usage
    All rights reserved
  • Commercial edition: for professionals or organisations, commercial usage
    All rights reserved
  • Viewer edition: for professionals or organisations
    All rights reserved
  • Documentation
    All rights reserved

Macro Definition Documentation

◆ EXPANDER_MODE

#define EXPANDER_MODE   USE_EXPANDER_NONE

Selected option.

Note
Commercial edition only

◆ HAPTICS_MODE

#define HAPTICS_MODE   USE_HAPTICS_NONE

Selected option.

Note
Commercial edition only

◆ MAX_FONT_SIZE

#define MAX_FONT_SIZE   64

4- Maximum number of fonts

With MCU Flash, based on available memory, check performed at compilation

  • USE_FONT_TERMINAL: 1..4
  • USE_FONT_HEADER: 1..64

With SPI Flash, based on the fonts previously uploaded

  • USE_FONT_FLASH: eg. 64

◆ SRAM_MODE

#define SRAM_MODE   USE_INTERNAL_MCU

Selected option.

Note
Commercial edition only

◆ STORAGE_MODE

#define STORAGE_MODE   USE_SERIAL_CONSOLE

Selected options.

Note
Advanced and Viewer editions only

◆ TOUCH_MODE

#define TOUCH_MODE   USE_TOUCH_NONE

Selected option.

Note
Commercial edition only

◆ USE_hV_SCREEN

#define USE_hV_SCREEN   USE_hV_SCREEN_VIRTUAL

Selected option.

Note
Commercial edition only