Getting Started VCU118

Getting Started

1. Fetch changes from upstream repo

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

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

3. Make sure repo is clean

4. Get pre-built bitstream.

<syntaxhighlight lang="bash"> $ make get_latest_bitstream TAG=VCU118-v2.0-alpha4 </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>

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

Well, yeah.

Solution 1: Press the