.. _librem_5_troubleshooting_leds:

LED Indicator Colors
--------------------

The phone's indicator light uses different light emitting diodes (LEDs) to display different colors during boot-up to indicate which tasks the phone is performing and may flash to report problems. The table below explains the meaning of these colors.

+--------------------+--------------------------------------------------------+
| Color              | Description                                            |
+====================+========================================================+
| Red                | The phone is charging.                                 |
+--------------------+--------------------------------------------------------+
| Red (flashing)     | There is a problem with charging. |br|                 |
|                    | :ref:`See below <librem_5_troubleshooting>`            |
|                    | for advice.                                            |
+--------------------+--------------------------------------------------------+
| Green              | The U-Boot bootloader has started running.             |
+--------------------+--------------------------------------------------------+
| Green (flashing)   | A boot-loop in the bootloader. |br|                    |
|                    | :ref:`See below <librem_5_troubleshooting_boot_loop>`  |
|                    | for advice.                                            |
+--------------------+--------------------------------------------------------+
| Yellow (red/green) | The bootloader has started the kernel but there is     |
|                    | insufficient power to continue. |br|                   |
|                    | :ref:`See below <librem_5_troubleshooting_kernel>`     |
|                    | for advice.                                            |
+--------------------+--------------------------------------------------------+

Once the phone has started the operating system, the battery status is shown on the lock screen. When the screen is unlocked, the battery status is shown in the status line at the top of the screen.

Red
~~~

.. note:: Ensure that you use the charger supplied with the phone as this can supply 10 W of power.

A lit red indicator light with no flashing indicates that the phone is charging normally.

If the light flashes red once per second, there is a problem with the charge controller. Contact Purism support for further guidance.

.. _librem_5_troubleshooting_boot_loop:

Green
~~~~~

A flashing green light is a symptom of the bootloader starting followed by a reset as a result of insufficient power. This is usually the result of a battery charging issue. Follow the steps below to work around the problem:

 #. Hold down the Volume Up button for 5 seconds to enable trickle-charging.
 #. Once the light stops flashing, unplug then replug the power supply.
 #. Let the battery charge for an hour or more.
 #. Unplug the USB cable from the phone.
 #. Hold down the power button for 15 seconds.
 #. The light should appear green.
 #. Plug in the USB charging cable.

If the above steps do not help, try the recharging procedure for your phone:

 * Birch: :ref:`librem_5_troubleshooting_birch_recharging`
 * Dogwood: :ref:`librem_5_troubleshooting_dogwood_recharging`

.. _librem_5_troubleshooting_kernel:

Yellow
~~~~~~

If the light is yellow, the bootloader is trying to load the kernel but has already determined that there is insufficient power to succeed for one of the following reasons:

 * The battery voltage is low and the USB C cable was not plugged in before the bootloader ran the USB power check.
 * The battery voltage is low and so is the USB charging current.
 * The battery voltage is zero and the USB current is too low.

Try disabling the modem and WLAN by pushing their kill switches in the down positions, towards the center of the phone.

Follow the charging procedure for your phone:

 * Birch: :ref:`librem_5_troubleshooting_birch_recharging`
 * Dogwood: :ref:`librem_5_troubleshooting_dogwood_recharging`

.. include:: ../defs.txt
