[[PageOutline]]

= 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
{{{
#!sh
# 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:
 * codeblocks (all Fl-AIR documentation is based on it):
{{{
sudo apt-get install codeblocks codeblocks-contrib
}}}
 * or eclipse:
{{{
sudo apt-get install eclipse-cdt
}}}

__NB__: last codeblocks version has problems with cmake and the code completion plugin. Thus it is recommended to install an older version manually (see next section).

== 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 [http://sourceforge.net/projects/codeblocks/files/Binaries/10.05/ 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) ==

__NB__: recent distros (ubunutu 16.4 or mint 18) seem to have a different bluetooth configuration; and dualshock3 in bluetooth is no longer functioning. Use USB connection instead.

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:
{{{
$ 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 
}}}