1.. _ssd1306_128_shield:
2
3SSD1306 128x64(/32) pixels generic shield
4#########################################
5
6Overview
7********
8
9This is a generic shield for 128x64(/32) pixel resolution OLED displays
10based on SSD1306 controller. These displays have an I2C interface and
11usually only four pins: GND, VCC, SCL and SDA. Display pins can be
12connected to the pin header of a board using jumper wires.
13
14Current supported displays
15==========================
16
17+---------------------+---------------------+---------------------+
18| Display             | Controller /        | Shield Designation  |
19|                     | Driver              |                     |
20+=====================+=====================+=====================+
21| No Name             | SSD1306 /           | ssd1306_128x64      |
22| 128x64 pixel        | ssd1306             |                     |
23+---------------------+---------------------+---------------------+
24| No Name             | SSD1306 /           | ssd1306_128x32      |
25| 128x32 pixel        | ssd1306             |                     |
26+---------------------+---------------------+---------------------+
27| No Name             | SH1106 /            | sh1106_128x64       |
28| 128x64 pixel        | ssd1306             |                     |
29+---------------------+---------------------+---------------------+
30
31Requirements
32************
33
34This shield can only be used with a board which provides a configuration
35for Arduino connectors and defines a node alias for the I2C interface
36(see :ref:`shields` for more details).
37
38Programming
39***********
40
41Set ``--shield ssd1306_128x64`` when you invoke ``west build``. For example:
42
43.. zephyr-app-commands::
44   :zephyr-app: samples/subsys/display/lvgl
45   :board: frdm_k64f
46   :shield: ssd1306_128x64
47   :goals: build
48