Just some mtk tool for exploitation, reading/writing flash and doing crazy stuff. For windows, you need to install the stock mtk port and the usbdk driver (see instructions below). For linux, a patched kernel is only needed when using old kamakiri (see Setup folder) (except for read/write flash).
Once the mtk script is running, boot into brom mode by powering off device, press and hold either vol up + power or vol down + power and connect the phone. Once detected by the tool, release the buttons.
- kamakiri [xyzz]
- linecode exploit [chimera]
- Chaosmaster
- All contributors
Download Re Live DVD V2 User: livedvd, Password:livedvd
sudo apt install python3 git libusb1.0
git clone https://github.com/bkerler/mtkclient
cd mtkclient
pip3 install -r requirements.txt
python3 setup.py build
python3 setup.py install
sudo usermod -a -G plugdev $USER
sudo usermod -a -G dialout $USER
sudo cp Setup/Linux/*.rules /etc/udev/rules.d
sudo udevadm control -R
Make sure to reboot after adding the user to dialout/plugdev.
- Install python 3.9 and git
- If you install python from microsoft store, "python setup.py install" will fail, but that step isn't required.
- WIN+R
cmd
git clone https://github.com/bkerler/mtkclient
cd mtkclient
pip3 install -r requirements.txt
- Install normal MTK Serial Port driver (or use default Windows COM Port one, make sure no exclamation is seen)
- Get usbdk installer (.msi) from here and install it
- Test on device connect using "UsbDkController -n" if you see a device with 0x0E8D 0x0003
- Works fine under Windows 10 and 11 :D
- For linux (kamakiri attack), you need to recompile your linux kernel using this kernel patch :
sudo apt-get install build-essential libncurses-dev bison flex libssl-dev libelf-dev libdw-dev
git clone https://git.kernel.org/pub/scm/devel/pahole/pahole.git
cd pahole && mkdir build && cd build && cmake .. && make && sudo make install
sudo mv /usr/local/libdwarves* /usr/local/lib/ && sudo ldconfig
wget https://cdn.kernel.org/pub/linux/kernel/v5.x/linux-`uname -r`.tar.xz
tar xvf linux-`uname -r`.tar.xz
cd linux-`uname -r`
patch -p1 < ../Setup/kernelpatches/disable-usb-checks-5.10.patch
cp -v /boot/config-$(uname -r) .config
make menuconfig
make
sudo make modules_install
sudo make install
- These aren't needed for current ubuntu (as make install will do, just for reference):
sudo update-initramfs -c -k `uname -r`
sudo update-grub
See Setup/kernels for ready-to-use kernel setups
- Reboot
sudo reboot
- Dump boot and vbmeta
python mtk r boot,vbmeta boot.img,vbmeta.img
- Reboot the phone
python mtk reset
-
Download patched magisk for mtk: Download (here)[https://raw.githubusercontent.com/vvb2060/magisk_files/44ca9ed38c29e22fa276698f6c03bc1168df2c10/app-release.apk]
-
Install on target phone
- you need to enable usb-debugging via Settings/About phone/Version, Tap 7x on build number
- Go to Settings/Additional settings/Developer options, enable "OEM unlock" and "USB Debugging"
- Install magisk apk
adb install app-release.apk
- accept auth rsa request on mobile screen of course to allow adb connection
- Upload boot to /sdcard/Download
adb push boot.img /sdcard/Download
- Start magisk, tap on Install, select boot.img from /sdcard/Download, then:
adb pull /sdcard/Download/[displayed magisk patched boot filename here]
mv [displayed magisk patched boot filename here] boot.patched
-
Do the steps needed in section "Unlock bootloader below"
-
Flash magisk-patched boot and empty vbmeta
python mtk w boot,vbmeta boot.patched,vbmeta.img.empty
- Reboot the phone
python mtk reset
- Disconnect usb cable and enjoy your rooted phone :)
- Erase metadata and userdata (and md_udt if existing):
python mtk e metadata, userdata
- Unlock bootloader:
python mtk xflash seccfg unlock
for relocking use:
python mtk xflash seccfg lock
- Reboot the phone:
python mtk reset
and disconnect usb cable to let the phone reboot.
If you are getting a dm-verity error on Android 11, just press the power button, then the device should boot and show a yellow warning about unlocked bootloader and then the device should boot within 5 seconds.
Dump boot partition to filename boot.bin via preloader
python mtk r boot boot.bin
Dump boot partition to filename boot.bin via bootrom
python mtk r boot boot.bin [--preloader=Loader/Preloader/your_device_preloader.bin]
Read full flash to filename flash.bin (use --preloader for brom)
python mtk rf flash.bin
Dump all partitions to directory "out". (use --preloader for brom)
python mtk rl out
Show gpt (use --preloader for brom)
python mtk printgpt
(use --preloader for brom)
Write filename boot.bin to boot partition
python mtk w boot boot.bin
Write filename flash.bin as full flash (currently only works in da mode)
python mtk wf flash.bin
Write all files in directory "out" to the flash partitions
python mtk wl out
Erase boot partition
python mtk e boot
Erase boot sectors
python mtk es boot [sector count]
Peek memory
python mtk xflash peek [addr in hex] [length in hex] [optional: -filename filename.bin for reading to file]
Poke memory
python mtk xflash peek [addr in hex] [data as hexstring or -filename for reading from file]
Read rpmb
python mtk xflash rpmb r [will read to rpmb.bin]
Write rpmb [Dangerous and may not work as it's not tested !]
python mtk xflash rpmb w filename
Generate and display rpmb1-3 key
python mtk xflash generatekeys
Unlock / Lock bootloader
python mtk xflash seccfg [lock or unlock]
python mtk payload
If you want to use SP Flash tool afterwards, make sure you select "UART" in the settings, not "USB".
- Device has to be in bootrom mode and preloader has to be intact on the device
python mtk dumppreloader [--ptype=["amonet","kamakiri","kamakiri2","hashimoto"]] [--filename=preloader.bin]
- Device has to be in bootrom mode, or da mode has to be crashed to enter damode
- if no option is given, either kamakiri or da will be used (da for insecure targets)
- if "kamakiri" is used as an option, kamakiri is enforced
- Valid options are : "kamakiri" (via usb_ctrl_handler attack), "amonet" (via gcpu) and "hashimoto" (via cqdma)
python mtk dumpbrom --ptype=["amonet","kamakiri","hashimoto"] [--filename=brom.bin]
For to dump unknown bootroms, use brute option :
python mtk brute
If it's successful, please add an issue over here and append the bootrom in order to add full support.
python mtk crash [--vid=vid] [--pid=pid] [--interface=interface]
- Boot in Brom or crash to Brom
python mtk peek [addr] [length] --preloader=patched_preloader.bin
python mtk payload --payload=payload.bin [--var1=var1] [--wdt=wdt] [--uartaddr=addr] [--da_addr=addr] [--brom_addr=addr]
python mtk stage
python mtk plstage
- Boot in Brom or crash to Brom
python mtk plstage --preloader=preloader.bin
python stage2 reboot
python stage2 rpmb
python stage2 preloader
python stage2 memread [start addr] [length]
python stage2 memread [start addr] [length] --filename filename.bin
python stage2 memwrite [start addr] --data [data as hexstring]
python stage2 memwrite [start addr] --filename filename.bin
python stage2 keys --mode [sej, dxcc]
For dxcc, you need to use plstage instead of stage
- Run the mtk tool with --debugmode. Log will be written to log.txt (hopefully)
- Go to config/brom_config.py
- Unknown usb vid/pids for autodetection go to config/usb_ids.py