SOURCEFORGE » RALF

h1. RAdio Logicielle pour la Formation (RALF)

!>logo-ralf-240x148.png!

Welcome to the main wiki page of the _RAdio Logicielle pour la Formation_ (RALF) project. You will find here a complete list of the available resources and their operating procedures (hardware booking, platform access...). Documentation is also provided in order to help users in building their SDR(Sofware Defined Radio) workbench. Do not hesitate to contribute !

For general information on the project, you can also visit our website: http://websites.isae.fr/ralf.

{{toc}}

h2. Hardware resources

The project includes two types of equipments, click on the links below for a detailed inventory:

* [[light hardware]], available for loan (mainly SDR transceivers);

* [[heavy hardware]], available on the platform (rooftop antennas, signal analysers and synthetisers, desktop computers...).

h2. Documentation

h3. Text formating in SourceForge

The forge uses a markup language called _Textile_ and characterized by simple and intuitive tags.

* Official documentation with all bindings: http://www.redmine.org/projects/redmine/wiki/RedmineTextFormatting.

* Documentation on the Wiking text formating extension: http://projects.andriylesyuk.com/projects/wiking/wiki/Syntax.

* The MathJax plugin allows to interpret LaTeX source code. For example @$\sum_i x_i$@ gives $\sum_i x_i$. More documentation: https://github.com/process91/redmine_latex_mathjax 

h3. Using Git repositories in SourceForge

Every project is provided with a Git repository which is accessible at the following URL(Uniform Ressource Locator):

<pre>

https://votre_login@sourceforge.isae.fr/git/<project-id>

</pre>

where @<project-id>@ is the project identifier as it appears in the SourceForge's URL(Uniform Ressource Locator). An open course on Git handling is provided here: http://backlogtool.com/git-guide/en/intro/intro1_1.html. You can also refer to the official documentation: http://git-scm.com/doc.

h3. Setting up a GNU/Linux USRP workbench

* [[Debian Wheezy 7 installation guidelines]]

* [[Xubuntu 14.04 installation guidelines]]

* [[UHD and GNURadio installation]]

* [[USRP B200 installation notes]]

h2. Procedures

h3. Local managers

For each school participating to the project, at least one local manager has been nominated. The can make create projects on the forge, borrow equipments, book the hosted platform...

Local managers:

* Pascal Berthou (UPS);

* Daniela Dragomirescu (INSA);

* Laurent Franck (TELECOM Bretagne);

* Christophe Morlaas (ENAC);

* Damien Roque (ISAE);

* Nathalie Thomas (ENSEEIHT).

h3. Forge sub-projects

This forge allows per-project spaces providing various services such as ticket management, source versioning (Git), wiki, forums... Every RALF member is encouraged to centralize the documentation using this service. Local managers can create sub-projects under their respective branches (ENAC, ENSEEIHT, INSA, ISAE, UPS). If a you encounter an issue, please refer to the procedure available on [[Sourceforge:Submissions_on_sourceforgeisaefr|this page]].

h3. Hardware loan request

Every local manager can make an loan request using the ticket manager. The procedure is the following.

# Consult the [[light hardware]] inventory and identify the hardware needed.

# Open the ticket manager of the current project.

# Filter the tickets by status (open) and by category (loan).

# Check for the availability of the needed hardware. If it seems available, go to next step.

# Write a new ticket assigned asking for the resources with the following settings.

* A clear subject and description (type and number of equipments).

* A starting date and a end date.

* Tracker: request.

* Status: assigned.

* Assignee: Damien Roque

* Category: loan.

Once the hardware is returned, the ticket will be closed.

h3. Platform access request

Every local manager can make an booking request using the ticket manager. The procedure is the following.

# Open the ticket manager of the current project.

# Filter the tickets by status (open) and by category (platform).

# Check for the availability of the platform. If it seems available, go to next step.

# Write a new ticket assigned asking for the resources with the following settings.

* A clear subject and description (precise the number of students and the requested resources).

* A starting date and a end date.

* Tracker: request.

* Status: assigned.

* Assignee: Damien Roque

* Category: platform.

Once the hardware is returned, the ticket will be closed.