Refactor Samsung devices install guide

Signed-off-by: BlackMesa123 <giangrecosalvo9@gmail.com>

docs/install.md

@@ -20,7 +20,7 @@ The result of **Ramdisk** determines whether your device has ramdisk in the boot
 
 > _(Unfortunately, there are exceptions as some devices' bootloader accepts ramdisk even if it shouldn't. In this case, you will have to follow the instructions as if your device's boot partition **does** include ramdisk. There is no way to detect this, so the only way to know for sure is to actually try. Fortunately, as far as we know, only some Xiaomi devices are known to have this property, so most people can simply ignore this piece of information.)_
 
-If you are using a Samsung device that is launched with Android 9.0 or higher, you can now jump to [its own section](#samsung-system-as-root).
+If you are using a Samsung device, you can now jump to [its own section](#samsung-devices).
 
 If your device has boot ramdisk, get a copy of the `boot.img` (or `init_boot.img` if exists).<br>
 If your device does **NOT** have boot ramdisk, get a copy of the `recovery.img`.<br>
@@ -80,30 +80,51 @@ As a summary, after installing Magisk in recovery **(starting from power off)**:
 
 (Note: You **CANNOT** use custom recoveries to install or upgrade Magisk in this case!!)
 
-## Samsung (System-as-root)
+## Samsung Devices
 
-> If your Samsung device is NOT launched with Android 9.0 or higher, you are reading the wrong section.
+Before proceeding, please acknowledge that:
 
-### Before Installing Magisk
+- Installing Magisk **WILL** trip your Knox Warranty Bit, this action is not reversible in any way.
+- Installing Magisk for the first time **REQUIRES** a full data wipe (this is **NOT** counting the data wipe when unlocking bootloader). Please make a backup your data.
 
-- Installing Magisk **WILL** trip KNOX
+### Flashing Tools
-- Installing Magisk for the first time **REQUIRES** a full data wipe (this is **NOT** counting the data wipe when unlocking bootloader). Backup your data before continue.
-- Download Odin (for Windows) or [Heimdall](https://www.glassechidna.com.au/heimdall/) (for Linux) that supports your device.
 
-### Unlocking Bootloader
+- [Samsung Odin3](https://dl2018.sammobile.com/Odin.zip) (Windows only) (requires [Samsung USB Drivers](https://developer.samsung.com/android-usb-driver))
+- [Samsung Odin4](https://forum.xda-developers.com/t/official-samsung-odin-v4-1-2-1-dc05e3ea-for-linux.4453423/) (Linux only)
+- [Heimdall](https://www.glassechidna.com.au/heimdall/) (or [Grimler's fork](https://git.sr.ht/~grimler/Heimdall))
 
-Unlocking the bootloader on modern Samsung devices have some caveats. The newly introduced `VaultKeeper` service will make the bootloader reject any unofficial partitions in some circumstances.
+### Requirements
+
+To verify whether or not Magisk can be installed in your Samsung device, you first must check the OEM Lock and KnoxGuard (RMM) status, to do so boot your device in Download mode with its key combo.
+
+Possible OEM Lock values are the following:
+- **ON (L)**: fully locked.
+- **ON (U)**: bootloader locked, OEM unlocking enabled.
+- **OFF (U)**: fully unlocked.
+
+To unlock your bootloader, follow the instructions below. If no OEM Lock value is shown in Download mode, your device is probably not unlockable due to market limitations (USA/Canada devices).
+
+Possible KnoxGuard values are the following:
+
+- `Active`, `Locked`: your device has been remotely locked by your telecom operator or your insurance company.
+- `Prenormal`: your device is temporarely locked, reaching 168h of uptime should trigger unlock.
+- `Checking`, `Completed`, `Broken`: your device is unlocked.
+
+Having KnoxGuard active will prevent you from installing/running Magisk regardless of your bootloader lock state.
+
+### Unlocking the bootloader
 
 - Allow bootloader unlocking in **Developer options → OEM unlocking**
 - Reboot to download mode: power off your device and press the download mode key combo for your device
 - Long press volume up to unlock the bootloader. **This will wipe your data and automatically reboot.**
-- Go through the initial setup. Skip through all the steps since data will be wiped again in later steps. **Connect the device to Internet during the setup.**
-- Enable developer options, and **confirm that the OEM unlocking option exists and is grayed out.** This means the `VaultKeeper` service has unleashed the bootloader.
-- Your bootloader now accepts unofficial images in download mode
 
 ### Instructions
 
-- Use either [samfirm.js](https://github.com/jesec/samfirm.js), [Frija](https://forum.xda-developers.com/s10-plus/how-to/tool-frija-samsung-firmware-downloader-t3910594), or [Samloader](https://forum.xda-developers.com/s10-plus/how-to/tool-samloader-samfirm-frija-replacement-t4105929) to download the latest firmware zip of your device directly from Samsung servers.
+- Download the latest firmware package for your device, you can use one of the tools below to download it directly from Samsung servers:
+  - [SamFirm.NET](https://github.com/jesec/SamFirm.NET), [samfirm.js](https://github.com/jesec/samfirm.js)
+  - [Frija](https://forum.xda-developers.com/s10-plus/how-to/tool-frija-samsung-firmware-downloader-t3910594)
+  - [Samloader](https://forum.xda-developers.com/s10-plus/how-to/tool-samloader-samfirm-frija-replacement-t4105929)
+  - [Bifrost](https://forum.xda-developers.com/t/tool-samsung-samsung-firmware-downloader.4240719/)
 - Unzip the firmware and copy the `AP` tar file to your device. It is normally named as `AP_[device_model_sw_ver].tar.md5`
 - Press the **Install** button in the Magisk card
 - If your device does **NOT** have boot ramdisk, check the **"Recovery Mode"** option
@@ -112,7 +133,7 @@ Unlocking the bootloader on modern Samsung devices have some caveats. The newly
   `adb pull /sdcard/Download/magisk_patched_[random_strings].tar`<br>
   **DO NOT USE MTP** as it is known to corrupt large files.
 - Reboot to download mode. Open Odin on your PC, and flash `magisk_patched.tar` as `AP`, together with `BL`, `CP`, and `CSC` (**NOT** `HOME_CSC` because we want to **wipe data**) from the original firmware.
-- Your device should reboot automatically once Odin finished flashing. Agree to do a factory reset if asked.
+- Your device should reboot automatically once Odin finished flashing. **Agree to do a factory reset if asked.**
 - If your device does **NOT** have boot ramdisk, reboot to recovery now to enable Magisk (reason stated in [Magisk in Recovery](#magisk-in-recovery)).
 - Install the Magisk app you've already downloaded and launch the app. It should show a dialog asking for additional setup.
 - Let the app do its job and automatically reboot the device. Voila!