e-Paper Essentials
An e-paper screen behaves differently from an LCD or OLED. This page covers the few ideas that change how you write code for Inkplate 10: it draws into a frame buffer first, it has two display modes, and it can refresh in full or in part.
How does this e-paper display work?
Inkplate 10 does not draw straight onto the panel. Your sketch draws into a frame buffer in memory, and a call to display() sends that buffer to the panel. The Hello World example says it directly: clearDisplay() clears only the frame buffer, so display() must be called to update the physical screen.
An e-paper panel keeps its image without power. That is why the board can sleep at 22 µA between updates and still show the last picture.
Display modes
The Arduino library offers two modes, chosen when you create the display object:
INKPLATE_1BITis black and white. Each pixel is either black or white.INKPLATE_3BITis grayscale. The library's grayscale example describes 8 shades from 0 (black) to 7 (white).
Pick the mode in the constructor, for example Inkplate display(INKPLATE_3BIT);. The black and white mode is the simpler one, and partial updates are available only in that mode according to the partial update example.
Full and partial updates
A full update, display(), refreshes the whole panel. Inkplate 10 lists a full refresh time of 1.61 s. A partial update, partialUpdate(), redraws only the changed areas, which is faster and avoids a full-screen flicker.
Partial updates build up ghosting (a faint trace of earlier content), so mix in full updates. The library can do this for you with setFullUpdateThreshold(), which forces a full update after a set number of partial updates. Run a full update every 5 to 10 partial updates.
If ghosting stays visible, the library ships a burnInClean example that runs repeated full refreshes. See the Arduino section for the page.
Waveforms
A waveform is the sequence of voltages that drives the panel pixels. The pinned library stores several waveforms for Inkplate 10 and lets you choose one, and its Set_Waveform diagnostic example previews waveforms 1 to 5 on a gray gradient. Burning a waveform into EEPROM has limited endurance, so only do it when you need to.
The waveforms differ very little: they only change how the shades of gray are generated. You need to choose one only if the waveform stored in EEPROM is lost. In that case, preview several waveforms and pick the one whose grays look best on your panel.