Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit bab9b3a9 authored by Pranav's avatar Pranav
Browse files

Merge branch 'add-fp4-upgrade-guide-84304' into 'master'

Add FP4 upgrade guide

Closes e/backlog#6736

See merge request e/documentation/user!984
parents 2dff8756 384b20f2
Loading
Loading
Loading
Loading
+2 −0
Original line number Diff line number Diff line
@@ -10,6 +10,7 @@ codename: FP4
cpu: Kryo 570
cpu_cores: '8'
cpu_freq: Upto 2.2 GHz
upgrade_available: S
current_branch:
depth: 10.5 mm (0.41 in)
download_boot: devices.hold_volume_down_power_fairphone_4
@@ -72,3 +73,4 @@ verified_boot:

bootloader_relocking:
- {vendor: 'Any vendor', supported: 'yes'}
steps_to_flash_file_name: device_upgrade_FP4
+29 −0
Original line number Diff line number Diff line
{% include alerts/warning.html content="We are testing migration only for /stable package. It should work the same way with /dev, but I strongly advise you to backup all your data before proceeding." %}

### Manually upgrading your {{ device.codename }} to {{ device.upgrade_available }}

1. Download the /e/OS installation package as linked in the `Downloads for the {{ device.codename }} ` section in this guide.

1. Make sure your computer has working `adb`. Setup instructions are linked in the `Basic Requirements` section above

1. Open a console window on your computer. The next set of commands will be run on the console.
{{ adbRoot }}
{%- if device.format_on_upgrade %}
1. Reboot into recovery by running `adb reboot recovery`, or by performing the following:
    * {{ device.recovery_boot }}
1. Wipe your data partition (this is usually named `Wipe`, or `Format`)
    {% include alerts/warning.html content="Without this step your device will not boot on the new version!" %}
{%- if device.uses_twrp != true %}
1. Click `Advanced`, then `Enable ADB`.
{%- endif %}
{%- endif %}
1. Run `adb reboot sideload`.
    {% include alerts/warning.html content="The device may reboot to a blank black screen, this is a known bug on some recoveries, proceed with the instructions." %}
1. Run `adb sideload /path/to/zip` (inserting the path to your /e/OS package).
  

{% if device.uses_twrp and device.is_ab_device != true %}
1. Once you have installed everything successfully, run `adb reboot`.
{% else %}
1. Once you have installed everything successfully, click the back arrow in the top left of the screen, then `Reboot system now`.
{% endif %}
+11 −0
Original line number Diff line number Diff line
@@ -19,6 +19,16 @@ Try the /e/OS Recovery (**limited functionality**)
{% endif %}
[//]: # ( Build type related )

{% if device.codename == "FP4" %}

{% include alerts/danger.html content="You must flash the corresponding build linked below, to manually upgrade from Android R to Android S on your FP4. Upgrading directly to the latest Android S build from Android R will cause a bluetooth database corruption." %}

- [/e/OS S upgrade dev build for dev Android R users](http://images.ecloud.global/dev/FP4/e-1.5.1-s-20221103231515-dev-FP4.zip)
- [/e/OS S upgrade stable build for stable Android R users](http://images.ecloud.global/stable/FP4/e-1.5.1-s-20221102231514-stable-FP4.zip)

{% endif %}

{% if device.codename != "FP4" %}
{% if device.build_version_dev %}
- /e/OS build : [{{ device.build_version_dev }} dev](https://images.ecloud.global/dev/{{ device.codename }}) {{ security_patch }}
{%- endif %}
@@ -31,6 +41,7 @@ Try the /e/OS Recovery (**limited functionality**)
{% if device.build_version_stable %}
- /e/OS build : [{{ device.build_version_stable }} stable](https://images.ecloud.global/stable/{{ device.codename }}) {{ security_patch }}
{%- endif %}
{%- endif %}

> To understand the difference between /e/OS builds check [this guide](/build-status)