History

RAdio Logicielle pour la Formation (RALF)

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

For general information on the project, you can also visit our website.

Hardware resources

The project includes two types of equipments: light hardware (available for loan) and heavy hardware (available at onsite, at Supaero campus).

Getting started

Using and installing your hardware Running examples

Using the forge

Text formating in SourceForge

The forge uses a markup language called Textile and characterized by simple and intuitive tags.
  • Official documentation with all bindings.
  • Documentation on the Wiking text formating extension.
  • The MathJax plugin allows to interpret LaTeX source code. For example $\sum_i x_i$ gives $\sum_i x_i$. More documentation here.

Using Git repositories in SourceForge

Every project is provided with a Git repository which is accessible at the following URL:

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

where <project-id> is the project identifier as it appears in the SourceForge's URL.

For further documentation, a tutorial on Git handling is provided here or there. You can also refer to the official documentation.

Procedures and good practices

Local managers

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

Local managers:
  • Pascal Berthou (UPS);
  • Daniela Dragomirescu (INSA);
  • Christophe Morlaas (ENAC);
  • Damien Roque (ISAE);
  • Nathalie Thomas (ENSEEIHT).

Forge sub-projects creation and use

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]]. See below for a list of recommendations.

  • Authorized languages for your projects are English (preferred) and French (do not mix both).
  • Use UTF-8 encoding for text files.
  • Define and respect a naming convention for enclosed files (with no spaces, no capital letters, no accents...).
  • Write precise tickets for small pieces of work.
  • Try to adopt a clear structure in you Wiki.
  • Do not include the following files in your source code repository: results from compilation process, temporary, huge binary files.

Hardware loan request

Every local manager can make an loan request using the ticket manager. The procedure is the following.
  1. Check for the availability of the needed hardware: see the inventory above as well as the ticket manager (use custom report "current hardware loans").
  2. Write a new ticket 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.

Platform access request

Every local manager can make an booking request using the ticket manager. The procedure is the following.
  1. Check for the availability of the platform: see the ticket manager (use custom report "current platform reservations").
  2. 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.