Skip to content

Commit

Permalink
Reworked the instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
x1y committed Mar 20, 2024
1 parent 38af793 commit 0e610c2
Showing 1 changed file with 19 additions and 14 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -22,17 +22,13 @@ To install an image to the microSD card:

image:/documentation/images/Pinephone_slots.png[The microSD belongs in the upper slot, the micro-SIM in the lower slot.,title="The microSD belongs in the upper slot, the micro-SIM in the lower slot.",width=600]

== Flashing the microSD

=== Using Balena Etcher
== Using Balena Etcher

Using the graphical application _Balena Etcher_ to flash the microSD card is _'recommended_' for new or inexperienced users.

Download: https://etcher.balena.io/#download-etcher

Install the application and start it.
Download and install the application: https://etcher.balena.io/#download-etcher

Click the button _Flash from file_:
Then start it and click the button _Flash from file_:

image:../Etcher1.png[width=600]

Expand All @@ -50,21 +46,30 @@ Then click on _Flash!_:

image:../Etcher4.png[width=600]

That's it! Now follow the further instructions above.
That's it!

== Using dd

For flashing the microSD card, the command _dd_ can be used as well.

=== Using dd
Make sure to select the correct device using `lsblk`. Then run `dd` with the selected device:
Make sure to select the correct device using `lsblk`. Then run _dd_ with the selected device:

`sudo dd if=*IMAGE.img* of=/dev/*[DEVICE]* bs=1M status=progress conv=fsync`

NOTE: The image needs to be written to the whole device, not to partition 1. Make sure you're NOT selecting _/dev/sda1_ or _/dev/mmcblk0p1_ as target.

=== Using bmaptool
== Using bmaptool

Make sure to select the correct device using `lsblk`. Then run bmaptool with the correct device:

Download the _IMAGE.xz_ and the _IMAGE.bmap_ files, then run `bmaptool copy --bmap *IMAGE.bmap* *IMAGE.xz* /dev/*[DEVICE]*`. This takes around 2.5 minutes to flash a 4 Gb file.
Download the _IMAGE.xz_ and the _IMAGE.bmap_ files, then run:

`bmaptool copy --bmap *IMAGE.bmap* *IMAGE.xz* /dev/*[DEVICE]*`

This takes around 2.5 minutes to flash a 4 Gb file.

== Using Gnome Disks

=== Using Gnome Disks
The graphical application _Gnome Disks_ can be used to flash the microSD card as well.

Gnome Disks can be used to flash the microSD card. To do so, select the correct device in the left device selection, then click on the three dot menu and select _Restore Disk Image..._ and follow the on-screen instructions.
To do so, select the correct device in the left device selection, then click on the three dot menu and select _Restore Disk Image..._ and follow the on-screen instructions.

0 comments on commit 0e610c2

Please sign in to comment.