Documentation
Display Editor

Display Editor

If you have a display connected to your board, you can put your own content on it: text, live sensor readings and simple layouts.


How it works

The display editor in the Palpable app lets you design what appears on your screen with blocks. Your changes go to the display on their own as you edit; there is no save button.

When a sensor value in your design changes, the display updates with the new value.


Getting started with the display editor

  1. Connect a display to your board with a Qwiic cable
  2. Open your project in the Palpable app
  3. You'll see a live preview of the display. Tap it to open the editor

Display not showing up? A newly plugged display usually appears within a few seconds. If it doesn't, check the cable.


What you can put on the display

Text

Labels, headings or any text you want. You control the size and position.

Live sensor values

Show real-time readings from your sensors. The values update by themselves as the sensors report new readings. For example:

  • Current temperature and humidity
  • A distance reading
  • A counter that follows the knob

Layout

Arrange content in grids, add dividers, or build structured layouts.

More than the editor can draw

Ask PAL for something the blocks can't do, and it can make the display for you in other ways:

  • A custom design, built from scratch, with its own shapes, animation and live values
  • A moving pattern, like a slow gradient or a ripple, drawn fresh on every frame
  • A web page, shown on the display from its address

Just describe what you want: "Show a slowly breathing circle that gets bigger when it's warmer."


Display compatibility

The editor adapts to your display's size and shape. Palpable works with small OLED screens, color LCDs and e-ink displays. Some popular ones:

DisplayResolutionNotes
SSD1306 OLED128 x 32 or 128 x 64Tiny, low-power, great for status info
SH1107 OLED128 x 128A larger square display
LCD / TFTVariousColor displays for richer content
E-inkVariousLow-power, keeps showing its content

Live updates

Content on your display reacts to sensor changes by itself. You don't need a script for this: it happens when your design includes a sensor reading.


Tips

  • Keep it simple. Small displays work best with one or two pieces of information.
  • High contrast works best. Bold text and simple graphics look good on every display.
  • Ask PAL. Say "Show the temperature and humidity on my display" and PAL makes the layout for you.