Simple test

Ensure your device works with this simple test.

examples/displayio_ssd1306_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# from fourwire import FourWire
13import terminalio
14from adafruit_display_text import label
15from i2cdisplaybus import I2CDisplayBus
16
17import adafruit_displayio_ssd1306
18
19displayio.release_displays()
20
21oled_reset = board.D9
22
23# Use for I2C
24i2c = board.I2C()  # uses board.SCL and board.SDA
25# i2c = board.STEMMA_I2C()  # For using the built-in STEMMA QT connector on a microcontroller
26display_bus = I2CDisplayBus(i2c, device_address=0x3C, reset=oled_reset)
27
28# Use for SPI
29# spi = board.SPI()
30# oled_cs = board.D5
31# oled_dc = board.D6
32# display_bus = FourWire(spi, command=oled_dc, chip_select=oled_cs,
33#                                 reset=oled_reset, baudrate=1000000)
34
35WIDTH = 128
36HEIGHT = 32  # Change to 64 if needed
37BORDER = 5
38
39display = adafruit_displayio_ssd1306.SSD1306(display_bus, width=WIDTH, height=HEIGHT)
40
41# Make the display context
42splash = displayio.Group()
43display.root_group = splash
44
45color_bitmap = displayio.Bitmap(WIDTH, HEIGHT, 1)
46color_palette = displayio.Palette(1)
47color_palette[0] = 0xFFFFFF  # White
48
49bg_sprite = displayio.TileGrid(color_bitmap, pixel_shader=color_palette, x=0, y=0)
50splash.append(bg_sprite)
51
52# Draw a smaller inner rectangle
53inner_bitmap = displayio.Bitmap(WIDTH - BORDER * 2, HEIGHT - BORDER * 2, 1)
54inner_palette = displayio.Palette(1)
55inner_palette[0] = 0x000000  # Black
56inner_sprite = displayio.TileGrid(inner_bitmap, pixel_shader=inner_palette, x=BORDER, y=BORDER)
57splash.append(inner_sprite)
58
59# Draw a label
60text = "Hello World!"
61text_area = label.Label(terminalio.FONT, text=text, color=0xFFFFFF, x=28, y=HEIGHT // 2 - 1)
62splash.append(text_area)
63
64while True:
65    pass