Screen constants¶
Each screen has a product number printed on the back of the screen, on the top line close to the QR-code. This product number is used to build the screen constant used by the constructor.
The hV_List_Screens header file provides the extensive list of constants used by the supported screens.
Each driver library lists the screens it supports.
Screen product number¶
The product number printed on the back of the screen includes the size, the film and the controller.
Example
The screen with product number CE2271CS094 corresponds to a 2.71” panel with monochrome film CS and controler 09. It supports normal update.
Constructor screen constant¶
The screen constant used by the constructor closely follows this product number.
The screen constant starts with eScreen_EPD, contains the size, the film and the controller taken from the product number and separated with a _.
Some options like touch are mentioned with a suffix.
Example
The screen with product number CE2271KS094 corresponds to a 2.71” panel with film K and controler 09. The last digit 4 is ignored.
| - | Size | Film | Controller | - |
|---|---|---|---|---|
CE2 |
271 |
KS |
09 |
4 |
eScreen_EPD |
_271 |
_KS |
_09 |
The screen constant for the constructor is eScreen_EPD_271_KS_09.
// Driver
#include "Pervasive_Wide_Small.h"
Pervasive_Wide_Small myDriver(eScreen_EPD_271_KS_09, boardRaspberryPiPico_RP2040);
// Screen
#include "PDLS_Advanced.h"
Screen_EPD myScreen(&myDriver);
Legacy release 8
Screen_EPD_EXT3_Fast myScreen(eScreen_EPD_271_KS_09, boardRaspberryPiPico_RP2040);
Size¶
The size refers to the diagonal in inches and is coded on three positions.
Example
The code 271 from screen product number CE2271KS094 corresponds to a 2.71” panel.
The code 741 from screen product number CE2741KS060 corresponds to a 7.41” panel.
Film¶
The film defines the features of the screen.
| Film | Feature | Colour | Update | Commercial name |
|---|---|---|---|---|
C |
Monochrome | Black and white | Normal update | |
H |
Monochrome | Black and white | Normal update | Freezer |
J |
Red | Black, white, red | Normal update | Spectra Red |
Q |
Red and yellow | Black, white, red, yellow | Normal update | Spectra 4 |
P |
Embedded fast update | Black and white | Fast update | Aurora |
K |
Wide temperature and embedded fast update |
Black and white | Fast update | Wide temperature |
| Touch | Black and white | Fast update |
Example
The code K from screen product number CE2271KS094 corresponds to a monochrome panel with wide temperature and embedded fast update.
Controller¶
The controller is coded on two positions.
Example
Both screens with product numbers CE2266CS090 and CE2266CS0C0 correspond to a 2.66” monochrome panel. However, the first uses the 09 controller while the second uses the 0C controller.
Screens with same size and film can have different controllers.
Warning
Selecting a wrong controller may cause unexpected results and damage the screen.
Suffix¶
The only specific part for the constructor corresponds to the screens featuring touch and embedded fast update.
The screens featuring touch and embedded fast update require the additional mention of _Touch.
The screen constant starts with eScreen_EPD and contains the size, the film and the controller taken from the product number and separated by a _, then _Touch.
Example
The product number of the screens with touch includes a T at the second position.
The screen with product number QT2370PS0C1 corresponds to a 3.70” touch-panel with controler 0C.
| - | Size | Film | Controller | Touch |
|---|---|---|---|---|
QT2 |
370 |
PS |
0C |
|
eScreen_EPD_EXT3 |
_370 |
_PS |
_0C |
_Touch |
The screen constant for the constructor is eScreen_EPD_370_PS_0C_Touch.
// Driver
#include "Pervasive_Touch_Small.h"
Pervasive_Touch_Small myDriver(eScreen_EPD_370_PS_0C_Touch, boardRaspberryPiPico_RP2040);
// Screen
#include "PDLS_Advanced.h"
Screen_EPD myScreen(&myDriver);
Legacy release 8
Pervasive_Touch_Small myDriver(eScreen_EPD_370_PS_0C_Touch, boardRaspberryPiPico_RP2040);
Screen_EPD myScreen(&myDriver);
Legacy version 8
The product number of the screens with touch includes a T at the second position.
The screen with product number QT2370PS0C1 corresponds to a 3.70” touch-panel with controler 0C.
| - | Size | Film | Controller | Touch |
|---|---|---|---|---|
QT2 |
370 |
PS |
0C |
|
eScreen_EPD_EXT3 |
_370 |
_PS |
_0C |
_Touch |
The screen constant for the constructor is eScreen_EPD_370_PS_0C_Touch.
Screen_EPD_EXT3_Fast myScreen(eScreen_EPD_370_PS_0C_Touch, boardRaspberryPiPico_RP2040);
For more information about the screen product numbers, please refer to the Model name explanation and The different types E Ink imaging film pages on the Pervasive Displays website.