Simple test

Ensure your device works with this simple test.

examples/displayio_ssd1305_simpletest.py
 1# SPDX-FileCopyrightText: 2021 ladyada for Adafruit Industries
 2# SPDX-License-Identifier: MIT
 3
 4"""
 5This test will initialize the display using displayio and draw a solid white
 6background, a smaller black rectangle, and some white text.
 7"""
 8
 9import board
10import displayio
11
12# Use for I2C
13# from i2cdisplaybus import I2CDisplayBus
14import terminalio
15from adafruit_display_text import label
16from fourwire import FourWire
17
18import adafruit_displayio_ssd1305
19
20displayio.release_displays()
21
22# Reset is usedfor both SPI and I2C
23oled_reset = board.D9
24
25# Use for SPI
26spi = board.SPI()
27oled_cs = board.D5
28oled_dc = board.D6
29display_bus = FourWire(
30    spi, command=oled_dc, chip_select=oled_cs, baudrate=1000000, reset=oled_reset
31)
32
33# Use for I2C
34# i2c = board.I2C()  # uses board.SCL and board.SDA
35# i2c = board.STEMMA_I2C()  # For using the built-in STEMMA QT connector on a microcontroller
36# display_bus = I2CDisplayBus(i2c, device_address=0x3c, reset=oled_reset)
37
38WIDTH = 128
39HEIGHT = 64  # Change to 32 if needed
40BORDER = 8
41FONTSCALE = 1
42
43display = adafruit_displayio_ssd1305.SSD1305(display_bus, width=WIDTH, height=HEIGHT)
44
45# Make the display context
46splash = displayio.Group()
47display.root_group = splash
48
49color_bitmap = displayio.Bitmap(display.width, display.height, 1)
50color_palette = displayio.Palette(1)
51color_palette[0] = 0xFFFFFF  # White
52
53bg_sprite = displayio.TileGrid(color_bitmap, pixel_shader=color_palette, x=0, y=0)
54splash.append(bg_sprite)
55
56# Draw a smaller inner rectangle
57inner_bitmap = displayio.Bitmap(display.width - BORDER * 2, display.height - BORDER * 2, 1)
58inner_palette = displayio.Palette(1)
59inner_palette[0] = 0x000000  # Black
60inner_sprite = displayio.TileGrid(inner_bitmap, pixel_shader=inner_palette, x=BORDER, y=BORDER)
61splash.append(inner_sprite)
62
63# Draw a label
64text = "Hello World!"
65text_area = label.Label(terminalio.FONT, text=text, color=0xFFFFFF)
66text_width = text_area.bounding_box[2] * FONTSCALE
67text_group = displayio.Group(
68    scale=FONTSCALE,
69    x=display.width // 2 - text_width // 2,
70    y=display.height // 2,
71)
72text_group.append(text_area)  # Subgroup for text scaling
73splash.append(text_group)
74
75while True:
76    pass