How To Build and Deploy LV2 Plugin to MOD Duo

From MOD Wiki
Revision as of 17:27, 6 May 2016 by Alercunha (talk | contribs)
Jump to navigation Jump to search

Introduction

This is a quick start guide to get a LV2 plugin running in a MOD Duo Device. Let's cut the chatter and get started.

LV2 Basics

This information is well described elsewhere.

Prepare build tools

A LV2 plugin is just a binary. However in order to run in a MOD Device it must be compiled using a cross-compiler targeting our hardware and software. MOD Duo for example uses an ARM processor running a special flavor of Linux containing a specific set of libraries (dependencies).

We currently provide a custom cross-compiler that will take care of building LV2 plugins that will run in a MOD Duo. Just clone MOD Plugin Builder and follow the instructions.

In summary:

$ cd
$ git clone https://github.com/moddevices/mod-plugin-builder
$ ./bootstrap.sh

Once the process is finished you should have local binary called build.

Get source code and create a .mk file

If you have an existing LV2 Plugin you just need to create a .mk file that will be used to build it. In case you haven't started your LV2 plugin yet just follow through the links above from #LV2 Basics.

We have a few samples available here. For this guide we'll use the eg-amp.lv2 example.

The build script is based on Buildroot which requires you to create a new package under plugins/package/ and add a make file <plugin-name>.mk.

$ cd
$ git clone git://github.com/moddevices/mod-lv2-examples
$ cp -R mod-lv2-examples/package/eg-amp-lv2 mod-plugin-builder/plugins/package/

Compile it

We're all set to compile.

$ cd ~/mod-plugin-builder/
$ ./build eg-amp-lv2

Deploy it

Publish it