mirror of
https://github.com/tillitis/tillitis-key1.git
synced 2024-10-01 01:45:38 -04:00
072b204d3d
* ch552 firmware: add ch55x support files directly * Add sdcc compiler to docker image, for building CH552 firmware * Rework production test script * Add menu-based test runner * Rewrite production test flows as lists of individual tests * Add both production flows and manual tests to menu * Switch to using included binaries * production test: Update message format * test_txrx_touchpad: Retry if device communications fail * production test: put all binaries in binaries/ folder * binaries/top.bin: replace broken binary * flash_check: Check for explicit flash IDs * Document most test procedures * Test plan documentation * Sample udev rules * Production test: allow external references to be overridden * Remove outdated descriptions * Correct shebang * Update shebangs to comply with PEP 394 Change the python scripts to call python instead of python3, as this works cross platform. See: https://peps.python.org/pep-0394/#for-python-script-publishers * Move production test to higher-level directory * Clarify production test setup * Move USB C connector test to separate directory Co-authored-by: Michael Cardell Widerkrantz <mc@tillitis.se>
31 lines
864 B
Markdown
31 lines
864 B
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. Note that the CH552 flash is only guaranteed for a few hundred flash cycles.
|