Cours:Elen4 TNS TP TpsReel : Différence entre versions
(→Fichier passetout_impl.cc) |
|||
Ligne 178 : | Ligne 178 : | ||
using output_type = float; | using output_type = float; | ||
</source> | </source> | ||
+ | {{Todos| On spécifie ici le type des données d'entrée et de sortie. Pas de modification à apporter, il suffit de supprimer les deux <code>#pragma</code>}} | ||
+ | |||
+ | <source lang=cpp> | ||
+ | passetout_impl::passetout_impl() | ||
+ | : gr::sync_block("passetout", | ||
+ | gr::io_signature::make( | ||
+ | 1 /* min inputs */, 1 /* max inputs */, sizeof(input_type)), | ||
+ | gr::io_signature::make( | ||
+ | 1 /* min outputs */, 1 /*max outputs */, sizeof(output_type))) | ||
+ | { | ||
+ | } | ||
+ | </source> | ||
+ | |||
+ | {{Todos| On spécifie ici le nombre d'entrée (1) et le nombre de sorties (1). Pas de modification non plus.}} | ||
+ | |||
+ | {{Todos| Expliquez la syntaxe <code>passetout_impl::passetout_impl() : gr::sync_block(...)"</code> }} | ||
+ | |||
+ | <source lang=cpp> | ||
+ | int passetout_impl::work(int noutput_items, | ||
+ | gr_vector_const_void_star& input_items, | ||
+ | gr_vector_void_star& output_items) | ||
+ | { | ||
+ | auto in = static_cast<const input_type*>(input_items[0]); | ||
+ | auto out = static_cast<output_type*>(output_items[0]); | ||
+ | |||
+ | #pragma message("Implement the signal processing in your block and remove this warning") | ||
+ | // Do <+signal processing+> | ||
+ | |||
+ | // Tell runtime system how many output items we produced. | ||
+ | return noutput_items; | ||
+ | } | ||
+ | </source> | ||
+ | * <code>in</code> et <code>out</code> contiennent respectivement les données en entrée et les données en sortie. Il faut donc calculer <code>out</code> en fonction de <code>in</code> | ||
+ | * Les données d'entrée arrivent par paquets dans un buffer. La variable <code>noutput_items</code> contient le nombre de données disponibles en entrées. | ||
+ | * à la fin de la méthode, on renvoie le nombre de données en sortie que l'on a calculé (entre 1 et <code>noutput_items</code>). Les données d'entrées éventuellement non consommées seront conservées dans le buffer. | ||
===== Fichier <code>monModule_passetout.block.yml</code> ===== | ===== Fichier <code>monModule_passetout.block.yml</code> ===== |
Version du 27 mars 2023 à 14:39
TP6 : Temps réel : Codage d'un bloc en C++ / démodulation et PID numérique
Le but de ce TP est ...
Codage de bloc Gnuradio en c++
Première partie - guide de création d'un bloc en C++
Ce guide est inspirée du guide Creating an OOT (C++ block example) en l'adaptant pour nos besoins :
Nous allons créer un simple bloc qui recopie son entrée (en float
) sur sa sortie. Donc le filtre caractérisé par y(n) = x(n) ou encore H(z)=1. Il s'agit donc d'une sorte de filtre passe-tout.
Suivez bien toutes les étapes, sans aller trop rapidement
Création d'un module externe
Dans les lignes qui suivent, le $
indique que l'on saisi une commande dans un terminal. Le $
n'est pas à saisir.
- Ouvrez un terminal et placez-vous à la racine de votre dossier personnel :
$ cd $HOME
- Créez un dossier de travail dédié à gnuradio et déplacez-vous à l'intérieur :
$ mkdir gnuradio
$ cd gnuradio
- GNU Radio est livré avec gr_modtool, un utilitaire qui permet de créer des modules externes (OOT). Créons un module
monModule
$ gr_modtool newmod monModule
- Le dossier
gr-monModule
est créé et contient tout le code squelette d'un module OOT, mais il n'a pas encore de blocs. Déplacez-vous dansgr-monModule
:
$ cd gr-monModule
- Vous pouvez afficher le contenu de ce dossier par
$ ls
Création d'un bloc dans ce module
- Ajoutez un nouveau bloc nommé
passetout
:
$ gr_modtool add passetout
- Quelques questions permettent alors de spécifier le type de bloc
GNU Radio module name identified: passetout
('sink', 'source', 'sync', 'decimator', 'interpolator', 'general', 'tagged_stream', 'hier', 'noblock')
Saisissez sync
comme type de bloc, car le bloc que nous écrivons produira le même nombre d'échantillons en sortie que le nombre d'échantillons consommés depuis l'entrée.
Enter block type: sync
- Spécifiez
cpp
comme langage :
Language (python/cpp): cpp
Language: C++
Block/code identifier: passetout
- Spécifiez un nom pour le copyright :
Please specify the copyright holder: Bibi
- Il est possible de spécifier des paramètres d'entrée qui peuvent permettre de régler le fonctionnement du bloc. Ce ne sera pas notre cas, ne rien saisir sur cette question :
Enter valid argument list, including default arguments:
- De même, on ne donnera pas de code permettant de tester le bon fonctionnement :
Add Python QA code? [Y/n] n
Add C++ QA code? [Y/n] n
- Plusieurs fichers sont alors crées :
Adding file 'lib/passetout_impl.h'...
Adding file 'lib/passetout_impl.cc'...
Adding file 'include/gnuradio/monModule/passetout.h'...
Adding file 'python/monModule/bindings/docstrings/passetout_pydoc_template.h'...
Adding file 'python/monModule/bindings/passetout_python.cc'...
Adding file 'grc/monModule_passetout.block.yml'...
Editing grc/CMakeLists.txt...
Quelques indications :
- le fichier
passetout_impl.h
contient l'entête de la classe de notre bloc - le fichier
passetout_impl.cc
contient l'implémentation de la classe de notre bloc - le fichier
monModule_passetout.block.yml
va contenir des informations faisant le lien entre notre code c++ et le code python utilisé en interne par Gnuradio - Le tout sera compilé par un
Makefile
généré parcmake
.
Fichier passetout_impl.h
Le code utile généré est le suivant :
class passetout_impl : public passetout
{
private:
// Nothing to declare in this block.
public:
passetout_impl();
~passetout_impl();
// Where all the action really happens
int work(int noutput_items,
gr_vector_const_void_star& input_items,
gr_vector_void_star& output_items);
};
Pour se réveiller les neurones sur la POO, qu'est-ce que sont
-
passetout_impl()
, -
~passetout_impl()
, -
private
,public
?
Le travail sera réalisé dans la méthode work()
, mais nous n'avons pas de modification à apporter dans les déclarations par défaut.
Fichier passetout_impl.cc
Le code utile généré est le suivant :
passetout_impl.cc
namespace monModule {
#pragma message("set the following appropriately and remove this warning")
using input_type = float;
#pragma message("set the following appropriately and remove this warning")
using output_type = float;
passetout::sptr passetout::make() { return gnuradio::make_block_sptr<passetout_impl>(); }
/*
* The private constructor
*/
passetout_impl::passetout_impl()
: gr::sync_block("passetout",
gr::io_signature::make(
1 /* min inputs */, 1 /* max inputs */, sizeof(input_type)),
gr::io_signature::make(
1 /* min outputs */, 1 /*max outputs */, sizeof(output_type)))
{
}
/*
* Our virtual destructor.
*/
passetout_impl::~passetout_impl() {}
int passetout_impl::work(int noutput_items,
gr_vector_const_void_star& input_items,
gr_vector_void_star& output_items)
{
auto in = static_cast<const input_type*>(input_items[0]);
auto out = static_cast<output_type*>(output_items[0]);
#pragma message("Implement the signal processing in your block and remove this warning")
// Do <+signal processing+>
// Tell runtime system how many output items we produced.
return noutput_items;
}
} /* namespace monModule */
Détaillons :
#pragma message("set the following appropriately and remove this warning")
using input_type = float;
#pragma message("set the following appropriately and remove this warning")
using output_type = float;
On spécifie ici le type des données d'entrée et de sortie. Pas de modification à apporter, il suffit de supprimer les deux #pragma
passetout_impl::passetout_impl()
: gr::sync_block("passetout",
gr::io_signature::make(
1 /* min inputs */, 1 /* max inputs */, sizeof(input_type)),
gr::io_signature::make(
1 /* min outputs */, 1 /*max outputs */, sizeof(output_type)))
{
}
On spécifie ici le nombre d'entrée (1) et le nombre de sorties (1). Pas de modification non plus.
Expliquez la syntaxe passetout_impl::passetout_impl() : gr::sync_block(...)"
int passetout_impl::work(int noutput_items,
gr_vector_const_void_star& input_items,
gr_vector_void_star& output_items)
{
auto in = static_cast<const input_type*>(input_items[0]);
auto out = static_cast<output_type*>(output_items[0]);
#pragma message("Implement the signal processing in your block and remove this warning")
// Do <+signal processing+>
// Tell runtime system how many output items we produced.
return noutput_items;
}
-
in
etout
contiennent respectivement les données en entrée et les données en sortie. Il faut donc calculerout
en fonction dein
- Les données d'entrée arrivent par paquets dans un buffer. La variable
noutput_items
contient le nombre de données disponibles en entrées. - à la fin de la méthode, on renvoie le nombre de données en sortie que l'on a calculé (entre 1 et
noutput_items
). Les données d'entrées éventuellement non consommées seront conservées dans le buffer.
Fichier monModule_passetout.block.yml
monModule_passetout.block.yml
id: monModule_passetout
label: passetout
category: '[monModule]'
templates:
imports: from gnuradio import monModule
make: monModule.passetout()
# Make one 'parameters' list entry for every parameter you want settable from the GUI.
# Keys include:
# * id (makes the value accessible as keyname, e.g. in the make entry)
# * label (label shown in the GUI)
# * dtype (e.g. int, float, complex, byte, short, xxx_vector, ...)
# * default
parameters:
- id: parametername_replace_me
label: FIX ME:
dtype: string
default: You need to fill in your grc/monModule_passetout.block.yaml
#- id: ...
# label: ...
# dtype: ...
# Make one 'inputs' list entry per input and one 'outputs' list entry per output.
# Keys include:
# * label (an identifier for the GUI)
# * domain (optional - stream or message. Default is stream)
# * dtype (e.g. int, float, complex, byte, short, xxx_vector, ...)
# * vlen (optional - data stream vector length. Default is 1)
# * optional (optional - set to 1 for optional inputs. Default is 0)
inputs:
#- label: ...
# domain: ...
# dtype: ...
# vlen: ...
# optional: ...
outputs:
#- label: ...
# domain: ...
# dtype: ...
# vlen: ...
# optional: ...
# 'file_format' specifies the version of the GRC yml format used in the file
# and should usually not be changed.
file_format: 1