OLED screen menu document?

pi-top [4]
#1

Where is the documentation of the OLED screen menu? The Knowledge Base article points to the desktop Help menu, but it seems to be out of date - no such document there any more in the June 2021 software image.

The OLED screen tutorial in Further doesn’t work. After connecting to the Pi-Top and clicking Run, the following error appears:

Traceback (most recent call last):
File “/tmp/3033314480.py”, line 2, in
from pitop.miniscreen import OLED
ImportError: cannot import name ‘OLED’ from ‘pitop.miniscreen’ (/usr/lib/python3/dist-packages/pitop/miniscreen/__init__.py)

#2

Where is the documentation of the OLED screen menu?

Currently, the actual menu application does not have documentation. This application is currently being rewritten (almost from scratch), so it would be out of date soon anyway. This should be a much friendlier interface, with documentation, in the near future.

As for using the miniscreen for yourself:

from pitop import Pitop

pitop = Pitop()
pitop.miniscreen.display_...(...)

(docs here)

#3

Thanks for pointing this out, there was indeed some code in the miniscreen tutorial using this old form of the sdk. We have corrected it now.

If you have made your own edits to the sample code you will have to press the ‘reset’ button in the editor to see this change.

#4

So, what should the code in the tutorial be if not:

# Import modules
from pitop.miniscreen import OLED
from time import sleep

# Initialise the Mini Screen
miniscreen = OLED()

# Prompt for user input from the console
name = input("Type your name here, then press Enter: ")

# Draw the message to the screen for 5 seconds
miniscreen.display_multiline_text('Hello, ' + name, font_size=20)
sleep(5)