eric/Crosspoint
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix: Add documentation for USB-locked Xteink devices (#1990)

Browse Source 
Document the Xteink Unlocker tool requirement for third-party purchased
xteink units that ship with USB flashing locked. Include warnings about
bricking risks when flashing unsupported firmwares (e.g. Papyrix) on
locked devices, as they may permanently lock the device with no recovery
path.
# Conflicts:
#	README.md
This commit is contained in:
Justin Mitchell
2026-05-15 11:00:41 -05:00
committed by Zach Nelson
parent 16e5e5f00b
commit c26e410c58
1 changed files with 24 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+24
View File
@@ -50,6 +50,30 @@ CrossPoint is open-source e-reader firmware - community-built, fully hackable, f
---
## USB-locked devices (Xteink Unlocker)
Some Xteink units purchased from third-party stores (e.g. AliExpress) ship with USB flashing locked from the factory.
If your device is locked, you will need to use the **Xteink Unlocker** tool available at
https://crosspointreader.com/#unlock-tool before you can flash CrossPoint.
**You do not need this tool if you bought your device directly from xteink.com.** Those units are not locked.
**Not sure if your device is locked?** Power it on, connect the USB-C cable, and try flashing via the web flasher first (see
[Install firmware](#Install%20firmware) below). If the browser's serial device picker does not show your device, try a different
USB port or browser before assuming the device is locked. Only reach for the unlocker if the device still doesn't appear.
### ⚠️ WARNING: READ THIS BEFORE USING THE UNLOCKER ⚠️
**The only officially supported firmwares in the unlock tool are CrossPoint and CrossInk.**
Flashing any other firmware on a USB-locked device may **permanently brick the device** or leave it **permanently
stuck on that firmware with no recovery path**. Once USB flashing is re-locked, your only way back is via OTA, and if
the firmware you flashed doesn't support OTA, **there is no way out**.
**The Papyrix fork has removed OTA update support from its code.** If you flash Papyrix onto a
USB-locked unit, you will have **zero update or recovery path** and will be stuck on it forever. **Do not flash
Papyrix (or any other unsupported firmware) on a locked device.**
## Install firmware
### Web installer (recommended)