From 204fd595b3e8d203ed8dc2b11529967336965800 Mon Sep 17 00:00:00 2001 From: Luxferre <3335173-suborg@users.noreply.gitlab.com> Date: Tue, 21 Dec 2021 16:33:33 +0200 Subject: [PATCH] Described adding your own targets --- README.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index c6b2f5f..cead0a7 100644 --- a/README.md +++ b/README.md @@ -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.