Ce tutoriel présente l'installation d'openFrameworks 0.12.0 sur une RaspberryPi 4. Il se base sur celui fourni sur openFrameworks.

Avant de commencer, il est nécessaire d'installer et de configurer sa Raspberry Pi avec la dernière version de Raspberry Pi OS (64-bit) Lite.

Ces commandes vont télécharger et décompresser l'archive dans le répertoire /home/pi/openFrameworks Il faut télécharger la version aarch64 d'openFrameworks pour un système en 64 bits.

cd
wget https://github.com/openframeworks/openFrameworks/releases/download/0.12.1/of_v0.12.1_linuxaarch64_release.tar.gz
mkdir openFrameworks
tar vxfz of_v0.12.1_linuxaarch64_release.tar.gz -C openFrameworks --strip-components 1

Des librairies supplémentaires sont nécessaires pour pouvoir compiler correctement OpenFrameworks.

cd /home/pi/openFrameworks/scripts/linux/debian
sudo ./install_dependencies.sh

Pour une Raspberry 4 il faut installer le système de fenêtrage X11 :

sudo apt-get install xorg

Enfin compiler openFrameworks avec :

make Release -C /home/pi/openFrameworks/libs/openFrameworksCompiled/project

cd /home/pi/openFrameworks/examples/graphics/polygonExample
make

Pour une RPI4 cette commande vous permet d'exécuterer l'exemple dans une fenêtre de X11.

startx ./bin/polygonExample -- -s off

Pour commencer un projet, il faut copier la structure d'un projet vide dans un nouveau répertoire.

cp -R /home/pi/openFrameworks/apps/myApps/emptyExample /home/pi/openFrameworks/apps/myApps/premierProjet
cd /home/pi/openFrameworks/apps/myApps/premierProjet
make
startx ./bin/premierProjet -- -s off

Il faut garder en mémoire que le répertoire de l'application doit être un sous-réperoire d'un sous-répertoire du répertoire openFrameworks.

Si vous utilisez des addons, il faut indiquer au compilateur lesquels. Pour cela il faut modifier le fichier addons.make. S'il n'existe pas il sera créé. Il faut le placer dans le répertoire de votre projet au même niveau que config.make :

cd /home/pi/openFrameworks/apps/myApps/premierProjet
sudo nano addons.make

Ajoutez le nom des addons que vous souhaitez utiliser par exemple :

ofxXmlSettings
ofxOsc

Puis ctrl-O pour sauvegarder en validant, puis ctrl-x pour quitter.

La bibliothèque wiringPi est idéale pour gérer le GPIO avec OpenFrameworks.

Afin d'obtenir la librairie, taper :

cd
wget https://github.com/WiringPi/WiringPi/releases/download/3.10/wiringpi_3.10_arm64.deb

Ensuite installer la librairie :

sudo apt install ./wiringpi_3.10_arm64.deb

Pour tester que tout fonctionne bien :

gpio -v
gpio readall

La liste des fonctionnalités est disponible sur le site du dévellopeur.

Il est nécessaire d'indiquer au compilateur la présence de la librairie wiringPi. Pour cela, il faut éditer le fichier config.make de l'application en cours de développement :

sudo nano config.make

et ajouter la dernière ligne dans les PROJECT LINKER FLAGS :

################################################################################
# PROJECT LINKER FLAGS
#       These flags will be sent to the linker when compiling the executable.
#
#               (default) PROJECT_LDFLAGS = -Wl,-rpath=./libs
#
#   Note: Leave a leading space when adding list items with the += operator
#
# Currently, shared libraries that are needed are copied to the
# $(PROJECT_ROOT)/bin/libs directory.  The following LDFLAGS tell the linker to
# add a runtime path to search for those shared libraries, since they aren't
# incorporated directly into the final executable application binary.
################################################################################
#PROJECT_LDFLAGS=-Wl,-rpath=./libs
PROJECT_LDFLAGS += -lwiringPi

Ctrl-o pour sauvegarder et Ctrl-x pour quitter

Pour utiliser le port série du GPIO il est nécessaire de désactiver la console série.

Ouvrir le fichier bashrc

sudo nano /home/pi/.bashrc

Se positionner tout à la fin et copier les lignes suivantes :

#  startx if it isn't already running
XPID=`/usr/bin/pgrep Xorg`
if  [[ -z $XPID ]]
then
  cd openFrameworks/apps/myApps/Dialogues
  startx ./bin/Dialogues -- -s off
fi

Puis ctrl-O pour sauvegarder en validant, puis ctrl-x pour quitter.

Le programme lancé se nomme Dialogues