Skip to content

A library and example application for low-level communication with the Madrona Labs Soundplane.

Notifications You must be signed in to change notification settings

madronalabs/soundplanelib

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Soundplanelib

Low-level support and and example application for the Madrona Labs Soundplane.

Copyright (c) 2019-2021 Madrona Labs LLC. http://www.madronalabs.com

Distributed under the MIT license: http://madrona-labs.mit-license.org/

Building

OS X

To compile this project, the Xcode Command Line Tools and CMake are required. Xcode Command Line Tools can be downloaded and installed from the "Downloads" tab in Xcode's settings. An easy way of installing CMake is to do it via Homebrew: With Homebrew installed, type brew install cmake in a terminal.

In order to prepare the build, the following commands can be used.

$ mkdir build
$ cd build
$ cmake -GXcode ..

At this point, there is an Xcode project soundplanelib.xcodeproj ready for coding and compiling in build/. If you just want to build the example application and run it from the comfort of the terminal, these commands can be used:

$ xcodebuild -project soundplanelib.xcodeproj -target helloSoundplane -configuration Debug
$ open examples/Debug/helloSoundplane

To install soundplanelib.a and the headers for use in other applications, run the install target from the build directory:

$ xcodebuild -project soundplanelib.xcodeproj -target install

All of the XCode targets can also be run from the XCode GUI app.

Either the Apple IOKit driver or the libusb library can be used. To enable a libusb build, first install libusb and then add the option -DSP_USE_LIBUSB=ON to the cmake command. This can be done using Homebrew:

$ brew install libusb
$ cmake -DSP_USE_LIBUSB=ON -GXcode ..

Linux

On Linux, the libusb library is used for USB communications. On Ubuntu/Debian the following command should install it:

$ sudo apt-get install cmake libusb-1.0.0-dev

In order to fetch source dependencies and build, the following commands can be used (in a terminal)

$ mkdir build
$ cd build
$ cmake ..
$ make

On Linux, the Soundplane application typically uses udev to access Soundplane via USB. On most stock Linux installations, the default configuration is to block non-superuser access to the Soundplane. In order to allow the Soundplane application to access the device, add a udev rule that allows it:

$ sudo cp Data/59-soundplane.rules /etc/udev/rules.d/
$ sudo udevadm control --reload-rules

The app can now be run with

$ examples/helloSoundplane

Packaging

If desired, it is possible to build a Debian package with the command

$ make package

The Debian package will install udev rules outline above in addition to header and library files.

Tested Configurations

Tested on:

OS Arch Driver Compiler
macOS Mojave (10.14) x86_64 IOKit clang 11.0.0
macOS Mojave (10.14) x84_64 libusb-1.0 (installed via homebrew) clang 11.0.0
Debian Buster x86_64 libusb-1.0 gcc 8.3.0
Raspbian ~Stretch rpi3+/rpi4 armhf libusb-1.0 gcc 6.3.0

About

A library and example application for low-level communication with the Madrona Labs Soundplane.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages