Merge branch 'revert-60c095b1' into 'master'

gpu: Adreno 630

has_recovery_partition: true

image: axolotl.png

install_method: fastboot_nexus

is_ab_device: true

kernel: android_kernel_shift_sdm845

maintainers: []

peripherals: [A-GPS, Accelerometer, BeiDou, Compass, DP over USB-C, Fingerprint reader, GLONASS, GPS, Galileo, Gyroscope, Light sensor, NFC, Proximity sensor, QZSS, SBAS, USB OTG, Wi-Fi Display]

ram: 8 GB LPDDR4X

recovery_boot: devices.hold_volume_down_power

release: 2020

release: 2020-06

screen: 6 in

screen_ppi: 402

screen_res: 1080x2160

screen_tech: AMOLED

security_patch_date: 2024-01-05

sdcard: Upto '512 GB'

soc: Qualcomm SDM845 Snapdragon 845

storage: 128 GB UFS 2.1

maturity: green

install:

- { mode: Community install doc }

display_erecovery: false

requirements_file_name: requirements_axolotl

oem_unlock_file_name: oem_unlock_generic

install_e_file_name: install_e_axolotl

recovery_install_file_name: recovery_install_fastboot_generic_install

recovery_install_command: fastboot flash recovery

install_e_file_name: erecovery_install

safetynet:  2

rootbeer_pass:  1

 No newline at end of file

## Installing /e/OS 

{% 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 axolotl comes with an anti-rollback feature. Read the paragraph marked `Caution` in Requirements section of this guide, before proceeding." %}

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_axolotl_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_axolotl_factory.sh` file.

    **Linux**

    - Right click -> Open terminal here

    **Windows**

    - Right click -> Git Bash here

    - Execute the following command:

    ```

    chmod +x flash_axolotl_factory.sh && ./flash_axolotl_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

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

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

1. Lock critical partition with the following command

   - `fastboot flashing lock_critical`

   -  Approve with  <kbd>Volume +</kbd> then <kbd>power</kbd>

1. Reboot your device into bootloader, and plug it to your computer

1. Lock the device with the following command

   - `fastboot flashing lock`

   - Approve with  <kbd>Volume +</kbd> then <kbd>power</kbd>

{% include templates/requirements.md %}

{% include alerts/danger.html content="The axolotl comes with an anti-rollback feature. Google Android anti-roll back feature is supposedly a way to ensure you are running the latest software version, including the latest security patches.

<br><br>If you try installing a version of /e/OS based on a security patch that is older than the one on your device, you will brick your device. Click on `Details` below for detailed information<br>

<details>

<br>

To check the security patch level on your phone with a locked bootloader, prior to installing /e/OS, open your phone `Settings` >> `About Phone` >> `Android Version` >> `Android Security Patch Level`.Then compare it against the level of the security patch on the /e/OS build as visible in the Downloads for axolotl section below.

<br><br><strong>The following values control whether anti-rollback features are triggered on axolotl:</strong>

<br>

<br> * Rollback protection errors trigger if you install an update whose version number is `LESS` than the rollback index's value stored on device.

<br> * The value of rollback index is `UPDATED` to match `ro.build.version.security_patch`'s value of the currently installed version, but only if the bootloader is `LOCKED`.

<br> * The value of rollback index is `NOT` dependent on the currently installed `ANDROID VERSION`.

<br> * The value of rollback index can `NEVER` be `DOWNGRADED`.

<br> * Rollback protection errors are `FATAL` when the bootloader is `LOCKED`.

<br> * Rollback protection errors are `IGNORED` when the bootloader is `UNLOCKED`.

<br>

<br>

Here are some examples to help you understand how anti-rollback features work:

<br><br>

<strong>Example 1</strong>

<br> * Your axolotl with Google Android has a Security Patch Level saying June 5, 2022

<br> * The /e/OS build available says: /e/OS build : R stable (Security patch: 2022-05-05)

<br> * In this example, the /e/OS build has an older Security Patch level than the origin, so the anti-roll back protection will trigger, and you will brick your phone

<br>     

<strong>Example 2</strong>

<br> * Your axolotl with Google Android has a Security Patch Level saying June 5, 2022.

<br> * The /e/OS build available says: /e/OS build : R stable (Security patch: 2022-06-05)

<br> * In this example, the /e/OS build has the same Security Patch level than the origin, so the anti-roll back protection will pass, and you will be able to install /e/OS with no issues.

<br>

<br>

<strong>Example 3</strong>

<br> * Your axolotl runs Google Android -R while /e/OS is now available based on AOSP -S.

<br> * Your axolotl with Google Android has a Security Patch Level saying 2022-10-03 or October 3rd, 2022.

<br> * The /e/OS build available says: /e/OS build : S stable (Security patch: 2022-06-05)

<br> * In this example, the /e/OS build has an older Security Patch level than the origin, so the anti-roll back protection will trigger, even if the /e/OS version runs on a more recent version of AOSP. In this example, you will brick your phone.

</details>

" %}