Updated README

This commit is contained in:
Luxferre
2021-12-18 14:28:09 +02:00
parent 7136c7797c
commit 6ecf36f90c
+10 -2
View File
@@ -1,5 +1,13 @@
# UniDump: an opensource Unisoc/Spreadtrum phone flash reader # UniDump: an opensource Unisoc/Spreadtrum phone flash reader
## About
Cross-platform MediaTek feature phone dumping had been achieved long ago with [MTreader](https://gitlab.com/suborg/mtreader). Now it's time to do the same for Unisoc (ex-Spreadtrum) phones.
Unfortunately, the architecture of Unisoc chipset boot ROM doesn't allow us to get away without any loader blobs. So, some FDL binaries are also shipped in this repo.
The `unidump.py` is the main file to use. The `unicmd.py` is the library created for easier command interface encapsulation.
## Dependencies ## Dependencies
Python 3.8+ and PyUSB. Python 3.8+ and PyUSB.
@@ -20,13 +28,13 @@ For SC6531F or SC6531M where firmware can be larger, you need to pass in the len
E.g. for CAT B26 (bootkey is `#`): `python unidump.py -l 0x6b7000 b26.bin` E.g. for CAT B26 (bootkey is `#`): `python unidump.py -l 0x6b7000 b26.bin`
### UMS9117/UMS9117L (NOT SUPPORTED YET) ### ~~UMS9117/UMS9117L~~ (NOT SUPPORTED YET)
For these 4G chipsets you need to use your own FDLs (although you **may** try the ones shipped with UniDump) and the following addresses: 0x6200 for FDL1, 0x80100000 for FDL2. For these 4G chipsets you need to use your own FDLs (although you **may** try the ones shipped with UniDump) and the following addresses: 0x6200 for FDL1, 0x80100000 for FDL2.
E.g. for Nokia 225 4G (if you're in the UniDump directory): `python unidump.py -fdl1 fdls/ums9117/fdl1.bin -addr1 0x6200 -fdl2 fdls/ums9117/fdl2.bin -addr2 0x80100000 225.bin` E.g. for Nokia 225 4G (if you're in the UniDump directory): `python unidump.py -fdl1 fdls/ums9117/fdl1.bin -addr1 0x6200 -fdl2 fdls/ums9117/fdl2.bin -addr2 0x80100000 225.bin`
### SC7701/SC7702/SC7703 (NOT SUPPORTED YET) ### ~~SC7701/SC7702/SC7703~~ (NOT SUPPORTED YET)
First, for these 3G chipsets you need to use your own FDLs (although you **may** try the ones shipped with UniDump) and the following addresses: 0x40000000 for FDL1, 0x0 for FDL2. First, for these 3G chipsets you need to use your own FDLs (although you **may** try the ones shipped with UniDump) and the following addresses: 0x40000000 for FDL1, 0x0 for FDL2.