The luma.oled library supports a wide range of OLED display controllers: SSD1305, SSD1306, SSD1309, SSD1315, SSD1316, SSD1322, SSD1325, SSD1327, SSD1331, SSD1351, SSD1362, SH1106, SH1107, WS0010, and CH1115. Controllers span three color modes — monochrome (1-bit), 4-bit greyscale, and 16-bit RGB color — and are accessible over I2C, SPI, or parallel interfaces depending on the chipset.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/rm-hull/luma.oled/llms.txt
Use this file to discover all available pages before exploring further.
| Class | Controller | Color mode | Default resolution | Interface |
|---|---|---|---|---|
ssd1305 | SSD1305 | Monochrome | 128×32 | I2C / SPI |
ssd1306 | SSD1306 | Monochrome | 128×64 | I2C / SPI |
ssd1309 | SSD1309 | Monochrome | 128×64 | SPI |
ssd1315 | SSD1315 | Monochrome | 128×64 | I2C / SPI |
ssd1316 | SSD1316 | Monochrome | 128×32 | I2C / SPI |
ssd1322 | SSD1322 | 4-bit greyscale | 256×64 | SPI |
ssd1322_nhd | SSD1322 (NHD) | 4-bit greyscale | 128×64 | SPI |
ssd1325 | SSD1325 | 4-bit greyscale | 128×64 | SPI |
ssd1327 | SSD1327 | 4-bit greyscale | 128×128 | I2C / SPI |
ssd1331 | SSD1331 | 16-bit RGB color | 96×64 | SPI |
ssd1351 | SSD1351 | 16-bit RGB color | 128×128 | SPI |
ssd1362 | SSD1362 | 4-bit greyscale | 256×64 | SPI |
sh1106 | SH1106 | Monochrome | 128×64 | I2C / SPI |
sh1107 | SH1107 | Monochrome | 64×128 | I2C / SPI |
ws0010 | WS0010 | Monochrome | 100×16 | Parallel |
winstar_weh | WS0010 | Monochrome | 16×2 chars | Parallel |
ch1115 | CH1115 | Monochrome | 128×64 | I2C / SPI |
The table above lists the default resolution for each class. Many controllers accept alternate resolutions — for example,
ssd1306 also supports 128×32, 96×16, 64×48, and 64×32. Passing an unsupported resolution raises a DeviceDisplayModeError. See the device class reference for the full list of supported dimensions per class.