Browse Source

Update README

main
Pekka Helenius 3 years ago
parent
commit
320a64dd59
1 changed files with 18 additions and 16 deletions
  1. +18
    -16
      README.md

+ 18
- 16
README.md View File

@ -23,47 +23,47 @@ Follow [Lineage OS for Samsung S5 Neo guide](https://wiki.lineageos.org/devices/
- **DO NOT** install `recovery.img`. LineageOS Recovery is horrible, TWRP is great. Use TWRP. Thanks. If you mistakenly install `recovery.img` anyway, getting rid of it requires use of heimdall to flash back TWRP `recovery.img` (`heimdall flash --RECOVERY <twrp-recovery>.img`)
- Install only contents of LineageOS zip file `lineage-18.1-YYYYMMDD-UNOFFICIAL-s5neolte.zip` using TWRP
- I use `ccache` with setting `10G`
- You may already have `repo` command pre-installed on your system
- Use command `repo init -u https://github.com/LineageOS/android.git -b lineage-18.1`
- `./extract-files.sh` commands relative to LineageOS source dir:
- `device/samsung/universal7580-common/extract-files.sh`
- `device/samsung/s5neolte/extract-files.sh`
- Both must be executed
- In order to `./extract-files.sh` commands fully succeed, you must have Samsung Android `6.0.1` preinstalled on your phone. Otherwise you get errors for missing files.
## LineageOS requirements for s5neolte
- If you have original Samsung Android OS installed, it must be version `6.0.1`. LineageOS installation on phones using older Android versions (`5.1.1`, etc.) simply fails.
- If you do not have Android `6.0.1` , get official Samsung update with [samloader](https://github.com/nlscc/samloader). Extract `zip` and `tar.md5` files, until you get all required `.img` and `.bin` files. Flash extracted `.bin` and `.img` files with [heimdall](https://github.com/Benjamin-Dobell/Heimdall)
- Samloader [Arch Linux PKGBUILD (AUR)](https://aur.archlinux.org/packages/samloader-git/)
- Take backup with TWRP before issuing `heimdall` commands
- Relevant files are as follows: `boot.img`, `system.img`, `userdata.img`, `cm.bin`, `param.bin`, `sboot.bin`, `modem.bin`, `cache.img`, `hidden.img`
- If you use custom recovery such as TWRP, **do not** flash `recovery.img`
- File `S5NEOLTE_<XXX>_OPEN.pit` is a partition definition file. You may extract one directly from your phone using `heimdall`, as well.
- You must patch heimdall to successfully flash your Samsung S5 Neo phone. Compile heimdall, and apply patch file [misc/heimdall/patch_filepartindex.patch](misc/heimdall/patch_filepartindex.patch). See [this GitHub issue](https://github.com/Benjamin-Dobell/Heimdall/issues/347) for details.
- Heimdall source code: [GitHub - alexax66/Heimdall](https://github.com/alexax66/Heimdall)
- Heimdall [Arch Linux PKGBUILD](https://github.com/archlinux/svntogit-community/tree/packages/heimdall/trunk)
- Heimdall [Arch Linux PKGBUILD](https://github.com/archlinux/svntogit-community/tree/packages/heimdall/trunk)
- Heimdall usage and command explanations: [SAMMobile - [Firmware]Restoring Stock Firmware with Heimdall](https://www.sammobile.com/forum/threads/45894-Restoring-Stock-Firmware-with-Heimdall)
- Heimdall flash command for Samsung S5 Neo: `heimdall flash --BOOT boot.img --SYSTEM system.img --USERDATA userdata.img --CM cm.bin --PARAM param.bin --BOOTLOADER sboot.bin --RADIO modem.bin --CACHE cache.img --HIDDEN hidden.img`
## Additional tips
@ -71,3 +71,5 @@ Follow [Lineage OS for Samsung S5 Neo guide](https://wiki.lineageos.org/devices/
- You may build parts of LineageOS using `mm` and `mmm` commands after sourcing `build/envsetup.sh`
- This is useful for partial patches
- For instance, building only `Dialer` APK, run `mmm packages/apps/Dialer` in lineage source root dir

Loading…
Cancel
Save