Add an extended version of st7789_280x240_simpletest.py

[CrackXT]

Hello Adafruit team,

I have extended the test code of st7789_280x240_simpletest.py.

Now the backlight setting and the offset correction of the ST7789 display driver at a resolution of 280x240 (1.69", Product ID: 5206) is included.

# SPDX-FileCopyrightText: 2021 ladyada for Adafruit Industries
# SPDX-License-Identifier: MIT

"""
This test will initialize the display using displayio, set display brighness and draw a solid green
background, a smaller purple rectangle, and some yellow text.
"""

import board
import displayio
import terminalio
from adafruit_display_text import label
from fourwire import FourWire

from adafruit_st7789 import ST7789

# Release any resources currently in use for the displays
displayio.release_displays()

spi = board.SPI()
tft_cs = board.D20
tft_dc = board.D21
backlight = board.D6

display_bus = FourWire(spi, command=tft_dc, chip_select=tft_cs, reset=board.D5)

#display = ST7789(display_bus, width=240, height=280, colstart=0, rowstart=20, rotation=0, backlight_pin=backlight)			# default setting for 1.69" with 0° rotation
display = ST7789(display_bus, width=280, height=240, colstart=0, rowstart=20, rotation=90, backlight_pin=backlight)			# default setting for 1.69" with 90° rotation
#display = ST7789(display_bus, width=240, height=280, colstart=0, rowstart=20, rotation=180, backlight_pin=backlight)		# default setting for 1.69" with 180° rotation
#display = ST7789(display_bus, width=280, height=240, colstart=0, rowstart=20, rotation=270, backlight_pin=backlight)		# default setting for 1.69" with 270° rotation

# set the backlight
# minimum value 0.001 (0.000 would be off), maximum value 1.000
display.brightness = 0.5

# Make the display context
splash = displayio.Group()
display.root_group = splash

#color_bitmap = displayio.Bitmap(240, 280, 1)			# default setting for 1.69" with 0° and 180° rotation
color_bitmap = displayio.Bitmap(280, 240, 1)			# default setting for 1.69" with 90° and 270° rotation
color_palette = displayio.Palette(1)
color_palette[0] = 0x00FF00  # Bright Green

bg_sprite = displayio.TileGrid(color_bitmap, pixel_shader=color_palette, x=0, y=0)
splash.append(bg_sprite)

# Draw a smaller inner rectangle
#inner_bitmap = displayio.Bitmap(200, 240, 1)			# default setting for 1.69" with 0° and 180° rotation
inner_bitmap = displayio.Bitmap(240, 200, 1)			# default setting for 1.69" with 90° and 270° rotation
inner_palette = displayio.Palette(1)
inner_palette[0] = 0xAA0088  # Purple
inner_sprite = displayio.TileGrid(inner_bitmap, pixel_shader=inner_palette, x=20, y=20)
splash.append(inner_sprite)

# Draw a label
#text_group = displayio.Group(scale=2, x=50, y=140)		# default setting for 1.69" with 0° and 180° rotation
text_group = displayio.Group(scale=3, x=37, y=120)		# default setting for 1.69" with 90° and 270° rotation
text = "Hello World!"
text_area = label.Label(terminalio.FONT, text=text, color=0xFFFF00)
text_group.append(text_area)  # Subgroup for text scaling
splash.append(text_group)

while True:
    pass

The code was tested with a Waveshare display (SKU: 27057) and an Unexpected Maker FeatherS2.

Thank you for your work and that of the community!

With kind regards
CrackXT

[makermelissa]

Awesome. Thanks for sharing.
The only suggestion I have for improving it is to have the rotation be its own variable and the width and height adjust based on the rotation. Something like this:

rotation = 90
if rotation not in (0, 90, 180, 270)
    raise ValueError("Rotation must be be one of: 0, 90, 180, 270")
width = 280 if rotation % 180 else 240
height = 240 if rotation % 180 else 280
display = ST7789(display_bus, width=width, height=height, colstart=0, rowstart=20, rotation=rotation, backlight_pin=backlight)

Want to submit the code as a PR for using this as an additional example?

[CrackXT]

Hello makermelissa,

Sorry for the delay and late response from me and thanks for the food for thought to improve the code once again.

Here is the optimized version, please have a look at it, thank you.

# SPDX-FileCopyrightText: 2021 ladyada for Adafruit Industries
# SPDX-License-Identifier: MIT

"""
This test will initialize the display using displayio, set display brightness and draw a solid green
background, a smaller purple rectangle, and some yellow text. The test also has the option of
rotating the screen content.
"""

import board
import displayio
import terminalio
from adafruit_display_text import label
from fourwire import FourWire
from adafruit_st7789 import ST7789

# set the display rotation
rotation = 90
if rotation not in (0, 90, 180, 270):
    raise ValueError("The value of rotation must be one of: 0, 90, 180, 270")

# Display settings depending on the selected rotation
# first value default setting for 1.69" with 0° and 180° rotation
# second value default setting for 1.69" with 90° and 270° rotation
width = 240 if rotation in (0, 180) else 280
height = 280 if rotation in (0, 180) else 240
color_bitmap_x = 240 if rotation in (0, 180) else 280
color_bitmap_y = 280 if rotation in (0, 180) else 240
inner_bitmap_x = 200 if rotation in (0, 180) else 240
inner_bitmap_y = 240 if rotation in (0, 180) else 200
scale = 2 if rotation in (0, 180) else 3
x = 50 if rotation in (0, 180) else 37
y = 140 if rotation in (0, 180) else 120

# Release any resources currently in use for the displays
displayio.release_displays()
spi = board.SPI()
tft_cs = board.D20
tft_dc = board.D21
backlight = board.D6
display_bus = FourWire(spi, command=tft_dc, chip_select=tft_cs, reset=board.D5)
display = ST7789(display_bus, width=width, height=height, colstart=0, rowstart=20, rotation=rotation, backlight_pin=backlight)

# set the backlight
# minimum value 0.001 (0.000 would be off), maximum value 1.000
display.brightness = 0.5

# Make the display context
splash = displayio.Group()
display.root_group = splash

# Draw background rectangle
color_bitmap = displayio.Bitmap(color_bitmap_x, color_bitmap_y, 1)
color_palette = displayio.Palette(1)
color_palette[0] = 0x00FF00  # Bright Green
bg_sprite = displayio.TileGrid(color_bitmap, pixel_shader=color_palette, x=0, y=0)
splash.append(bg_sprite)

# Draw a smaller inner rectangle
inner_bitmap = displayio.Bitmap(inner_bitmap_x, inner_bitmap_y, 1)
inner_palette = displayio.Palette(1)
inner_palette[0] = 0xAA0088  # Purple
inner_sprite = displayio.TileGrid(inner_bitmap, pixel_shader=inner_palette, x=20, y=20)
splash.append(inner_sprite)

# Draw a label
text_group = displayio.Group(scale=scale, x=x, y=y)
text = "Hello World!"
text_area = label.Label(terminalio.FONT, text=text, color=0xFFFF00)
text_group.append(text_area)  # Subgroup for text scaling
splash.append(text_group)

while True:
    pass

If you think the code is good enough, we would be happy to do a PR.

Thank you for your work and that of the community!

With kind regards
CrackXT

[makermelissa]

Looks great. Yes, please submit a PR.