# afiskon/stm32-ssd1306

STM32 library for working with OLEDs based on SSD1306, SH1106, SH1107 and SSD1309, supports I2C and SPI

Repository: https://github.com/afiskon/stm32-ssd1306
Canonical: https://ross.abutalabs.com/products/stm32-ssd1306
Homepage: https://eax.me/2018/2018-03-26-stm32-ssd1306.html
Language: C
License: MIT
License Family: permissive
Topics: stm32, oled, ssd1306, ssd1309
Last push: 2025-07-01T09:09:20+00:00

## Health v2 (maintenance only)
Score: 45/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 29, release rhythm 35, longevity 100
- inputs: {"age_days": 3090, "days_push": 428, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1124, forks 276 (observed 2026-08-28T04:03:40.903363+00:00)

## What it is
A C library for STM32 microcontrollers that drives OLED displays based on SSD1306, SH1106, SH1107, and SSD1309 controllers over I2C or 4-wire SPI. It provides text rendering with custom fonts and graphics support, built on top of STM32 HAL.

## Use cases
- display text and graphics on an SSD1306 OLED from an STM32
- drive SH1106 displays that are only partially SSD1306-compatible
- connect a small OLED screen to a microcontroller over I2C or SPI
- render custom fonts on an embedded OLED display
- add a status display to an STM32-based IoT device

## When to choose
- you are using STM32 with HAL and an SSD1306-family OLED
- you need both I2C and SPI support for the same display driver
- you want a lightweight, MIT-licensed C library with examples

## When to avoid
- you target Arduino or non-STM32 microcontrollers (look for platform-specific ports or libraries)
- you need advanced color graphics for displays like SSD1351 or ILI9341 (separate libraries exist)
- you want a full GUI framework rather than a display driver

## Facets
- artifact type: library
- maturity: stable
- function: graphics, embedded
- domain: embedded-systems, hardware, developer-tools
- platform: embedded, c, iot
- tags: ssd1306, sh1106, oled-display, stm32, i2c, spi, display-driver

## Member repositories
- afiskon/stm32-ssd1306 (main) score 45

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:40.903363+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:39:38.241732+00:00, confidence not recorded.
  - readme: https://github.com/afiskon/stm32-ssd1306 (fetched 2026-08-28T04:03:40.903363+00:00, sha 486d810b23fe)
  - homepage: https://eax.me/2018/2018-03-26-stm32-ssd1306.html (fetched 2026-08-29T12:43:59.155180+00:00, sha 4a0291a68c2d)
- Data as of 2026-08-30T08:39:29.467469+00:00.