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

Commit a1236b51 authored by Bharath's avatar Bharath
Browse files

FP3: Simplify installation steps

* Drop all steps that are not required
* Rewrite instructions that will help use the new installation
package.

NOTE: Currently supports Linux OS only.

Change-Id: Ic1d5f75677ea7c03e1941e253233dc48f828467c
parent 65d4edfa
Loading
Loading
Loading
Loading
+20 −45
Original line number Diff line number Diff line
## Installing /e/OS from the bootloader

{% include alerts/tip.html content="Some of the commands have a -S after them. Please note it is a hyphen '-' followed by a capital 'S' and the value 522239K "%}

1. Unzip the archive

    ```
    unzip fileyoudownloaded
    ```

   > Replace `fileyoudownloaded` with the name of the archive file you downloaded . You can unzip the files into the folder where you copied the fastboot files.
   > Replace `fileyoudownloaded` with the name of the archive file you downloaded.

   > Alternately you can create a folder and unzip the archive there.

   >  In the second case the below commands will need the path to the folder where you unzipped the archive.
1. Install /e/OS using the following commands (from fastboot mode)

    ```
    fastboot -w
    fastboot flash system_a system.img -S 522239K
    fastboot flash boot_a boot.img
    fastboot flash vendor_a vendor.img -S 522239K
    fastboot flash dtbo_a dtbo.img
    fastboot flash vbmeta_a vbmeta.img

    fastboot flash system_b system.img -S 522239K
    fastboot flash boot_b boot.img
    fastboot flash vendor_b vendor.img -S 522239K
    fastboot flash dtbo_b dtbo.img
    fastboot flash vbmeta_b vbmeta.img

    fastboot flashing lock
    ```

    - The last command will ask you to confirm on the device to lock the bootloader.
1. Confirm that extracted directory contains following content:

    - `bin-linux-x86 directory` - which contains linux tools including fastboot and adb
    - `bin-msys directory` - which contains Windows tools including fastboot and adb
    - `img files` - The `img` files that are to be flashed onto the device.
    - `flash_FP3_factory.sh` - The installer script.

    - Select **LOCK THE BOOTLOADER** with `Volume +` and valid with `Power`.
1. Boot into bootloader/fastboot mode.

    - Power OFF the device and press `Volume Down + Power` buttons simultaneously.

    - On previous version of `fastboot`, the last command is `fastboot oem lock`

1. Enjoy! The device will now reboot automatically on /e/OS.
1. Run the installer script on Linux terminal.

### Getting a `fastboot` error ?
    ```
    chmod +x flash_FP3_factory.sh && ./flash_FP3_factory.sh
    ```

-  On some versions of `fastboot` you may get an error while running the `Fastboot flash boot boot.img` command
    - The script will flash all required files and will wait for input at the last step.

- The below error may show up on the console
    - The last command will ask you to confirm on the device to lock the bootloader.

    ```
    fastboot error: couldn’t parse partition size ‘0x’
    ```

- A workaround for this error is as under. Run this command on the console:
    - Select **LOCK THE BOOTLOADER** with `Volume +` and validate with `Power` button.

    ```
    fastboot getvar current-slot
    ```
- This would show the current active slot. For e.g. if it shows `a` , run the below command

    ```
    fastboot --set-active=b
    fastboot flash boot_b boot.img
    ```
1. Enjoy! The device will now reboot automatically on /e/OS.

{% include alerts/tip.html content= "If you find an issue with this installation document or if you want to suggest improvements, Please create a dedicated thread on our  [community forum](https://community.e.foundation/) "%}
{% include alerts/tip.html content= "If you find an issue with this installation document or if you want to suggest improvements, Please share your suggestion in [this document](https://community.e.foundation/t/fairphone-fp3-fp3-documentation-suggestions/20955) "%}

{% include alerts/success.html content= "Congratulations !! Your phone should now be booting into /e/OS !! "%}