Setup your computer

Fl-AIR directory

It is advised to put all Fl-AIR related stuffs in the same directory, for example $HOME/flair:

$ mkdir $HOME/flair

Then add an environment variable to your .bashrc with the path of this directory:

$ nano ~/.bashrc

and add

# variable for Fl-AIR
export FLAIR_ROOT=$HOME/flair

reload the script

$ source ~/.bashrc

All Fl-AIR documentation, scripts and CMakeLists.txt will use this variable.

Install packages

Install an optional IDE (Integrated Development Environment), for example:

• CodeLite (all Fl-AIR documentation is based on it):
  • Download the version corresponding to your OS : ​https://downloads.codelite.org/
  • If the downloaded file is .deb, run:

    sudo opkg install filename.deb
    

• or eclipse:

  sudo apt-get install eclipse-cdt
  

• or codeblocks (depreciated because of cmake and code completion problems, see next section if you want to use CodeBlocks):

  sudo apt-get install codeblocks codeblocks-contrib
  

Codeblocks

if Codeblocks is slow or crashes

It seems that auto completion plugin of Codeblocks (version 12.11 and up) does not work very well with a cmake generated project. One solution is to deactivate this plugin, another solution is to install an older version of Codeblocks (10.05), from ​this page. For example on a 64 bits computer:

$ cd
$ wget http://sourceforge.net/projects/codeblocks/files/Binaries/10.05/Linux%20%2864%20bit%29/codeblocks-10.05-1-debian-amd64.tar.bz2
$ tar -xjf codeblocks-10.05-1-debian-amd64.tar.bz2
$ cd amd64
$ sudo dpkg -i *.deb
$ cd ..
$ rm -rf amd64 codeblocks-10.05-1-debian-amd64.tar.bz2

environment variables

When Codeblocks is not launched from command line, it does not read environment variables set in .bashrc. This can make trouble when a CMakelists.txt is modified for example.

To solve this, go to settings/environment menu. Choose environment variables section on the left. Clic on Add and fill the form:

• key: FLAIR_ROOT
• value: path to the FLAIR_ROOT directory

Use rtprio

In order to use FL-AIR without Xenoami, but with high priorities, you need to be root or to allow your user using the following file:

$ sudo nano /etc/security/limits.conf

And add these lines:

your_user		soft	rtprio		99
your_user               hard    rtprio          99

where your_user is your user login. Then logout and login.

Setup bluetooth for DualShock3 controller (optional)

L'utilisation du bluetooth pour la manette n'est pas conventionnelle. Il faut donc faire une modification sur le service bluetooth de Linux. Cette opération n'est à faire qu'une seule fois pour toute.

On newer distros (ubuntu >=16.4 or mint>=18)

$ sudo nano /etc/systemd/system/bluetooth.target.wants/bluetooth.service

And modify the ExecStart value:

ExecStart=/usr/lib/bluetooth/bluetoothd --noplugin=input

Then restart the dameon bluetoothd:

$ sudo systemctl daemon-reload
$ sudo service bluetooth restart 

On older distros

$ sudo nano /etc/bluetooth/main.conf

et ajouter input à la directive DisablePlugins:

[General]
# List of plugins that should not be loaded on bluetoothd startup
DisablePlugins = network,input

Puis redémarrer bluetoothd:

$ sudo service bluetooth restart