Skip to content

OLED

tcPDU supports 128x64 and 128x32 OLED displays via I2C protocol. The display is refreshed approximately every 3 seconds.

Elements of page

OLED

  1. Configuration form with fields to enable OLED display support, set I2C bus frequency, screen size, display time and define up to 4 screen content configurations.
  2. List of readings that can be displayed on the display.
  3. Virtual OLED function.

OLED display configuration

Data on the display can be presented in 2 or 4 lines (depending on the size of the display) with a length of up to 16 characters. The characters a-z, A-Z, 0-9, =, % and space are allowed.

You can also insert values from sensors, just like in the HTTP client, using a special format. More information on this here.

Configuration of multiple screens

The display time is the time after which the screen will be turned off. The time is counted from when the screen is turned on or the screen is changed using the action from Events and Scheduler.

Action OLED ON/NEXT SCREEN, available in Events and Scheduler, allows you to configure the cyclical changing of screens or turning on and changing screens in response to an event, e.g. a button connected to INPD. This action turns the screen on if it was off or if it was on it changes the screen to the next one.

Cyclic changing of screens

Continuously changing screens can be configured in many ways, offering different effects. Two of the possibilities are described below:

  • displaying successive screens without dimming the display

    To do this, in the Scheduler tab, add the entry as below and set the display time equal to 0 or longer than the period defined in the Schedule (here selected 15s).

    OLED - Cyclic changing of screens

  • displaying successive screens with the display dimming

    To do this, add two entries to the Scheduler as in the image below and set the display time to more than 0 (recommended not less than 5) and less than the period of defined entries (here 10s). It is important that both entries are activated at the same time, i.e. with a single save of form. This is because the OLED ON/NEXT SCREEN action must be performed twice in quick succession to turn on the display and change to the next screen.

    OLED - Cyclic changing of screens 2

Changing screens from events

Using Events, you can control the display depending on the readings available on the device, e.g. when one condition is met, display screen 1, and when the second condition is met, screen 2, or control the screen with the button.

Controlling the screen with a button

One option may be to use the INPD logic input with a button connected to it (the button connects the INPD input to ground). In Events, the following entry should be added (second visible entry with OUT1 allows you to test the function without connecting the button):

OLED - Changing screens from events

Pressing the button (or the OUT1 button) will turn on the display or change the displayed screen.

Virtual OLED

Virtual OLED

Experimental feature that displays content of OLED display in browser. Just fill in the form and visit the page via one of links in the section on page. There is no need for actual OLED display and the page can be viewed without signing in.