LCD_Problems.rst 4.49 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52
.. _imx8_devkit_troubleshooting_lcd:

Diagnosing LCD Problems
=======================

If you are experiencing problems with the LCD display, there are a few checks
you can make to diagnose the problem. For example, it can be useful to
determine whether the problem is the LCD panel or the backlight.

Known Problems
--------------

Backlight Remains Off
~~~~~~~~~~~~~~~~~~~~~

If the backlight remains off after booting, this can mean that either the
board is running an old kernel, using the wrong device tree binary (dtb), or
that the backlight itself is not connected. Follow the procedure below to
diagnose which of these possible causes is the problem.

Stripes Along the Display Length
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

If the backlight is on and the display shows stripes parallel to the longest
edge of the screen, the fault is probably due to an old kernel and display
driver. Follow the procedure below, paying special attention to the first step.

Procedure
---------

As a general guide, the following steps can be diagnose and cure the problem:

#. **Check that you are running an up-to-date kernel.**

   Log in to the development board and type the following at the command line::

      uname -v

   You should see output like the following::

      #1 SMP PREEMPT Wed Feb 20 14:38:03 PST 2019

   Generally, kernels with a date later than this should have a working driver
   for the display panel.

   The simplest solution is to reflash the software on the board -- see
   :ref:`imx8_devkit_flashing_emmc` for instructions.

#. **Check the ribbon cable.**

   The ribbon cable should be inserted squarely into the J1202 connector on the
   board. If it is inserted at an angle, perhaps due to movement of the panel,
David Boddie's avatar
David Boddie committed
53 54
   then it needs to be reinserted properly. **Power down the development board
   before attempting to reinsert the cable.**
55 56 57

   .. figure:: images/devkit-LCD-panel-connector.svg
      :width: 80%
58
      :align: center
59 60 61 62
      :alt: The location of the LCD ribbon cable connector (click to enlarge)

      The location of the LCD ribbon cable connector

63 64 65 66 67
   The socket holding the ribbon cable can be opened by carefully inserting a
   tool with a thin, flat surface into the socket between the cable and the
   lid of the socket. The socket's lid can then be flipped open, as shown in
   the following images. You should not need to remove the screen to open the
   socket -- the screen was removed to illustrate the socket more clearly.
68

69 70 71 72 73 74 75 76 77 78 79 80 81 82 83
   .. |image1| image:: images/J1202-screen-connector-closed.jpg
      :scale: 50%
      :alt: The socket in the closed position
   .. |image2| image:: images/J1202-screen-connector-open.jpg
      :scale: 50%
      :alt: The socket in the open position

   .. centered:: |image1| |image2|

   With the socket open, position the end of the cable on top of the pins
   underneath, so that the cable covers them, ensuring that the end of the
   cable is parallel with the long edge of the socket.

   .. figure:: images/inserting-cable.svg
      :width: 80%
84
      :align: center
85
      :alt: Cable not placed, cable placed, socket lid closed
86

87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102
      Cable not placed, cable placed, socket lid closed

   The white line on the cable should be covered, at least partially, by the
   lid of the socket. It should run parallel to the socket's edge.

   .. |image3| image:: images/J1202-screen-cable.jpg
      :scale: 50%
      :alt: The cable partially inserted in the socket
   .. |image4| image:: images/J1202-screen-cable-inserted.jpg
      :scale: 50%
      :alt: The cable more securely inserted in the socket

   .. centered:: |image3| |image4|

   The ribbon cable may not need to be perfectly aligned with the socket --
   some slight misalignment should not cause problems as long as a good
103 104 105 106
   connection is made. If your cable looks like the one in the left picture,
   but your display is functioning, there is no need to reinsert the cable.
   However, you should be aware that the cable may need reinserting if you
   encounter display problems.
107

108 109 110
#. **Use a spotlight to check the LCD display.**

   If the backlight is off, it can be difficult to check that the LCD display
111 112
   itself is working. However, if you shine a spotlight onto the center of the
   panel, you may be able to see a faint image of a digital clock:
113

114 115
   .. image:: images/lock-screen-time.png
      :scale: 50%
116
      :align: center
117

118
   Swiping the screen should cause the text to move and/or disappear.
119

David Boddie's avatar
David Boddie committed
120
If none of these checks result in an obvious cause, please `get in touch`_.
121 122

.. _`get in touch`: https://developer.puri.sm/Librem5/Contact.html