Troubleshooting¶

Start with the matching section below. For problems that are not listed, collect debug logs and open a GitHub issue with the device model. Known issues lists problems already reported.

Debug logs¶

Put an empty file called debug on the microSD card's BOOT drive.
Boot, and reproduce the problem.
Attach the debug-logs folder from the BOOT drive to a GitHub issue.

Android doesn't start after installing to internal storage¶

Installs made with versions before 1.3 gave the Linux boot partition a type that Android does not start next to. The Snapdragon logo shows, then the device turns off. Changing the type fixes it without erasing anything, and Zaviya keeps booting from internal storage.

Open Konsole in Desktop Mode and find the boot partition:
```
readlink -f /dev/disk/by-partlabel/ROCKNIX
```
It prints something like /dev/sda12.

Change its type, using the number from step 1 (here 12):

sudo sfdisk --part-type /dev/sda 12 C12A7328-F81F-11D2-BA4B-00A0C93EC93B

Clear Android's leftover data so it sets itself up fresh. This erases Android's user data.

sudo blkdiscard -f -z /dev/disk/by-partlabel/metadata
sudo dd if=/dev/zero of=/dev/disk/by-partlabel/userdata bs=1M count=8

Restart holding Volume Down and choose Android. The first start takes a few minutes while it sets up.

Note

On 1.3 and newer the same fix is sudo ufs-partition.py fix-types followed by sudo ufs-partition.py reset-android --yes.

Black screen after booting¶

Check that the device model in the OpenABL menu matches the device exactly.
Flash the card again. An interrupted flash is the most common cause.
Collect debug logs and open an issue.

No sound¶

Open the volume slider in Quick Access and check the output device.
On the Pocket FIT, run konkrctl status and include the output in an issue.