Skip to content

Commit

Permalink
Update README
Browse files Browse the repository at this point in the history
  • Loading branch information
patrislav1 committed Oct 24, 2023
1 parent 3525e09 commit 9c2bb05
Showing 1 changed file with 18 additions and 2 deletions.
20 changes: 18 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# unisoc-unlock

This is a tool to unlock a Unisoc / Spreadtrum (SPD) Android bootloader using its Identifier Token.
This is a tool to lock/unlock a Unisoc / Spreadtrum (SPD) Android bootloader using its Identifier Token.

It is a port of a WebUSB based tool [1] to Python. The WebUSB based tool does not work on Linux for some reason.
There is also a custom fastboot binary in circulation [2] which implements a custom command for unlocking the bootloader.
Expand All @@ -20,14 +20,30 @@ pip3 install unisoc-unlock

## Usage

```
usage: unisoc_unlock [-h] [--version] [command]
Lock/Unlock tool for Spreadtrum/Unisoc bootloader
positional arguments:
command Command (lock|unlock), default=unlock
options:
-h, --help show this help message and exit
--version show program's version number and exit
```

* Reboot device into fastboot mode
```
adb reboot bootloader
```

* Wait for 'fastboot mode' to show up on the device screen

* Run the python script
```
python3 -m unisoc_unlock
python3 -m unisoc_unlock unlock # To unlock the bootloader
python3 -m unisoc_unlock lock # To re-lock the bootloader
```

* Confirm unlocking on the device
Expand Down

0 comments on commit 9c2bb05

Please sign in to comment.