[[PageOutline]]

__NOTE__: For Flair version <= 0.2.1, see [wiki:sinus_old this page].

= Sinus demo =

This page explains how to compile and test a simple program using Flair. Moreover, this program is commented to help understand how to code with Flair. You can also read Flair's documentation [wiki:documentation page].

The program generates a sinusoidal signal and low pass filters are added. Everything can be configured through the ground control station. This demo shows how filters are added and updated, and how to draw graphs on ground control station.

__NB__: Filter and !SensorActuator libraries sources are alwo a good starting point to see how to program with Flair. Yet, they use the [http://c2.com/cgi/wiki?PimplIdiom pimpl idiom], which can be harder to read than this example.

== Compilation ==

There is various ways to compile/recompile it

=== Compile among everything (recommended) ===

Use the [source:flair-dev/trunk/scripts/flair_compile_all.sh flair_compile_all.sh] script using [wiki:compile_all this page].

All libs, tools and demos will be compiled for all supported architectures (the ones with an installed toolchain).

=== Recompile only this demo ===

If you have already done the previous step (compile among everything) and you want to just recompile this particular demo, do the following:
{{{
$ cd $FLAIR_ROOT/flair-build/build/demos/Sinus
$ make install
}}}

It will compile for x86_64 architecture. To compile for a different architecture, go to the corresponding directory, for example:
{{{
$ cd $FLAIR_ROOT/flair-build/build_armv5te/demos/Sinus
or
$ cd $FLAIR_ROOT/flair-build/build_armv7a_neon/demos/Sinus
or
$ cd $FLAIR_ROOT/flair-build/build_cortexa7thf_neon_vfpv4/demos/Sinus
}}}

Calling ''make'' compile both real time and non real time version of the demo.


== Exécution du programme sur le PC ==

=== station sol ===

{{{
$ $FLAIR_ROOT/flair-bin/tools/scripts/launch_flairgcs.sh
}}}

=== programme ===

Ouvrir un terminal et exécuter le programme via son script:
{{{
$ cd $FLAIR_ROOT/flair-src/demos/Sinus/build/bin
$ ./Sinus.sh
}}}

Ce script, comme pour la station sol, permet de lancer le programme avec un certain nombre d'arguments.

A noter que ce script détecte également la présence ou non de Xenomai afin de lancer le bon programme (temps réel ou non temps réel).

==== réglages ====

A l’exécution du programme, la station sol doit se construire et faire apparaître les réglages et les graphes.

== Exécution des programmes sur la cible ==

=== copie des fichiers sur la cible ===

A adapter en fonction de l'adresse de votre cible:
{{{
$ scp $FLAIR_ROOT/flair-src/demos/Sinus/build_arm/bin/* root@192.168.147.x:
}}}

x is the drone number, from 18 to 63.

=== exécution ===

==== coté PC (station sol) ====

{{{
$ $FLAIR_ROOT/flair-bin/tools/scripts/launch_FlairGCS.sh
}}}

==== coté cible ====

Ouvrir un terminal sur la cible et exécuter le programme via le script:
{{{
# ./Sinus.sh adresse_PC
}}}
Où ''adresse_PC'' est a remplacer par l'adresse IP de votre PC.

Ce script, comme pour la station sol, permet de lancer le programme avec un certain nombre d'arguments.

A noter que ce script détecte également la présence ou non de Xenomai afin de lancer le bon programme (temps réel ou non temps réel).

==== réglages ====

A l’exécution du programme sur la cible, la station sol doit se construire et faire apparaître les réglages et les graphes.