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