Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions docs/devices/supported-devices.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,7 @@ sidebar to jump to its devices. Device-specific guides are linked where availabl
| AYN Thor | SM8550 | ✅ Tested | — |
| AYN Thor Lite | SM8250 | ✅ Tested | — |
| AYN Odin 3 | SM8750 | ✅ Tested | — |
| AYN Odin 3 Portal | SM8750 | ✅ Tested | — |

## Retroid

Expand All @@ -39,6 +40,7 @@ sidebar to jump to its devices. Device-specific guides are linked where availabl
| Retroid Pocket Flip 2 | SM8250 | ✅ Tested | — |
| Retroid Pocket Mini | SM8250 | ⚪ Untested | — |
| Retroid Pocket Mini V2 | SM8250 | ✅ Tested | — |
| Retroid Pocket Duo | SM7750 | ✅ Tested | — |
| Retroid Pocket 6 | SM8550 | ✅ Tested | — |
| Retroid Pocket Nova | SM8550 | ✅ Tested | — |

Expand Down
9 changes: 4 additions & 5 deletions docs/getting-started/flashing-to-an-sd-card.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,13 +13,12 @@ Once it is running, you can optionally install it to internal storage so it boot

Common flashing tools include [Balena Etcher](https://www.balena.io/etcher/), [Raspberry Pi Imager](https://www.raspberrypi.com/software/), and [Win32 Disk Imager](https://sourceforge.net/projects/win32diskimager/). If you're skilled with the command line, `dd` works fine too.

3. Flash the ROCKNIX ABL for your device.
3. Flash OpenABL for your device.

- Insert the SD card, boot into Android, and copy the `rocknix_abl` folder to
- Insert the SD card, boot into Android, and copy the `openabl` folder to
the root of your internal storage.

- Identify your SoC from [Supported Devices](../devices/supported-devices.md) (`SM8250`, `SM8550`, `SM8650`, or
`SM8750`).
- Identify your SoC from [Supported Devices](../devices/supported-devices.md) (`SM7750`, `SM8250`, `SM8550`, `SM8650`, or `SM8750`).

!!! warning

Expand All @@ -40,7 +39,7 @@ Once it is running, you can optionally install it to internal storage so it boot
*Thanks Bob*{ .root-script-easter-egg }

- Choose the option to select a script, browse to your SoC's subfolder on
internal storage (for example, `rocknix_abl/SM8550`), and select
internal storage (for example, `openabl/SM8550`), and select
`backup_abl.sh`.

- Copy the backup (`abl_a.img` and `abl_b.img`, written into your SoC subfolder)
Expand Down
10 changes: 3 additions & 7 deletions docs/getting-started/install-to-internal-storage.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,18 +20,14 @@ When it finishes, **power off and remove the SD card.**

## Check Boot Source

To ensure your device boots from internal storage, enter the ROCKNIX ABL by holding **VOL-** as the device powers on.
To ensure your device boots from internal storage, enter OpenABL by holding **VOL-** as the device powers on.

Once in the ABL, look for the **Boot source** option and make sure it is set to **Internal**.

![ROCKNIX ABL - Boot Source](../assets/images/getting-started/abl-switch-boot-source.jpg){ width="300" }

If it says anything other than **Internal**, use **VOL-** and **VOL+** until the **Switch boot source** option is selected, then press the **POWER** button to toggle the boot source.
Once in the ABL, use use **VOL-** and **VOL+** to navigate the entrires, and **POWER** to change options. Ensure **Boot mode** is set to **Linux**, and **Boot source** is set to **Internal**.

## Recovering a Failed Installation

If an installation is interrupted, rerun Armada Installer from the SD card to finish it.

If the device will not boot the internal installation, enter the ROCKNIX ABL and change the **Boot source** to **SDCard** to attempt the installation from the SD card.
If the device will not boot the internal installation, enter OpenABL and change the **Boot source** to **SD Card** to attempt the installation from the SD card again.

If you want to restore the full Android user data partition, see [Uninstalling and Restoring Android](./uninstalling-and-restoring-android.md).
15 changes: 6 additions & 9 deletions docs/getting-started/uninstalling-and-restoring-android.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,20 +6,17 @@ To remove or reinstall an internal install, you can use the ROCKNIX ABL.

1. **Enter the bootloader.** Power off, then hold **VOL-** while powering on to enter the bootloader.

2. **Select Uninstall Option.** Use **VOL-** or **VOL+** to change options until **UNINSTALL CFW** is selected, then press the **POWER** button to bring up the uninstall confirmation screen.
2. **Select Uninstall CFW Option.** Use **VOL-** or **VOL+** to change options until **Uninstall CFW** is selected, then press the **POWER** button to bring up the uninstall confirmation prompt.

![ROCKNIX ABL - Select Uninstall Option](../assets/images/getting-started/abl-select-uninstall.jpg){ width="300" }

3. **Confirm CFW Uninstall.** Use **VOL-** or **VOL+** to change the option to **UNINSTALL CFW & EXPAND USERDATA**, then press the **POWER** button to start the process.

![ROCKNIX ABL - Confirm Uninstall](../assets/images/getting-started/abl-confirm-uninstall.jpg){ width="300" }
3. **Confirm CFW Uninstall.** Use **VOL-** or **VOL+** to change the option to **Uninstall**, then press the **POWER** button to start the process.

## Change Boot Mode

To switch the boot mode back to Android, you can use the ROCKNIX ABL.
To switch the boot mode back to Android, you can use OpenABL.

1. **Enter the bootloader.** Power off, then hold **VOL-** while powering on to enter the bootloader.

2. **Switch Boot Mode.** Use **VOL-** or **VOL+** to change options until **Switch boot mode** is selected, then press the **POWER** button to change options until the **Boot mode** says **Android**.
2. **Switch Boot Mode.** Use **VOL-** or **VOL+** to select the **Boot mode** option, then press the **POWER** button to change options until the **Boot mode** says **Android**.

![ROCKNIX ABL - Switch Boot Mode](../assets/images/getting-started/abl-switch-boot-mode.jpg){ width="300" }
3. **Restart the device** Navigate to either the **Start** or **Power off** option to complete the change.
4.
Loading