#  spreadtrum_flash

**Repository Path**: xjingiii/spreadtrum_flash

## Basic Information

- **Project Name**:  spreadtrum_flash
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-22
- **Last Updated**: 2026-07-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## Spreadtrum firmware dumper

使用官方SPRD U2S Diag驱动程序或LibUSB驱动程序。

### Windows预构建程序下载 [Release](https://github.com/TomKing062/spreadtrum_flash/releases)|[Dev](https://nightly.link/TomKing062/spreadtrum_flash/workflows/build/main)

### [原作者(ilyakurdyukov)版本的说明信息](https://github.com/ilyakurdyukov/spreadtrum_flash)

### 使用方法

```
spd_dump [选项] [指令] [退出指令]
```

#### 示例

**单行模式**

```
spd_dump --wait 300 fdl /path/to/fdl1 fdl1_addr fdl /path/to/fdl2 fdl2_addr exec path savepath r all reset
```

**交互模式**

```
spd_dump --wait 300 fdl /path/to/fdl1 fdl1_addr fdl /path/to/fdl2 fdl2_addr exec
```

成功后应提示 `FDL2>`

#### 选项

- `--wait <秒数>`

  指定等待设备连接的时间。

- `--stage <数字>|-r|--reconnect`

  尝试重新连接在brom/fdl1/fdl2阶段的设备。数字输入多少无所谓（甚至非数字也行）。

  处于brom/fdl1阶段的设备可以无限次重新连接，但在fdl2阶段只能重新连接一次

- `--verbose <等级>`

  设置屏幕日志的详细程度（支持0、1或2，不影响文件日志）。

- `--kick`

  使用 `boot_diag->cali_diag->dl_diag` 途径连接设备。
  
  boot_diag是在设备关机直接上电出现的u2s端口，其中cali_diag依赖原厂或少数经过定制的第三方recovery

- `--kickto <模式>`

  使用`boot_diag->custom_diag` 途径连接设备。支持的模式为0-127。
  
  (模式0为ums9621平台的新版`--kickto 2`, 模式 1 = cali_diag, 模式 2 = dl_diag; 并非所有设备都支持模式 2)


- `-h|--help|help`
  显示使用帮助。

#### 运行时命令

- `verbose level`

  设置屏幕日志的详细程度（支持0、1或2，不影响文件日志）。

- `timeout <毫秒>`

  设置读写等待的超时时间（毫秒）

- `baudrate [波特率]`(仅限Windows SPRD驱动程序和brom/fdl2阶段)

  支持的波特率为57600、115200、230400、460800、921600、1000000、2000000、3250000和4000000。

  在u-boot/littlekernel源代码中，只列出了115200、230400、460800和921600。


- `exec_addr [addr]`（仅限brom阶段）
  将 `customexec_no_verify_addr.bin` 发送到指定的内存地址，以绕过brom对 `splloader/fdl1` 的签名验证。

  用于CVE-2022-38694。


- `fdl FILE addr`

  将文件（`splloader`,`fdl1`,`fdl2`,`sml`,`trustos`,`teecfg`）发送到指定的内存地址。

- `loadexec FILE(addr_in_name)`

  以文件名中的地址作为exec_addr，同时在执行fdl1/spl时使用该文件作为exec_file。

- `loadfdl FILE(addr_in_name)`

  以文件名中的地址作为fdl的目标地址并发送该文件到内存。

- `exec`

  在fdl1阶段执行已发送的文件。通常与`sml`或`fdl2`（也称为uboot/lk）一起使用。

- `path [保存目录]`

  更改`r`,`read_part(s)`,`read_flash`和`read_mem`命令的保存目录。

- `nand_id [id]`

  指定nand芯片的4th id参数，该参数影响`read_part(s)`分区大小的算法，默认值为0x15。

- `rawdata {0,1,2}`（仅限fdl2阶段）
  rawdata协议用于加速`w`和`write_part`命令，当rawdata为1或2时，写入速度与blk_size无关（依赖于u-boot/lk，请勿手动修改）

- `blk_size byte`（仅限fdl2阶段）
  设置块大小，最大为65535字节。此选项用于加快`r`、`w`、`read_part(s)`和`write_part(s)`命令的速度。

- `r all|part_name|part_id`

  当分区表可用时：

    - `r all`: 全盘备份 (跳过 blackbox, cache, userdata)
    - `r all_lite`: 全盘备份（不包括非活动槽位, blackbox, cache和userdata）
    - NAND上all和all_lite不可用

  当分区表不可用时:

    - `r` 将自动计算分区大小（emmc/ufs和NAND均可）

- `read_part part_name|part_id offset size FILE`

  以给定的偏移量和大小将特定分区读取到文件中。

  （在nand上读取ubi）`read_part system 0 ubi40m system.bin`


- `read_parts partition_list_file`

  按照XML类型分区列表从设备读取分区（如果文件名以“ubi”开头，则将使用NAND ID计算大小）

- `w|write_part part_name|part_id FILE`

  将指定的文件写入分区。

- `write_parts save_location`

  写入指定文件夹下所有文件到设备分区，通常由`read_parts`得到。用`write_parts_a`或`write_parts_b`可以强制写入的槽位。

- `wof part_name offset FILE`

  把文件写入分区偏移位置。

- `wov part_name offset VALUE`

  把数值写入分区偏移位置（最大值为0xFFFFFFFF）。

- `e|erase_part part_name|part_id`

  擦除指定分区。

- `erase_all`

  擦除全部分区。

- `partition_list FILE`

  读取emmc/ufs上的分区列表，并非所有fdl2都支持此命令。

- `repartition partition_list_xml`

  根据XML类型分区列表重新分区。

- `p|print`

  打印分区列表。

- `size_part|part_size part_name`

  获取分区大小。

- `check_part part_name`

  检测分区是否存在。

- `verity {0,1}`

  在Android 10(+)上禁用或启用`dm-verity`。

- `set_active {a,b}`

  设置VAB设备上的活动槽位。

- `firstmode mode_id`

  设置重启后设备将进入的模式。

#### 退出指令

- `reboot-recovery`

  仅FDL2

- `reboot-fastboot`

  仅FDL2

- `reset`

  FDL2和新版FDL1

- `poweroff`

  FDL2和新版FDL1

### Android(Termux)

1. 安装[Termux-api](https://github.com/termux/termux-api/releases)并授权自启动

2. 安装依赖库和编译组件

```
pkg install termux-api libusb clang git
```

3. 拉取源代码

```
git clone https://github.com/TomKing062/spreadtrum_flash.git
cd spreadtrum_flash
```

4. 编译

```
make
```
生成可执行文件: spd_dump

5. 搜索OTG设备

```
termux-usb -l
[
"/dev/bus/usb/xxx/xxx"
]
```

6. 授权OTG设备(如果可用)

```
termux-usb -r /dev/bus/usb/xxx/xxx
```
允许访问目标设备

7. 运行 SPD_SUMP

```
termux-usb -e './spd_dump --usb-fd' /dev/bus/usb/xxx/xxx
```