.. include:: ../../../format.rst
.. include:: ../../../urls.rst

.. _l5_birch_known_issues:

Known issues
============

This page lists known issues for the **Birch** shipment of phones as supplied to users.


Data
----

Inability to write to microSD card
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

**Problem**:
Any installed microSD card can only be read from and not written to.

**Description**:
This is a limitation of the Birch hardware.


Unable to receive a fixed GNSS location
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

**Problem**:
The GNSS module is unable to reliably receive broadcasts from satellites, making it difficult to fix the location of the phone.

**Description**:
This problem will be addressed in later revisions of the hardware, from Dogwood onwards.


Power
-----


Rapid charging failure
~~~~~~~~~~~~~~~~~~~~~~

**Problem**:
When charging the phone using a charger, 12V negotiation and rapid charging can fail.

**Description**:
If this failure occurs, USB 2.0 data transmission can also be affected.
This failure mode does not affect 5V charging over a USB type-C to USB type-A cable.

**Solution**:
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.
#. Unplug the USB-C cable from the phone.


Difficulty powering on the device
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

**Problem**:
After being powered down, the phone can be difficult to power up again.

**Description**:
This problem is related to a software issue which was fixed after the phones were shipped:
`Power Button Not Turning Device Back On <linux-next-109_>`_

**Solution**:
The solution for a phone with the original software is to unplug the USB cable, then press the power button for 15-18 seconds.


Call audio routing not working
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

**Problem**:
Call audio routing is not functioning completely.

**Description**:
This issue will be fixed in an upcoming system update.


Incorrectly labeled battery capacity
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

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

**Description**:
This is a conservative estimate of the capacity.
Later iterations of the phone should have higher capacity batteries.


Power/heat issues
~~~~~~~~~~~~~~~~~

**Problem**:
Power management and heat issues are caused by various subsystems.

**Description**:
The processor will be run more slowly to prevent overheating, affecting processing performance.


Device reboots when turning on the modem HKS
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

**Description**:
The phone may sometimes restart when turning the modem on using the kill switch.

**Description**:
This depends on the modem in use.
BroadMobi BM818-A1/E1 modems do not seem to be affected.


Device reboots if SIM inserted/removed while powered on
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

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

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


Inconsistencies with rapid charging
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

**Problem**:
Activation of rapid charging depends on whether the TPS65982 power controller is first powered via USB or via the battery.


Rapid charging not working with certain USB cables
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

**Problem**:
Rapid charging is currently not possible over a USB A to C cable.

**Description**:
This is due to a software issue.
(See `BQ25895: Disable BC1.2 and Set IINLIM to Max Value <linux-next-135_>`_).