Difference between revisions of "PinePhone Software Releases"

Jump to navigation Jump to search
Line 23: Line 23:


== Installation to eMMC ==
== Installation to eMMC ==
* Prepare a new SD card as above
* Boot the phone with your new SD card image
* The eMMC appears as /dev/mmcblk2 and so any standard Linux mechanism to move your image there will work, e.g. dd.


You can dd the current installation to eMMC using this command:
=== Method Using Factory Installed Tools ===


  dd if=/dev/mmcblkX of=/dev/mmcblkY bs=1M
The initial OS you get with your phone has the option to flash an image on SD card to eMMC.


Where X is the number label of the SD card, and Y is the number label of the eMMC. Use the command ''lsblk'' to check your devices: typically with the current kernel the SD card is /dev/mmcblk0 and the eMMC is /dev/mmcblk2 but as always with ''dd'' be extremely cautious to get the devices correct.
# Copy (not flash) the image file to a formatted SD card.
# Insert SD card into powered-off phone.
# Turn on phone and select option to install to eMMC.


It will take about 15 minutes (depending on the speed of your card), and in the end it may show an error about not enough space - just ignore it. Turn off phone, take out SD card, and try booting the phone which should load up the new OS from eMMC.
=== Safe & Easy Method ===


This is method is more convenient because you don't have to rebuild the image from within the PinePhone, which usually requires resizing partitions and other extra steps.
https://forum.pine64.org/showthread.php?tid=9444
https://github.com/dreemurrs-embedded/Jumpdrive


Also, in the default/factory installed image provided to you upon shipment, there is an option to install any image to the eMMC.
# download the Jumpdrive image
# flash the Jumpdrive image to a SD card
# boot from the SD card
# connect the PinePhone to your computer using USB-A -> USB-C cable.
# flash the exposed (mounted) PinePhone drive with a chosen OS image as you'd flash any SD card
# once the flashing process is complete, disconnect the PinePhone from your PC, power it down and remove the Jumpdrive SD card
# boot into your OS of choice on eMMC
 
=== Safe With No Extra Tools, But Slower ===
 
# Prepare a formatted SD card, flash desired OS to the SD card
# Boot the phone with your new SD card image
# Resize partition to fill the SD card
# Open terminal and <code>git clone [url]</code> your desired project OR: Open web browser and download the desired OS image file.
# Build the OS (Optional)
# Flash the resulting image file you got by downloading or by building, to eMMC, using <code>dd if=/dev/mmcblkX of=/dev/mmcblkY bs=1M</code> where X is the number label of the SD card, and Y is the number label of the eMMC. Use the command ''lsblk'' to check your devices: typically with the current kernel the SD card is /dev/mmcblk0 and the eMMC is /dev/mmcblk2 but as always with ''dd'' be extremely cautious to get the devices correct.
# Turn off phone, remove SD card. Turn on phone.
# Open terminal and resize partition to fill up entire disk (see below).
 
=== Less Safe Method ===
 
Warning: This copies a mounted filesystem, which can lead to instability and data corruption. May cause bugs. Do not use as daily driver.
 
# Prepare a new SD card, flash desired OS to the SD card
# Boot the phone with your new SD card image
# Within the booted OS, flash/clone the running OS to eMMC, e.g. using dd. It will take about 15 minutes (depending on the speed of your card), and in the end it may show an error about not enough space - just ignore it.
# Turn off phone, take out SD card, and try booting the phone which should load up the new OS from eMMC.
# Open terminal and resize partition to fill up entire disk (see below).


== Resize partition to fit disk space ==
== Resize partition to fit disk space ==