Git-Mirrors/tillitis-key
1
0
Fork 0
mirror of https://github.com/tillitis/tillitis-key1.git synced 2025-09-22 05:44:43 -04:00
Code Issues Projects Releases Packages Wiki Activity

doc: Add description on how to build and flash USB controller firmware

Browse source
This commit is contained in:
Michael Cardell Widerkrantz 2025-05-23 15:43:44 +02:00
parent f5d2cfef15
commit 24ef7b412b
No known key found for this signature in database
GPG key ID: D3DB3DDF57E704E5
1 changed files with 28 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

28
README.md
View file

@ -87,6 +87,8 @@ but keep our own copy of it in the repo. See below.
## Building & flashing ## Building & flashing
### FPGA
You need a [TKey You need a [TKey
Unlocked](https://shop.tillitis.se/products/tkey-not-provisioned) and Unlocked](https://shop.tillitis.se/products/tkey-not-provisioned) and
a [TKey Programmer a [TKey Programmer
@ -124,6 +126,32 @@ device into the container.
See the [Tillitis Developer Handbook](https://dev.tillitis.se) for See the [Tillitis Developer Handbook](https://dev.tillitis.se) for
more. more.
### USB Controller
Build:
```
cd contrib
make run
cd hw/usb_interface/ch552_fw
make
```
To flash the controller you need hardware like the [Blinkinlabs CH55x
Reset
Controller](https://shop-nl.blinkinlabs.com/products/ch55x-reset-controller)
and a USB-A to USB-C converter.
[Reset Controller source](https://github.com/Blinkinlabs/ch55x_programmer).
You also need [chprog](https://github.com/ole00/chprog).
1. Connect the Reset Controller to your computer through the "DUT\_IN".
2. Connect the TKey to "DUT\_OUT".
3. Press the "BOOTLOADER" button.
4. Run `make flash_patched` in `hw/usb_interface/ch552_fw` outside of
a container.
## Updating and working with tkey-libs ## Updating and working with tkey-libs
A copy of [tkey-libs](https://github.com/tillitis/tkey-libs) is kept A copy of [tkey-libs](https://github.com/tillitis/tkey-libs) is kept