adafruit-circuitpython-displayio-sh1106 1.4.0

简介

SH1106 OLED显示屏的DisplayIO兼容库

依赖项

此驱动程序依赖于

• Adafruit CircuitPython

请确保所有依赖项都在CircuitPython文件系统中可用。这可以通过下载Adafruit库和驱动程序捆绑包或使用circup安装单个库轻松实现。

从PyPI安装

在支持GNU/Linux系统（如树莓派）上，您可以从PyPI本地安装驱动程序。为当前用户安装

pip3 install adafruit-circuitpython-displayio-sh1106

要全局安装（在某些情况下可能需要）

sudo pip3 install adafruit-circuitpython-displayio-sh1106

在当前项目虚拟环境中安装

mkdir project-name && cd project-name
python3 -m venv .venv
source .venv/bin/activate
pip3 install adafruit-circuitpython-displayio-sh1106

使用示例

import busio
import displayio
import terminalio
import fourwire
from adafruit_display_text import label
import adafruit_displayio_sh1106

displayio.release_displays()

spi = busio.SPI(board.SCK, board.MOSI)
display_bus = fourwire.FourWire(
    spi,
    command=board.OLED_DC,
    chip_select=board.OLED_CS,
    reset=board.OLED_RESET,
    baudrate=1000000,
)

WIDTH = 128
HEIGHT = 64
BORDER = 5
display = adafruit_displayio_sh1106.SH1106(display_bus, width=WIDTH, height=HEIGHT)

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

color_bitmap = displayio.Bitmap(WIDTH, HEIGHT, 1)
color_palette = displayio.Palette(1)
color_palette[0] = 0xFFFFFF  # White

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(WIDTH - BORDER * 2, HEIGHT - BORDER * 2, 1)
inner_palette = displayio.Palette(1)
inner_palette[0] = 0x000000  # Black
inner_sprite = displayio.TileGrid(
    inner_bitmap, pixel_shader=inner_palette, x=BORDER, y=BORDER
)
splash.append(inner_sprite)

# Draw a label
text = "Hello World!"
text_area = label.Label(
    terminalio.FONT, text=text, color=0xFFFFFF, x=28, y=HEIGHT // 2 - 1
)
splash.append(text_area)

while True:
    pass

文档

此库的API文档可在Read the Docs上找到。

有关构建库文档的信息，请参阅本指南。

贡献

欢迎贡献力量！在向本项目贡献力量之前，请阅读我们的行为准则，以帮助本项目保持开放和友好。