Quick Start

SHIRUI CAO2023/08/16

We are providing custom ROMs for you to quickly enjoy the benefit brought by PowerPhone.

INFO

This page serves as a general introduction about the process. You should follow the model-specific instructions on the navigation bar whenever possible.

1. Supported Smartphones

Make sure you have one of the following smartphones:

BrandModelCodename
MotorolaEdge (2020)racer
XiaomiRedmi Note 9 Projoyeuse
SamsungGalaxy S9+ (Snapdragon version)star2qltechn
SamsungGalaxy S10 (Exynos version)beyond1lte

(Results shown in the paper are mostly done using racer.)

If you don't have above-mentioned smartphones, please check Smartphones Model Info to see if you can access smartphones that are similar to above-mentioned and are possible compatible to our published system images.

Or you can reconfigure a smartphone from scratch.

WARNING

Check Smartphones Model Info carefully before purchasing a smartphones. Depends on the country / region, the same smartphone may be advertised as a completely different model name, and the same model name may represent a different smartphone.

2. Tooling

You will need to install Android SDK Platform-Toolsopen in new window to access the command-line utilities we're going to use such as adb and fastboot. After downloading, unzip it to your desired location, and add it to your environment variable $PATH.

Samsung does not implement fastboot, therefore you will need Odinopen in new window (Windows GUI) or Heimdall suiteopen in new window(Multi-platform CLI)

3. Unlock Bootloader

On factory-setting, the bootloader of the Android smartphones is locked, meaning it can only flash signed images from the manufacturer. We need to unlock it before applying our systems. In general, by Googleing "PHONE_MODEL unlock bootloader" should lead you to tutorials of this producers. Helpful links:

Note that bootloader locks are different from the carrier locksopen in new window, though normally you will need to unlock carrier locks before unlocking bootloader.

WARNING

You will lost all data after unlocking. A smartphone with a unlocked bootloader is extremely vulnerable. Never do this on your personal daily-used smartphone.

INFO

Samsung officials do not support unlocking Qualcomm Snapdragon devices sold in North America region. The only way to unlock such devices is exploiting security vulnerabilities or buying unlocking services from grey market. Samsung smartphones with Snapdragon SoC sold in Asia should be generally fine.

4. Flash Custom Custom Recovery Image

  1. Download custom recovery image from our Releaseopen in new window.
  2. Reboot smartphone to bootloader mode by running adb reboot bootloader.
  3. Flash custom recovery by fastboot flash recovery xxxxx.img. For Samsung smartphones, you'll need Odinopen in new window to do so.
  4. Reboot to recovery through fastboot reboot recovery. For Samsung smartphones, reboot to recovery through volume keys.

WARNING

If operate incorrectly, this step may brick your smartphone.

5. Flash Our System Image

  1. Download our system image (.zip) from our Releaseopen in new window.
  2. Reboot into custom recovery through fastboot reboot recovery if you are in bootloader mode, or through adb reboot recovery if you are in the Android system.
  3. In the custom recovery, find and enter "ADB Sideload" mode.
  4. On the computer, run adb sideload xxxx.zip to install our Android distribution.

6. Play & Record Audios

  1. Run adb root to get root privilege.
  2. Run adb shell to enter the shell of the smartphone.
  3. Create a playground working directory for yourself mkdir /data/tmp/.
  4. Explore scriptsopen in new window in our repo.
  5. Copy corresponding script to your working directory.
  6. Use our scripts to play and / or record audio from/to files.
  7. You can use adb pull and adb push commands to fetch / send files to the smartphone.
Last Updated 10/5/2023, 9:29:35 AM