Troubleshooting

If you have problems with PINN, you can try the following steps:

1. Remove anything attached to the GPIO pins. Certain pins cause NOOBS/PIN to enter a safe rescue mode. To avoid this remove any HATs or other circuitry attached to the GPIO pins. Is this is not possible, edit recovery.cmdline in the first SD card partition and add disablesafemode to disable this feature.

2. Try noobs-lite to see if you get the same problem. PINN is very close to NOOBS, so if the same error occurs with NOOBS then it is more likely to be a common NOOBS issue that you should get sorted using the normal NOOBS issue troubleshooting process. Once you are sure it is not NOOBS related, then continue below.

3. Check the debug log. Press Ctrl-Alt-F2 to get to the recovery shell. Use the username:root password:raspberry. type `cat /tmp/debug/' and review any log output for anything that might indicate an error. If the log is too long, you can browse it using 'less /tmp/debug'. Press Ctrl-Alt-F1 to return to the GUI.

4. Check system messages. Press Ctrl-Alt-F2 to get to the recovery shell. Use the username:root password:raspberry. type `dmesg | less' and review any log output for anything that might indicate an error. Press Ctrl-Alt-F1 to return to the GUI.

5. Open an issue on this github repository. If the problem can still not be identified, please post the following details in the new Issue:

• The exact steps you took
• What you expected to happen
• What actually happened
• Any error messages that were displayed on screen
• A copy of the debug log, and/or a copy of the dmesg output.

To capture the debug logs you can do the following: Press Ctrl-Alt-F2 to get to the recovery shell. Use the username:root password:raspberry.

cd \tmp
mount -o remount,rw /mnt
cp debug /mnt/debug.txt
dmesg >/mnt/dmesg.txt
sync

Now you can turn off the Pi, put your SD card in a PC and copy the debug.txt and dmesg.txt files to your PC.