terbijn shared/common/magicbit.c:6:22: fatal error: g_canvas.h: No such file or directory
#include "g_canvas.h"
^

yes that's what I meant earlier. Get all the .h files from the src/ folder of this repo and copy them to your board in /usr/local/include/libpd/ then re-run the make commands.

    Excuse me but I couldn’t find that path on the board. Can you tell me where it is located or tell me which command I have to use to copy the files from my desktop there?

    Thank you!

    Now I found some time to do it (Friday night, 2am, of course).

    Preparation:
    - get extra header files needed to compile Cyclone (and ggee, and others) on Bela:
    - on your computer open a terminal and:

    git clone https://github.com/giuliomoro/pure-data &&\
cd pure-data &&\
scp src/*h root@192.168.7.2:/usr/local/include/libpd/

    - make sure that the pd-externals folder exists on Bela:

    ssh root@192.168.7.2 mkdir -p Bela/projects/pd-externals

    Now, the externals:

    Cyclone:

    • get Cyclone from Github. Go to the releases page. The latest release requires Pd 0.49, but Bela has Pd 0.48-2. So we get the v0.3, RC-1, which requires Pd 0.48-1. Here is the direct link to the source code.
    • Download the code on your computer and uncompress it by double clicking on it. This results into an pd-cyclone-cyclone0.3rc1. In my case, this is on my Desktop.
    • Open a terminal, navigate to the folder containing the pd-cyclone-cyclone0.3rc1 folder. In my case: 
      cd ~/Desktop
    • copy the folder to the board: 
      scp -r pd-cyclone-cyclone0.3rc1 root@192.168.7.2:
    • go on the board and go into the cyclone folder we just copied: 
      ssh root@192.168.7.2 
cd pd-cyclone-cyclone0.3rc1/
    • compile Cyclone. The README says that Cyclone uses the pd-lib-builder building system. The provided documentation for pd-lib-builder says that you should invoke make by passing the path to the folder containing the Pd includes (in our case, the /usr/local/include/libpd path we copied the .h files to earlier on). This may take 10 minutes or so to run, and print some warnings, but all should be fine in the end: 
      make PDINCLUDEDIR=/usr/local/include/libpd
    • once this is successful, you can install the externals. These go in the ~/Bela/projects/pd-externalsfolder we created earlier, and in order to tell pd-lib-builder about it is to set PDLIBDIR when calling make install: 
      make PDLIBDIR=/root/Bela/projects/pd-externals install
    • now if you look into the destination folder you will see all the externals (with extension .pd_linux): 
       ls ~/Bela/projects/pd-externals/cyclone
    • great, test it: open the IDE, create a Pd project, upload a patch like this one:

    alt text

    It works!

    Ggee:

    • I struggled to locate the most up-to-date source code. On my computer, Deken shows that there is a v0.27 version, but I cannot find that online, so I go for the v0.26 available via Sourceforge through the Pd website: https://sourceforge.net/projects/pure-data/files/libraries/ggee/ggee-0.26.tar.gz/download
    • download that file, unzip it on your computer by clicking it. This results into a ggee-0.26 folder. In my case, this is on my Desktop.
    • Open a terminal, navigate to the folder containing the ggee-0.26 folder. In my case: 
      cd ~/Desktop
    • copy the folder to the board: 
      scp -r ggee-0.26 root@192.168.7.2:
    • go on the board and go into the cyclone folder we just copied: 
      ssh root@192.168.7.2 
cd ggee-0.26
    • compile ggee. The README does not say much about compiling, so we inspect the Makefile and find that the path to the folder containing the Pd headers is given as the PD_INCLUDE variable. 
      make PD_INCLUDE=/usr/local/include/libpd
    • however, the above command fails: 
      root@bela:~/ggee-0.26# make PD_INCLUDE=/usr/local/include/libpd
cc -DPD -I. -I"/usr/local/include/libpd"/pd -Wall -W -g -DVERSION='"0.26"' -fPIC -O6 -funroll-loops -fomit-frame-pointer -o "control/constant.o" -c "control/constant.c"
control/constant.c:4:18: fatal error: m_pd.h: No such file or directory
 #include <m_pd.h>
                  ^
compilation terminated.
Makefile:165: recipe for target 'control/constant.o' failed
make: *** [control/constant.o] Error 1
    • we inspect the error message and notice there that the path provided by -I in the compiler parameters is not, as we expected "/usr/local/include/libpd", but rather it is "/usr/local/include/libpd"/pd. Further inspecting the Makefile we find the line CFLAGS = -DPD -I. -I"$(PD_INCLUDE)"/pd -Wall -W -g, and that is the only place where the PD_INCLUDE variable is used. So instead of passing PD_INCLUDE=, we can pass all the options passed by CFLAGS=, replacing the -I parameter with the correct one. Additionally, we can add some optimization flags here: 
      make CFLAGS="-DPD -I. -I"/usr/local/include/libpd" -Wall -W -g -DVERSION='"0.26"' -fPIC -O6 -funroll-loops -fomit-frame-pointer -march=armv7-a -mtune=cortex-a8 -mfloat-abi=hard -mfpu=neon -ftree-vectorize -ffast-math"
    • now install. Further exploring the Makefile we find that pkglibdir= tells make where to install the externals, so: 
      make install pkglibdir=/root/Bela/projects/pd-externals
    • now if you look into the destination folder you will see all the externals (with extension .pd_linux): 
       ls ~/Bela/projects/pd-externals/ggee
    • great, test it: open the IDE, create a Pd project, upload a patch like this one:

    alt text

    It works!

    As you can see, there is no hard and fast rule for building externals, though many use pd-lib-builder and therefore will be installed the same way as cyclone. Some others have some different Makefiles, but it's often fairly straightforward to observe the error, inspect the Makefile and figure out what variable needs to be set.

      giuliomoro,

      this is amazingly helpful, thank you so much, I managed to get Cyclone working, hurray!

      Unfortunately, I ran into an unexpected error with Ggee. When

      make PD_INCLUDE=/usr/local/include/libpd

      I got this:

      cc -DPD -I. -I"/usr/local/include/libpd"/pd -Wall -W -g -DVERSION='"0.26"' -fPIC -O6 -funroll-loops -fomit-frame-pointer -o "control/constant.o" -c "control/constant.c"
      control/constant.c:4:18: fatal error: m_pd.h: No such file or directory
      #include <m_pd.h>
      ^
      compilation terminated.
      Makefile:165: recipe for target 'control/constant.o' failed
      make: *** [control/constant.o] Error 1

      I know, the 'm_pd.h' case has been discussed before but I don't know how to solve it here. Could you please help me?

      Thank you so much for your time!

      sorry I had left a couple of bullet points in there that I copied/pasted from the cyclone section, fixed now

      Thank you. I hate to say it but I still cannot get it to work:

      root@bela:~/ggee-0.26# make CFLAGS="-DPD -I. -I"/usr/local/include/libpd"/pd -Wall -W -g -DVERSION='"0.26"' -fPIC -O6 -funroll-loops -fomit-frame-pointer -march=armv7-a -mtune=cortex-a8 -mfloat-abi=hard -mfpu=neon -ftree-vectorize -ffast-math"
      cc -DPD -I. -I/usr/local/include/libpd/pd -Wall -W -g -DVERSION='0.26' -fPIC -O6 -funroll-loops -fomit-frame-pointer -march=armv7-a -mtune=cortex-a8 -mfloat-abi=hard -mfpu=neon -ftree-vectorize -ffast-math -o "control/constant.o" -c "control/constant.c"
      control/constant.c:4:18: fatal error: m_pd.h: No such file or directory
      #include <m_pd.h>
      ^
      compilation terminated.
      Makefile:165: recipe for target 'control/constant.o' failed
      make: *** [control/constant.o] Error 1

      If I had an idea where to start figuring it out, I would...

      Thank you!

      I don't know how I left another typo in there, fixed again.

      giuliomoro,

      thank you so much for your time, help and patience with people who are as clueless as I am! It works and I am really happy!

      6 months later

      I feel quite efficient at Pd patching, but no real coding skills whatsoever (apart from basic arduino and processing coding). So I find it all terribly puzzling.

      I need to install the Helmholtz~ external http://www.katjaas.nl/helmholtz/helmholtz.html#download
      What I managed to do so far is that I created the Bela/projects/pd-externals/ with basic linux commands in the ide. The pd-externals also appears in a "project explorer" in the ide. What am I supposed to do now? I know I should build the projec on bela, but what exactly does it mean, step by step? Should I run the "Makefile" from the ide command line?

      I know most of this stuff is not a rocket science for people with coding and linux experience, but for someone like me who is just patching stuff in pd, max, reaktor and such, this is really puzzling...

      Here is how I compiled helmoltz~. As mentioned earlier, there is no standard way of compiling externals, and each and everyone of them will probably require inspecting the Makefile at some point to get it to build.

      Steps:
      - get the source code and copy it to the board:

      scp -r helmoltz~ root@192.168.7.2:

      - ssh to the board and navigate to the helmoltz~ folder:

      ssh root@192.168.7.2
cd helmoltz~
      • inspect the files in the folder:
        • There are several pre-built externals in the folder, let's get rid of those manually: 
          rm helmholtz~.dll helmholtz~.pd_* src/helmholtz~.pd_darwin
        • There is a file in src/include/m_pd.h which is the pd include. However, we should not compile against this (which - according to the docs - is from Pd0.42), but against the one that is installed on our board. So, first off let's delete this: 
          src/include/m_pd.h
      • navigate to the src/ folder where there is a Makefile: 
        cd src
      • for good measure, run make clean to get rid of any leftover pre-built files
      • try to run make and see if/how it fails 
        root@bela:~/helmholtz~/src# make
g++ -DPD -O3 -Wall -W -Wshadow -Wno-unused -Wno-parentheses -Wno-switch -fcheck-new -fvisibility=hidden -I ./include	 -c *.cpp
g++ -bundle -undefined suppress -flat_namespace -o helmholtz~.pd_darwin *.o
g++: error: suppress: No such file or directory
g++: error: unrecognized command line option ‘-bundle’; did you mean ‘-Wundef’?
g++: error: unrecognized command line option ‘-flat_namespace’; did you mean ‘-Wnamespaces’?
Makefile:44: recipe for target 'helmholtz~.pd_darwin' failed
        So it seems it is trying to build a helmholtz~.pd_darwin external, which would be for macos. We need to rectify this. Open Makefile in your favourite text editor, and you will see the first target (which is the default target) is: 
        current: pd_darwin
        Scroll down and you will see that there is a target called pd_linux.
        So the next thing to try is to run make with that target: 
        root@bela:~/helmholtz~/src# make pd_linux
g++ -msse -DPD -DUNIX -DICECAST -O3 -funroll-loops -fomit-frame-pointer -fcheck-new -fPIC -Wall -W -Wshadow -Wno-unused -Wno-parentheses -Wno-switch -fvisibility=hidden -I ./include -c *.cpp
g++: error: unrecognized command line option ‘-msse’; did you mean ‘-fdse’?
Makefile:23: recipe for target 'helmholtz~.pd_linux' failed
make: *** [helmholtz~.pd_linux] Error 1
        The error her is that it is trying to use -msse, which instructs the compiler to use the sse instructions, but these are only available on Intel CPUs. So open the Makefile again, and see where these are defined: 
        LINUXCFLAGS = -msse -DPD -DUNIX -DICECAST -O3 -funroll-loops -fomit-frame-pointer -fcheck-new -fPIC\
    -Wall -W -Wshadow \
    -Wno-unused -Wno-parentheses -Wno-switch -fvisibility=hidden
        Now, with make, the internal variables can be overridden from the command-line, without editing the Makefile, so we can use this feature to remove the -msse option. Inspecting the current list of options, we see that many of those (those starting with -W) refer to warnings, so we can just remove them. While we are at it, we can add in the standard Bela optimization options (which can be found in ~/Bela/Makefile): -O3 -march=armv7-a -mtune=cortex-a8 -mfloat-abi=hard -mfpu=neon -ftree-vectorize -ffast-math. Let's not remove the -D options (which define flags that are used by the code).
        The resulting LINUXCFLAGS variable should then contain: -DPD -DUNIX -DICECAST -O3 -funroll-loops -fomit-frame-pointer -fcheck-new -fPIC -fvisibility=hidden -march=armv7-a -mtune=cortex-a8 -mfloat-abi=hard -mfpu=neon -ftree-vectorize -ffast-math. We can therefore execute the following command:
      make pd_linux LINUXCFLAGS="-DPD -DUNIX -DICECAST -O3 -funroll-loops -fomit-frame-pointer -fcheck-new -fPIC -fvisibility=hidden -march=armv7-a -mtune=cortex-a8 -mfloat-abi=hard -mfpu=neon -ftree-vectorize -ffast-math"

      This fails like this:

      In file included from Helmholtz.cpp:14:0:
./include/Helmholtz.h:53:18: fatal error: m_pd.h: No such file or directory
 #include "m_pd.h"
                  ^
compilation terminated.
helmholtz~.cpp:12:18: fatal error: m_pd.h: No such file or directory
 #include "m_pd.h"
                  ^
compilation terminated.
Makefile:23: recipe for target 'helmholtz~.pd_linux' failed
make: *** [helmholtz~.pd_linux] Error 1

      This means that we need to tell make where to find our m_pd.h file. This is in /usr/local/include/libpd. We can simply add -I/usr/local/include/libpd to the LINUXCFLAGS:

      make pd_linux   LINUXCFLAGS="-DPD -DUNIX -DICECAST -O3 -funroll-loops -fomit-frame-pointer -fcheck-new -fPIC -fvisibility=hidden -march=armv7-a -mtune=cortex-a8 -mfloat-abi=hard -mfpu=neon -ftree-vectorize -ffast-math -I/usr/local/include/libpd"

      This produces the following output:

      g++ -DPD -DUNIX -DICECAST -O3 -funroll-loops -fomit-frame-pointer -fcheck-new -fPIC -fvisibility=hidden -march=armv7-a -mtune=cortex-a8 -mfloat-abi=hard -mfpu=neon -ftree-vectorize -ffast-math -I/usr/local/include/libpd -I ./include -c *.cpp
g++ -Wl -export-dynamic -shared -o helmholtz~.pd_linux *.o -lc -lm -lstdc++
g++: error: unrecognized command line option ‘-Wl’; did you mean ‘-W’?
Makefile:23: recipe for target 'helmholtz~.pd_linux' failed
make: *** [helmholtz~.pd_linux] Error 1

      The first line is the compiling step and it actually works ok. The second line is the linking stage and it fails because of the -Wl option. Not sure here what the original developer meant by that. Options starting with -Wl, normally contain flags to be passed to the linker, but this one is incomplete, so we can just remove it. Inspecting the Makefile once more, we see that the -Wl option is actually hardcoded in the recipe for pd_linux:, so we cannot override it from the command line and we have to delete it manually from the Makefile. Once that is done, we can re-run the command above and this time we obtain:

      g++ -DPD -DUNIX -DICECAST -O3 -funroll-loops -fomit-frame-pointer -fcheck-new -fPIC -fvisibility=hidden -march=armv7-a -mtune=cortex-a8 -mfloat-abi=hard -mfpu=neon -ftree-vectorize -ffast-math -I/usr/local/include/libpd -I ./include -c *.cpp
g++ -export-dynamic -shared -o helmholtz~.pd_linux *.o -lc -lm -lstdc++
rm -f *.o ../helmholtz~.pd_linux
cp helmholtz~.pd_linux ../helmholtz~.pd_linux

      Success! The generated file is in ~/helmholtz~/src/helmholtz~.pd_linux, and also it is copied in /root/helmholtz~/helmholtz~.pd_linux. We now can copy this file to ~/Bela/projects/pd-externals, after creating the folder (in case it doesn't exist):

      mkdir -p ~/Bela/projects/pd-externals
cp ~/helmholtz~/src/helmholtz~.pd_linux ~/Bela/projects/pd-externals/
        3 months later

        i thought i'd just pin my own problems onto this thread..
        trying to install the HCS library.

        i'm following your steps.. so i got the extra header files. done.
        created the pd-externals folder. done.
        got HCS-0.1 folder, copied it to the board.

        when i tried invoking make, i got this:

        alt text

        which to me is very much like a menu from a chinese restaurant. in chinese. in china.
        anybody that has succesfully installed that library, by any chance?

        It may mean that the external requires a more recent version off Pd than the one that is installed (0.48-2). What does the README say about it? Also, provide a link to the repo pleaee

        hmm, i seem to have a mac os version installed on my laptop - one with .pd_darwin files, not .c files like in that download link. the mac folder doesn't contain a MakeFile.
        i'm quite sure that one was installed (or at least downloaded) with Deken.

        See if on deken there is an ARMv7 build available, or source code. I will not be able to look at this before thursday.

        Success! i think.

        okay, so i had a closer look at that log file..
        'classpath.c', causing the error, is an object from the library i don't need.
        so i removed that from the sources in the Makefile.

        tried the whole thing again.
        i ended up removing the [classpath] and [helppath] objects, since they both messed up the Make process.
        it looks like that did the trick - all the others are showing up in the externals project/folder in the IDE now!

        kinda eager to test, but need to sleep. tomorrow!

        hmm.
        the [folder_list] object i'm using still gives me an error when i try to run the patch on bela.
        IDE says:
        Jan 07 23:22:48 bela stdbuf[747]: folder_list
        Jan 07 23:22:48 bela stdbuf[747]: error: ... couldn't create
        Jan 07 23:22:48 bela stdbuf[747]: verbose(4): ... you might be able to track this down from the Find menu.

        do i still need to explicitly use [declare] (or similar) for bela to use the libraries in the externals folder?
        or is there still something not right with the install?

        Where are the externals located? If they are in the project folder or in /root/Bela/projects/pd-externals then they should be detected automatically. If this is a single-file library, then you may have to manually load the library ( I think [declare] is the right object

        they are in pd_externals/hcs.
        i guess i need to specify that subfolder as a path? and if so, how?