README.md

MicroPython SSD1306

MicroPython Library for SSD1306 OLED Displays with some simple shape drawing functions.

Installation

• Manual Installation
  • Upload the ssd1306.py file to your device.
• Thonny IDE Package Manager
  • Open Thonny IDE.
  • Go to Tools > Manage Packages.
  • Search for micropython-ssd1306-driver and install it.

Example Usage

• Screen Control
• Text
• Shape
• Image
• QRCode
• More Example

Quick Example

# Import Library
from ssd1306 import SSD1306_I2C
from machine import Pin,SoftI2C

# Pin Setup
i2c = SoftI2C(scl=Pin(22), sda=Pin(21))
oled = SSD1306_I2C(128, 64, i2c)

# Text Display (Text,x,y,color)
oled.text("Hello Wolrd!",0,0,1)
oled.show()

Useful Link & Tools

• External QRCode Library
  • This library is used to generate a QR code matrix and render it to the SSD1306.
• Image to Matrix Generator
  • This link is used to convert images into byte arrays and render them to the SSD1306.