Getting Started VCU118

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

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

3. Make sure repo is clean

4. Get pre-built bitstream.

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

5. Build embedded software

<syntaxhighlight lang="bash"> $ make sdk_gen_projects PRJ=VCU118 </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. Power on board

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

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

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

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.

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

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.

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

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

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

Solution 4: Reprogram

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