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

Commit b825cfb6 authored by Manoj Nair's avatar Manoj Nair
Browse files

content changes

parent 41bbb05a
Loading
Loading
Loading
Loading
+47 −34
Original line number Diff line number Diff line
{% include alerts/warning.html content="Make sure you can rollback to stock firmware in case /e/OS doesn't work at all" %}
{% include alerts/warning.html content="Make sure you can rollback to stock firmware in case the /e/OS GSI doesn't work" %}

## Step 1: Install fastboot
> This step is executed on the PC

## Installing fastboot

### On Windows

@@ -17,40 +19,46 @@ To install fastboot on your Windows PC follow [this guide](/pages/install-adb-wi

If you do not have fastboot installed on your linux device follow [this guide](/pages/install-adb)

## Find your phone architecture
## Step 2: Find your phone architecture
> This step is executed on the Phone


An easy way to do this is to install `treble info`
An easy way to do this is to install `treble info` on your phone.

> You will find the `treble info` app in the /e/OS default Apps Store as shown in the screenshot below
{% include alerts/tip.html content="You will find the `treble info` app in the /e/OS App Lounge. Once installed the app will display information as shown in the screenshot below" %}


![](/images/TrebleCheck_Apps-small.png)
![](/images/TrebleCheck_Apps.png)

This is to verify that the 
- Phone is Project Treble compatible
- Check the CPU architecture it should show 
This information can help to verify that the 
1. Phone is Project Treble compatible
1. Check the CPU architecture it should show 
  - arm or 
  - arm 64
1. If the device is "System as root" then a A/B build will be necessary
1. Name of the required system image (for example system-arm64-ab.img.xz)
1. Under Dynamic Partition, check if you need fastbootd. Clickinf on the option will display a pop-up which will have this information.

- If the device is "System as root" then a A/B build will be necessary

So, please note the following information:
- name of the required system image (for example system-arm64-ab.img.xz)
- Under Dynamic Partition, check if you need fastbootd
## Step 3: Remove dm verity
> This step is executed on the Phone if using TWRP or on the PC from the console where you are executing fastboot commands


## Remove dm verity

- This can be done on some devices using twrp 
- A slightly more complicated method is by extracting the kernel and reflashing it with the below command

```shell
fastboot flash --disable-verity --disable-verification boot boot.img
```

## Flash the system image
  `fastboot flash --disable-verity --disable-verification boot boot.img`


## Step 4: Flash the system image

> This step is executed on the PC


Once you know which system image you need, download it
Once you know which system image you need, download it and save it to a location on your PC.

Choose the system image specific to your device from the list below:

- [Arm A](https://images.ecloud.global/dev/treble_arm_avN/) (system-arm-a.img.xz)
- [Arm A/B](https://images.ecloud.global/dev/treble_arm_bvN/) (system-arm-ab.img.xz)
@@ -59,24 +67,29 @@ Once you know which system image you need, download it
- [Binder 64 A](https://images.ecloud.global/dev/treble_a64_avN/) (system-a64-a.img.xz)
- [Binder 64 A/B](https://images.ecloud.global/dev/treble_a64_bvN/) (system-a64-ab.img.xz)

if fastbootd is required, start with
1. Connect your phone to your PC with a USB cable. 
  > Please note there are cables which are only for charging your phone. They will not work here. The USB cable should allow data exchange between the PC and the phone.

1. Type the below command in the PC console. If fastbootd is required for your device as detected in Step 2 , type the below command

    `fastboot reboot fastboot`
    

1. Extract system.img and flash it on the phone with this command line. The command is executed in the PC console

    
    `fastboot flash system system.img`
    
```shell
fastboot reboot fastboot
```

then, in every cases, extract system.img and flash it with this command line
## Step 5: Erase userdata
 > This step is executed on the PC in the console where you are executing fastboot commands

```shell
fastboot flash system system.img
```
- This step will remove all existing userdata on the device
    
## Erase userdata
    `fastboot -w`
    
```shell
fastboot -w
```

## Optional steps

- install a custom recovery
 No newline at end of file
## Additional References
- [Project Treble](https://android-developers.googleblog.com/2020/12/treble-plus-one-equals-four.html)
- [How to flash a GSI image](https://www.xda-developers.com/flash-generic-system-image-project-treble-device/)
 No newline at end of file
+40.2 KiB
Loading image diff...
+1 −1
Original line number Diff line number Diff line
---
layout: page
title: How to /e/OS on a non supported device?
title: How to install /e/OS using a GSI?
permalink: /support-topics/install-GSI
toc: true
---