Difference between revisions of "PinePhone Pro"

Jump to navigation Jump to search
(→‎Software: +more text)
Line 69: Line 69:
{{Under construction}}
{{Under construction}}


As explained in the [[PinePhone Pro#Boot order|boot order]] paragraph, the eMMC has a higher boot priority than the microSD card. On the '''Explorer Edition''' the default installation of U-Boot shipped by the factory points to the microSD card when holding the power key at boot. If the default installation was corrupted or overwritten by a different configured U-Boot, the eMMC may have to be bypassed to boot from microSD card and to alter the eMMC contents.
As explained in the [[PinePhone Pro#Boot order|boot order]] section, the eMMC has a higher boot priority than the microSD card. On the '''Explorer Edition''' the default installation of U-Boot shipped by the factory points to the microSD card when holding the power key at boot. If the default installation was corrupted or overwritten by a differently configured bootloader, the eMMC may have to be bypassed to boot from microSD card and to alter the eMMC contents.


{{hint|If the '''battery is fully drained''' U-Boot might fail to boot any installed operating system on the eMMC and microSD card due to a bug.  
{{hint|If the '''battery is fully drained''' U-Boot might fail to boot any installed operating system on the eMMC and microSD card due to a bug.  
Line 82: Line 82:
}}
}}


==== Bypass the eMMC to temporarily boot from microSD card ====
==== Bypassing the eMMC ====


TBD
The pre-installed bootloader on the '''Explorer Edition''' can boot the microSD card when holding the power button at boot for a few seconds. The eMMC can be temporarily bypassed at boot to be able to boot from microSD card, for example if the installation of U-Boot on the eMMC got corrupted or overwritten by a differently configured bootloader. To bypass the eMMC in such a case:


==== Wipe U-Boot from the eMMC to boot from the microSD by default ====
On the '''Explorer Edition''' hold the ''RE'' button underneath the cover for a few seconds, while powering on the device (holding it too long will cause the eMMC to not get initialized after the boot).


TBD
On the '''Developer Edition''' short the eMMC bypass contacts while booting.
 
For details see the section [[PinePhone Pro#Boot order|boot order]].
 
==== Wipe U-Boot from the eMMC ====
To boot from microSD card permanently, one of the methods is to wipe the bootloader from the eMMC. If no bootloader is found on the eMMC, the phone will boot to the microSD card instead. To wipe U-Boot from the microSD card:
 
* Boot a GNU/Linux operating system from the microSD card by holding power at boot (or using the above bypass method if the bootloader was altered or the Developer Edition is used)
* Type <code>lsblk</code> in a terminal on the phone to list the devices
* Wipe the bootloader using <code>sudo dd if=/dev/zero of=/dev/DEVICE bs=8k seek=1 count=4</code> (Note: please replace DEVICE with the eMMC device and double-check you got it correct and neither selected the microSD card nor a partition of the eMMC!
 
The phone should now default to the microSD card at boot. If there are any issues please join the bridged [[Main Page#Community and Support|community PinePhone channel]] and explain your issue and what you've tried so far.


=== Software releases ===
=== Software releases ===