DIYables_MicroPython_OLED_SSD1309
MicroPython library for SSD1309-based monochrome OLED displays using the I2C interface.
Product Link: DIYables 2.4-inch OLED Display Module SSD1309 128×64
Features
- Supports 128×64, 128×32, 96×16, 64×48, and 64×32 display sizes
- Extends
framebuf.FrameBuffer– all MicroPython drawing primitives available out of the box (pixel,fill,fill_rect,rect,line,hline,vline,text,blit,ellipse,poly, …) - Hardware scrolling: right, left, diagonal right, diagonal left
- Contrast control and dim mode
- Power-off / power-on (sleep mode)
- Zero-copy
show()– no temporary buffer allocation on each refresh - Compatible with SoftI2C and hardware I2C
- Optional hardware reset pin support
Tested Hardware
| Board | Tested |
|---|---|
| ESP32 | ✅ |
| Raspberry Pi Pico | ✅ |
| DIYables ESP32 Development Board | ✅ |
| DIYables ESP32 S3, Uno-form factor | ✅ |
| Arduino Nano ESP32 | Not yet, expected to work |
| Arduino Giga R1 WiFi | Not yet, expected to work |
| Other MicroPython boards | Not yet, expected to work |
Tutorials
References
Installation
Install via mpremote (recommended for MicroPython boards):
mpremote mip install DIYables-MicroPython-OLED-SSD1309
Or install via pip and copy to your board manually:
pip install DIYables-MicroPython-OLED-SSD1309
Quick Start
from machine import I2C, Pin
from DIYables_MicroPython_OLED_SSD1309 import OLED_SSD1309
# ESP32 – SDA=GPIO21, SCL=GPIO22
# Pico – SDA=GP0, SCL=GP1
i2c = I2C(0, scl=Pin(22), sda=Pin(21), freq=400_000)
oled = OLED_SSD1309(128, 64, i2c)
oled.fill(0)
oled.text("Hello, World!", 0, 0)
oled.show()
Documentation
See DIYables_MicroPython_OLED_SSD1309 Library Reference for the complete API documentation including all constructors, methods, and constants.
Examples
| Example | Description |
|---|---|
| hello_world.py | Display text using the built-in 8×8 font |
| draw_shapes.py | Draw pixels, lines, rectangles, and ellipses |
| scroll_text.py | Hardware scrolling (right, left, diagonal) |
| contrast_dim.py | Animate contrast level and use dim mode |
| bitmap.py | Display a monochrome bitmap image using blit() |
1 maintainer
Release files for DIYables-MicroPython-OLED-SSD1309 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| diyables_micropython_oled_ssd1309-1.0.0.tar.gz | 10.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| diyables_micropython_oled_ssd1309-1.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 17.9 kB
Release files / diyables_micropython_oled_ssd1309-1.0.0.tar.gz
| Download URL | diyables_micropython_oled_ssd1309-1.0.0.tar.gz |
|---|---|
| Size | 10.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e5559f29e48047c9011539e8e35cfc00ef99834533dfeeddb808326ef15b9d0e
|
|
BLAKE2b-256 checksum How to use checksums |
2bb553372225d3387d8fd9e6d4c412003092efa432f6a89f7874a88c4b0aa59e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Release files / diyables_micropython_oled_ssd1309-1.0.0-py3-none-any.whl
| Download URL | diyables_micropython_oled_ssd1309-1.0.0-py3-none-any.whl |
|---|---|
| Size | 7.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
47a9058b5ce5ef18803937a200eab9293b7900c8bfe72ac0668227e6ead3622d
|
|
BLAKE2b-256 checksum How to use checksums |
ca3b986b122e3d372aff264bb4a4881331170fc4945d840e082d463af549ba73
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
