https://github.com/anthony-bernaert/ftdi-cloner
Simple FTDI chip EEPROM backup and restore utility
https://github.com/anthony-bernaert/ftdi-cloner
backup dump eeprom eeprom-programmer ftdi python restore
Last synced: about 2 months ago
JSON representation
Simple FTDI chip EEPROM backup and restore utility
- Host: GitHub
- URL: https://github.com/anthony-bernaert/ftdi-cloner
- Owner: anthony-bernaert
- License: gpl-3.0
- Created: 2024-10-20T12:47:44.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-21T19:40:57.000Z (about 1 year ago)
- Last Synced: 2025-04-21T20:42:17.819Z (about 1 year ago)
- Topics: backup, dump, eeprom, eeprom-programmer, ftdi, python, restore
- Language: Python
- Homepage:
- Size: 25.4 KB
- Stars: 0
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# FTDI EEPROM cloner
This simple Python program makes EEPROM dumps of FTDI-based devices, and can restore the entire EEPROM from a file on your computer.
Aside from backup and analysis purposes, this program also allows cloning of devices that use an FTDI chip with a proprietary signature in their EEPROM. This signature often prevents using custom FTDI-based boards with specific software such as FPGA toolchains, even though the software perfectly supports the FTDI chip.
Note that only raw EEPROM data is manipulated. The program currently has no checks on the correctness of the EEPROM contents you read or write. It does NOT update the checksum nor does it automatically generate serial numbers for your device.
>[!IMPORTANT]
>Use this utility at your own risk. Writing an invalid file to the EEPROM may result in a subsequent enumeration failure, bricking your device until you replace the EEPROM chip!
## How to use
### Python virtual environment
The recommended way is to create a virtual environment from which the program is run. Dependencies are automatically loaded based on the package configuration files. For this, run the `install.sh`/`install.bat` (depending on your OS) from the repository's root folder.
You can then launch the program through the `run.sh`/`run.bat` file, or directly launch the executable created in the 'dist' folder.
### Manually run from ftdi-cloner.py
If you prefer to directly invoke the Python script using `python ftdi-cloner.py`, you need to install the following dependencies first using `pip`:
- `ftd2xx=1.3.8`
- `simple-hexdump`
### Interactive CLI
Currently, the program only runs interactively from the command line. On-screen instructions guide you through the backup/restore process.