Mac OS X

sigrok-gui on Mac OS X

This page describes how to build sigrok on Mac OS X.

Building

These instructions have been tested on a clean Mac OS X 10.6.8 install.

Requirements

Install MacPorts, follow the guide on macports.org (this step will require Xcode on your machine, which is also a dependency to build sigrok).

Install Qt, download qt-mac-opensource-4.7.4.dmg from qt.nokia.com (Only needed for sigrok-qt).

TODO: Install GTK+ libs and dependencies for sigrok-gtk.

Install git:

$ sudo port install git-core

This will also pull in a bunch of dependencies required by git-core (and some of them also by sigrok).

Install libusb, libzip and libftdi, the sigrok build dependencies:

$ sudo port install libusb
$ sudo port install libzip
$ sudo port install libftdi

Building libsigrok:

$ git clone git://sigrok.org/libsigrok
$ cd libsigrok
$ ./autogen.sh
$ ./configure
$ make
$ sudo make install
$ cd ..

Building libsigrokdecode:

$ git clone git://sigrok.org/libsigrokdecode
$ cd libsigrokdecode
$ ./autogen.sh
$ ./configure
$ make
$ sudo make install
$ cd ..

Then you need to build the chosen user interfaces (cli, qt or gtk).

For building sigrok-cli (the command-line interface for sigrok):

$ git clone git://sigrok.org/sigrok-cli
$ cd sigrok-cli
$ ./autogen.sh
$ ./configure
$ make
$ sudo make install
$ cd ..

For building PulseView:

$ git clone git://sigrok.org/pulseview
$ cd pulseview
$ cmake .
$ make
$ sudo make install
$ cd ..

For building sigrok-gtk (Note: The GTK+ GUI is not yet usable!):

$ git clone git://sigrok.org/sigrok-gtk
$ cd sigrok-gtk
$ ./autogen.sh
$ ./configure
$ make
$ sudo make install
$ cd ..

For building sigrok-qt (Note: The Qt GUI is not yet usable!):

$ git clone git://sigrok.org/sigrok-qt
$ cd sigrok-qt
$ PKG_CONFIG_PATH=/usr/local/lib/pkgconfig qmake -spec macx-g++
$ make
$ sudo make install
$ cd ..

If you get warnings claiming potential symbol conflicts when running qmake, you are likely not invoking qmake-qt4. Try running qmake-qt4 to force the correct version.

Open the sigrok-gui application just built:

$ open -a sigrok-gui.app

Notes

• To build on Snow Leopard (10.6) you need to use the Cocoa (32bit and 64bit) Qt libraries. Don't use the default download link on that page but the one you can find further down the page.
• Currently we are using macports for the libusb dependency and are relying on the fact that macports are installed in /opt/local.
• See also Wafelijzer's efforts to build Mac OS X binaries.
  • Python framework incorrect build for OS X issue 15353

TODO

• Find a sane way to bundle libusb with the sigrok.app.
• Include an icon with the app.
• Set the relative paths in the binary's and DyLibs
• Building universal DyLibs and binaries
• Bundle the dynamic libraries with MacDylibBundler

Resources

• Qt: Deploying Applications on Mac OS X
• Porting UNIX/Linux Applications to Mac OS X
• CairoGraphics - End to End build for Mac OS X
• Documentation about bundles
• Stackoverflow - Building OSX App Bundle