Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
playground:vivado_github_demo_startup_rework [2017/05/10 18:00] – [3. Compile, Program, and Run the Project] Arthur Brown | playground:vivado_github_demo_startup_rework [2022/03/04 20:49] (current) – redirected to offical page James Colvin | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Using Github | + | ====== Using Digilent |
- | ===== Overview ===== | + | |
- | Digilent provides several projects through Github that are designed to demonstrate different uses of our FPGA and Zynq boards. This guide will describe how to download and use these projects. | + | |
- | At the end of this tutorial you will have your demo project running on your board. | + | ~~REDIRECT> |
- | ----- | + | ~~NOSEMANTIC~~ |
- | ===== Prerequisites ===== | + | {{tag>redirect}} |
- | + | ||
- | === Hardware === | + | |
- | * **A Supported Digilent 7-Series FPGA or Zynq Board** | + | |
- | * **USB Cables** | + | |
- | + | ||
- | === Software === | + | |
- | * **Xilinx Vivado 2016.X** | + | |
- | * //Vivado 2016.4 is used in this tutorial// | + | |
- | * **Digilent Board Support Files** | + | |
- | * //Follow the **[[vivado: | + | |
- | + | ||
- | + | ||
- | --> Projects Supported by this Tutorial# | + | |
- | + | ||
- | ^ Platform ^ Project Name ^ Uses SDK ^ Hardware Handoff Available ^ Wiki Link ^ Github Link ^ | + | |
- | | Arty | Pmod VGA Demo | No | No | [[https:// | + | |
- | + | ||
- | <-- | + | |
- | + | ||
- | <WRAP round important 660px> | + | |
- | ===Important=== | + | |
- | For further requirements, | + | |
- | </ | + | |
- | + | ||
- | ----- | + | |
- | + | ||
- | =====Tutorial===== | + | |
- | + | ||
- | ====1. Download the Project ZIP from the Digilent Github ==== | + | |
- | + | ||
- | >1.1) From the demo repository landing page, select the **release** link. | + | |
- | > | + | |
- | >{{: | + | |
- | + | ||
- | >1.2) If the repository has multiple releases, select **Latest Release**, then click on the project ZIP file included in the Downloads section of the release to download it. | + | |
- | > | + | |
- | >< | + | |
- | ===Important=== | + | |
- | Make sure that you download the project-2016.4-x.zip, | + | |
- | </ | + | |
- | > | + | |
- | > | + | |
- | + | ||
- | >1.3) All of the necessary files are included within each project folder, with relative file paths established, | + | |
- | + | ||
- | ----- | + | |
- | + | ||
- | ====2. Open the Project ==== | + | |
- | + | ||
- | Select the "SDK Hardware Handoff" | + | |
- | + | ||
- | --> Vivado Block Design or HDL Only# | + | |
- | + | ||
- | >2.1) Within the project folder there will be several subfolders named " | + | |
- | > | + | |
- | > | + | |
- | + | ||
- | >2.2) Open Vivado and find the Tcl Console on the bottom of the window. Enter the letters ' | + | |
- | > | + | |
- | >< | + | |
- | ===Important=== | + | |
- | Select the proj folder from the drop-down menu to make sure that Vivado converts the path's back slashes ' / ' to forward slashes ' \ '. Vivado will not recognize the path otherwise. | + | |
- | </ | + | |
- | > | + | |
- | > | + | |
- | + | ||
- | >2.3) Enter the command " | + | |
- | > | + | |
- | > | + | |
- | + | ||
- | >2.4) The project will now be open in Vivado and you can navigate through the **Design Sources** subwindow or select **Open Block Design** in the project flow manager to the left to see how the project hardware works. (Not all projects will have a block design) | + | |
- | + | ||
- | <-- | + | |
- | + | ||
- | --> SDK Hardware Handoff# | + | |
- | + | ||
- | >2.1) Find and Launch Vivado SDK. | + | |
- | + | ||
- | >2.2) In the Select Workspace dialog, click **Browse**, then find and select the " | + | |
- | > | + | |
- | > | + | |
- | + | ||
- | >2.3) Click **Ok** to finish launching Vivado SDK. | + | |
- | > | + | |
- | > | + | |
- | + | ||
- | >2.4) In the main page that pops up, click the **Import Projects** button. | + | |
- | > | + | |
- | > | + | |
- | + | ||
- | >2.5) Check the **Select root directory** option, then click **Browse**, again find and select the " | + | |
- | > | + | |
- | > | + | |
- | + | ||
- | >2.6) Make sure that the hw_handoff, application, | + | |
- | + | ||
- | <WRAP round tip 660px> | + | |
- | ===TIP=== | + | |
- | Some common issues at this stage can be solved by right clicking the BSP project and selecting **Regenerate BSP Sources**. | + | |
- | </ | + | |
- | + | ||
- | <-- | + | |
- | + | ||
- | ----- | + | |
- | + | ||
- | ====3. Compile, Program, and Run the Project ==== | + | |
- | + | ||
- | The options in this step carry through from step 2. If you chose SDK Hardware Handoff before, select that again, otherwise, select the option that applies to the project you are working with. Review the Supported Projects table to help determine what kind of project you are working with. | + | |
- | + | ||
- | --> HDL Only# | + | |
- | + | ||
- | >3.1) Click **Generate Bitstream** on the left hand menu towards the bottom. In the " | + | |
- | > | + | |
- | >< | + | |
- | ===Tip=== | + | |
- | If your computer has multiple cores, you can increase the number of jobs to make this process faster. | + | |
- | </ | + | |
- | > | + | |
- | + | ||
- | >3.2) When this process has finished, which may take a while, in the " | + | |
- | > | + | |
- | > | + | |
- | + | ||
- | >3.3) After the last step, if you don't have the hardware manager opened, select **Hardware Manager** from the Program and Debug section of the Flow Navigator to the left, just underneath **Generate Bitstream**. | + | |
- | + | ||
- | >3.4) Select **Open Target** from the green bar at the top. In the drop down menu that this creates, select **Open New Target**. | + | |
- | > | + | |
- | > | + | |
- | + | ||
- | >3.5) Click **Next**. Then make sure that **Local server** is selected in the " | + | |
- | > | + | |
- | > | + | |
- | + | ||
- | >3.6) Click **Next** and click **Finish**. | + | |
- | > | + | |
- | > | + | |
- | + | ||
- | <WRAP round important 650px> | + | |
- | ===Important=== | + | |
- | The project may have further setup requirements, | + | |
- | </ | + | |
- | + | ||
- | >3.7) Select **Program Device** from the green bar, then select your device from the dropdown list (there will usually only be one device listed). | + | |
- | > | + | |
- | > | + | |
- | > | + | |
- | >< | + | |
- | ===Important=== | + | |
- | If nothing shows up in the " | + | |
- | </ | + | |
- | + | ||
- | >The project will now be programmed onto your board and you can return to the project' | + | |
- | + | ||
- | <-- | + | |
- | + | ||
- | --> SDK Hardware Handoff# | + | |
- | + | ||
- | >3.1) After plugging your board into your PC with a USB cable, select **Program FPGA** from the Xilinx Tools dropdown in the toolbar. Then click **Program**. | + | |
- | > | + | |
- | > | + | |
- | + | ||
- | <WRAP round important 650px> | + | |
- | ===Important=== | + | |
- | The project may have further setup requirements, | + | |
- | </ | + | |
- | + | ||
- | >3.2) Right click on the application project - the one that doesn' | + | |
- | > | + | |
- | > | + | |
- | + | ||
- | >The project will now be programmed onto your board and you can return to the project' | + | |
- | + | ||
- | <-- | + | |
- | + | ||
- | --> SDK and Block Design# | + | |
- | + | ||
- | >3.1) Generate Bitstream | + | |
- | > | + | |
- | > | + | |
- | > | + | |
- | > | + | |
- | > | + | |
- | > | + | |
- | + | ||
- | >3.2) Export Hardware - Include Bitsream - Local to project | + | |
- | > | + | |
- | > | + | |
- | > | + | |
- | > | + | |
- | + | ||
- | >3.3) Launch SDK - Local to Project | + | |
- | > | + | |
- | > | + | |
- | > | + | |
- | > | + | |
- | + | ||
- | >< | + | |
- | ===Tip=== | + | |
- | Some warnings and errors can be resolved by right clicking on the BSP project and selecting **Re-generate BSP Sources**. | + | |
- | </ | + | |
- | + | ||
- | >3.4) Import the existing SDK projects. | + | |
- | > | + | |
- | > | + | |
- | > | + | |
- | > | + | |
- | > | + | |
- | > | + | |
- | > | + | |
- | > | + | |
- | + | ||
- | >3.5) After plugging your board into your computer with a JTAG USB cable, select **Program FPGA** from the Xilinx Tools dropdown in the toolbar. Then click **Program**. | + | |
- | > | + | |
- | > | + | |
- | > | + | |
- | > | + | |
- | + | ||
- | <WRAP round important 650px> | + | |
- | ===Important=== | + | |
- | The project may have further setup requirements, | + | |
- | </ | + | |
- | + | ||
- | >3.6) Right click on the application project - the one that doesn' | + | |
- | > | + | |
- | > | + | |
- | + | ||
- | >The project will now be programmed onto your board and you can return to the project' | + | |
- | + | ||
- | + | ||
- | <-- | + | |
- | + | ||
- | ----- | + | |