Skip to main content

unisoc-unlock

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. unisoc-unlock implements the same functionality, but without resorting to a custom fastboot binary. Since it is a pure Python solution it should be able to run on any platform running Python.

python-adb

unisoc-unlock is implemented with python-adb [3]. Since python-adb is abandoned and requires some tweaking to work with the Unisoc, it is not referenced as dependency, but bundled instead.

Installation

Install with pip:

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 unlock  # To unlock the bootloader
python3 -m unisoc_unlock lock    # To re-lock the bootloader
  • Confirm unlocking on the device

    Note: on the RG405M, the text on the device screen will ask for 'volume down' button to confirm unlock, but the home/back button has to be pressed instead!

References

[1] https://github.com/turtleletortue/turtleletortue.github.io

[2] https://www.hovatek.com/forum/thread-32287.html

[3] https://github.com/google/python-adb

Metadata

Release files for unisoc-unlock 0.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for unisoc-unlock 0.0.2
File Size Uploaded
unisoc_unlock-0.0.2.tar.gz 13.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for unisoc-unlock 0.0.2
File Interpreter ABI Platform
unisoc_unlock-0.0.2-py3-none-any.whl Python 3 none any Details

Total release size: 29.8 kB

Release files / unisoc_unlock-0.0.2.tar.gz

Download URL unisoc_unlock-0.0.2.tar.gz
Size 13.6 kB
Tags Source
SHA-256 checksum
How to use checksums
be2e02e395e8fe6586e7f645033d8475168785e52c46ddfba79a63fd1e6b7c11
BLAKE2b-256 checksum
How to use checksums
90c9b7e23d3e1930619e38c2f6ef37e34f89dd3a78d9f59a7c808078ab964821
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.6

Release files / unisoc_unlock-0.0.2-py3-none-any.whl

Download URL unisoc_unlock-0.0.2-py3-none-any.whl
Size 16.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
66933e899916744c070fc0476c807f250f1b07213d3db3736aace4ee8cce8864
BLAKE2b-256 checksum
How to use checksums
97aa0a2338c2db812ea26bee4160f2ae26da7c2d0ec2cf40eab49432230a793a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.6

Release history Release notifications | RSS feed

This release

0.0.2 This release

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page