mirror of
https://github.com/tillitis/tillitis-key1.git
synced 2025-04-27 18:36:23 -04:00
65 lines
1.4 KiB
Markdown
65 lines
1.4 KiB
Markdown
# CH552 USB-to-Serial firmware
|
|
|
|
## Toolchain setup
|
|
|
|
SDCC:
|
|
|
|
sudo apt install build-essential sdcc
|
|
|
|
chprog (for flashing the firmware to a device):
|
|
|
|
cd ~
|
|
sudo apt install libusb-1.0-0-dev
|
|
git clone https://github.com/ole00/chprog.git
|
|
cd chprog
|
|
./build_linux.sh
|
|
sudo cp chprog /usr/local/bin
|
|
|
|
## Usage
|
|
|
|
Build the firmware using a default serial number:
|
|
|
|
make
|
|
|
|
Flash the firmware to a device:
|
|
|
|
make flash_patched
|
|
|
|
## Re-programming the firmware
|
|
|
|
By design, once the USB to serial firmware is loaded onto the chip,
|
|
there isn't an intended way to reflash it using only software.
|
|
However, if 3.3V is applied to the D+ line through a 10K resistor
|
|
during power-up, then the CH552 will enter bootloader mode, and a new
|
|
firmware can be programmed onto the chip.
|
|
|
|
The Blinkinlabs CH55x Reset Controller can help you do this:
|
|
|
|
https://shop-nl.blinkinlabs.com/products/ch55x-reset-controller
|
|
|
|
https://github.com/Blinkinlabs/ch55x_programmer
|
|
|
|
Note that the CH552 flash is only guaranteed for a few hundred flash
|
|
cycles.
|
|
|
|
## License
|
|
|
|
Originally based on reference firmware for the CH552 by WCH released
|
|
under the MIT license:
|
|
|
|
https://www.wch-ic.com/
|
|
|
|
The oldest files Copyright 1999.
|
|
|
|
Much changed and added to by Tillitis.
|
|
|
|
Check licenses using the reuse tool:
|
|
|
|
https://github.com/fsfe/reuse-tool
|
|
|
|
Note that so far you need to specify this directory as root, as in:
|
|
|
|
```
|
|
$ reuse --root . lint
|
|
```
|