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

Commit 326b8ff9 authored by Romain Hunault's avatar Romain Hunault 💻
Browse files

Merge branch '1085-fp6-installation-guide-latest' into 'master'

Resolve "FP6 Installation guide"

Closes #1085

See merge request e/documentation/user!1296
parents 329afb0b e3b668a3
Loading
Loading
Loading
Loading
+76 −0
Original line number Diff line number Diff line
architecture: arm64
battery: {removable: True, capacity: 4415, tech: 'Li-Ion'}
bluetooth: {spec: 5.4 + LE aptX HD aptX Adaptive,  profiles: [A2DP]}
cameras:
- {flash: 'Dual-LED (dual-tone)', info: '50MP f/1.6 (Rear Wide)'}
- {flash: 'Dual-LED (dual-tone)', info: '13MP f/2.2 (Rear Ultra Wide)'}
- {info: '32MP f/2.0 (Front Wide)'}
codename: FP6
cpu: Octa-core (1x2.5 GHz Cortex-A720 & 3x2.4 GHz Cortex-A720 & 4x1.8 GHz Cortex-A520)
cpu_cores: '8'
cpu_freq:
current_branch: A15
depth: 9.6 mm (0.38 in)
download_boot: devices.hold_volume_down_power
gpu: Qualcomm Adreno 710 (940 MHz)
height: 156.5 mm (6.16 in)
image: FP6.png
maintainers: []
name: The Fairphone (Gen. 6)
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/17/20/25/26/28/32/38/40/41/42/48/66/71' }
- {tech: 5G, bands: 'n1/n2/n3/n5/n7/n8/n20/n28/n38/n40/n41/n66/n71/n77/n78'}
- {tech: VoLTE + VoWiFi (depending on local network)}
available_in_murena_store: true
murena_store_url: https://murena.com/shop/smartphones/brand-new/murena-fairphone-6/
peripherals: [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.recovery_boot_using_volume_keys
release: 2025
screen: 6.31 in
screen_ppi: 432
screen_res: 1116x2484
screen_tech: P-OLED LTPO
screen_refresh_rate: 
security_patch_date: 2025-06-05 
security_patch_date_dev: 2025-06-05 
sdcard: Upto 256 GB microSDXC (dedicated slot)
soc: Qualcomm Snapdragon 7s Gen 3
storage: 256 GB
type: phone
community_doc_url: https://community.e.foundation/t/fairphone-fp6-fp6-documentation-suggestions/71179
uses_twrp: false
vendor: Fairphone
vendor_short: fairphone
width: 73.3 mm (2.89 in)
wifi: 802.11 a/b/g/n/ac/6e + tri-band + WiFi Direct
build_version_dev: A15
build_version_stable: A15
should_be_latest_version: false
oem_unlock_code_required: https://www.fairphone.com/en/bootloader-unlocking-code-for-fairphone
is_ab_device: true
is_lineageos_official: false
oem_unlock_file_name: oem_unlock_FP6
install_e: install_e_FP6
can_rollback: false
removable_battery: 1
sim_slots: 2
region: All
maturity: green
install:
- { mode: /e/OS Installer }
- { mode: Official install doc }
- { mode: Murena smartphones }
- { mode: Roll-back, url: "https://support.fairphone.com/hc/en-us/articles/18896094650513-Installing-Fairphone-OS-Manually" }
display_erecovery: false
install_e_file_name: install_e_FP6
ignore_troubleshooting_tips: true
requirements_file_name: requirements_FP6
verified_boot:
- {vendor: 'Any vendor', supported: 'yes'}
bootloader_relocking:
- {vendor: 'Any vendor', supported: 'yes'}
safetynet:  1
rootbeer_pass:  1
+66 −0
Original line number Diff line number Diff line
## 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="FP6 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 FP6." %}

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_FP6_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).
   {% include alerts/tip.html content="Executing the `chmod` command may require root or `sudo` privileges."%}
    - Make sure you are in the current directory which contains the `flash_FP6_factory.sh` file.
    - **Linux** 
       - Right click -> Open terminal here
       - Execute the following command:
       
        ```
        chmod +x flash_FP6_factory.sh && ./flash_FP6_factory.sh
        ``` 

    - **Windows**
       - Right click -> Git Bash here
       - Execute the following command:
       
        ```
        chmod +x flash_FP6_factory.sh && ./flash_FP6_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/warning.html content="The bootloader is lockable in official builds only. The procedure to lock the bootloader will not work on community builds."%}

{% include alerts/danger.html content="FP6 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 FP6." %}

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>
+20 −0
Original line number Diff line number Diff line
## 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) 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
+46 −0
Original line number Diff line number Diff line
{% include templates/requirements.md %}

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

<br><br><strong>The following values control whether anti-rollback features are triggered on FP6:</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 FP6 with Google Android has a Security Patch Level saying June 5, 2025
<br> * The /e/OS build available says: /e/OS build : A15 official (Security patch: 2025-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 FP6 with Google Android has a Security Patch Level saying June 5, 2025.
<br> * The /e/OS build available says: /e/OS build : A15 official (Security patch: 2025-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 FP6 runs Google Android -V while /e/OS is now available based on AOSP -U.
<br> * Your FP6 with Google Android has a Security Patch Level saying 2025-10-03 or October 3rd, 2025.
<br> * The /e/OS build available says: /e/OS build : A15 official (Security patch: 2025-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>



" %}