bladeGPS

Sehr grobe experimentelle Implementierung von gps-sdr-sim für die Echtzeit-Signalerzeugung. Der Code funktioniert mit bladeRF und wurde unter Windows 10 und Ubuntu 20.04 getestet.

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

Unter Windows mit Visual Studio bauen

Folgen Sie der Anleitung auf der Nuand-Wiki-Seite und bauen Sie die bladeRF-Bibliothek aus dem Quellcode mit Visual Studio 2013 Express für Windows Desktop. Gehen Sie davon aus, dass Sie bereits pthread- und libusb-Dateien heruntergeladen und die bladeRF-Bibliothek erfolgreich für Ihre Windows-Umgebung gebaut haben.

1. Visual Studio starten
2. Ein leeres Projekt für eine Konsolenanwendung erstellen
3. Im Projektmappen-Explorer rechts die folgenden Dateien zum Projekt hinzufügen:
   • bladegps.c und bladegps.h
   • gpssim.c und gpssim.h
   • getopt.c und getopt.h
4. Die Pfade zu den folgenden Ordnern unter Konfigurationseigenschaften -> C/C++ -> Allgemein -> Zusätzliche Includeverzeichnisse hinzufügen:
   • pthreads-w32-2-9-1-release/Pre-built.2/include für pthread.h
   • bladeRF/include für libbladeRF.h
5. Die Pfade zu den folgenden Ordnern unter Konfigurationseigenschaften -> Linker -> Allgemein -> Zusätzliche Bibliotheksverzeichnisse hinzufügen:
   • pthreads-w32-2-9-1-release/Pre-built.2/lib/x64 für pthreadVC2.lib
   • bladeRF/x64 für bladeRF.lib
6. Die Namen der zusätzlichen Bibliotheken unter Konfigurationseigenschaften -> Linker -> Eingabe -> Zusätzliche Abhängigkeiten angeben:
   • pthreadVC2.lib
   • bladeRF.lib
7. Release in der Dropdown-Liste Projektmappenkonfigurationen auswählen
8. X64 in der Dropdown-Liste Sofution Platforms auswählen
9. Build -> Projektmappe erstellen ausführen

Nach einem erfolgreichen Build finden Sie die ausführbare Datei im Ordner Release. Sie sollten Kopien der folgenden DLLs im selben Ordner ablegen, um den Code auszuführen:

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

Unter Linux (Ubuntu 20.04) bauen

1. Den bladeRF-Quellcode in einem Verzeichnis neben dem aktuellen Verzeichnis abrufen

   root@kitploit:~

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

2. Die bladeRF-Hostbibliothek bauen

   root@kitploit:~

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

3. bladeGPS bauen

   root@kitploit:~

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

Unter Mac OS X (Catalina) bauen

1. Xcode installieren

2. Xcode-Befehlszeilentools installieren

   root@kitploit:~

    $ xcode-select --install
   

3. MacPorts installieren

4. Einen symbolischen Link zu port erstellen

   root@kitploit:~

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

5. bladeRF installieren

   root@kitploit:~

    $ sudo port install bladeRF +tecla
   

6. cmake installieren

   root@kitploit:~

    $ sudo port install cmake
   

7. Den bladeRF-Quellcode in einem Verzeichnis neben dem aktuellen Verzeichnis abrufen

   root@kitploit:~

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

8. Die bladeRF-Hostbibliothek bauen

   root@kitploit:~

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

9. libomp und wget installieren

   root@kitploit:~

    $ sudo port install libomp
    $ sudo port install wget
   

10. Für _MACOSX mit OpenMP-Pfad kompilieren und bladeGPS bauen

    root@kitploit:~

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

Docker

Ein Dockerfile wurde aus einem Ubuntu-20.04-Image erstellt, mit dem Sie in Sekundenschnelle einen Docker-Container starten können.

1. Docker-Image bauen

   root@kitploit:~

    $ cd docker
    $ docker build -t bladegps .
   

2. bladegps-Befehl direkt ausführen

   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. bladegps-Befehl von der Docker-CLI aus ausführen

   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

Eine docker-compose.yml-Beispieldatei wird bereitgestellt, wenn Sie bladegps als Dienst ausführen möchten, der beim Erreichen der Enddauer neu startet. Bearbeiten Sie den Befehl und den Gerätenamen, bevor Sie den Dienst mit docker-compose starten.

1. Docker-Compose-Dienst im Hintergrund ausführen

   root@kitploit:~

    $ cd docker
    $ docker-compose up -d
   

2. Status des Docker-Compose-Prozesses überprüfen

   root@kitploit:~

    $ docker-compose ps
   

3. Bei Bedarf eine Verbindung zum Container herstellen, der den Dienst ausführt

   root@kitploit:~

    $ docker-compose exec bladegps /bin/bash
   

4. Den Dienst beenden, wenn fertig

   root@kitploit:~

    $ docker-compose down
   

Lizenz

Copyright © 2015-2022 Takuji Ebinuma
Verteilt unter der MIT-Lizenz.