Git-Mirrors/tillitis-key
1
0
Fork 0
mirror of https://github.com/tillitis/tillitis-key1.git synced 2025-07-26 00:15:23 -04:00
Code Issues Projects Releases Packages Wiki Activity
tillitis-key/hw/application_fpga/tools/tkeyimage
History
Michael Cardell Widerkrantz a1f37d17c9
tool: Rename partition_table to tkeyimage
2025-05-20 13:50:55 +02:00
..
go.mod tool: Rename partition_table to tkeyimage 2025-05-20 13:50:55 +02:00
go.sum tool: Rename partition_table to tkeyimage 2025-05-20 13:50:55 +02:00
README.md tool: Rename partition_table to tkeyimage 2025-05-20 13:50:55 +02:00
tkeyimage.go tool: Rename partition_table to tkeyimage 2025-05-20 13:50:55 +02:00

README.md

tkeyimage

A tool to parse or generate partition table or entire filesystems for the TKey.

  • Parse with -i file.bin for "input".
  • Generate with -o file.bin for "output".

Add -f to parse or generate an entire flash image file.

Usage

Inspect a partition table dump

Dump the entire data from flash, then inspect:

$ tillitis-iceprog -R 1M dump.bin
$ ./tkeyimage -i dump.bin -f
INFO: main.Flash struct is 1048576 byte long
Partition Table Storage
  Partition Table
    Header
      Version          : 1
    Preloaded App 0
      Size             : 23796
      Digest           : 00000000000000000000000000000000
                         00000000000000000000000000000000
      Signature        : 00000000000000000000000000000000
                         00000000000000000000000000000000
                         00000000000000000000000000000000
                         00000000000000000000000000000000
    Preloaded App 1
      Size             : 264
      Digest           : 96bb4c90603dbbbe09b9a1d7259b5e9e
                         61bedd89a897105c30c9d4bf66a98d97
      Signature        : ccb60c034e559b8c695f25233b80c245
                         e099316324e1a4e68a14c82d834eee58
                         5700cd5c29b64e74159a4dbf3fed030a
                         140e981fb3b6972c125afb4d4497da0a
  Digest               : 4628f142764f724e45e05b20363960967705cfcee8285b2d9d207e04a46e275e

Read only the first copy of the partition table from flash to file, then inspect:

$ tillitis-iceprog -o 128k -r partition.bin
$ ./tkeyimage -i partition.bin
INFO: main.PartTableStorage struct is 365 byte long
Partition Table Storage
  Partition Table
    Header
      Version          : 1
    Preloaded App 0
      Size             : 23796
      Digest           : 00000000000000000000000000000000
                         00000000000000000000000000000000
      Signature        : 00000000000000000000000000000000
                         00000000000000000000000000000000
                         00000000000000000000000000000000
                         00000000000000000000000000000000
    Preloaded App 1
      Size             : 0
      Digest           : 00000000000000000000000000000000
                         00000000000000000000000000000000
      Signature        : 00000000000000000000000000000000
                         00000000000000000000000000000000
                         00000000000000000000000000000000
                         00000000000000000000000000000000
  Digest               : 40c6dbb4c8fda561369ec54a907452ae352ccbd736ba7824c4e173fd438b7d7a

Generate a partition table

If you want to generate just a partition table:

$ ./tkeyimage -o partition.bin

With an app in slot 0, filling in the size in the partition table:

$ ./tkeyimage -o partition.bin -app0 ../../fw/testloadapp/testloadapp.bin

Generate flash image

The program can also generate an entire flash image for use either with real hardware or qemu.

Generate like this:

$ ./tkeyimage -o flash.bin -f -app0 ../../fw/testloadapp/testloadapp.bin

Using -app0 is mandatory because TKey firmware won't start without an app in slot 0.

The qemu args to use to run with flash.bin as the flash are:

-drive file=flash.bin,if=mtd,format=raw,index=0

A complete command example:

$ qemu-system-riscv32 -nographic -M tk1-castor,fifo=chrid \
-bios qemu_firmware.elf -chardev pty,id=chrid -s -d guest_errors \
-drive file=flash.bin,if=mtd,format=raw,index=0