Troubleshooting
---------------

Corrupted display due to using incorrect driver
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Using the SSD1306 driver on a display that has a SH1106 controller can result in
the display showing a small section of the expected output with the rest of the
display consisting of semi-random pixels (uninitialized memory).

.. figure:: images/ssd1306_driver_on_sh1106_controller.jpg
  :scale: 50 %
  :alt: Display corruption due to using driver for wrong controller

  Display corruption due to using driver for incorrect controller when running
  the `maze.py` example

This is due to differences in required initialization sequences and how memory
is mapped in the two controllers.

To use the SSH1106 driver in code, use the :py:class:`luma.oled.device.sh1106`
serial interface class.