Skip to content

Open Source Version of Allwinner PhoenixCard to Dump, Unpack, Flash Allwinner IMG Files on Linux

License

Notifications You must be signed in to change notification settings

YuzukiTsuru/OpenixCard

Repository files navigation

OpenixCard

Open Source Version of Allwinner PhoenixCard to Dump, Unpack, Flash Allwinner Linux IMG Files on Linux

forthebadge forthebadge forthebadge forthebadge

CMake

About Android IMG File Supporting

Android firmware will not support and will not adapt to support it in the future. Due to the large number of Android GKI, GMS, and GRF versions, it is impossible to cover all firmware versions, and Android firmware partitioning is very complex. There is no universal method to generate usable firmware, nor is there a fixed address to make it run. Even if it can be adapted, there will be situations where the functionality is unavailable like fastboot, GMS service and more. Finally, Android firmware modifications are often used to crack and modify firmware, and this project does not support such behavior

Usage

 _____             _     _____           _ 
|     |___ ___ ___|_|_ _|     |___ ___ _| |
|  |  | . | -_|   | |_'_|   --| .'|  _| . |
|_____|  _|___|_|_|_|_,_|_____|__,|_| |___|
      |_| 
Copyright (c) 2022, YuzukiTsuru <[email protected]>

Usage: OpenixCard [options] input 

Positional arguments:
input           Input image file or directory path [required]

Optional arguments:
-h --help       shows help message and exits [default: false]
-v --version    prints version information and exits [default: false]
-u --unpack     Unpack Allwinner Image to folder [default: false]
-d --dump       Convert Allwinner image to regular image [default: false]
-c --cfg        Get Allwinner image partition table cfg file (use together with unpack) [default: false]
-p --pack       pack dumped Allwinner image to regular image from folder (needs cfg file) [default: false]
-s --size       Get the accurate size of Allwinner image [default: false]

eg.:
OpenixCard -u  <img>   - Unpack Allwinner image to target
OpenixCard -uc <img>   - Unpack Allwinner image to target and generate Allwinner image partition table cfg
OpenixCard -d  <img>   - Convert Allwinner image to regular image
OpenixCard -p  <dir>   - pack dumped Allwinner image to regular image from folder
OpenixCard -s  <img>   - Get the accurate size of Allwinner image

Download

ArchLinux

OpenixCard Now available at AUR #3

yay -S openixcard

Other Linux

You can find the new release file:
https://github.com/YuzukiTsuru/OpenixCard/releases

Build from source

# Download the source code
git clone --recursive --depth 1 https://github.com/YuzukiTsuru/OpenixCard

# Download the depends
sudo apt install cmake build-essential automake autoconf libconfuse-dev pkg-config

# Make build directory
mkdir build
cd build

# Make
cmake .. && make -j

Note: Ubuntu 20.04 compilation will report an error, This is caused by the bug of ar, you can compile and install the new version.

sudo apt-get install texinfo

wget https://ftp.gnu.org/gnu/binutils/binutils-2.38.tar.xz && \
  tar xvf binutils-2.38.tar.xz && \
  cd binutils-2.38 && \
  ./configure --prefix=/usr/local && \
  make
  
sudo make install

LICENSE

GNU GENERAL PUBLIC LICENSE Version 2, June 1991
                       
Copyright (c) 2022, YuzukiTsuru <[email protected]>

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License version 2 as
published by the Free Software Foundation.

See README and LICENSE for more details.