Difference between revisions of "PinePhone Pro/Create a multi-distribution image using rk2aw"

From PINE64
Jump to navigation Jump to search
Line 1: Line 1:
= How to Flash Rk2Aw BootLoader and Setup Multi-Distro on PinePhonePro =
= How to Flash Rk2Aw BootLoader and Setup Multi-Distro on PinePhonePro =
''References: https://xff.cz/kernels/rk2aw/rk2aw-rk3399-pinephone-pro/INSTALL and https://xnux.eu/rk2aw/''
''References: https://xff.cz/kernels/rk2aw/rk2aw-rk3399-pinephone-pro/INSTALL and https://xnux.eu/rk2aw/''
''Requirements: SSH connection from linux machine to PinePhonePro, internet connection.''
''Requirements: SSH connection from linux machine to PinePhonePro, internet connection.''
''Note: Preloader and userspace utility to flash it are non-free.''
''Note: Preloader and userspace utility to flash it are non-free.''
''Thanks: Megi at https://xnux.eu/log/''
''Thanks: Megi at https://xnux.eu/log/''


Revision as of 12:37, 10 August 2023

How to Flash Rk2Aw BootLoader and Setup Multi-Distro on PinePhonePro

References: https://xff.cz/kernels/rk2aw/rk2aw-rk3399-pinephone-pro/INSTALL and https://xnux.eu/rk2aw/

Requirements: SSH connection from linux machine to PinePhonePro, internet connection.

Note: Preloader and userspace utility to flash it are non-free.

Thanks: Megi at https://xnux.eu/log/

Flash Rk2Aw BootLoader to SPI

Download and Run rk2aw SPI Flasher

  1. Connect PinePhonePro to linux machine and start a ssh connection
  2. ssh <user>@<phoneip> # set a connection
  3. cd ~/Downloads # enter to directory
  4. curl -O https://xff.cz/kernels/bootloaders/ppp.tar.gz # download installer
  5. tar -xvzf ppp.tar.gz -C ~/Downloads # extract
  6. # scp -r ~/Downloads/ppp <user>@<phoneip>:~/Downloads # copy to phone, non needed
  7. sudo ./spinor-flash-initial-setup.sh # flash SPI

Build multi-distro SD Card

  1. Get distro compressed images and decompress them. (i.e. Manjaro.phosh.beta34, Mobian.6.1, ArchLinux)
  2. Mount distro images both partitions "/boot", "/root" for each distro
  3. lsblk # find /loop, /sd references. Use blkid to see the UUID for the partition
    ├─loop0p1 /media/xxx/BOOT_MNJRO
    └─loop0p2 /media/xxx/ROOT_MNJRO
    ├─loop1p1 /media/xxx/boot
    └─loop1p2 /media/xxx/rootfs
    ├─loop2p1 /media/xxx/52CA-6165
    └─loop2p2 /media/xxx/3d99072c-9fd6-4316-8526-9192e192c441
    └─sdb disk (after each dd command you'll see the partition id name to adjust into scripts.)
  4. sudo dd if=/dev/zero of=/dev/sdb count=945728 bs=32768 status=progress # quick erase sd card. i.e. # 32GB SDcard (30989615104bytes/32768dim=945728volte)
  5. or sudo dd if=/dev/zero of=/dev/sdb count=1 bs=32768 status=progress # slow erase sd card. i.e. # 32GB SDcard (30989615104bytes/32768dim=1volta) )
  6. Partition sd card (min 6432GB)
sudo sfdisk /dev/sdb <<EOF
label: gpt
first-lba: 64
table-length: 8
start=64, size=32704, type=D7B1F817-AA75-2F4F-830D-84818A145370, name="loader", attrs=RequiredPartition
size=10G, name="ALARM", attrs="RequiredPartition,LegacyBIOSBootable"
size=10G, name="MANJARO", attrs="RequiredPartition,LegacyBIOSBootable"
size=+, name="MOBIAN", attrs="RequiredPartition,LegacyBIOSBootable"
EOF
  1. lsblk # list partitions on sd and mounted distro images
    1. Device Start End Sectors Size Type
      /dev/sdb1 64 32767 32704 16M unknown
      /dev/sdb2 32768 16809983 16777216 8G Linux filesystem
      /dev/sdb3 16809984 33587199 16777216 8G Linux filesystem
      /dev/sdb4 33587200 60524543 26937344 12.8G Linux filesystem
  2. Copy files for Arch Linux ARM
    1. sudo dd if=/dev/loop2p2 of=/dev/sdb2 bs=1M status=progress conv=fsync # copy rootfs to sd part2
    2. sudo mount /dev/sdb2 /media/xxx/3d99072c-9fd6-4316-8526-9192e192c441
    3. sudo scp -r /media/xxx/52CA-6165/* /media/xxx/3d99072c-9fd6-4316-8526-9192e192c4411/boot # copy bootfs to to part2/boot
    4. sudo mv /media/xxx/3d99072c-9fd6-4316-8526-9192e192c4411/boot/boot.scr /media/xxx/3d99072c-9fd6-4316-8526-9192e192c4411/boot/boot.scrORIG # hide auto-menu item
    5. sudo nano /media/xxx/3d99072c-9fd6-4316-8526-9192e192c4411/etc/fstab # add PARTLABEL=ALARM and delete UUID=xxx from second line, delete /boot entry
    6. sudo mkdir /media/xxx/3d99072c-9fd6-4316-8526-9192e192c4411/boot/extlinux # add directory
    7. sudo nano /media/xxx/3d99072c-9fd6-4316-8526-9192e192c4411/boot/extlinux/extlinux.conf # add file
 #/boot/extlinux/extlinux.conf
 MENU TITLE Pinephone Pro Boot Menu
 LABEL l0
 MENU LABEL ALarm
 FDT /boot/dtbs/rockchip/rk3399-pinephone-pro.dtb
 KERNEL /boot/Image
 INITRD /boot/initramfs-linux.img
 APPEND root=PARTLABEL=ALARM console=ttyS2,115200 console=tty0 loglevel=4 rw rootwait fbcon=rotate:0 pinephone_keyboard.disable_input
  1. Copy files for ManJaro
    1. sudo dd if=/dev/loop0p2 of=/dev/sdb3 bs=1M status=progress conv=fsync # copy rootfs to sd part3
    2. sudo mount /dev/sdb3 /media/xxx/ROOT_MNJRO1/
    3. sudo scp -r /media/xxx/BOOT_MNJRO/* /media/xxx/ROOT_MNJRO1/boot # copy bootfs to to part3/boot
    4. sudo nano /media/xxx/ROOT_MNJRO1/etc/fstab # change UUID=xxx to PARTLABEL=MANJARO, delete /boot line
    5. sudo mv /media/xxx/ROOT_MNJRO1/boot/boot.scr /media/xxx/ROOT_MNJRO1/boot/boot.scrORIG # hide auto-menu item
    6. sudo mkdir /media/xxx/ROOT_MNJRO1/boot/extlinux # add directory
    7. sudo nano /media/xxx/ROOT_MNJRO1/boot/extlinux/extlinux.conf #add file
 #/boot/extlinux/extlinux.conf
 MENU TITLE Pinephone Pro Boot Menu
 LABEL l0
 MENU LABEL ManJaro
 FDT /boot/dtbs/rockchip/rk3399-pinephone-pro.dtb
 KERNEL /boot/Image
 INITRD /boot/initramfs-linux.img
 APPEND root=PARTLABEL=MANJARO console=ttyS2,115200 console=tty0 loglevel=4 rw rootwait fbcon=rotate:0 pinephone_keyboard.disable_input
  1. Copy files for MObian
    1. sudo dd if=/dev/loop1p2 of=/dev/sdb4 bs=1M status=progress conv=fsync # copy rootfs to sd part4
    2. mount /dev/sdb4 /media/xxx/rootfs1/
    3. sudo scp -r /media/xxx/boot/* /media/xxx/rootfs1/boot # copy bootfs to to part4/boot
    4. sudo nano /media/xxx/rootfs1/etc/fstab # replace UUID=xxx with PARTLABEL=MOBIAN and delete UUID=xxx from second line. Delete /boot line
    5. sudo nano /media/xxx/rootfs1/boot/extlinux/extlinux.conf # edit path from /bootfs to /part4/boot
 >linux /boot/vmlinuz-6.1-rockchip
 >initrd /boot/initrd.img-6.1-rockchip
 >fdtdir /boot/dtb-6.1-rockchip/
 APPEND root=PARTLABEL=MOBIAN console=ttyS2,115200 console=tty0 loglevel=4 rw rootwait fbcon=rotate:0 pinephone_keyboard.disable_input

Flash rk2aw BootLoader to SPI & multi-distro eMMC

Make sure you boot from the SDcard in your PPP as we are going to be building the eMMC. Note that below, arch is booted from the SDcard and the SDcard shows as /dev/mmcblk1

Download and Run rk2aw SPI Flasher

Same as above. Note this installs rk2aw and a bootloader to SPI NOR flash. Resulting SPI status is as follows: 

# ./rk2aw-spi-flasher 
Machine: Pine64 PinePhonePro (pine64,pinephone-pro)
SPI NOR Flash:
- Total size: 16384 KiB
- Erase block size: 4 KiB
- Write size: 1
- Manufacturer: gigadevice
- Part name: gd25lq128e
- JEDEC ID: 257018
Bootable images currently present in SPI NOR flash:
Idx Header     Off 1      Size 1     Off 2      Size 2     Notes/content
-------------------------------------------------------------------------------
0   0          2048       6144       0          0          (padded) 0='rk2aw'
5   131072     133120     67584      200704     124928     0='U-Boot TPL' 1='U-Boot SPL'
7   524288     526336     147456     673792     124928     0='ddrbin' 1='U-Boot SPL'
Auto-calculated layout for rk2aw dual bootloader scheme:
Area                 Offset     Size      
---------------------------------------------------
rk2aw primary        0          65536     
rk2aw backup         65536      65536     
spl fallback         131072     393216    
spl primary          524288     389120    
itb fallback         913408     2097152   
itb primary          3010560    2097152

Build multi-distro eMMC

In this example we are going to build 2 partitions on the eMMC, the first with Arch/phosh and the second with Arch/sxmo. We have already downloaded the images from Danct12 and decompressed them.

Mount the images

[me@PPP Downloads]$ sudo su
[sudo] password for me: 
[root@PPP Downloads]# losetup -P /dev/loop0 archlinux-pinephone-pro-phosh-20230203.img 
[root@PPP Downloads]# losetup -P /dev/loop1 archlinux-pinephone-pro-sxmo-20230203.img 
[root@PPP Downloads]# ls -l /mnt/
total 0
[root@PPP Downloads]# mkdir /mnt/phosh
[root@PPP Downloads]# mkdir /mnt/sxmo
[root@PPP Downloads]# mkdir /mnt/phosh/boot
[root@PPP Downloads]# mkdir /mnt/phosh/root
[root@PPP Downloads]# mkdir /mnt/sxmo/boot
[root@PPP Downloads]# mkdir /mnt/sxmo/root
[root@PPP Downloads]# mkdir /mnt/ephosh     # e for the partition on the eMMC
[root@PPP Downloads]# mkdir /mnt/esxmo      # e for the partition on the eMMC
[root@PPP Downloads]# mount /dev/loop0p1 /mnt/phosh/boot/
[root@PPP Downloads]# mount /dev/loop0p2 /mnt/phosh/root/
[root@PPP Downloads]# mount /dev/loop1p1 /mnt/sxmo/boot/
[root@PPP Downloads]# mount /dev/loop1p2 /mnt/sxmo/root/
[root@PPP Downloads]# lsblk
NAME         MAJ:MIN RM   SIZE RO TYPE MOUNTPOINTS
loop0          7:0    0     5G  0 loop 
├─loop0p1    259:0    0   122M  0 part /mnt/phosh/boot
└─loop0p2    259:1    0   4.9G  0 part /mnt/phosh/root
loop1          7:1    0   3.5G  0 loop 
├─loop1p1    259:2    0   122M  0 part /mnt/sxmo/boot
└─loop1p2    259:3    0   3.4G  0 part /mnt/sxmo/root
mmcblk2      179:0    0 115.2G  0 disk 
├─mmcblk2p1  179:1    0   122M  0 part 
└─mmcblk2p2  179:2    0 115.1G  0 part 
mmcblk2boot0 179:32   0     4M  1 disk 
mmcblk2boot1 179:64   0     4M  1 disk 
mmcblk1      179:96   0  59.6G  0 disk 
├─mmcblk1p1  179:97   0   122M  0 part /boot
└─mmcblk1p2  179:98   0  59.5G  0 part /
zram0        254:0    0   1.5G  0 disk [SWAP]

Prepare eMMC

[root@PPP Downloads]# dd if=/dev/zero of=/dev/mmcblk2 count=32768 bs=32768 status=progress  # overwrite the front to clear any bootloaders
985759744 bytes (986 MB, 940 MiB) copied, 3 s, 329 MB/s
32768+0 records in
32768+0 records out
1073741824 bytes (1.1 GB, 1.0 GiB) copied, 8.14441 s, 132 MB/s
[root@PPP Downloads]# sfdisk /dev/mmcblk2 << EOF
> label: gpt
> first-lba: 64
> table-length: 8
> size=32G, name="PHOSH", attrs="RequiredPartition,LegacyBIOSBootable"
> size=+, name="SXMO", attrs="RequiredPartition,LegacyBIOSBootable"
> EOF
Checking that no-one is using this disk right now ... OK
Disk /dev/mmcblk2: 115.23 GiB, 123731968000 bytes, 241664000 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
>>> Script header accepted.
>>> Script header accepted.
>>> Script header accepted.
>>> Created a new GPT disklabel (GUID: 7EB4B1E0-5F49-4F30-9F1E-E9E1F305D461).
The maximal number of partitions is 8 (default is 128).
/dev/mmcblk2p1: Created a new partition 1 of type 'Linux filesystem' and of size 32 GiB.
/dev/mmcblk2p2: Created a new partition 2 of type 'Linux filesystem' and of size 83.2 GiB.
/dev/mmcblk2p3: Done.
New situation:
Disklabel type: gpt
Disk identifier: 7EB4B1E0-5F49-4F30-9F1E-E9E1F305D461
Device            Start       End   Sectors  Size Type
/dev/mmcblk2p1     2048  67110911  67108864   32G Linux filesystem
/dev/mmcblk2p2 67110912 241661951 174551040 83.2G Linux filesystem
The partition table has been altered.
Calling ioctl() to re-read partition table.
Syncing disks.
[root@PPP Downloads]# lsblk
NAME         MAJ:MIN RM   SIZE RO TYPE MOUNTPOINTS
loop0          7:0    0     5G  0 loop 
├─loop0p1    259:0    0   122M  0 part /mnt/phosh/boot
└─loop0p2    259:1    0   4.9G  0 part /mnt/phosh/root
loop1          7:1    0   3.5G  0 loop 
├─loop1p1    259:2    0   122M  0 part /mnt/sxmo/boot
└─loop1p2    259:3    0   3.4G  0 part /mnt/sxmo/root
mmcblk2      179:0    0 115.2G  0 disk 
├─mmcblk2p1  179:1    0    32G  0 part 
└─mmcblk2p2  179:2    0  83.2G  0 part 
mmcblk2boot0 179:32   0     4M  1 disk 
mmcblk2boot1 179:64   0     4M  1 disk 
mmcblk1      179:96   0  59.6G  0 disk 
├─mmcblk1p1  179:97   0   122M  0 part /boot
└─mmcblk1p2  179:98   0  59.5G  0 part /
zram0        254:0    0   1.5G  0 disk [SWAP]

Build phosh partition

[root@PPP Downloads]# dd if=/dev/loop0p2 of=/dev/mmcblk2p1 bs=1M status=progress conv=fsync
5225054208 bytes (5.2 GB, 4.9 GiB) copied, 215 s, 24.3 MB/s5238685696 bytes (5.2 GB, 4.9 GiB) copied, 215.606 s, 24.3 MB/s
4996+0 records in
4996+0 records out
5238685696 bytes (5.2 GB, 4.9 GiB) copied, 218.565 s, 24.0 MB/s
[root@PPP Downloads]# mount /dev/mmcblk2p1 /mnt/ephosh/
[root@PPP Downloads]# scp -r /mnt/phosh/boot/* /mnt/ephosh/boot
[root@PPP Downloads]# mv /mnt/ephosh/boot/boot.scr /mnt/ephosh/boot/boot.scrORIG
[root@PPP Downloads]# nano /mnt/ephosh/etc/fstab              # set PARTLABEL for / and comment /boot
[root@PPP Downloads]# cat /mnt/ephosh/etc/fstab 
# Static information about the filesystems.
# See fstab(5) for details.
# <file system> <dir> <type> <options> <dump> <pass>
PARTLABEL=PHOSH 	/         	ext4      	rw,relatime	0 1
# UUID=52CA-6165      	/boot     	vfat      	rw,relatime,fmask=0022,dmask=0022,codepage=437,iocharset=ascii,shortname=mixed,utf8,errors=remount-ro	0 2
[root@PPP Downloads]# mkdir /mnt/ephosh/boot/extlinux
[root@PPP Downloads]# nano /mnt/ephosh/boot/extlinux/extlinux.conf
[root@PPP Downloads]# cat /mnt/ephosh/boot/extlinux/extlinux.conf
#/boot/extlinux/extlinux.conf
MENU TITLE Pinephone Pro Boot Menu
LABEL l0
MENU LABEL phosh
FDT /boot/dtbs/rockchip/rk3399-pinephone-pro.dtb
KERNEL /boot/Image
INITRD /boot/initramfs-linux.img
APPEND root=PARTLABEL=PHOSH console=ttyS2,115200 console=tty0 loglevel=4 rw rootwait fbcon=rotate:0 pinephone_keyboard.disable_input

Build sxmo partition

We have unmounted all the phosh devices, so 

[root@PPP Downloads]# lsblk
NAME         MAJ:MIN RM   SIZE RO TYPE MOUNTPOINTS
loop0          7:0    0     5G  0 loop 
├─loop0p1    259:0    0   122M  0 part 
└─loop0p2    259:1    0   4.9G  0 part 
loop1          7:1    0   3.5G  0 loop 
├─loop1p1    259:2    0   122M  0 part /mnt/sxmo/boot
└─loop1p2    259:3    0   3.4G  0 part /mnt/sxmo/root
mmcblk2      179:0    0 115.2G  0 disk 
├─mmcblk2p1  179:1    0    32G  0 part 
└─mmcblk2p2  179:2    0  83.2G  0 part 
mmcblk2boot0 179:32   0     4M  1 disk 
mmcblk2boot1 179:64   0     4M  1 disk 
mmcblk1      179:96   0  59.6G  0 disk 
├─mmcblk1p1  179:97   0   122M  0 part /boot
└─mmcblk1p2  179:98   0  59.5G  0 part /
zram0        254:0    0   1.5G  0 disk [SWAP]
[root@PPP Downloads]# dd if=/dev/loop1p2 of=/dev/mmcblk2p2 bs=1M status=progress conv=fsync
3613392896 bytes (3.6 GB, 3.4 GiB) copied, 153 s, 23.6 MB/s3628072960 bytes (3.6 GB, 3.4 GiB) copied, 153.543 s, 23.6 MB/s
3460+0 records in
3460+0 records out
3628072960 bytes (3.6 GB, 3.4 GiB) copied, 156.292 s, 23.2 MB/s
[root@PPP Downloads]# mount /dev/mmcblk2p2 /mnt/esxmo/
[root@PPP Downloads]# scp -r /mnt/sxmo/boot/* /mnt/esxmo/boot
[root@PPP Downloads]# mv /mnt/esxmo/boot/boot.scr /mnt/esxmo/boot/boot.scrORIG
[root@PPP Downloads]# nano /mnt/esxmo/etc/fstab                   # set PARTLABEL for / and comment /boot
[root@PPP Downloads]# cat /mnt/esxmo/etc/fstab 
# Static information about the filesystems.
# See fstab(5) for details.
# <file system> <dir> <type> <options> <dump> <pass>
PARTLABEL=SXMO	/         	ext4      	rw,relatime	0 1
# UUID=841C-F9DD      	/boot     	vfat      	rw,relatime,fmask=0022,dmask=0022,codepage=437,iocharset=ascii,shortname=mixed,utf8,errors=remount-ro	0 2
[root@PPP Downloads]# mkdir /mnt/esxmo/boot/extlinux
[root@PPP Downloads]# nano /mnt/esxmo/boot/extlinux/extlinux.conf
[root@PPP Downloads]# cat /mnt/esxmo/boot/extlinux/extlinux.conf 
#/boot/extlinux/extlinux.conf
MENU TITLE Pinephone Pro Boot Menu
LABEL l0
MENU LABEL sxmo
FDT /boot/dtbs/rockchip/rk3399-pinephone-pro.dtb
KERNEL /boot/Image
INITRD /boot/initramfs-linux.img
APPEND root=PARTLABEL=SXMO console=ttyS2,115200 console=tty0 loglevel=4 rw rootwait fbcon=rotate:0 pinephone_keyboard.disable_input

Follow-up comments

  1. On first boot neither phosh nor sxmo resized their partition - sudo resize2fs sorted that.
  2. Any time an update rebuilds the initramfs it is necessary to delete /boot/boot.scr again to keep the rk2aw menu clean.
  3. The end result is a boot screen as follows:
Options to boot phosh or sxmo
Retrieved from "https://wiki.pine64.org/index.php?title=PinePhone_Pro/Create_a_multi-distribution_image_using_rk2aw&oldid=20354"