Getting Started VCU118: Difference between revisions

From pCT
No edit summary
No edit summary
 
(11 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Getting Started ==
== Getting Started ==


1. Fetch changes from  [https://git.app.uib.no/pct/wp3|wp3 upstream repo]
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 assumes VCU118-v2.0-alpha4.
2. Checkout tag of your select release. See [https://git.app.uib.no/pct/wp3/-/releases latest releases]. This guide assumes VCU118-v2.0.1


<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
$ git checkout VCU118-v2.0-alpha4
$ git checkout VCU118-v2.0.1
</syntaxhighlight>
</syntaxhighlight>


Line 14: Line 14:


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


Line 29: Line 29:
</syntaxhighlight>
</syntaxhighlight>


7. [[Media:image.png | Power on board]]
7. [[Media:power_on_board_vcu118.jpg | Power on board]]


8. Program FPGA with bitstream + download embedded software and boot
8. Program FPGA with bitstream + download embedded software and boot
Line 36: Line 36:
$ make run_VCU118
$ make run_VCU118
</syntaxhighlight>
</syntaxhighlight>
The serial debug window should have something like the following output:
[[File:VCU118-boot.png|400 px]]


== Troubleshooting ==
== Troubleshooting ==
Line 61: Line 65:
=== Nothing works at all ===
=== Nothing works at all ===


Well, yeah.
That's too bad...
 
Solution 1: Press the [[Media:reset_soft.jpg |soft reset button]]


Solution 1: Press the
Solution 2: Press the [[Media:reset_hard.jpg |hard reset button]]
 
Solution 3: Restart embedded software
 
<syntaxhighlight lang="bash">
$ make run_VCU118_SW
</syntaxhighlight>
 
Solution 4: Reprogram
 
<syntaxhighlight lang="bash">
$ make run_VCU118
</syntaxhighlight>

Latest revision as of 14:04, 11 January 2020

Getting Started

1. Fetch changes from wp3 upstream repo

2. Checkout tag of your select release. See latest releases. This guide assumes VCU118-v2.0.1

$ git checkout VCU118-v2.0.1

3. Make sure repo is clean

4. Get pre-built bitstream.

$ make get_latest_bitstream TAG=VCU118-v2.0.1

5. Build embedded software

$ make sdk_gen_projects PRJ=VCU118

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

$ make serial

7. Power on board

8. Program FPGA with bitstream + download embedded software and boot

$ make run_VCU118

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

VCU118-boot.png

Troubleshooting

Auto-negotiation failed

Sometimes a race-condition causes the auto-negotiation sequence to fail. This will make it impossible to connect to the embedded software via Ethernet.

Solution: Restart the embedded software only.

$ make run_VCU118_SW

Embedded software hangs

If you tried to talk to read or write a register that does not exist on the FPGA, the embedded system will hang. Unfortunately, there are no ways to avoid this.

Solution: Restart the embedded software only.

$ make run_VCU118_SW

Nothing works at all

That's too bad...

Solution 1: Press the soft reset button

Solution 2: Press the hard reset button

Solution 3: Restart embedded software

$ make run_VCU118_SW

Solution 4: Reprogram

$ make run_VCU118