Getting Started VCU118: Difference between revisions
(Created page with "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 releas...") |
No edit summary |
||
| (17 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
== Getting Started == | |||
2. Checkout tag of your select release. See [https://git.app.uib.no/pct/wp3/-/releases | 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.1 | |||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
$ git checkout VCU118-v2.0 | $ git checkout VCU118-v2.0.1 | ||
</syntaxhighlight> | |||
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.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. [[Media:power_on_board_vcu118.jpg | 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: | |||
[[File:VCU118-boot.png|400 px]] | |||
== 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 [[Media:reset_soft.jpg |soft reset button]] | |||
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
8. Program FPGA with bitstream + download embedded software and boot
$ make run_VCU118
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.
$ 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