Difference between revisions of "Projets:Lab:2011:GHPSDR3-Alex"

From Electrolab
Jump to: navigation, search
(Qu’est-ce que Linux)
(Récupération des libs nécessaires)
Line 226: Line 226:
 
(le "sudo" d'élévation de privilèges a été conservé ici car il semblerait que seules les Ubuntu soient frappées par de défaut)
 
(le "sudo" d'élévation de privilèges a été conservé ici car il semblerait que seules les Ubuntu soient frappées par de défaut)
  
Ceci fait, on peut passer à l'installation du programme serveur GHPSDR3 à proprement parler, après avoir lancé un  
+
Ceci fait, on peut passer à l'installation du programme serveur GHPSDR3 à proprement parler, après avoir redémarré le système en lançant un  
 
   shutdown -r now
 
   shutdown -r now
  

Revision as of 16:58, 11 April 2013

QTRadio, interface d'émission/réception et de de pilotage à distance des appareils connectés au serveur de flux GHPSDR3-Alex

Cékoidon

Ce projet s'inscrit en droite ligne de l'esprit Electrolab. Il associe informatique libre et bidouilles sauvages au fer à souder, construction de radios logicielles et concentration de leurs ressources. En d'autres termes, il s'agit d'installer, de configurer et d'équiper de ses périphériques un serveur d'émission/réception de type "Web SDR" ou "IP SDR", universel, reposant une plateforme GNU, indépendante du type de matériel radio ou de l'architecture des postes clients qui s'y connecteront.Ce serveur a pour nom GHPSDR.

Il est surtout le résultat de plusieurs projets Electrolab convergents, à commencer par le « gros » chantier du MSA, appareil de mesure et d’analyse des signaux radios.

Il procède également de l’intérêt croissant de beaucoup envers le hack des clefs USB de réception TV par le groupe Osmocom http://sdr.osmocom.org/trac/wiki/rtl-sdr -lequel a d’ailleurs généré à son tour un « mini-projet de demi-journée » (un « upconverter » pour l’écoute des bandes décamétriques).

Il est enfin la suite logique d'un « group build » organisé il y a peu autour de la construction de la SDR Widget, une carte de traitement de signal spécifiquement étudiée pour piloter et traiter les information provenant d’une radio logicielle.

On pourrait ajouter que ce projet se situe dans une mouvance technique quasi prévisible : la disparition –ou la diminution progressive- des récepteurs de radiodiffusion dédiés au profit de centres multimédias capables de distribuer un contenu via réseau. Que l’on parle de télévision, de radio « broacast », voir de systèmes plus exotiques tels qu’une installation radioamateur, il est pratiquement certains qu’à terme, la partie réception –donc purement électronique- sera concentrée en un seul point, un serveur de flux, flux qui sera lu par des terminaux ou postes clients polyvalents –tablette, diffuseurs vidéo, ordinateurs, smartphones etc. Une évolution rendue possible grâce à l’apparition d’une part des SDR et d’autre part des réseaux locaux à large bande passante.

De manière plus générale, le remplacement progressif des systèmes de liaison radio traditionnels par des outils autoreconfigurables par logiciel commence à ouvrir la porte à des infrastructures réseau « agiles » et « autoadaptatives » (ou, selon l’expression de leur inventeur Joseph Mitola, des réseaux cognitifs) considérablement plus sûres (mais pas inviolables) que les réseaux radio traditionnels constitués d’un bric à brac de technologies, de protocoles, de liens et de passerelles plus ou moins biens adaptés. Commencer à comprendre dès aujourd’hui, même par une approche simple, comment fonctionneront ces réseaux constitués d’un maillage SDR est une quasi nécessité pour le hacker contemporain. Le SDR est aux réseaux sans fil (dont font partie les grands réseaux d’opérateurs) ce que Wireshark, Nessus et Nmap sont aux réseaux filaires.

Passons aux choses concrètes. Nous partons du principe que toute personne intéressée par ce genre de projet possède déjà un récepteur ou un émetteur-récepteur logiciel. Les gros salaires peuvent dépoussiérer leurs USRP2, les hackers prolétaires brandiront d’un poing rageur leurs clefs DVB-T âprement achetées 7 dollars (port compris) sur les étals des ebayeurs de l’Empire du Milieu. Quant aux radioamateurs, ils dépoussièreront leurs Softrock, Perseus, UHFSDR, SDR-iq, HiQSDR et luxueux HPSDR et prouveront que leur ADN de hacker avant l’heure et leur passion de la communication et de la transmission du savoir ne sont pas de vains mots. Poil au dos.

 Note importante : Il va sans dire, mais cela ira mieux en l'écrivant, que l'usage de tout
  matériel d'émission en dehors des fréquences "sans licence" est soumis à des contraintes
  légales très strictes. Il est également important de préciser que l'utilisation à
  distance d'un émetteur du service amateur via le réseau public est strictement interdit
  en France. Lorsque nous parlons de transmission via protocole TCP/IP, cela s'entend dans
  le cadre précis du réseau local de l'exploitant. Le présent projet ne constitue en aucun
  cas une incitation à contourner la loi.

Les principaux conseils que vous trouverez sur ces pages reflètent essentiellement le fruit du travail et de l'expérience de Sid Boyce, G3VBV, qui anime la communauté Softrock depuis ses toutes premières heures.

Qu’est-ce que Linux

Ou Des différences génétiques qui caractérisent Linux et Windows

Le caractère très général de ce chapitre et le soucis de ne pas trop alourdir la page principale du projet avec des digressions moins techniques et moins "radio" ont nécessité l'ouverture d'une pages spécifique, intitulée Windows vs Linux

Qu'est-ce que GHPSDR3-Alex

L'ensemble softrock 6.3, Mobo 4.3, SDR-Widget 3.0, l'un des très nombreux SDR supporté par le serveur de streaming)

GHPSDR3-Alex est une évolution de GHPSDR de John Melton. Il s'agit d'un ensemble de logiciels capables de "servir" des flux radio reçus par des radios logicielles (SDR). Il peut piloter des émetteurs-récepteurs à distance via réseau, et partager les ressources de un à quatre récepteurs ou tranceivers SDR entre plusieurs usagers... en fonction des capacités et de la bande passante des segments de réseau IP utilisés, et bien entendu de la puissance CPU disponible coté serveur.


Attention : lorsque nous parlons de flux, il ne s'agit pas du simple streaming d'une seule et unique communication, mais d'une portion de spectre de 200 kHz -donc potentiellement plus de 150 stations radio-, portion de spectre pouvant être "positionnée" sur n'importe quelle fréquence située dans la plage du récepteur utilisé (en général, de 1,8 à 30 MHz avec un Softrock, mais pouvant couvrir de 3 à 700 MHz avec une tête UHFSDR, voir plus -22 à 1700 MHz par exemple si l'on connecte une clef DVB-T)

GHPSDR est constitué de trois parties : un frontal chargé d'interfacer l'électronique (radiorécepteur ou émetteur-récepteur), un serveur de flux -qui convertit le spectre reçu en trames IP- et un client local ou distant qui décodera le signal, sera chargé des changements de bande ou de fréquence etc. C'est la partie la plus visible de l'iceberg des "web-sdr".

La partie serveur n'existe que sous Linux. Les poste clients, en revanche, ont été compilés sous Linux, Windows, Android, JVM...

Plus d'informations sont disponibles sur le site GHPSDR3-Alex

Les sources des programmes sont accessibles sur github

Une cartographie en temps réel des serveurs accessibles sur Internet est hébergée sur le serveur Web d'Andréa Montefusco IW0HDV. Avant de vous lancer dans une telle réalisation, installez GLSDR sur votre tablette Android ou smartphone, et balayez les bandes... vous vous rendrez vite compte que cela n'a rien a voir avec le Web-SDR de l'Université de Twente, remarquable précurseur monté par PA3FWM

Le socle matériel historique est constitué d'un émetteur-récepteur Softrock 6.3NG, d'une extension associant filtres et commande de fréquence, la "mobo 4.3", et une interface de commande et de traitement de signal ayant déjà fait l'objet d'un projet de construction au sein de l'Electrolab, la SDR-Widget. C'est cette plateforme qui nous servira d'exemple d'application, mais nous tenterons également de fournir les paramètres pour les plateformes "clef DVB-T RTL 2832U" et UHFSDR.

Quelle version choisir

Il existe de nombreuses instructions d'installation.

- Notamment une édition "live USB" du serveur, qui n'accepte manifestement pas de fonctionner avec une SDR-Widget dotée d'un firmware récent

- une version "PPA nobrainer ubuntu" au format DEB conçue par Andréa Montefusco, mais qui ne semble plus maintenue depuis 2 ans.

- Par ailleurs, N8MDP a rédigé deux très longs et très détaillés "how to"... le tout pour installer un code qui ne parvient pas toujours à tomber en marche, car lié à des versions de bibliothèques, de noyau ou de code source relativement figés

C'est principalement la raison pour laquelle il nous a semblé nécessaire d'écrire ce guide d'installation rapide qui part des codes source principaux, ceux écrits par Alex, et donc la dernière versions stable connue.

Pour demeurer le plus orthodoxe possible, nous avons basé ce guide en prenant pour base un noyau Debian Squeeze 6.0.7. Plus "puritaine" qu'une ubuntu, si vous résolvez un problème sur ce noyau, toutes les versions dérivées de Debian pourront suivre votre exemple. L'inverse n'est pas toujours vrai.

Attention : sous Debian, contrairement à Ubuntu, le compte root est actif par défaut. Il est plus facile d’effectuer les installations avec ce privilège. Que les puritains de la sécurité en soient pour leurs frais, de toute manière, il est aussi simple d’effectuer des bêtises avec un « sudo su » ou un « sudo » qu’avec un login root.

Si vous partez d’une installation Debian Ubuntu, il est souhaitable tout d’abord de débloquer le compte root avec les opérations suivantes :

 sudo passwd root

Le système va demander deux fois de suite un nouveau mot de passe pour le compte root (à ne jamais oublier). Le déblocage du compte s’effectue ensuite par la commande

 sudo passwd –u root 

Il suffit de se déloguer puis de se reloguer avec le compte root et le mot de passe que l’on vient de choisir (et que l’on n’oublie pas !)(j'ai parfois l'impression de me répéter...)

Une autre possibilité "quick and dirty" consiste à lancer un

 sudo su

sauvage qui vous évitera d'avoir à taper des centaines de sudo avant chaque commande. Et il y en a un sacré paquet avant d'arriver à destination.

L'ordre sudo est la contraction de "super user do" (le super-utilisateur fait...). Super-user était le nom réservé généralement à l'Administrateur sur les systèmes Unix au début des années 80. On se doute qu'avec un surnom aussi mégalomaniaque, ce "super-user" possède des droits que le vulgum pecus ne peut espérer obtenir un jour. Revers de la médaille, une erreur de manipulation effectuée avec des droits de super-user (ou "root") font potentiellement plus de dégâts car susceptibles de s'étendre à tout le système ou presque.

Mais revenons à notre sudo


Ex :

 sudo apt-get install mc

sous Ubuntu, alors que sous Debian sous compte root

 apt-get install mc

Cette commande installe Midnight Commander, une version « linuxisée » du Norton Commander, interface de manipulation de fichiers en mode caractère conçue pour DOS par John Socha, qui fut également le créateur du tout premier tableur sur microordinateur : Visicalc

Ceci étant dit, les réaction d'une Ubuntu ne sont pas celle d'une Debian. Strictement appliquée, la suite de commande ci-après est garantie fonctionner sous Debian mais nécessite pas mal d'adaptations sous Ubuntu (adaptations liées en grande partie aux différences de versions de lib)

Ce qui suit a été testé sur 5 installations consécutives, sur deux plateformes matérielles différentes.

Installation

Récupération des libs nécessaires

Si cela n’a pas déjà été fait (installation de TVHeadend par exemple)

 apt-get install build-essential git pkg-config libssl-dev bzip2 wget
 apt-get install zlib1g-dev

puis

 apt-get install libqt4-opengl-dev glutg3-dev libusb-0.1-4
 apt-get install libfftw3-dev portaudio19-dev libpulse-dev
 apt-get install libsamplerate0-dev libusb-1.0-0-dev libconfig8-dev
 apt-get install autoconf libtool libjack-dev libgsl0-dev libgtk2.0-dev
 apt-get install libusb-dev libortp-dev git-core subversion

A noter :

  • - le gsl de la "libgsl0-dev" s'écrit "golf sierra lima" et non "golf sierra Unité Zéro".
  • - le libusb-dev par défaut risque de ne pas convenir sur certains noyaux (Ubuntu) : voir ci-après

Ces deux dernières installations permettent d’aller récupérer les versions les plus récentes des bibliothèques de fonctions “stables” sur les dépots Github et SVN, c'est à dire avec d'autres outils que les traditionnels aptitude/apt-get/dpkg utilisés par défaut sous Gnu-Linux-Debian-Unix-Like-but-not-Unix-dérivé-de-system-V (ironique, moi ? mais non, voyons)

Il est conseillé d’effectuer les différentes opérations dans le répertoire « home » de l’utilisateur principal (et non sur le répertoire "privé" de root)

Récupération du dernier source en date de ghpsdr3-Alex

cd /home/nomutilisateur
git clone git://github.com/alexlee188/ghpsdr3-alex.git

Récupération de 4 « libs » "à la main"

Ces bibliothèques de fonctions (Codec2-dev, Libevent et ortp) ne sont a priori pas accessibles depuis un noyau Pure Debian Squeeze. Elles sont parfois disponibles avec un simple "apt-get install" sous Ubuntu. Il est préférable de ne les installer que si le ./configure de ghpsdr3 le demande.

Codec2-dev

Se trouve sur un dépôt Subversion

 svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev
 cd codec2-dev
 ./configure
 make
 make intall
 ldconfig
 make clean
 cd ..

Libevent

Par défaut, libevent de Debian Squeeze en est resté à une version 1.4, il nous faut une version 2.0 Cette fois, le dépôt est sur Github

Note importante!


Il est primordial de supprimer toute ancienne version 1.4 et antérieure de libevent avant que de lancer la compilation du serveur. Cette suppression peut être effectuée en mode graphique via Synaptic ou en ligne de commande. Si vous ne prenez pas cette précaution, la compilation s'effectuera sans erreur, mais vos exécutable ne fonctionneront pas






 git clone git://github.com/libevent/libevent.git
 cd libevent
 ./autogen.sh
 ./configure
 make
 make install
 make clean
 cd ..

ortp-dev Si l’on ne parvient pas à la descendre libortp-dev avec apt-get ou synaptic... ceci n'est pas très clair dans la config du rédacteur de ces lignes

 git clone https://github.com/avis/ortp.git
 cd ortp
 ./autogen.sh
 ./configure
 make 
 make install
 make clean
 cd ..


Libusb

Certains noyaux Ubuntu utilisent par défaut une bibliothèque usb qui ne convient pas à GHPSDR3-Alex. Il faut alors récupérer la dernière version en date de libusb-1 qui ne figure pas dans les dépots par défaut

Note importante!

Cette opération n'est pas nécessaire sous Debian 6.0.7. Elle est même déconseillée car pouvant interférer avec la Libusb déjà en place et qui s'est avérée fonctionnelle.




 wget http://sourceforge.net/projects/libusb/files/libusb-1.0/libusb-1.0.9/libusb-1.0.9.tar.bz2/download

décompacter le fichier

 mv download libusb-1.0.9.tar.bz2
 sudo bunzip2 libusb-1.0.9.tar.bz2
 sudo tar xvf libusb-1.0.9.tar
 cd libusb-1.0.9/
 sudo ./configure
 sudo make
 sudo make install
 sudo make clean
 sudo cd ..
 sudo rm *.tar

(le "sudo" d'élévation de privilèges a été conservé ici car il semblerait que seules les Ubuntu soient frappées par de défaut)

Ceci fait, on peut passer à l'installation du programme serveur GHPSDR3 à proprement parler, après avoir redémarré le système en lançant un

 shutdown -r now

purement chamanique...

Compilation de GHPSDR3-Alex

 cd ghpsdr3-alex
 autoreconf –i
 ./configure
 make all
 make install

L’on obtient alors trois elements clef de la suite de programmes

 ghpsdr3-alex/trunk/src/QtRadio/QtRadio
 ghpsdr3-alex/trunk/src/dspserver/dspserver
 ghpsdr3-alex/trunk/src/server/hpsdr-server


Si vous allez dans

 /home/esh/ghpsdr3-alex/trunk/src/monitor

Vous pouvez lancer ¨make¨. ¨monitor" le binaire résultant, est expédié dans ghpsdr3­alex/trunk/bin Si vous allez dans

 /home/esh/ghpsdr3-alex/trunk/src/bandscope

Vous pouvez lancer ¨make¨.¨bandscope", le binaire résultant, est expédié dans ghpsdr3­alex/trunk/bin Si vous allez dans

 /home/esh/ghpsdr3-alex/trunk/src/receiver

Vous pouvez lancer ¨make¨. ¨ghpsdr¨, le binaire résultant, est expédié dans ghpsdr3­alex/trunk/bin

Enfin, si vous possédez une plateforme Softrock/Mobo, vous pouvez lancer un "make" dans le répertoire

 /home/esh/ghpsdr3-alex/trunk/src/softrock

softrock, le binaire résultant, est expédié dans ghpsdr3­alex/trunk/bin

Pour vérifier la validité des options de compilation, vous pouvez exécuter

 softrock --toto

qui vous répondra

 root@GHPSDR:/home/marc/ghpsdr3-alex/trunk/src/softrock# softrock --toto
 softrock: unrecognized option '--toto'
 invalid argument
 Usage options:
       -s= or --samplerate
       -d= or --device (OSS audio device)
       -i= or --input (Port Audio device for input)
       -o= or --output (Port Audio device for output)
       --iq or --qi (to swap I and Q channels)
       --si570 (to use a unit having a Si570 oscillater)
       -v or --verbose
       -f= or --startupfreq (set Si570 startup frequency)
       -m= or --multiplier (set Si570 multiplier)
       --correctedfreq (set Si570 corrected frequency)
       --serialid
       --record filename (record to this file)
       --playback filename (playback this file)
       --receivers (number of receivers)
       -j or --jack (use Jack Audio Connection Kit for audio in/out)
 root@GHPSDR:/home/marc/ghpsdr3-alex/trunk/src/softrock#

Un exécutable qui rouspète, c'est un exécutable qui fonctionne. On peut passer au branchement des différents appareils et entamer les premiers tests.

D’autres indications peuvent être obtenues sur le réflecteur hpsdr ainsi que sur

 https://github.com/alexlee188/ghpsdr3-alex/blob/master/README
 http://napan.ca/ghpsdr3/index.php/Main_Page


Configuration logicielle de GHPSDR3-Alex

Paramètres du serveur

Lancer une première fois le programme dspserver

 dspserver --share --lo 9000 --lookupcountry 

le programme répond

 root@GHPSDR:/etc/udev/rules.d# dspserver --share --lo 9000 --lookupcountry
 Country Lookup is On
 Reading conf file /root/dspserver.conf
 **********************************************************
   A new  dspserver config file template has been created at:
   /root/dspserver.conf
   Please edit this file and fill in your station details!
 ***********************************************************
 **********************************************************
   Your config file located at:
   /root/dspserver.conf
   Contains Unknown for a Call
   Please edit this file and fill in your station details!
 ***********************************************************

Editer le fichier dspserver.conf et renseigner les champs nécessaires (indicatif, QTH, type d’émetteur ou récepteur, type d’antenne etc) avec l’ordre

 nano/root/dspserver.conf

(on sort de l’éditeur en tapant Control-X avant confirmation d’écriture, O ou Y selon la localisaton)

Editer ensuite dans /etc/udev/rules.d un fichier 99-softrock.rules contenant

 SUBSYSTEM=="usb", ATTR{idVendor}=="16c0", ATTR{idProduct}=="05dc", MODE="0660", GROUP="dialout"

Ce fichier de règles indique que, sur une des prises USB (que l’on peut scanner avec l’ordre « lsusb ») se trouve un périphérique possédant l’identifiant de fabricant « 16c0 » et l’identifiant produit « 05dc » (qui correspondent aux interfaces de commande DG8SAQ), et que les droits attribués à cette règle sont élevées au niveau « 660 » pour tout membre du groupe « dialout ».

Pour vérifier que ce groupe fait bien partie de ceux référencés dans vos ACL (listes de contrôle d’accès), il suffit de lance l’ordre

cat /etc/group

qui va vous lister tous les groups officiellement acceptés par votre système. Quelque part doit se trouver le mot « dialout ». S'il n'existe pas, vous pouvez utiliser le nom d'un autre groupe, tel que "user"

Il ne vous reste plus qu’à ouvrir votre réseau local sur le monde extérieur pour que d’autres personnes (ou vous-même) puissent accéder à votre récepteur. Cette opération n’est possible qu’en modifiant les paramètres de redirection de port de votre routeur ADSL ou du routeur situé en aval de votre modem ADSL. Le port à ouvrir est le 8000, en TCP, lié à l’adresse ip de la machine exécutant GHPSDR3-Alex.

Il existe une multitude de façon de modifier les redirection de port sur un routeur ADSL. A titre d'exemple, celle fonctionnant sur une Freebox est documentée à l'adresse

http://www.journaldufreenaute.fr/05/03/2008/tuto-le-routeur-de-la-freebox-explications-et-configuration.html#redirections

Configuration et paramètres audio

UNDER CONSTRUCTION

Installer le paquet

 apt-get install pavucontrol
 apt-get install paprefs

Puis modifier les droits d’exploitation à la console audio avec votre nom de compte

 adduser NomUser pulse
 adduser NomUser pulse-access
 adduser NomUser audio

Editer le fichier system.pa

 nano /etc/pulse/system.pa 

avec le contenu suivant (à coller en fin de fichier)

 load-module module-position-event-sounds
 load-module module-native-protocol-tcp auth-anonymous=1

relancer PulseAudio pour qu’il puisse prendre en considération ce changement

 /etc/init.d/pulseaudio restart

Editer ensuite le fichier deamon.conf

 nano /etc/pulse/deamon.conf

en activant(suppression du caractère « # » de début de ligne) les lignes suivantes


 default-sample-format = s16le
 default-sample-rate = 192000
 default-sample-channels = 2
 default-channel-map = front-left,front-right

Il est à noter que si votre carte audio est limitée à 48 kHz ou à 96 kHz, la seconde ligne devra être modifiée en conséquence (48000 ou 96000)

Configuration du mode audio temps réel

Editer le fichier limits.conf

/etc/security/limits.conf

Avec le contenu suivant :

 @audio – rtprio 99
 @audio – memlock unlimited

Paramètres de lancement

Le lancement de ghpsdr3-Alex s’effectue en exécutant les ordres

 softrock --iq --si570 --samplerate 192000 
 dspserver --share --lo 9000 --lookupcountry

chacun dans une fenêtre de terminal différente (les deux processus doivent tourner de manière indépendantes. Considérez-les de la même manière que des processus préemptifs sous Windows par exemple