meissa/lineageos-fairphone
6
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Merge branch 'FP4' into 'main'

Browse source 
add FP4 installation procedure

See merge request domaindrivenarchitecture/lineageos-fairphone!3
This commit is contained in:
Michael Jerger 2023-04-14 14:30:52 +00:00
commit 9fe780334e
2 changed files with 58 additions and 45 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
Guides/1. PrepareInstallation.md
View file

@ -1,4 +1,5 @@
# Prepare Installation # Prepare Installation
## On your computer ## On your computer
1. Download and install adb & fastboot 1. Download and install adb & fastboot
@ -11,7 +12,8 @@
1. For the [Fairphone 3](https://download.lineageos.org/FP3) 1. For the [Fairphone 3](https://download.lineageos.org/FP3)
3. Generate unlockcode 3. Generate unlockcode
1. In case of Fairphone 2, it is not necessary 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 IMEI number (Settings - About phone)
- Find serial number (Settings - About phone - Model and Hardware) - 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. - enter [here](https://www.fairphone.com/en/bootloader-unlocking-code-for-fairphone-3/) and get your unlock code.

75
Guides/2. LineageOSInstallation.md
View file

@ -1,7 +1,8 @@
# Install LineageOS on Fairphone # Install LineageOS on Fairphone
## 1. Check your prerequisites on your computer ## 1. Checklist before starting
[ ] adb and fastboot are installed on your computer?
[ ] adb and fastboot are installed on the computer?
[ ] you downloaded the bootimage (img) and LineageOS (zip)? [ ] you downloaded the bootimage (img) and LineageOS (zip)?
[ ] you have the unlock code (in case of Fairphone 3)? [ ] you have the unlock code (in case of Fairphone 3)?
[ ] you have an usb cable ready? [ ] you have an usb cable ready?
@ -9,10 +10,10 @@
[ ] your phone has at least 70% battery? [ ] your phone has at least 70% battery?
[ ] you are prepared to erase all the data on your Fairphone? [ ] you are prepared to erase all the data on your Fairphone?
## 2. Unlock your Fairphone ## 2. Unlock your Fairphone
Unlocking will allow us to overwrite the boot-loader. Unlocking will allow us to overwrite the boot-loader.
1. Navigate to "Settings - About phone" 1. Navigate to "Settings - About phone"
1. Tap on “Build number” 7 times to enable developer mode 1. Tap on “Build number” 7 times to enable developer mode
1. Navigate to "Settings - System – Advanced – Developer options" 1. Navigate to "Settings - System – Advanced – Developer options"
@ -21,13 +22,13 @@ Unlocking will allow us to overwrite the boot-loader.
1. Navigate to "Settings - System – Advanced – Developer options" 1. Navigate to "Settings - System – Advanced – Developer options"
1. Enable OEM unlocking with your unlock code 1. Enable OEM unlocking with your unlock code
## 3. Connect via usb ## 3. Connect via usb
For overwriting the boot-loader of your Fairphone, it needs to be connected to your pc. 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. 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 The result should show something like
``` ```
List of devices attached List of devices attached
@ -39,15 +40,15 @@ 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: 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. 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. 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
``` ```
<SerialNumberOfYourPhone> fastboot <SerialNumberOfYourPhone> fastboot
``` ```
1. Check your downloaded recovery image 1. Check your downloaded recovery image
1. In Windows type `Get-FileHash <image_filename.img>` on your computer. 1. In Windows type `Get-FileHash <image_filename.img>` on the terminal.
1. in Linux type `sha256sum <image_filename.img>` or alternatively `shasum -a 256 <image_filename.img>` on your computer. 1. in Linux type `sha256sum <image_filename.img>` or alternatively `shasum -a 256 <image_filename.img>` on the terminal.
1. The result should look like 1. The result should look like
``` ```
b6494278d0a399547a9344a6018a30b388f71a97ef52989bcdd661002f3a8631 lineage-18.1-20210906-recovery-FP3.img b6494278d0a399547a9344a6018a30b388f71a97ef52989bcdd661002f3a8631 lineage-18.1-20210906-recovery-FP3.img
@ -59,27 +60,30 @@ The next step is critical. If something goes wrong here your Fairphone may remai
## 5. Install LinegaeOS recovery image ## 5. Install LinegaeOS recovery image
All checks passed? Then lets continues: All checks passed? Then let's continue:
1. On your computer type `fastboot oem unlock`.
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. 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 2. For Fairphone2
1. For Fairphone2 1. On the terminal type `fastboot flashing unlock`.
1. By typing on your computer `fastboot flash recovery <image_filename.img>` (<image_filename.img> is the img-file you have downloaded in 1.). 2. Install fastboot image & reboot to recovery by typing on the terminal `fastboot flash recovery <image_filename.img>` (<image_filename.img> is the img-file you have downloaded in 1.).
1. For Fairphone3 3. Reboot to recovery without starting your original rom: With the device powered off, hold Power + Volume Up. Release when boot logo appears.
1. By typing on your computer `fastboot flash boot <image_filename.img>` (<image_filename.img> is the img-file you have downloaded in 1.). 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 <image_filename.img>` (<image_filename.img> 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). - 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. 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.
1. Reboot to Recovery without starting your original rom 4. 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
1. Use your bootloader to restart 1. Use your bootloader to restart
[<img src="img/start.jpg" width="300" height="400">](img/start.jpg)[<img src="img/recovery.jpg" width="300" height="400">](img/recovery.jpg) [<img src="img/start.jpg" width="300" height="400">](img/start.jpg)[<img src="img/recovery.jpg" width="300" height="400">](img/recovery.jpg)
1. Or use the button method, hold Volume Up + Power. Release when boot logo appears. 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`.
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. 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 <image_filename.img>` (<image_filename.img> 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 ## 6. Install LineageOS
@ -92,7 +96,7 @@ If you are already in the recovery mode you can go to step 6.3.
1. Return to main menu 1. Return to main menu
1. Apply update - Apply from ADB 1. Apply update - Apply from ADB
[<img src="img/apply.jpg" width="300" height="400">](img/apply.jpg)[<img src="img/sideload.jpg" width="300" height="400">](img/sideload.jpg) [<img src="img/apply.jpg" width="300" height="400">](img/apply.jpg)[<img src="img/sideload.jpg" width="300" height="400">](img/sideload.jpg)
1. Type `adb sideload <lineagos.zip>` on your computer (<lineagos.zip> is the zip-file you have downloaded in 1.). 1. Type `adb sideload <lineagos.zip>` on the terminal (<lineagos.zip> is the zip-file you have downloaded in 1.).
[<img src="img/done.jpg" width="300" height="400">](img/done.jpg) [<img src="img/done.jpg" width="300" height="400">](img/done.jpg)
1. Check whether you see the `Step 2/2` on the bottom of your Fairphone. 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 ### 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. 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. Download your favored version from [here](https://opengapps.org/).
1. Install gapps the same way, you installed LineageOs: `adb sideload <gapps.zip>` 1. Install gapps the same way, you installed LineageOs: `adb sideload <gapps.zip>`
@ -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. 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
``` ```
<SerialNumberOfYourPhone> fastboot <SerialNumberOfYourPhone> 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 ## 8. Start LineageOS
The first start of your new LineageOS - hurray. 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) 1. execute Step 1 - 4 of [DegoogleLineageOS.md](3. DegoogleLineageOS.md)
2. activate your wifi 2. activate your wifi
## 9. Download the F-Droid App-Store ## 9. Download the F-Droid App-Store
For installing more software we recommend 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. 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. 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. 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. 1. Now you can install Apps like DeltaChat, NextCloud, Fennec, Tusky, k9 (...) through the F-Droid Store.
## 10. Enable Data-Encryption ## 10. Enable Data-Encryption
Your private data should stay safe in case of loosing your phone 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). 1. Settings -> Privacy -> Trust -> activate encryption (you have to choose at least a screen-lock-pin for this process).
## 11. Final steps ## 11. Final steps
Now your phone is ready for use Now your phone is ready for use
1. Disable Development Options: Settings -> System -> Development Options. 1. Disable Development Options: Settings -> System -> Development Options.
1. insert your sim-card 1. insert your sim-card