From b3192165010d1727d72ff50f8183ce5af5d72c5c Mon Sep 17 00:00:00 2001 From: Michael Jerger Date: Fri, 14 Apr 2023 14:30:52 +0000 Subject: [PATCH] add FP4 installation procedure --- Guides/1. PrepareInstallation.md | 4 +- Guides/2. LineageOSInstallation.md | 99 +++++++++++++++++------------- 2 files changed, 58 insertions(+), 45 deletions(-) diff --git a/Guides/1. PrepareInstallation.md b/Guides/1. PrepareInstallation.md index 03169f0..e700b1f 100644 --- a/Guides/1. PrepareInstallation.md +++ b/Guides/1. PrepareInstallation.md @@ -1,4 +1,5 @@ # Prepare Installation + ## On your computer 1. Download and install adb & fastboot @@ -11,7 +12,8 @@ 1. For the [Fairphone 3](https://download.lineageos.org/FP3) 3. Generate unlockcode 1. In case of Fairphone 2, it is not necessary - 1. In case of Fairphone 3: + 1. In case of Fairphone 3 & 4: + - Connect your phone with your wifi active - Find IMEI number (Settings - About phone) - Find serial number (Settings - About phone - Model and Hardware) - enter [here](https://www.fairphone.com/en/bootloader-unlocking-code-for-fairphone-3/) and get your unlock code. diff --git a/Guides/2. LineageOSInstallation.md b/Guides/2. LineageOSInstallation.md index 61b9894..cac695d 100644 --- a/Guides/2. LineageOSInstallation.md +++ b/Guides/2. LineageOSInstallation.md @@ -1,18 +1,19 @@ # Install LineageOS on Fairphone -## 1. Check your prerequisites on your computer -[ ] adb and fastboot are installed on your computer? +## 1. Checklist before starting + +[ ] adb and fastboot are installed on the computer? [ ] you downloaded the bootimage (img) and LineageOS (zip)? [ ] you have the unlock code (in case of Fairphone 3)? [ ] you have an usb cable ready? -[ ] you have removed your screen lock? -[ ] your phone has at least 70% battery? -[ ] you are prepared to erase all the data on your Fairphone? - +[ ] you have removed your screen lock? +[ ] your phone has at least 70% battery? +[ ] you are prepared to erase all the data on your Fairphone? ## 2. Unlock your Fairphone Unlocking will allow us to overwrite the boot-loader. + 1. Navigate to "Settings - About phone" 1. Tap on “Build number” 7 times to enable developer mode 1. Navigate to "Settings - System – Advanced – Developer options" @@ -21,17 +22,17 @@ Unlocking will allow us to overwrite the boot-loader. 1. Navigate to "Settings - System – Advanced – Developer options" 1. Enable OEM unlocking with your unlock code - ## 3. Connect via usb For overwriting the boot-loader of your Fairphone, it needs to be connected to your pc. -1. Connect your computer & Fairphone via usb + +1. Connect your Fairphone to the computer via usb 1. On your Fairphone allow the usb connection -1. Type `adb devices` on your computer (for Windows users: open the terminal in the directory containing adb&fastboot.exe and use the `.\` prefix. The resulting command will be: `.\adb devices`). +1. Type `adb devices` on your terminal (for Windows users: open the terminal in the directory containing adb&fastboot.exe and use the `.\` prefix. The resulting command will be: `.\adb devices`). The result should show something like ``` List of devices attached - device + device ``` ## 4. Prepare recovery image installation @@ -39,60 +40,63 @@ For overwriting the boot-loader of your Fairphone, it needs to be connected to y The next step is critical. If something goes wrong here your Fairphone may remain broken. Time to do some checks: 1. Make sure your phone has at least 70% battery. -1. Reboot your Fairphone to bootloader mode: Type `adb reboot bootloader` on your computer. +1. Reboot your Fairphone to bootloader mode: Type `adb reboot bootloader` on the terminal. 1. Your Fairphone should show the bootloader screen. -1. Type `fastboot devices` on your computer. The result should show something like +1. Type `fastboot devices` on the terminal. The result should show something like ``` - fastboot + fastboot ``` -1. Check your downloaded recovery image - 1. In Windows type `Get-FileHash ` on your computer. - 1. in Linux type `sha256sum ` or alternatively `shasum -a 256 ` on your computer. +1. Check your downloaded recovery image + 1. In Windows type `Get-FileHash ` on the terminal. + 1. in Linux type `sha256sum ` or alternatively `shasum -a 256 ` on the terminal. 1. The result should look like ``` b6494278d0a399547a9344a6018a30b388f71a97ef52989bcdd661002f3a8631 lineage-18.1-20210906-recovery-FP3.img ``` -1. Now compare the number to the one given on the recovery image download page. Ensure you are browsing with "https". +1. Now compare the number to the one given on the recovery image download page. Ensure you are browsing with "https". [](img/sha256.png) 1. Be aware, in the next step all data will be erased on your Fairphone! ## 5. Install LinegaeOS recovery image -All checks passed? Then lets continues: -1. On your computer type `fastboot oem unlock`. +All checks passed? Then let's continue: + 1. If your Fairphone reboots, you might have to do the steps 2.1-2.4 again to re-enable USB debugging. Then `adb reboot bootloader` will bring you back. -1. Install fastboot image & reboot to recovery - 1. For Fairphone2 - 1. By typing on your computer `fastboot flash recovery ` ( is the img-file you have downloaded in 1.). - 1. For Fairphone3 - 1. By typing on your computer `fastboot flash boot ` ( is the img-file you have downloaded in 1.). +2. For Fairphone2 + 1. On the terminal type `fastboot flashing unlock`. + 2. Install fastboot image & reboot to recovery by typing on the terminal `fastboot flash recovery ` ( is the img-file you have downloaded in 1.). + 3. Reboot to recovery without starting your original rom: With the device powered off, hold Power + Volume Up. Release when boot logo appears. +3. For Fairphone3 + 1. On the terminal type `fastboot flashing unlock`. + 2. Install fastboot image & reboot to recovery by typing on the terminal `fastboot flash recovery ` ( is the img-file you have downloaded in 1.). - If you see something like "boot partition is smaller than boot image" you might find the solution [here](https://gitlab.com/domaindrivenarchitecture/lineageos-Fairphone/-/blob/main/Guides/InstallationFAQ.md). - 1. On the phone you should not see any difference and it should remain in the bootloader screen. Then hold Volume Up + Power. Release when boot logo appears. -1. Reboot to Recovery without starting your original rom - 1. in case of Fairphone2 - 1. With the device powered off, hold Power + Volume Up. Release when boot logo appears. - 1. in case of Fairphone3 + 3. On the phone you should not see any difference and it should remain in the bootloader screen. Then hold Volume Up + Power. Release when boot logo appears. + 4. Reboot to Recovery without starting your original rom: 1. Use your bootloader to restart [](img/start.jpg)[](img/recovery.jpg) - 1. Or use the button method, hold Volume Up + Power. Release when boot logo appears. - - -Please take care not to boot in to your old Android / FairphoneOS. If you missed the proper reboot into recovery by buttons you've to step back to step 1. because your old os reinstall its own recovery over the one just installed. + 2. Or use the button method, hold Volume Up + Power. Release when boot logo appears. +4. For Fairphone4 + 1. On the terminal type `fastboot flashing unlock`. + 2. Do the steps 2.1-2.4 again to re-enable USB debugging. Then `adb reboot bootloader` + 3. On the terminal type `fastboot flashing unlock_critical` + 4. Do the steps 2.1-2.4 again to re-enable USB debugging. Then `adb reboot bootloader` + 5. Install fastboot image & reboot to recovery by typing on the terminal `fastboot flash recovery ` ( is the img-file you have downloaded in 1.). +Please take care not to boot your old Android / FairphoneOS. If you missed the proper reboot to recovery by buttons you are back to step 1. because your old os reinstalls its own recovery over the one just installed. ## 6. Install LineageOS -This step is not very dangerous. You can retry as often you need to. +This step is not very dangerous. You can retry as often you need to. The LineageOs boot-loader will verify your binaries. If you are already in the recovery mode you can go to step 6.3. -1. Choose Factory Reset - Format Data/Factory Reset +1. Choose Factory Reset - Format Data/Factory Reset [](img/reset.jpg)[](img/format.jpg) 1. Return to main menu -1. Apply update - Apply from ADB +1. Apply update - Apply from ADB [](img/apply.jpg)[](img/sideload.jpg) -1. Type `adb sideload ` on your computer ( is the zip-file you have downloaded in 1.). +1. Type `adb sideload ` on the terminal ( is the zip-file you have downloaded in 1.). [](img/done.jpg) 1. Check whether you see the `Step 2/2` on the bottom of your Fairphone. @@ -101,6 +105,7 @@ If you are already in the recovery mode you can go to step 6.3. ### 6.1 Optional installation of google Apps If you really need the google Apps or the google Play Store there are packages with various scopes, you will find a package comparison here: [https://github.com/opengapps/opengapps/wiki/Package-Comparison](https://github.com/opengapps/opengapps/wiki/Package-Comparison). You have to install google Apps before the first start. + 1. Download your favored version from [here](https://opengapps.org/). 1. Install gapps the same way, you installed LineageOs: `adb sideload ` @@ -113,37 +118,43 @@ Then do steps 2.1 - 2.4 again to re-enable USB-debugging and boot again into fas OEM unlocking / locking will erase all data, so we should ensure to do the lock again now. -1. Type `fastboot devices` on your computer. The result should show something like +1. Type `fastboot devices` on the terminal. The result should show something like ``` - fastboot + fastboot ``` -1. On your computer type `fastboot oem lock` and enter. - +2. For Fairphone2 + 1. On the terminal type `fastboot flashing lock`. +3. For Fairphone3 + 1. On the terminal type `fastboot flashing lock`. +4. For Fairphone4 + 1. OEM lock ist not possible on FP4. You have to use your phone unlocked. ## 8. Start LineageOS The first start of your new LineageOS - hurray. -1. Walk through the initial setup. If you want to avoid tracking from start, you should + +1. Walk through the initial setup. If you want to avoid tracking from start, you should 1. execute Step 1 - 4 of [DegoogleLineageOS.md](3. DegoogleLineageOS.md) 2. activate your wifi - ## 9. Download the F-Droid App-Store For installing more software we recommend the F-Droid app store + 1. Use the browser on your Fairphone to download F-Droid: [https://www.f-droid.org/](https://www.f-droid.org/) 1. Visit the download-folder and install F-Droid (accept the warning). 1. Do no longer trust your browser for installing apps: Settings -> Apps -> Browser -> extended -> switch "Install from unknown source" off. 1. Now you can install Apps like DeltaChat, NextCloud, Fennec, Tusky, k9 (...) through the F-Droid Store. - ## 10. Enable Data-Encryption Your private data should stay safe in case of loosing your phone + 1. Settings -> Privacy -> Trust -> activate encryption (you have to choose at least a screen-lock-pin for this process). ## 11. Final steps Now your phone is ready for use + 1. Disable Development Options: Settings -> System -> Development Options. 1. insert your sim-card