readme: minor changes

Signed-off-by: Cuynu <cuynu@proton.me>
This commit is contained in:
Cuynu 2025-11-12 00:43:10 +07:00
commit 5833234281

View file

@ -1,19 +1,46 @@
# PhoenixSuit CLI for Linux
This is a copy of PhoenixSuit tool downloaded from Allwinner developer page, it has no QT interface as old LiveSuit v3.06 does and only supports x86_64.
# Notice
I don't know where is it's source code, since it's downloaded from Allwinner developer page. Don't PM/DM me to ask for that.
# Usages
- Clone the repository with git clone first
* GitLab repository
```
git clone https://gitlab.com/cuynu/phoenixsuit-linux.git
cd phoenixsuit-linux
```
* Disroot repository
```
git clone https://git.disroot.org/cuynu/phoenixsuit-linux.git
cd phoenixsuit-linux
```
* Selfhost repository
```
git clone http://cuynutt.ddns.net/cuynu/phoenixsuit-linux.git
cd phoenixsuit-linux
```
- Run PhoenixSuit CLI
In order for this to works, you need to install `awusb` driver kernel module first. Scroll down for instructions.
```
sudo ./phoenixsuit {path to firmware image *.img}
```
# Known issues
- Newer firmware images format such as firmware of T95 Super with Android 10+ and super partition are unable to flash as it fail and can't handle when trying to verify `super` partition, idk why. PhoenixSuit on Windows are still able to handle this format somehow. (Android 9 or older firmware format should be fine!)
- Do not run phoenixsuit without arguments, as it will return with `Segmentation fault (core dumped)` error.
- Run without root permission will lead to Get Device stage error.
- Newer firmware images format such as firmware of T95 Super with Android 10+ and super partition are unable to flash as it fail and can't handle when trying to verify `super` partition, idk why. PhoenixSuit on Windows are still able to handle this format somehow. (Android 9 or older firmware format without `super` partition should be fine!)
- If you run PhoenixSuit without arguments, it will return with `Segmentation fault (core dumped)` error.
- Run without root permission will return with `Get Device stage` error.
# Kernel module installation to make sure device can be recognized
- If you using Debian or Fedora based distro, simply install *.deb or *.rpm on drivers folder. If you are using Arch/EndeavourOS or other distros, use following command to compile and install manually kernel module :
- If you using Debian or Fedora based distro, simply install *.deb or *.rpm on drivers folder. If you are using Arch/EndeavourOS or other distros, use following command to compile and install kernel driver module manually or install `sunxi-awusb-dkms` from AUR (don't forget to install `dkms` and also header for your kernel first) :
- GitLab repository
```
git clone https://gitlab.com/cuynu/phoenixsuit-linux.git
cd phoenixsuit-linux/drivers/awusb
@ -24,6 +51,29 @@ sudo modprobe awusb
cd ..
```
- Disroot repository
```
git clone https://git.disroot.org/cuynu/phoenixsuit-linux.git
cd phoenixsuit-linux/drivers/awusb
sudo make
sudo make install
sudo depmod -a
sudo modprobe awusb
cd ..
```
- Selfhost repository
```
git clone http://cuynutt.ddns.net/cuynu/phoenixsuit-linux.git
cd phoenixsuit-linux/drivers/awusb
sudo make
sudo make install
sudo depmod -a
sudo modprobe awusb
cd ..
```
# Example of good flash logs :
```