Described adding your own targets

This commit is contained in:
Luxferre
2021-12-21 16:33:33 +02:00
parent 2215104d81
commit 204fd595b3
+11 -1
View File
@@ -40,7 +40,7 @@ If you want to, the targets are fully overridable with individual parameters, se
### SC6531E
This is the default target for UniFlash, FDLs for it are shipped in the repo and you don't need to configure anything (even `-t` parameter) else unless your model requires signed FDLs.
This is the default target for UniFlash, FDLs for it are shipped in the repo and you don't need to configure anything else (even `-t` parameter) unless your model requires signed FDLs.
For SC6531E, firmware is usually 4MB long, so you just need to run `python uniflash.py dump your-output-file.bin` to dump the firmware image and `python uniflash.py flash your-input-file.bin` to flash it.
@@ -62,6 +62,16 @@ SC6531C is a single-FDL variant. Here, if your model doesn't require signed FDLs
For now, SC6531DA and other variants of SC6531 chipset older than SC6531CA are not supported.
### Add your own targets
If you work with non-standard devices but don't find specifying individual FDL parameters every time convenient, you can always create your own target and refer to it via the `-t` parameter. It's pretty straightforward: you just need to collect FDL loader files for your device, rename them accordingly and place them into `fdls/` directory in the root of UniFlash project.
For two-FDL targets (more common scenario), the naming scheme is like this: `[targetname]_[load_addr_1]_fdl1.bin` and `[targetname]_[load_addr_2]_fdl2.bin`.
For single-FDL targets, the FDL file name must be `[targetname]_[load_addr]_single.bin`.
For example, if you have found signed FDL loaders for Nokia 105 2019 somewhere and want to add this phone as a target, you know that they are loaded into `0x40004000` and `0x14000000` respectively, so you can rename them, for instance, to `sc6531efm_nokia_0x40004000_fdl1.bin` and `sc6531efm_nokia_0x14000000_fdl2.bin`, place them into `fdls/` and then just use `-t sc6531efm_nokia` in your commands.
## Credits
Created by Luxferre in 2021. All files except the FDL blobs are public domain.