... | ... | @@ -18,61 +18,80 @@ The /e/ project and its project members deny any and all responsibility about th |
|
|
### Notes
|
|
|
|
|
|
Some useful additional information can be found at:
|
|
|
1. https://forum.xda-developers.com/essential-phone/development/rom-lineageos-14-1-essential-ph-1-mata-t3703759
|
|
|
1. https://forum.xda-developers.com/essential-phone/development/stock-7-1-1-nmj20d-t3701681
|
|
|
2. https://mata.readthedocs.io/en/latest/
|
|
|
1. https://mata.readthedocs.io/en/latest/
|
|
|
|
|
|
### Requirements
|
|
|
|
|
|
1. *Optionnal*: It is recommended that you have an /e/ account (like: john.doe@e.email) if you want to benefit from /e/ account integration for all online services such as: email, drive, calendar, notes, tasks. In order to get a test /e/ account, please read instructions [here](create-e-test-account).
|
|
|
1. Make sure your computer has working `adb` and `fastboot`. Setup instructions can be found [here](https://wiki.lineageos.org/adb_fastboot_guide.html).
|
|
|
1. Enable USB debugging on your device.
|
|
|
1. In can of issue, please use another USB cable than the one provided by Essential
|
|
|
1. Please read through the instructions at least once completely before actually following them to avoid any problems because you missed something!
|
|
|
|
|
|
### Unlocking the bootloader
|
|
|
|
|
|
### Installing a custom recovery
|
|
|
1. Unlock bootloader
|
|
|
|
|
|
1. Download a custom recovery - you can download [TWRP](https://dl.twrp.me/mata).
|
|
|
1. Connect your device to your PC via USB.
|
|
|
1. On the computer, open a command prompt (on Windows) or terminal (on Linux or macOS) window, and type
|
|
|
```shell
|
|
|
fastboot flashing unlock
|
|
|
```
|
|
|
|
|
|
1. Unlock critical partition
|
|
|
|
|
|
```shell
|
|
|
adb reboot bootloader
|
|
|
fastboot flashing unlock_critical
|
|
|
```
|
|
|
1. Once the device is in fastboot mode, verify your PC finds it by typing
|
|
|
|
|
|
### Flashing firmwares
|
|
|
|
|
|
1. Download the [https://www.androidfilehost.com/?fid=674106145207485528 NMI81C archive] and unzip
|
|
|
|
|
|
1. make the flash script executable and run the script:
|
|
|
|
|
|
On Linux or MacOS X:
|
|
|
|
|
|
```shell
|
|
|
fastboot devices
|
|
|
chmod +x ./no\ SYSTEM-BOOT-VENDOR-flash-all-WIPE.sh
|
|
|
./no\ SYSTEM-BOOT-VENDOR-flash-all-WIPE.sh
|
|
|
```
|
|
|
1. Flash recovery onto your device
|
|
|
|
|
|
On Windows:
|
|
|
|
|
|
```shell
|
|
|
fastboot flash recovery twrp-x.x.x-x-mata.img
|
|
|
chmod +x ./no\ SYSTEM-BOOT-VENDOR-flash-all-WIPE.bat
|
|
|
./no\ SYSTEM-BOOT-VENDOR-flash-all-WIPE.sh
|
|
|
```
|
|
|
1. Now reboot into recovery to verify the installation
|
|
|
|
|
|
### Installing a custom recovery: TWRP for Mata
|
|
|
|
|
|
1. Download [https://gg.gg/9ubmn TWRP for Mata]
|
|
|
1. Connect your device to your PC via USB.
|
|
|
1. Flash TWRP to the boot partition:
|
|
|
|
|
|
```shell
|
|
|
fastboot -w
|
|
|
fastboot flash boot twrp-mata_11.img
|
|
|
```
|
|
|
1. Stay in bootloader mode, and use the volume down to select "Recovery mode". Then hit the power button: this should boot you in to recovery mode (TWRP). If it's asking for a password, enter your previous lockscreen password or pin, this will decrypt your data partition. Note: don't be surprised that TWRP will be erased at next boot. Therefore, you will have to reinstall it if you want to install another ROM on your device.
|
|
|
|
|
|
### Installing /e/ from custom recovery
|
|
|
|
|
|
1. Download the /e/ install package that you’d like to install from [here](https://images.ecloud.global/nightly/mata/).
|
|
|
1. If you aren’t already in recovery mode, reboot into recovery mode:
|
|
|
1. In recovery mode, put your device in sideload mode:
|
|
|
|
|
|
```shell
|
|
|
adb reboot recovery
|
|
|
adb shell twrp sideload
|
|
|
```
|
|
|
1. *Optional* Tap the Backup button to create a backup. Make sure the backup is created in the external sdcard or copy it onto your computer as the internal storage will be formatted.
|
|
|
1. Go back to return to main menu, then tap Wipe.
|
|
|
1. Now tap Format Data and continue with the formatting process. This will remove encryption as well as delete all files stored on the internal storage.
|
|
|
1. Return to the previous menu and tap Advanced Wipe.
|
|
|
1. Select the Cache and System partitions to be wiped and then Swipe to Wipe.
|
|
|
1. Place the /e/ .zip package on the root of /sdcard:
|
|
|
|
|
|
1. Flash the /e/ .zip package:
|
|
|
|
|
|
```
|
|
|
adb push filename.zip /sdcard/
|
|
|
adb sideload
|
|
|
```
|
|
|
1. Go back to return to main menu, then tap Install.
|
|
|
1. Navigate to /sdcard, and select the /e/ .zip package.
|
|
|
1. Follow the on-screen prompts to install the package.
|
|
|
1. Once installation has finished, return to the main menu, tap Reboot, and then System
|
|
|
|
|
|
<i>This documentation "Install /e/ on **** - *"mata"*" is a derivative of ["install LineageOS on mata"](https://wiki.lineageos.org/devices/mata/install) by The LineageOS Project, used under [CC BY](https://creativecommons.org/licenses/by-sa/3.0/) . "Install /e/ on **** - *"mata"*" is licensed under [CC BY](https://creativecommons.org/licenses/by-sa/3.0/) by e Foundation 2018.</i>
|
|
|
1. Once installation has finished, you can reboot
|
|
|
|
|
|
<i>"Install /e/ on **** - *"mata"*" is licensed under [CC BY](https://creativecommons.org/licenses/by-sa/3.0/) by e Foundation 2018.</i>
|
|
|
|