Getting Started VCU118: Difference between revisions
No edit summary |
No edit summary |
||
| Line 9: | Line 9: | ||
3. Make sure repo is clean | 3. Make sure repo is clean | ||
4. | 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. [:Media:image.png|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 | |||
Revision as of 17:33, 12 September 2019
1. Fetch changes from upstream repo
2. Checkout tag of your select release. See releases. This guide assumes VCU118-v2.0-alpha4.
$ git checkout VCU118-v2.0-alpha4
3. Make sure repo is clean
4. Get pre-built bitstream.
$ make get_latest_bitstream TAG=VCU118-v2.0-alpha4
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. [:Media:image.png|Power on board]
8. Program FPGA with bitstream + download embedded software and boot
$ make run_VCU118
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
Well, yeah.
Solution 1: Press the