diff --git a/components/display/images/ssd1322-full.jpg b/components/display/images/ssd1322-full.jpg new file mode 100644 index 000000000..dc58e5251 Binary files /dev/null and b/components/display/images/ssd1322-full.jpg differ diff --git a/components/display/ssd1322.rst b/components/display/ssd1322.rst new file mode 100644 index 000000000..d2a0dd249 --- /dev/null +++ b/components/display/ssd1322.rst @@ -0,0 +1,65 @@ +SSD1322 OLED Display +==================== + +.. seo:: + :description: Instructions for setting up SSD1322 OLED display drivers. + :image: ssd1322.jpg + +.. _ssd1322-spi: + +Usage +----- + +The ``ssd1322_spi`` display platform allows you to use +SSD1322 (`datasheet `__, +`Newhaven Display `__) +displays with ESPHome. Note that this component is for displays that are connected via the 4-Wire :ref:`SPI bus `. + +.. figure:: images/ssd1322-full.jpg + :align: center + :width: 75.0% + + SSD1322 OLED Display + +Connect CLK, DIN, CS, DC, and RST to pins on your ESP. For power, connect +VCC to 3.3V and GND to GND. + +.. code-block:: yaml + + # Example configuration entry + spi: + clk_pin: D5 + mosi_pin: D7 + + display: + - platform: ssd1322_spi + model: "SSD1322 256x64" + reset_pin: D0 + cs_pin: D8 + dc_pin: D1 + lambda: |- + it.print(0, 0, id(font), "Hello World!"); + +Configuration variables: +************************ + +- **model** (**Required**): The model of the display. At present, only one option is available: + + - ``SSD1322 256x64`` + +- **reset_pin** (:ref:`Pin Schema `): The RESET pin. +- **cs_pin** (:ref:`Pin Schema `): The CS pin. +- **dc_pin** (:ref:`Pin Schema `): The DC pin. +- **lambda** (*Optional*, :ref:`lambda `): The lambda to use for rendering the content on the display. + See :ref:`display-engine` for more information. +- **update_interval** (*Optional*, :ref:`config-time`): The interval to re-draw the screen. Defaults to ``5s``. +- **pages** (*Optional*, list): Show pages instead of a single lambda. See :ref:`display-pages`. +- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation. + +See Also +-------- + +- :doc:`index` +- :apiref:`ssd1322_base/ssd1322_base.h` +- `SSD1322 Display documentation `__ at `Newhaven Display `__ +- :ghedit:`Edit` diff --git a/images/ssd1322.jpg b/images/ssd1322.jpg new file mode 100644 index 000000000..3a4260c13 Binary files /dev/null and b/images/ssd1322.jpg differ diff --git a/index.rst b/index.rst index 521b2abe7..d3acfa69f 100644 --- a/index.rst +++ b/index.rst @@ -281,6 +281,7 @@ Display Components TM1637, components/display/tm1637, tm1637.jpg Nextion, components/display/nextion, nextion.jpg SSD1306, components/display/ssd1306, ssd1306.jpg + SSD1322, components/display/ssd1322, ssd1322.jpg SSD1325, components/display/ssd1325, ssd1325.jpg SSD1327, components/display/ssd1327, ssd1327.jpg SSD1331, components/display/ssd1331, ssd1331.jpg