bladeGPS

Implementazione sperimentale molto grezza di gps-sdr-sim per la generazione di segnali in tempo reale. Il codice funziona con bladeRF ed è stato testato su Windows 10 e 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

Build su Windows con Visual Studio

Segui le istruzioni nella pagina wiki di Nuand e costruisci la libreria bladeRF dal sorgente con Visual Studio 2013 Express per Windows Desktop. Supponiamo che tu abbia già scaricato i file pthread e libusb e che tu abbia compilato con successo la libreria bladeRF per il tuo ambiente Windows.

1. Avvia Visual Studio
2. Crea un progetto vuoto per un'applicazione console
3. In Solution Explorer a destra, aggiungi i seguenti file al progetto:
   • bladegps.c e bladegps.h
   • gpssim.c e gpssim.h
   • getopt.c e getopt.h
4. Aggiungi i percorsi alle seguenti cartelle in Configuration Properties -> C/C++ -> General -> Additional Include Directories:
   • pthreads-w32-2-9-1-release/Pre-built.2/include per pthread.h
   • bladeRF/include per libbladeRF.h
5. Aggiungi i percorsi alle seguenti cartelle in Configuration Properties -> Linker -> General -> Additional Library Directories:
   • pthreads-w32-2-9-1-release/Pre-built.2/lib/x64 per pthreadVC2.lib
   • bladeRF/x64 per bladeRF.lib
6. Specifica il nome delle librerie aggiuntive in Configuration Properties -> Linker -> Input -> Additional Dependencies:
   • pthreadVC2.lib
   • bladeRF.lib
7. Seleziona Release nell'elenco a discesa Solution Configurations
8. Seleziona X64 nell'elenco a discesa Sofution Platforms
9. Esegui Build -> Build Solution

Dopo una compilazione riuscita, puoi trovare l'eseguibile nella cartella Release. Devi mettere le copie delle seguenti DLL nella stessa cartella per eseguire il codice:

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

Build su Linux (Ubuntu 20.04)

1. Recupera il sorgente di bladeRF in una directory accanto a quella corrente

   root@kitploit:~

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

2. Compila la libreria host di bladeRF

   root@kitploit:~

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

3. Compila bladeGPS

   root@kitploit:~

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

Build su Mac OS X (Catalina)

1. Installa Xcode

2. Installa Xcode Command Line Tools

   root@kitploit:~

    $ xcode-select --install
   

3. Installa MacPorts

4. Crea un symlink a port

   root@kitploit:~

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

5. Installa bladeRF

   root@kitploit:~

    $ sudo port install bladeRF +tecla
   

6. Installa cmake

   root@kitploit:~

    $ sudo port install cmake
   

7. Recupera il sorgente di bladeRF in una directory accanto a quella corrente

   root@kitploit:~

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

8. Compila la libreria host di bladeRF

   root@kitploit:~

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

9. Installa libomp e wget

   root@kitploit:~

    $ sudo port install libomp
    $ sudo port install wget
   

10. Compila per _MACOSX con il percorso OpenMP e compila bladeGPS

    root@kitploit:~

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

Docker

Un Dockerfile è stato creato dall'immagine Ubuntu 20.04 che ti permette di avviare un contenitore docker in pochi secondi.

1. Costruisci l'immagine docker

   root@kitploit:~

    $ cd docker
    $ docker build -t bladegps .
   

2. Esegui il comando bladegps direttamente

   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. Esegui il comando bladegps dalla 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 esempio docker-compose.yml viene fornito, se desideri eseguire bladegps come servizio, che si riavvia quando raggiunge la fine della durata. Modifica il comando e il nome del dispositivo prima di avviare il servizio usando docker-compose.

1. Esegui il servizio docker-compose in background

   root@kitploit:~

    $ cd docker
    $ docker-compose up -d
   

2. Controlla lo stato del processo docker-compose

   root@kitploit:~

    $ docker-compose ps
   

3. Connettiti al contenitore in esecuzione del servizio, se desiderato

   root@kitploit:~

    $ docker-compose exec bladegps /bin/bash
   

4. Ferma il servizio quando hai finito

   root@kitploit:~

    $ docker-compose down
   

Licenza

Copyright © 2015-2022 Takuji Ebinuma
Distribuito sotto la Licenza MIT.