Merge branch '68-updates-to-the-documentation-required-to-handle-device-upgrades' into 'master'

soc: Qualcomm MSM8974AB-AB Snapdragon 801

storage: 32 GB

tree: android_device_fairphone_FP2

twrp_version: 3.2.3.0

type: phone

upgrade_available: v1-pie

vendor: Fairphone

vendor_short: fairphone

versions: [nougat]

versions: v1-nougat

width: 73 mm (2.9 in)

wifi: 802.11 b/g/n/ac

status: dev

- The updater app does not support upgrades from one Android version to another. It will hide any update of a different version.

- We are working on resolving this issue.

- While this issue is resolved, users need to manually upgrade their OS.

- Upgrading manually requires similar steps to installing /e/OS for the first time.

* The stock ROM has firmware and configuration settings which is not included in the /e/OS ROM. These files are required for the hardware to work correctly. By flashing the stock your smartphone is optimized to receive this operating system update. This will be a one time process and subsequent /e/OS updates will be available OTA (over the air).

* Flashing the /e/OS upgrade directly without flashing the stock ROM can result in the device going into a bootloop.

      <br>

      <div class="tile is-child is-8" id="install">

        <h3 class="title is-4 is-spaced">Install</h3>

        <p class="subtitle is-6">To get the latest /e/OS build for your {{ device.vendor }} {{ device.name }} - "{{ device.codename }}" <a href="{{ "devices/" | append: device.codename | append: "/install" | relative_url }}"> click here</a> </p>

        <p class="subtitle is-6">To update to a newer version of the /e/OS on your {{ device.vendor }} {{ device.name }} - "{{ device.codename }}" <a href="{{ "devices/" | append: device.codename | append: "/install" | relative_url }}"> click here</a> </p>

      </div>

      <br>

      <br>

      {% if device.upgrade_available %}

      <div class="tile is-child is-8" id="upgrade">

        <h3 class="title is-4 is-spaced">Upgrade</h3>

        <p class="subtitle is-6">To upgrade to a higher version of the e/OS version for your {{ device.vendor }} {{ device.name }} - "{{ device.codename }}" <a href="{{ "devices/" | append: device.codename | append: "/upgrade" | relative_url }}"> click here</a> </p>

        <small>(For e.g. {{ device.versions }} -> {{ device.upgrade_available }})</small>

      </div>

      <br>

      <br>

      {% endif %}

      <div class="tile is-child is-8" id="build">

        <h3 class="title is-4 is-spaced">Build</h3>

        <p class="subtitle is-6">Want to build the /e/OS for the {{ device.vendor }} {{ device.name }} - {{ device.codename }} ? <a href="{{ site.baseurl }}/how-tos/build-e"> Click here</a></p>

<div class="wrapper" markdown="1">

{% assign device = site.data.devices[page.device] %}

## Manually upgrade {{ device.codename }} to {{ device.upgrade_available }}

### Basic Requirements

* adb and fastbooot should be setup and working on your PC

  > To set up adb follow details provided [here](../../pages/install-adb)

* adb and fastboot need root rights in Linux and administrator rights in Windows.

  > In Linux prepend sudo to any adb or fastboot command For e.g. “sudo fastboot reboot” and

    in Windows start the command window as administrator.

### Download

* Download Upgrade Build for the {{ device.codename }} here

  {%- for status in device.status %}

  [{{status}}](https://images.ecloud.global/{{status}}/{{device.codename}}/) ({{device.upgrade_available}})

  {%- endfor %}

* Download [TWRP](https://dl.twrp.me/FP2/)

  {% if device.twrp_version %}

> The TWRP version we tested was {{ device.twrp_version }}

  {% endif %}

> Download of TWRP is not required if you already have it running on your {{ device.codename }}

{% if device.stockupgrade %}

* Download the latest stock ROM build for the {{ device.codename }}

  > stock ROM tested {{ device.stockupgrade }}

* Download the {{ device.stockupgrade_tool }}

   > tool version tested {{ device.stockupgrade_toolver }}

- Follow the steps to install the stock ROM as given on the vendor site

- Once the Stock ROM is flashed check if it is working for e.g receiving and making calls, audio, FMRadio ..

- Next enable developer options on the phone     

{% endif %}

### Steps to Flash the Upgrade /e/OS ROM

1. Open a command window and change into the directory where you downloaded the files

1. Take a complete backup of your phone data

1. Ensure your {{ device.codename }} smartphone is fully charged

1. Remove any pattern or PIN locks you may have set on your phone

  > you can set these up after the OS has been successfully installed on your phone

1. If you already have TWRP recovery installed on your device

    - skip steps 6 and 7

    - Go directly into TWRP recovery (step 9)

    - To do that reboot your device and press volume-up during startup.

1. To flash TWRP recovery

   - Reboot your device and press volume-down during startup.

   - This will bring the device into fastboot mode

1. Flash the TWRP image in the fastboot mode by running below command in the PC

    ```

    fastboot flash recovery twrpimagename.img

    ```

    on some devices the below command may be required

    ```

    fastboot boot twrpimagename.img

    ```

   > replace the twrpimagename.img with the name of the twrp image file name you downloaded previously

   > the boot command will flash a temporary TWRP image on your smartphone

    {% if device.twrp_version %}

    > The TWRP version we tested was {{ device.twrp_version }}

    {% endif %}

1. Reboot the device via the command

   ```

   fastboot reboot

   ```

   and press volume-up while booting to go into TWRP recovery

1. If your device is un-encrypted

   - Continue with installing the new build as given in step 13

1. If your device is encrypted

   - Ensure you have taken a backup as proposed in step 1

   - Continue to step 11

1. In TWRP wipe screen on your device click the format data button on the lower side to remove encryption

1. Select the Wipe button and in the wipe screen select system + data + cache and swipe to wipe

1. Sideload the /e/ .zip package

    - On the device, In TWRP select

     Advanced >> ADB Sideload >> then swipe to begin sideload

    - On the host machine, sideload the package by running the below command

```

	adb sideload /e/ OS image name.zip

```

     >replace the /e/ OS image name.zip with the name of the /e/ OS zip file name,

     e.g. adb sideload e-0.7-p-2020011437643-test-FP2.zip

1. Once the installation is successfully completed reboot system from the TWRP screen.

1. Your {{ device.codename}} should now be running the  {{ device.upgrade_available}} version of /e/..enjoy !!!

### Answers to some questions you may have on the process

#### Why do I need to manually upgrade the OS

> {% include alerts/warning_why_manually_upgrade.md %}

{%  if device.stockupgrade %}

#### Why do I need to flash Stock ROM before flashing the /e/ROM to upgrade?

  > {% include alerts/warning_why_stock_upgrade.md %}

{% endif %}