Git-Mirrors/tillitis-key
1
0
Fork 0
mirror of https://github.com/tillitis/tillitis-key1.git synced 2024-10-01 01:45:38 -04:00
Code Issues Packages Projects Releases Wiki Activity

Add information about UDS, UDI and the tpt tool

Browse Source
This commit is contained in:
Joachim Strömbergson 2022-09-19 12:28:35 +02:00
parent 3110d1218d
commit 608c1c8656
No known key found for this signature in database
GPG Key ID: 865B8A548EA61679
1 changed files with 22 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
doc/quickstart.md
View File

@ -40,5 +40,25 @@ $ cd tillitis-key1/hw/application_fpga
$ make prog_flash
```
Your Key1 device should eventually be running the firmware with the LED
flashing white, indicating that it is ready to receive an app.
After programming, when your Key1 device is connected to the host, it would boot the firmware.
When boot has completed, the device will start flashing the LED white. This indicates that the device
is ready to receive and measure an app.
To personalize the device, you need to modify the hex file that contain the Unique Device Secret (UDS).
You should also update the Unique Device Identity (UDI). These hex files are located in hw/application_fpga/data.
To make this easier there is a tool, tpt that can generate these files. The tool can be found in hw/application_fpga/tools/tpt.
The tool allow you to supply a secret used as part of the UDS generation. The tool can be run interactively, or by suppling
inputs on the command line:
```
usage: tpt.py [-h] [-v] [--uss USS] [--vid VID] [--pid PID] [--rev REV] [--serial SERIAL]
options:
-h, --help show this help message and exit
-v, --verbose Verbose operation
--uss USS User supplied secret
--vid VID Vendor id (0 - 65535)
--pid PID Product id (0 - 2555
--rev REV Revision number (0 - 15)
--serial SERIAL Serial number (0 - (2**31 - 1))
```