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

Commit c66a804a authored by Rohit Sekhar's avatar Rohit Sekhar Committed by Jackeagle
Browse files

docs: Add SHIFTphone 8 (otter)

parent db651a9e
Loading
Loading
Loading
Loading
+85 −0
Original line number Diff line number Diff line
architecture: arm64
battery: { removable: True, capacity: 3820, tech: "Li-Ion" }
bluetooth: { spec: 5.2 + LE, profiles: [A2DP] }
cameras:
  - { flash: "Dual-LED (dual-tone)", info: "50MP (Rear Wide)" }
  - { flash: "Dual-LED (dual-tone)", info: "50MP (Rear Ultra Wide)" }
  - { info: "32MP (Front Wide)" }
channels:
codename: otter
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.8 mm (0.39 in)
download_boot: devices.hold_volume_up_power
gpu: Qualcomm Adreno 643
height: 164.2 mm (6.46 in)
image: otter.png
maintainers: []
name: SHIFTphone 8
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) }
available_in_murena_store: true
peripherals:
  [
    Compass,
    Accelerometer,
    Gyroscope,
    Fingerprint Scanner (In Display),
    Light sensor,
    Dual SIM (2 Physical),
    GPS,
    GLONASS,
    Proximity sensor,
    USB Type C,
  ]
ram: 12 GB
recovery_boot: devices.bootloader_to_recovery
release: 2024
screen: 6.67 in
screen_ppi: 402
screen_res: 1080x2400
screen_tech: OLED
screen_refresh_rate: 120
security_patch_date: 2024-10-05
security_patch_date_dev: 2024-10-05
sdcard: Upto 256 GB
soc: Qualcomm QCM6490
storage: 256/512 GB
type: phone
community_doc_url: https://community.e.foundation/t/fairphone-fp5-fp5-documentation-suggestions/53036
uses_twrp: false
vendor: SHIFT
vendor_short: shift
width: 78.7 mm (3.10 in)
wifi: 802.11 a/b/g/n/ac/6e + WiFi Direct
build_version_dev: U
build_version_stable: U
should_be_latest_version: false
is_ab_device: true
is_lineageos_official: true
oem_unlock_file_name: oem_unlock_otter
install_e: install_e_otter
can_rollback: false
removable_battery: 1
sim_slots: 2
region: All
maturity: green
install:
  - { mode: Official install doc }
  - { mode: Murena smartphones }
display_erecovery: false
install_e_file_name: install_e_otter
ignore_troubleshooting_tips: true
requirements_file_name: requirements_otter
verified_boot:
  - { vendor: "Any vendor", supported: "yes" }
bootloader_relocking:
  - { vendor: "Any vendor", supported: "yes" }
safetynet: 1
rootbeer_pass: 1
+63 −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="SHIFTphone 8 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 SHIFTphone 8." %}

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

1. Boot into bootloader/fastboot mode.

    - Power OFF the device.
    - Hold `Power` + `Volume Up` 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_otter_factory.sh` file.
    - **Linux** 
       - Right click -> Open terminal here
       - Execute the following command:

        ```
        chmod +x flash_otter_factory.sh && ./flash_otter_factory.sh
        ``` 

    - **Windows**
       - Right click -> Git Bash here
       - Execute the following command:
       
        ```
        chmod +x flash_otter_factory.sh && ./flash_otter_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="SHIFTphone 8 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 SHIFTphone 8." %}

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>
+17 −0
Original line number Diff line number Diff line
## Unlocking the bootloader

{% include templates/unlock_bootloader.md %}

1. Boot the device
1. Enable Developer options
1. From developer options, enable OEM unlock
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>
1. Unlock critical with `fastboot flashing unlock_critical`
1. Approve with <kbd>volume + </kbd>
1. Reboot the device `fastboot reboot`
    - The device proceeds with a factory reset
+46 −0
Original line number Diff line number Diff line
{% include templates/requirements.md %}

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

<br><br><strong>The following values control whether anti-rollback features are triggered on SHIFTphone 8:</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 SHIFTphone 8 with Google Android has a Security Patch Level saying June 5, 2022
<br> * The /e/OS build available says: /e/OS build : R official (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 SHIFTphone 8 with Google Android has a Security Patch Level saying June 5, 2022.
<br> * The /e/OS build available says: /e/OS build : R official (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 SHIFTphone 8 runs Google Android -R while /e/OS is now available based on AOSP -S.
<br> * Your SHIFTphone 8 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 official (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>



" %}
+136 KiB
Loading image diff...