Mega65 Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== FPGA Development Walkthrough ======

Once you've got yourself a [[http://store.digilentinc.com/nexys-4-ddr-artix-7-fpga-trainer-board-recommended-for-ece-curriculum|Nexys 4 DDR Artix-7 FPGA: Trainer Board]], you'll want to program the [[http://www.xilinx.com/products/silicon-devices/fpga/artix-7.html|Xilinx Artix-7 FPGA]] chip to do your bidding.

This page will walk through the process of getting your pc prepared to do a build of the project.

===== TODO: Migration to Vivado =====

The latest version of the codebase now needs to be built via Vivado and not ISE.

I'll try document this in more detail in future. For now, try download the latest Vivado from here:

  * https://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/vivado-design-tools.html

Then try follow the steps below, replacing and ISE-specific options with Vivado.

===== Which tool to use =====

There are two software tool packages Xilinx provides to build on these systems, "**ISE Design Suite**" (older) and "<del>Vivado</del>" (newer). This project uses the former, as Paul reported problems with Vivado (see his log entries: [[https://c65gs.blogspot.com.au/2014/11/migrating-from-ise-to-vivado-part-1.html|#1]], [[https://c65gs.blogspot.com.au/2014/11/migrating-to-vivado-part-2.html|#2]], [[https://c65gs.blogspot.com.au/2014/06/did-i-mention-that-fpga-development-is.html|#3]]).

Note that presently, this tool is only available for Windows and Linux (no Mac support).


===== Download ISE Design Suite =====

  * Download the install file from:
    * http://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/design-tools.html
  * Scroll down the screen a bit and choose the "**Full Installer for Windows**" option
    * {{http://gurce.net/Logs/images/img_2016_06_21_7_07.png}}
  * I think at this point, you need to fill out a form with your details
  * It then runs a java applet within your browser to handle the **6.1GB** download
    * Please note the large file size, it might take a while! (and don't accidentally use your mobile's internet ;)
    * Also, you might need to enable java applets to run in your web-browser (many modern browsers try to block them these days)
  * Once the download completes, look in your "**My Documents**" folder
  * You will find the "**Xilinx_ISE_DS_Win_14.7_1015_1.tar**" file there
  * You can unzip it with a tool such as [[http://www.7-zip.org/download.html|7-zip]]


===== Install ISE Design Suite =====

  * Run the "**xsetup.exe**" file
    * {{http://gurce.net/Logs/images/img_2016_06_20_14_13.png}}
  * You'll get a nice welcome screen, click "**Next**"
    * {{http://gurce.net/Logs/images/img_2016_06_20_14_15.png}}
  * Tick the two checkboxes and click "**Next**"
    * {{http://gurce.net/Logs/images/img_2016_06_20_14_17.png}}
  * Tick another checkbox and click "**Next**"
    * {{http://gurce.net/Logs/images/img_2016_06_20_14_18.png}}
  * Then choose the "**ISE WebPack**" option (this is the 'free' one) and "**Next**":
    * {{http://gurce.net/Logs/images/img_2016_06_20_14_19.png}}
  * Just leave all the checkboxes ticked on this page and click "**Next**":
  * Click "**Next**" once more
    * {{http://gurce.net/Logs/images/img_2016_06_20_14_21.png}}
  * Then click the "**Install**" button
    * {{http://gurce.net/Logs/images/img_2016_06_20_14_23.png}}
  * Now wait two or three hours for it to install... :)
  * At around the 90% point of the install, it wants to install "**WinPCAP**"
  * Just install it with the default settings
    * {{http://gurce.net/Logs/images/img_2016_06_20_15_44.png}}

Congrats, it's finally installed! :)

===== Acquiring the License ====

  * After the install, the "**Xilinx License Configuration Manager**" app will appear automatically
  * On the "**Acquire a License**" tab, select the "**(x) Get Free Vivado/ISE WebPack License**"
  * Then click "**Next**"
    * {{http://gurce.net/Logs/images/img_2016_06_20_15_52.png}}
  * You will then get this popup. Click "**Connect Now**":
    * {{http://gurce.net/Logs/images/img_2016_06_20_16_00.png}}
  * You will get re-directed to a website:
    * Tick the checkbox for the "**Vivado Design Suite: HL WebPACK 2015 and Earlier License**" (in-case our project moves to it later on)
    * Tick the checkbox for the "**ISE WebPack License**" item too (this is the tool we use presently)
    * Then click the "**Generate Node-Locked License**" button
      * {{http://gurce.net/Logs/images/img_2016_06_20_16_05.png}}
  * You will then see this web-form. Just click "**Next**"
    * {{http://gurce.net/Logs/images/img_2016_06_20_21_21.png}}
  * Then this page, just click "**Next**" again:
    * {{http://gurce.net/Logs/images/img_2016_06_20_21_22.png}}
  * Then we get this congratulatory message saying the license has been emailed to us.
    * {{http://gurce.net/Logs/images/img_2016_06_20_21_24.png}}
  * Check your email client for this email and download the attached "**Xilinx.lic**" file
  * It then takes you back to the "**Xilinx License Configuration Manager**" app
    * This time, it shows the "**Manage Licenses**" pane
    * Click on the "**Load License...**" button
    * {{http://gurce.net/Logs/images/img_2016_06_21_6_32.png}}
  * then browse to the "**Xilinx.lic**" file you downloaded from the attachment of the license email.
  * You will then get this nice re-assuring popup!
    * {{http://gurce.net/Logs/images/img_2016_06_20_22_18.png}}

Great, we finally got that pesky license stuff out of the way! :)


===== Build the project =====

  * From the [[Preparing a build environment in Cygwin]] page, assure you've done the following sections.
    * [[Preparing a build environment in Cygwin#Installing Cygwin]]
    * [[Preparing a build environment in Cygwin#Cygwin Prerequisites]]
    * [[Preparing a build environment in Cygwin#Retrieve the MEGA65 source code]]

We then need to run "make" on the project, then open in ISE Project Navigator and do the synthesise stuff...

TODO: Provide more detail...