View source for Getting Started PTB

== Superfast flow ==

The PTB stores the bitstream, embedded software and a bootloader on a flash memory. A power cycle will not reset this. Thus, one can use the PTB by simply turning in on.
By checking the serial debug output, one can check if the correct version is running.

1. (Optional) Start debugging stream. Shows messages from embedded system once programmed.

2. [[Media:power_on_board_ptb.jpg | Power on board]]

The serial debug window should have something like the following output:

[[File:PTB-boot.png|400 px]]

<syntaxhighlight lang="bash">
$ make serial
</syntaxhighlight>

== Getting Started ==

1. Fetch changes from  [https://git.app.uib.no/pct/wp3|wp3 upstream repo]

2. Checkout tag of your select release. See [https://git.app.uib.no/pct/wp3/-/releases|latest releases]. This guide assumesPTB-v2.0.

<syntaxhighlight lang="bash">
$ git checkout PTB-v2.0
</syntaxhighlight>

3. Make sure repo is clean

4. Get pre-built bitstream.

<syntaxhighlight lang="bash">
$ make get_latest_bitstream TAG=PTB-v2.0
</syntaxhighlight>

5. Build embedded software

<syntaxhighlight lang="bash">
$ make sdk_gen_projects PRJ=PTB
</syntaxhighlight>

6. (Optional) Open a new terminal window and start debugging stream. Shows messages from embedded system once programmed.

<syntaxhighlight lang="bash">
$ make serial
</syntaxhighlight>

7. [[Media:power_on_board_ptb.jpg | Power on board]]

8. Generate bootloader and program flash

<syntaxhighlight lang="bash">
$ make gen_bootimage
$ make program_flash
</syntaxhighlight>

9. [[Media:reset_ptb.jpg | Restart PTB]]

The serial debug window should have something like the following output:

[[File:PTB-boot.png|400 px]]