bladeGPS

Implémentation expérimentale très rudimentaire de gps-sdr-sim pour la génération de signaux en temps réel. Le code fonctionne avec bladeRF et a été testé sur Windows 10 et Ubuntu 20.04.

Usage: bladegps [options]
Options:
  -e <gps_nav>     RINEX navigation file for GPS ephemerides (required)
  -y <yuma_alm>    YUMA almanac file for GPS almanacs
  -u <user_motion> User motion file (dynamic mode)
  -g <nmea_gga>    NMEA GGA stream (dynamic mode)
  -l <location>    Lat,Lon,Hgt (static mode) e.g. 35.274,137.014,100
  -t <date,time>   Scenario start time YYYY/MM/DD,hh:mm:ss
  -T <date,time>   Overwrite TOC and TOE to scenario start time
  -d <duration>    Duration [sec] (max: 86400)
  -x <XB_number>   Enable XB board, e.g. '-x 200' for XB200
  -i               Interactive mode: North='w', South='s', East='d', West='a'
  -I               Disable ionospheric delay for spacecraft scenario
  -p               Disable path loss and hold power level constant

Compilation sur Windows avec Visual Studio

Suivez les instructions sur la page wiki de Nuand et compilez la bibliothèque bladeRF à partir des sources avec Visual Studio 2013 Express pour Windows Desktop. Supposons que vous ayez déjà téléchargé les fichiers pthread et libusb et que vous ayez compilé avec succès la bibliothèque bladeRF pour votre environnement Windows.

1. Démarrez Visual Studio
2. Créez un projet vide pour une application console
3. Dans l'Explorateur de solutions à droite, ajoutez les fichiers suivants au projet :
   • bladegps.c et bladegps.h
   • gpssim.c et gpssim.h
   • getopt.c et getopt.h
4. Ajoutez les chemins vers les dossiers suivants dans Configuration Properties -> C/C++ -> General -> Additional Include Directories :
   • pthreads-w32-2-9-1-release/Pre-built.2/include pour pthread.h
   • bladeRF/include pour libbladeRF.h
5. Ajoutez les chemins vers les dossiers suivants dans Configuration Properties -> Linker -> General -> Additional Library Directories :
   • pthreads-w32-2-9-1-release/Pre-built.2/lib/x64 pour pthreadVC2.lib
   • bladeRF/x64 pour bladeRF.lib
6. Spécifiez le nom des bibliothèques supplémentaires dans Configuration Properties -> Linker -> Input -> Additional Dependencies :
   • pthreadVC2.lib
   • bladeRF.lib
7. Sélectionnez Release dans la liste déroulante Configurations de solution
8. Sélectionnez X64 dans la liste déroulante Plateformes de solution
9. Exécutez Build -> Build Solution

Après une compilation réussie, vous trouverez l'exécutable dans le dossier Release. Vous devez placer les copies des DLL suivantes dans le même dossier pour exécuter le code :

• bladeRF.dll
• libusb-1.0.dll
• pthreadVC2.dll

Compilation sur Linux (Ubuntu 20.04)

1. Récupérez les sources de bladeRF dans un répertoire adjacent au répertoire actuel

   root@kitploit:~

    $ cd ..
    $ git clone [email protected]:Nuand/bladeRF.git
   

2. Compilez la bibliothèque hôte bladeRF

   root@kitploit:~

    $ cd bladeRF/host
    $ mkdir build
    $ cd build
    $ cmake ..
    $ make
   

3. Compilez bladeGPS

   root@kitploit:~

    $ cd ../../../bladeGPS
    $ make
   

Compilation sur Mac OS X (Catalina)

1. Installez Xcode

2. Installez les outils en ligne de commande Xcode

   root@kitploit:~

    $ xcode-select --install
   

3. Installez MacPorts

4. Créez un lien symbolique vers port

   root@kitploit:~

    $ sudo ln -s /opt/local/bin/port /usr/local/bin/port
   

5. Installez bladeRF

   root@kitploit:~

    $ sudo port install bladeRF +tecla
   

6. Installez cmake

   root@kitploit:~

    $ sudo port install cmake
   

7. Récupérez les sources de bladeRF dans un répertoire adjacent au répertoire actuel

   root@kitploit:~

    $ cd ..
    $ git clone [email protected]:Nuand/bladeRF.git
   

8. Compilez la bibliothèque hôte bladeRF

   root@kitploit:~

    $ cd bladeRF/host
    $ mkdir build
    $ cd build
    $ cmake ..
    $ make && sudo make install
   

9. Installez libomp et wget

   root@kitploit:~

    $ sudo port install libomp
    $ sudo port install wget
   

10. Compilez pour _MACOSX avec le chemin OpenMP et construisez bladeGPS

    root@kitploit:~

    $ cd ../../../bladeGPS
    $ make CFLAGS=”-I/opt/local/include/libomp _MACOSX”
    

Docker

Un Dockerfile a été créé à partir de l'image Ubuntu 20.04 qui vous permet de lancer un conteneur docker en quelques secondes.

1. Construisez l'image docker

   root@kitploit:~

    $ cd docker
    $ docker build -t bladegps .
   

2. Exécutez directement la commande bladegps

   root@kitploit:~

    $ docker run -it --rm --privileged --device /dev/ttyUSB0 bladegps \
            /bin/bash -c "bladegps -e /opt/bladeGPS/brdc3300.18n -l 35.274,137.014,100 -d 86400"
   

3. Exécutez la commande bladegps depuis le cli docker

   root@kitploit:~

    $ docker run -it --rm --privileged --device /dev/ttyUSB0 bladegps /bin/bash
    bladegps@cb744220dea3:~$ bladegps -e /opt/bladeGPS/brdc3300.18n -l 35.274,137.014,100 -d 86400
   

Docker Compose

Un exemple de docker-compose.yml est fourni, si vous souhaitez exécuter bladegps en tant que service, en redémarrant lorsqu'il atteint la fin de la durée. Modifiez la commande et le nom du périphérique avant de démarrer le service avec docker-compose.

1. Exécutez le service docker-compose en arrière-plan

   root@kitploit:~

    $ cd docker
    $ docker-compose up -d
   

2. Vérifiez l'état du processus docker-compose

   root@kitploit:~

    $ docker-compose ps
   

3. Connectez-vous au conteneur exécutant le service, si souhaité

   root@kitploit:~

    $ docker-compose exec bladegps /bin/bash
   

4. Arrêtez le service une fois terminé

   root@kitploit:~

    $ docker-compose down
   

Licence

Copyright © 2015-2022 Takuji Ebinuma
Distribué sous la Licence MIT.