Merge branch '694devices-t-FP5_docs' into 'master'

architecture: arm64

battery: {removable: True, capacity: 4200, tech: 'Li-Ion'}

bluetooth: {spec: 5.2 + LE, profiles: [A2DP]}

cameras:

- {flash: 'Dual-LED (dual-tone)', info: '50MP f/1.9 (Rear Wide)'}

- {flash: 'Dual-LED (dual-tone)', info: '50MP f/2.2 (Rear Ultra Wide)'}

- {info: '50MP f/2.5 (Front Wide)'}

channels:

codename: FP5

cpu: Kryo 670

cpu_cores: '8'

cpu_freq: 1 x 2.7 GHz + 3 x 2.2 GHz + 4 x 1.9 GHz

current_branch:

depth: 9.6 mm (0.38 in)

download_boot: devices.hold_volume_down_power

gpu: Qualcomm Adreno 643

height: 161.6 mm (6.36 in)

image: FP5.png

maintainers: []

models: [FP5]

name: FP5

network:

- {tech: 2G, bands: '850/900/1800/1900 Mhz' }

- {tech: 3G, bands: '1/2/5/8' }

- {tech: 4G, bands: '1/2/3/4/5/7/8/12/20/28/32/38/40/41/42/48/66/71' }

- {tech: 5G, bands: 'n1/n2/n3/n5/n7/n8/n20/n28/n38/n41/n48/n66/n71/n77/n78'}

- {tech: VoLTE + VoWiFi (depending on local network)}

peripherals: [Compass, Accelerometer, Gyroscope, Fingerprint Scanner (Side Mounted, Right), Light sensor, Dual SIM (1 Physical + 1 e-SIM), GPS, GLONASS, Proximity sensor, USB Type C]

ram: 8 GB

recovery_boot: devices.bootloader_to_recovery

release: 2023

screen: 6.46 in

screen_ppi: 459

screen_res: 1224x2700

screen_tech: OLED

screen_refresh_rate: 90

security_patch_date: 2023-10-06

sdcard: Upto 256 GB

soc: Qualcomm QCM6490

storage: 256 GB

type: phone

community_doc_url: https://community.e.foundation/t/fairphone-fp5-fp5-documentation-suggestions/53036

uses_twrp: false

vendor: Fairphone

vendor_short: fairphone

width: 75.8 mm (2.98 in)

wifi: 802.11 a/b/g/n/ac/6e + WiFi Direct

build_version_dev: T

build_version_stable: T

should_be_latest_version: false

oem_unlock_code_required: https://www.fairphone.com/en/bootloader-unlocking-code-for-fairphone-3/

is_ab_device: true

is_lineageos_official: false

oem_unlock_file_name: oem_unlock_FP5

install_e: install_e_FP5

can_rollback: false

removable_battery: 1

sim_slots: 2

region: All

maturity: green

install:

- { mode: Install doc }

- { mode: Murena smartphones }

- { mode: Roll-back, url: "https://support.fairphone.com/hc/en-us/articles/18896094650513" }

display_erecovery: false

install_e_file_name: install_e_FP5

ignore_troubleshooting_tips: true

requirements_file_name: requirements_FP5

verified_boot:

- {vendor: 'Any vendor', supported: 'yes'}

bootloader_relocking:

- {vendor: 'Any vendor', supported: 'yes'}

## 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="FP5 comes with an anti-rollback feature. Please read the paragraph marked `Caution` in Requirements section of this guide, before you proceed to install /e/OS on FP5." %}

1. Unzip the archive

    ```

    unzip <fileyoudownloaded>

    ```

   > In the command above, replace `<fileyoudownloaded>` with path of the downloaded archive.

   > Alternatively, you can unzip the archive using a File Manager/File Explorer.

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

1. Boot into bootloader/fastboot mode.

    - Power OFF the device.

    - Hold `Power` + `Volume Down` button combo simultaneously.

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

    - **Linux** 

        - Right click -> Open terminal here

    - **Windows**

        - Right click -> Git Bash here

    - Execute the following command:

        ```

        chmod +x flash_FP5_factory.sh && ./flash_FP5_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="FP5 comes with an anti-rollback feature. Please read the paragraph marked `Caution` in Requirements section of this guide, before you proceed to install /e/OS on FP5." %}

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>

## Unlocking the bootloader

{% include templates/unlock_bootloader.md %}

1. Boot the device

1. Enable and connect Wifi

1. Enable Developer options

1. From developer options, enable OEM unlock

    - Get the unlock code from [this site](https://www.fairphone.com/en/bootloader-unlocking-code-for-fairphone-3/) and enter it

1. Reboot on fastboot by running the command in the PC console `adb reboot bootloader`

   {% include alerts/tip.html content=" All the console commands are run on an adb enabled PC and in the `adb` console." %}

1. Ask for unlock with `fastboot flashing unlock`

1. Approve with <kbd>volume +</kbd> then <kbd>power</kbd>

    - The device proceed with a factory reset, and automatically reboots

1. Reboot again into bootloader

1. Unlock critical with `fastboot flashing unlock_critical`

1. Approve with <kbd>volume + </kbd> then <kbd>power</kbd>

    - The device proceeds with a factory reset, and automatically reboots

{% include templates/requirements.md %}

{% include alerts/danger.html content="The FP5 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 FP5 section below.

<br><br><strong>The following values control whether anti-rollback features are triggered on FP5:</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 FP5 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 FP5 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 FP5 runs Google Android -R while /e/OS is now available based on AOSP -S.

<br> * Your FP5 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>

" %}