Skip to main content

Tool for (un)locking a Unisoc/Spreadtrum Android bootloader

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

unisoc_unlock-0.0.2.tar.gz (13.6 kB view details)

Uploaded Source

Built Distribution

unisoc_unlock-0.0.2-py3-none-any.whl (16.2 kB view details)

Uploaded Python 3

File details

Details for the file unisoc_unlock-0.0.2.tar.gz.

File metadata

  • Download URL: unisoc_unlock-0.0.2.tar.gz
  • Upload date:
  • Size: 13.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.6

File hashes

Hashes for unisoc_unlock-0.0.2.tar.gz
Algorithm Hash digest
SHA256 be2e02e395e8fe6586e7f645033d8475168785e52c46ddfba79a63fd1e6b7c11
MD5 80fc9940e64667c17b1e46f6f197e948
BLAKE2b-256 90c9b7e23d3e1930619e38c2f6ef37e34f89dd3a78d9f59a7c808078ab964821

See more details on using hashes here.

File details

Details for the file unisoc_unlock-0.0.2-py3-none-any.whl.

File metadata

File hashes

Hashes for unisoc_unlock-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 66933e899916744c070fc0476c807f250f1b07213d3db3736aace4ee8cce8864
MD5 31838a14f5b9d996434deb9e5773c090
BLAKE2b-256 97aa0a2338c2db812ea26bee4160f2ae26da7c2d0ec2cf40eab49432230a793a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page