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

Commit f85abcac authored by Bharath's avatar Bharath
Browse files

Merge branch '159-improve-FP4-installation' into 'master'

FP4: Simplify installation steps

Closes #159

See merge request e/documentation/user!736
parents b127bdd6 b39b5f23
Loading
Loading
Loading
Loading
+41 −63
Original line number Diff line number Diff line
## Installing /e/OS 

### Installing /e/OS using IMG or image file
{% include alerts/tip.html content="For Windows users, we advise to use Git Bash. For more info about Downloads and Installation see [Official Documentation](https://git-scm.com/about)"%}

{% include alerts/danger.html content="The FP4 comes with an anti-rollback feature. Read the paragraph marked `Caution` in Requirements section of this guide, before proceeding." %}

1. Boot your FP4 in bootloader mode, and plug it to your computer
1. On your computer, download the zip file from the link provided above. Unzip the folder and browse into it 
1. Flash /e/OS with the following commands:

>> 

    fastboot flash bluetooth_a bluetooth.img
    fastboot flash bluetooth_b bluetooth.img
    fastboot flash devcfg_a devcfg.img
    fastboot flash devcfg_b devcfg.img
    fastboot flash dsp_a dsp.img
    fastboot flash dsp_b dsp.img
    fastboot flash modem_a modem.img
    fastboot flash modem_b modem.img
    fastboot flash xbl_a xbl.img
    fastboot flash xbl_b xbl.img
    fastboot flash tz_a tz.img
    fastboot flash tz_b tz.img
    fastboot flash hyp_a hyp.img
    fastboot flash hyp_b hyp.img
    fastboot flash keymaster_a keymaster.img
    fastboot flash keymaster_b keymaster.img

    fastboot flash abl_a abl.img
    fastboot flash abl_b abl.img
    fastboot flash boot_a boot.img
    fastboot flash boot_b boot.img
    fastboot flash recovery_a recovery.img
    fastboot flash recovery_b recovery.img
    fastboot flash dtbo_a dtbo.img
    fastboot flash dtbo_b dtbo.img
    fastboot flash vbmeta_system_a vbmeta_system.img
    fastboot flash vbmeta_system_b vbmeta_system.img
    fastboot flash vbmeta_a vbmeta.img
    fastboot flash vbmeta_b vbmeta.img
    fastboot flash super super.img

    fastboot flash aop_a aop.img
    fastboot flash aop_b aop.img
    fastboot flash featenabler_a featenabler.img
    fastboot flash featenabler_b featenabler.img
    fastboot flash imagefv_a imagefv.img
    fastboot flash imagefv_b imagefv.img
    fastboot flash multiimgoem_a multiimgoem.img
    fastboot flash multiimgoem_b multiimgoem.img
    fastboot flash qupfw_a qupfw.img
    fastboot flash qupfw_b qupfw.img
    fastboot flash uefisecapp_a uefisecapp.img
    fastboot flash uefisecapp_b uefisecapp.img
    fastboot flash xbl_config_a xbl_config.img
    fastboot flash xbl_config_b xbl_config.img
    fastboot flash core_nhlos_a core_nhlos.img
    fastboot flash core_nhlos_b core_nhlos.img

    fastboot erase userdata
    fastboot erase metadata

    fastboot --set-active=a
1. Unzip the archive

    ```
    unzip <fileyoudownloaded>
    ```

   > Replace `<fileyoudownloaded>` with the name of the archive file you downloaded.

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


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_FP4_factory.sh` - The installer script.

1. Boot into bootloader/fastboot mode.

    - Power OFF the device.
    - While holding `Volume Down` button, plug in a USB Cable that's connected to a PC on the other end.

1. Run the installer script on Terminal(Linux) or on Git Bash UI(Windows).
    - Make sure you are in the current directory which contains the `flash_FP4_factory.sh` file.

    **Linux**
    - Right click -> Open terminal here

    **Windows**
    - Right click -> Git Bash here
    - Execute the following command:

    ```
    chmod +x flash_FP4_factory.sh && ./flash_FP4_factory.sh
    ```

    The script will flash all required files and will wait for input at the last step. Proceed to locking the bootloader.


## Locking the Bootloader
@@ -70,7 +49,6 @@

Once you have completed the above steps  and before rebooting you can and should lock your Bootloader. 

1. Boot your device into bootloader if not already there, and plug it to your computer
1. Lock critical partitition with the following command
   - `fastboot flashing lock_critical`
   - Approve with  <kbd>Voume +</kbd> then <kbd>power</kbd>