PinePhone Pro - Revision history

Fxc: Undo revision 21552 by JohnA (talk), I don't agree with these contents, the style is to be optimized and potentially causes more confusion than helping. No or a broken installation is one cause.

2024-09-24T18:47:26Z

Undo revision 21552 by JohnA (talk), I don't agree with these contents, the style is to be optimized and potentially causes more confusion than helping. No or a broken installation is one cause.

← Older revision		Revision as of 18:47, 24 September 2024
Line 164:		Line 164:

	The device should now boot from the microSD card. If the phone does not boot from the microSD card the microSD card was flashed with an incompatible image or the battery got drained as explained above.		The device should now boot from the microSD card. If the phone does not boot from the microSD card the microSD card was flashed with an incompatible image or the battery got drained as explained above.

	~~==== SPI flash and eMMC are empty ====~~
	~~This is a variant of the above, and may be the result of replacing the board in your PinePhone Pro. In this case, when you try to boot, nothing vibrates and no leds come on.~~
	~~However, even without pressing any buttons or any other manipulation, the phone still ends up in Maskrom mode when you plug in a USB cable. This is because the phone checks~~
	~~the SPI and eMMC for something bootable. If it is bootable but corrupted, the phone will then try to boot and perhaps have a problem, so you need to press RE or whatever to~~
	~~bypass this. However, if there is nothing bootable, it~~
	will then go into Maskrom mode without the need to press any button or otherwise manipulate. Maskrom mode assumes there is a USB interface, but knows nothing else about the phone hardware, and so you do not have any feedback eg.
	~~leds flashing or the phone vibrating.~~

	~~This situation is rectified by writing a tow-boot or similar SPI installer to a SD card, and booting the phone with the SPI installer in the phone to write a tow-boot into~~
	~~memory. After that, leds will flash etc. etc. as there is something in the phone that knows about its hardware and can coordinate the boot.~~

	=== Bootloaders ===		=== Bootloaders ===

JohnA: /* Adding section on empty rather than corrupted memory */

2024-09-22T20:51:41Z

Adding section on empty rather than corrupted memory

← Older revision		Revision as of 20:51, 22 September 2024
Line 164:		Line 164:

	The device should now boot from the microSD card. If the phone does not boot from the microSD card the microSD card was flashed with an incompatible image or the battery got drained as explained above.		The device should now boot from the microSD card. If the phone does not boot from the microSD card the microSD card was flashed with an incompatible image or the battery got drained as explained above.

			==== SPI flash and eMMC are empty ====
			This is a variant of the above, and may be the result of replacing the board in your PinePhone Pro. In this case, when you try to boot, nothing vibrates and no leds come on.
			However, even without pressing any buttons or any other manipulation, the phone still ends up in Maskrom mode when you plug in a USB cable. This is because the phone checks
			the SPI and eMMC for something bootable. If it is bootable but corrupted, the phone will then try to boot and perhaps have a problem, so you need to press RE or whatever to
			bypass this. However, if there is nothing bootable, it
			will then go into Maskrom mode without the need to press any button or otherwise manipulate. Maskrom mode assumes there is a USB interface, but knows nothing else about the phone hardware, and so you do not have any feedback eg.
			leds flashing or the phone vibrating.

			This situation is rectified by writing a tow-boot or similar SPI installer to a SD card, and booting the phone with the SPI installer in the phone to write a tow-boot into
			memory. After that, leds will flash etc. etc. as there is something in the phone that knows about its hardware and can coordinate the boot.

	=== Bootloaders ===		=== Bootloaders ===

Fxc: /* The installation is corrupted */ updated

2023-12-21T21:30:26Z

The installation is corrupted: updated

← Older revision		Revision as of 21:30, 21 December 2023
Line 161:		Line 161:
	* Make sure the device is powered off by shortly removing the battery for a second		* Make sure the device is powered off by shortly removing the battery for a second
	* Insert the microSD card into the top slot of the PinePhone Pro. Make sure the microSD card is inserted all the way and that the notch of the right side of the microSD card is not visible anymore.		* Insert the microSD card into the top slot of the PinePhone Pro. Make sure the microSD card is inserted all the way and that the notch of the right side of the microSD card is not visible anymore.
	* Power on the device ~~while~~ bypassing the SPI and eMMC ~~as explained under~~ [[PinePhone Pro#Boot order\|Boot order]]		* Power on the device (bypassing the SPI and eMMC might be required, see [[PinePhone Pro#Boot order\|Boot order]])

	The device should now boot from the microSD card. If the phone does not boot from the microSD card the microSD card was flashed with an incompatible image or the battery got drained as explained above.		The device should now boot from the microSD card. If the phone does not boot from the microSD card the microSD card was flashed with an incompatible image or the battery got drained as explained above.

Fxc: /* Flashing to microSD card */ +1

2023-12-21T21:29:30Z

Flashing to microSD card: +1

← Older revision		Revision as of 21:29, 21 December 2023
Line 96:		Line 96:
	# Insert the microSD card into the top slot of the PinePhone Pro. Make sure the microSD card is inserted all the way and that the notch of the right side of the microSD card is not visible anymore, see [[:File:Pinephone_slots.png\|here]].		# Insert the microSD card into the top slot of the PinePhone Pro. Make sure the microSD card is inserted all the way and that the notch of the right side of the microSD card is not visible anymore, see [[:File:Pinephone_slots.png\|here]].
	# Boot the device using the following method:		# Boot the device using the following method:
			#* On the '''Explorer Edition ordered after November 2023''' boot the phone without any further action.
	#* On the '''Explorer Edition ordered after July 2022''' hold the ''volume down key'' while booting.		#* On the '''Explorer Edition ordered after July 2022''' hold the ''volume down key'' while booting.
	#* On the '''Explorer Edition ordered between January and July 2022''' hold the ''RE'' button underneath the back cover while booting (or use the ''volume down key'' if you flashed ''Tow-Boot'').		#* On the '''Explorer Edition ordered between January and July 2022''' hold the ''RE'' button underneath the back cover while booting (or use the ''volume down key'' if you flashed ''Tow-Boot'').

Fxc: /* Notes */ Removed outdated instructions

2023-12-21T21:28:40Z

Notes: Removed outdated instructions

← Older revision		Revision as of 21:28, 21 December 2023
Line 77:		Line 77:
	==== Notes ====		==== Notes ====

	If you received your device after July of 2022, the bootloader ~~(''Tow-Boot'')~~ resides on the SPI. To boot to an SD card, place the SD card in your PinePhone Pro and turn it on. The phone will vibrate once. At this point, hold down the volume down button until you feel the device vibrate again then release the button. The LED color should change to blue and your display should remain black for a few seconds. In a few seconds you should see the SD card booting, the indications of which are dependent on what image you chose. If the LED is flashing instead, the boot from SD failed. Erasing the SPI can be achieved via the Tow-Boot installer image. Instructions are available here [https://tow-boot.org/devices/pine64-pinephonePro.html Tow-Boot PinePhone Pro Instructions].		If you received your device after July of 2022, the bootloader resides on the SPI.

	See [[RK3399 boot sequence]] for further details regarding the boot sequence.		See [[RK3399 boot sequence]] for further details regarding the boot sequence.

Fxc: /* Boot from microSD card temporarily */ addition

2023-12-21T21:26:35Z

Boot from microSD card temporarily: addition

← Older revision		Revision as of 21:26, 21 December 2023
Line 58:		Line 58:

	To temporarily boot from an inserted '''microSD card''' do the following:		To temporarily boot from an inserted '''microSD card''' do the following:

			* On the '''Explorer Edition ordered after November 2023''' the microSD card is first in boot order due to using ''rk2aw'' instead of ''Tow-Boot'', see [https://xnux.eu/rk2aw/ here].

	* On the '''Explorer Edition ordered after July 2022''' hold the ''volume down key'' while powering on the device. The batches bought after July 2022 come with ''Tow-Boot'' flashed to the SPI, which offers additional functionality over ''U-Boot'' as bootloader.		* On the '''Explorer Edition ordered after July 2022''' hold the ''volume down key'' while powering on the device. The batches bought after July 2022 come with ''Tow-Boot'' flashed to the SPI, which offers additional functionality over ''U-Boot'' as bootloader.

Fxc: Reverted edits by Giorez (talk) to last revision by Fxc

2023-09-09T20:23:23Z

Reverted edits by Giorez (talk) to last revision by Fxc

Show changes

Giorez at 19:21, 9 September 2023

2023-09-09T19:21:35Z

← Older revision		Revision as of 19:21, 9 September 2023
Line 175:		Line 175:
	==== levinboot ====		==== levinboot ====
	The levinboot bootloader is another option for the PinePhone Pro. The project repository can be found [https://gitlab.com/DeltaGem/levinboot/-/tree/master/ here]. (Pinephone Pro supporting fork is [https://xff.cz/git/levinboot/ here].)		The levinboot bootloader is another option for the PinePhone Pro. The project repository can be found [https://gitlab.com/DeltaGem/levinboot/-/tree/master/ here]. (Pinephone Pro supporting fork is [https://xff.cz/git/levinboot/ here].)






Line 499:		Line 495:
	# append root=UUID=dec2be75-3594-4078-b8c9-f3b215e6eac3 console=ttyS2,115200n8 consoleblank=0 loglevel=7 rw spl>		# append root=UUID=dec2be75-3594-4078-b8c9-f3b215e6eac3 console=ttyS2,115200n8 consoleblank=0 loglevel=7 rw spl>
	EOF		EOF



	Unmount all /dev		Unmount all /dev
	sudo umount /mnt/archlinuxsd /mnt/manjarosd /mnt/mobiansd /mnt/postmarketossd /mnt/ubuntutouchsd /mnt//boot /mnt//root		sudo umount /mnt/archlinuxsd /mnt/manjarosd /mnt/mobiansd /mnt/postmarketossd /mnt/ubuntutouchsd /mnt//boot /mnt//root


	=== Multi-Distro on eMMC ===		=== Multi-Distro on eMMC ===
Line 714:		Line 709:
	# On first boot neither Phosh nor sxmo resized their partition - ''sudo resize2fs'' sorted that.		# On first boot neither Phosh nor sxmo resized their partition - ''sudo resize2fs'' sorted that.
	# Any time an update rebuilds the initramfs it is necessary to delete /boot/boot.scr again to keep the rk2aw menu clean.		# Any time an update rebuilds the initramfs it is necessary to delete /boot/boot.scr again to keep the rk2aw menu clean.

Giorez: /* Multi-Distro on MicroSD Card */

2023-09-09T19:20:19Z

Multi-Distro on MicroSD Card

← Older revision		Revision as of 19:20, 9 September 2023
Line 183:		Line 183:
	=== Multi-Distro on MicroSD Card ===		=== Multi-Distro on MicroSD Card ===

	This ~~article~~ explains how to install megi's [https://xnux.eu/rk2aw/ rk2aw loader], U-Boot to SPI and a multi-distribution image to the microSD card and eMMC of the [[PinePhone Pro]]. Further instructions regarding ''rk2aw'' can be found on megi's website under https://xff.cz/kernels/rk2aw/rk2aw-rk3399-pinephone-pro/INSTALL. Please note that loader and userspace utility to flash it are free, but not open-source.		This section explains how to install megi's [https://xnux.eu/rk2aw/ rk2aw loader], U-Boot to SPI and a multi-distribution image to the microSD card and eMMC of the [[PinePhone Pro]]. Further instructions regarding ''rk2aw'' can be found on megi's website under https://xff.cz/kernels/rk2aw/rk2aw-rk3399-pinephone-pro/INSTALL. Please note that loader and userspace utility to flash it are free, but not open-source.

	[[File:multi_distro_sd.jpg\|thumb\|right\|200px\|Options to boot Arch Linux ARM, Manjaro and Mobian (kernel 6.1 and 6.3)]]		[[File:multi_distro_sd.jpg\|thumb\|right\|200px\|Options to boot Arch Linux ARM, Manjaro and Mobian (kernel 6.1 and 6.3)]]
Line 504:		Line 504:
	Unmount all /dev		Unmount all /dev
	sudo umount /mnt/archlinuxsd /mnt/manjarosd /mnt/mobiansd /mnt/postmarketossd /mnt/ubuntutouchsd /mnt//boot /mnt//root		sudo umount /mnt/archlinuxsd /mnt/manjarosd /mnt/mobiansd /mnt/postmarketossd /mnt/ubuntutouchsd /mnt//boot /mnt//root




	=== Multi-Distro on eMMC ===		=== Multi-Distro on eMMC ===

Giorez at 19:19, 9 September 2023

2023-09-09T19:19:24Z

Show changes