What is this? These are instructions for getting the Xilinx tools up and running on OSX to work with the Embedded Micro Mojo v3 FPGA development board.
Why am I doing this? I bought the Mojo v3 development board last year to start playing with FPGA’s but haven’t gotten around to using it. I figured now is as good a time as any to start…
Why not just dual boot into Windows or Ubuntu? I don’t really have a Windows machine anymore, and why dual boot when I can just use a virtual machine?! I’ve been playing with Vagrant and Ansible at work, so I figured I’d try them out here. My goal is to automate most of the annoying things to get a Xilinx development board working on a VM so that you don’t have to. I was able to get almost everything automated, except for the Xilinx ISE installation, since it requires some user interaction :-/
- VirtualBox and VirtualBox extension pack
brew cask install virtualbox virtualbox-extension-pack
- or download from the VirtualBox website
brew install vagrant
brew install ansible
- Xilinx ISE WebPack for Linux Installation file
- Download from the Xilinx website (Make sure you get the “Full Installer for Linux”)
Install VirtualBox, vagrant, and ansible
Clone the osxMojo repo
git clone https://github.com/alvarop/osxMojo.git
If you already have it, copy your Xilinx.lic license key file to the roles/ise/files/ directory. This is for ISE WebPack, you can get a free one from the Xilinx license page. If you have trouble, keep going and ISE will ask you for one later on when it needs it.
In the top directory for the repo, run
- This will setup an ubuntu VM with most prerequisites as well as create shortcuts for things
After vagrant up finishes running, login via the VirtualBox window with username vagrant and password vagrant
Once the desktop comes up click on “Use default config”
On OSX, extract the Xilinx ISE Webpack installation files to the top directory on the host machine (For me it was Xilinx_ISE_DS_Lin_14.7_1015_1)
In the VM, open a terminal and run
sudo /vagrant/Xilinx_ISE_DS_Lin_14.7_1015_1/xsetup to install the Xilinx ISE tools
IMPORTANT: Make sure you set the installation path to /vagrant/opt/Xilinx
Once the installation is complete, you should be able to run ISE from the desktop icon!
Working with ISE
You can now open ISE with the included desktop shortcut
As an example, you can download the Mojo base project from Embedded Micro’s Creating a Project tutorial. I put the base project in a directory I created under osxMojo/projects/ on OSX. You can now open the project from ISE.
You can generate the FPGA programming file by double clicking “Generate Programming File” on the bottom left (If you can’t find it, check out the Embedded Micro tutorial. It’s much better than this.)
Programming the Mojo v3
First, you need to connect your mojo v3 to the computer via USB. Assuming everything goes as planned, the device should be mounted under /dev/ttyACM0. You can check easily by doing
ls -l /dev/ttyA* on the terminal.
You can launch the Mojo Loader from the desktop to get started.
Select the mojo serial port. (/dev/ttyACM0 in my case)
You can now open the mojo programming/binary file created by ISE by going to /vagrant/projects/mojo-base-project-master/syn/mojo_top.bin
Once the file is selected, you should be able to program the mojo by clicking on load!
If you’re not using ISE and want to save some memory, you can do
vagrant suspend on the command line to put the virtual machine to sleep.
If you want to save disk space, you are able to do
vagrant destroy and
vagrant up again later without needing to re-install ISE, since we installed it in the /vagrant/opt directory, which is on the shared folder and not in the VM itself.