Indexed by TopGit from live GitHub metadata: brandonlw/Psychson has 4.2k stars, written primarily in C#. Phison 2251-03 (2303) Custom Firmware & Existing Firmware Patches (BadUSB)
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
DriveCom -- PC C# application to communicate with Phison drives.
EmbedPayload -- PC C# application to embed Rubber Ducky inject.bin key scripts into custom firmware for execution on the drive.
Injector -- PC C# application to extract addresses/equates from firmware as well as embed patching code into the firmware.
firmware -- this is 8051 custom firmware written in C.
patch -- this is a collection of 8051 patch code written in C.
Releases have the following items:
patch -- this is a collection of 8051 patch code written in C.
tools -- these are the compiled binaries of all the tools.
CFW.bin -- this is custom firmware set up to send an embedded HID payload.
Take note that the firmware patches have only been tested against PS2251-03 firmware version 1.03.53 (which is for an 8K eD3 NAND flash chip). They may work for others, but be careful.
As long as you are using the correct firmware image for your controller version and NAND chip, there is no harm in downgrading to an earlier version (such as from 1.10.53).
WARNING: This is experimental software. Use on unsupported devices, or even on supported devices, may cause loss of data, or even permananent damage to devices. Use at your own risk.
Getting Started
See Known Supported Devices for information on supported devices; use on an unsupported device may cause permanent damage to the device.
To get started, you'll need to obtain a burner image, which is the 8051 executable responsible for flashing firmware to the drive.
See Obtaining a Burner Image on the wiki for more information.
Build Environment
To patch or modify existing firmware, you must first set up a build environment. See Setting Up the Environment on the wiki for more information.
At a minimum, SDCC needs to be installed to C:\Program Files\SDCC.
Dumping Firmware
Run DriveCom, passing in the drive letter representing the drive you want to flash, the path of the burner image you obtained, and the destination path for the firmware image:
where E is the drive letter, BN03V104M.BIN is the path to the burner image, and fw.bin is the resulting firmware dump.
Currently, only 200KB firmware images can be dumped (which is what the Patriot 8GB Supersonic Xpress drive uses).
Flashing Custom Firmware
Run DriveCom, passing in the drive letter representing the drive you want to flash, the path of the burner image you obtained, and the path of the firmware image you want to flash:
where inject.bin is the path to your inject.bin file, and hid.bin is the path to the HID payload custom firmware.
(Notice that the firmware image is copied, and the payload is embedded into the copy -- this is because the payload can only be embedded once, so the original CFW.bin must remain intact.)
You can now flash the firmware to your drive with:
where E is the drive letter representing your drive, BN03V104M.BIN is the path to your burner image, and hid.bin is the path to the HID payload custom firmware.
Huge thanks to the Hak5 team for their work on the excellent USB Rubber Ducky!
Running Demo 2 (Hidden Partition Patch)
First, determine the number of logical blocks (sectors) your drive has with the following command:
tools\DriveCom.exe /drive=E /action=GetNumLBAs
Go into the patch directory and modify base.c to disable all other patches, and enable the hidden partition patch:
Then modify the NUM_LBAS define to the number of logical blocks on your drive:
#define NUM_LBAS 0xE6C980UL //this needs to be even! (round down)
Make sure you round down to an even number, and it couldn't hurt to subtract a few first, in case a few blocks go bad over time. (For example, if the number of LBAs was 0xE6C981, you might reduce it to 0xE6C940.)
Place the firmware image you want to patch into the patch directory and name it fw.bin.
Go to the patch directory and run build.bat. It will produce a file at patch\bin\fw.bin -- this is the modified firmware image.
You can now flash this file to your drive.
After flashing, Windows may be confused, as it now only sees half of the partition it once did -- it may ask you to format the first time you view either the public or hidden halves of the drive. This is normal.
Running Demo 3 (Password Patch)
Go into the patch directory and modify base.c to disable all other patches, and enable the password patch:
Place the firmware image you want to patch into the patch directory and name it fw.bin.
Go to the patch directory and run build.bat. It will produce a file at patch\bin\fw.bin -- this is the modified firmware image.
You can now flash this file to your drive. Once flashed to your device, it will no longer act on the command to jump to boot mode. To update the firmware again will require shorting pins on the controller. To make it impossible* to update, after flashing this patch coat the device with epoxy.
Within reason; it may be possible to get to boot mode via an exploit or other non-standard method.
Converting to Mode 7
You can run the ModeConverterFF01.exe application (see Useful Links) to split the drive into public and secure partitions, or restore the original (mode 3) functionality.
After converting to mode 7, you should be able to set, change, or disable the secure partition password with the USB DISK Pro LOCK utility.
Building From Source
Modify the C files in the firmware directory for custom firmware, or the patch directory for the firmware patches, then run the build.bat file in the appropriate directory.
Once it has built successfully, use DriveCom to flash the resulting file (bin\fw.bin) to your drive:
Unfortunately this isn't the most straightforward process at the moment, so if you have questions, open an issue and we'll do our best to help (and update the readme/wiki).
No homepage URL was recorded for brandonlw/Psychson in TopGit's last sync. The README tab above frequently contains screenshots and demo links, or check the repository description on GitHub.
Does brandonlw/Psychson have any tags?
TopGit's last sync did not record any GitHub topics for brandonlw/Psychson. GitHub topics appear in the right sidebar of a repository page; that's the authoritative place to check.
How active is development on brandonlw/Psychson?
The most recent commit recorded on brandonlw/Psychson was 5.3 years ago, based on the GitHub push timestamp. The repository has 1.2k forks — one of the better signals of community interest.
How many stars does brandonlw/Psychson have?
brandonlw/Psychson has 4.2k GitHub stars — refresh the page for the live number, or check github.com/brandonlw/Psychson. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is brandonlw/Psychson open source?
Yes — brandonlw/Psychson ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/brandonlw/Psychson.
Where do I read more about brandonlw/Psychson?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/brandonlw/Psychson is the definitive source.
Read full README in the tab above.
Curious whether Psychson is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about Psychson.