.. include:: ../defs.txt

.. _librem_5_known_issues_chestnut:

Chestnut
========

This page contains the known issues for the Chestnut shipment of phones as supplied to users.

 * When charging the phone using a charger, 12V negotiation and rapid charging can fail.
   |gap|
   To help prevent this, follow these step to charge the phone:

      * Unplug the power adapter (wall wart) from the power outlet.
      * Plug one end of the USB-cable into the adapter and the other end into the phone.
      * Plug the adapter into the power outlet.

   When unplugging:

      * Unplug the adapter from the power outlet first.
      * Then unplug the USB-C cable from the phone.

   This failure mode does not affect 5V charging over a USB type-C to USB type-A cable.

 * The battery installed in the phone is labelled with a capacity of 2000 mAh.

   This is a conservative estimate of the capacity. Later iterations of the phone should have higher capacity batteries.
   |gap|

 * Power management and heat issues are caused by various subsystems. The processor will be run more slowly to prevent overheating, affecting processing performance.
   |gap|

 * The phone may restart if you remove or insert the SIM card while it is powered.

   This is due to the type of SIM tray in use. **Users should power off the phone before replacing SIM cards.**
   |gap|

 * Wi-Fi does not always start up correctly on boot even if it is enabled with the hardware switch. Disabling and re-enabling it with the switch should activate it.
   |gap|

 * Rapid charging currently only works when using the charger supplied with the phone or a compatible USB C PD (power delivery) charger.
   |gap|

 * Rapid charging is currently not possible over a USB A to C cable due to a software issue: `BQ25895: Disable BC1.2 and Set IINLIM to Max Value <linux-next-135_>`_
   |gap|

 * The GNSS module is unable to reliably receive broadcasts from satellites, making it difficult to fix the location of the phone. This problem will be addressed in later revisions of the hardware, from Dogwood onwards.
