Installation - Mac OS X

[Home] | [Installation - Windows] | [Installation - Linux] | [Installation - Mac OS X] | [About]

---

Installation - Mac OS X

In MacOS X it is necessary to install UMHDL and the external tools GHDL and GTKwave. Furthermore, GTKwave also requieres a X11 server.

• Installation - Mac OS X
• UMHDL
• GHDL
• X11 server
• GTKWave
• Environment variables

UMHDL

To install UMHDL simply uncompress the file 'umhdl-mac-app-1.60.zip' in any location, for example, in the Applications folder. It contains a single application file (.app) that can be added to the Dock or to the desktop (creating an Alias previously).
This .app file works from Mac OS X Lion 10.8; for older versions you need to execute the JAR file (.jar) included in the source code; uncompress the umhdl-jar.zip file and execute it with:

$ java -jar "UMHDL.jar"

Alternatively you can build yourself an Application (.app) from the JAR file with "Jar Bundler", including both the .jar file and the libraries that contains the dist folder.

To uninstall UMHDL simply drag the .app file to the Trash. Remove any shortcut from the Dock or Desktop too.

GHDL

• For OS X Mavericks 10.9 or later download the file ghdl-0.31-mcode-darwin13.mpkg.zip from:
  http://sourceforge.net/projects/ghdl-updates/files/Builds/ghdl-0.31/OSX/
• For older versions download the file ghdl_mcode_r142.dmg from:
  http://ghdl.free.fr/site/pmwiki.php?n=Main.Download

The program will be installed to: /usr/local/bin

Links:

http://gna.org/projects/ghdl/
http://ghdl.free.fr/
http://sourceforge.net/projects/ghdl-updates/

X11 server

• Recent Mac OS X versions (Mountain Lion 10.8, Mavericks 10.9, Yosemite 10.10, ...) does not include any X11 server as older ones. It is necessary to install XQuartz, which can be downloaded from:
  http://xquartz.macosforge.org
  Once installed it is necessary to reboot the computer.
• Older Mac OS X versions (Snow Leopard 10.6, Lion 10.7) already include an X11 server. It can be installed if needed from the Install DVD: Optional Installs > X11.

GTKWave

Using MacPorts o Fink:
0. Install MacPorts (if needed), which requieres Xcode:
https://www.macports.org/install.php
1. Update MacPorts (if needed):

      $ sudo port selfupdate --nosync

      $ sudo port selfupdate

1. Update installed programs with MacPorts:

      $ sudo port outdated

      $ sudo port selfupdate

      $ sudo port upgrade outdated

1. Install the gtkwave port:

      $ port search gtkwave

      $ port install gtkwave

The program will be installed to: /opt/local/bin

It is also possible to download an installer from:
http://eng-osx.sourceforge.net/GTKwave.html

Finally, it is possible to use WINE for installing from a Windows installer:
http://dwellangle.wordpress.com/2010/04/30/installing-ghdl-on-a-mac/

Links:

http://gtkwave.sourceforge.net/

Environment variables

• The PATH environment variable should include the path for the 'ghdl' and 'gtkwave':
  ghdl: /usr/local/bin
  gtkwave: /opt/local/bin
• In order to set these paths it is necessary to modify the '/etc/launchd.conf' file, because if they are included in the '.bash_profile' they will not be taken int account when invoking external tools from a graphical application like UMHDL:

   $ sudo vi /etc/launchd.conf

   setenv JAVA_HOME /Library/Java/Home

   setenv PATH /usr/local/bin

• Alternatively, it is possible to set that paths in the application configuration.
• We can check the directories with the 'which' or 'whereis' commands:

     $ which ghdl

     /usr/local/bin/ghdl

     $ which gtkwave

     /opt/local/bin/gtkwave