bladeGPS

Implementación experimental muy rudimentaria de gps-sdr-sim para generación de señales en tiempo real. El código funciona con bladeRF y ha sido probado en Windows 10 y 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

Compilar en Windows con Visual Studio

Sigue las instrucciones en la página wiki de Nuand y compila la librería bladeRF desde el código fuente con Visual Studio 2013 Express para Windows Desktop. Asume que ya descargaste los archivos de pthread y libusb y compilaste exitosamente la librería bladeRF para tu entorno Windows.

1. Inicia Visual Studio
2. Crea un proyecto vacío para una aplicación de consola
3. En el Explorador de soluciones a la derecha, agrega los siguientes archivos al proyecto:
   • bladegps.c y bladegps.h
   • gpssim.c y gpssim.h
   • getopt.c y getopt.h
4. Añade las rutas a las siguientes carpetas en Configuration Properties -> C/C++ -> General -> Additional Include Directories:
   • pthreads-w32-2-9-1-release/Pre-built.2/include para pthread.h
   • bladeRF/include para libbladeRF.h
5. Añade las rutas a las siguientes carpetas en Configuration Properties -> Linker -> General -> Additional Library Directories:
   • pthreads-w32-2-9-1-release/Pre-built.2/lib/x64 para pthreadVC2.lib
   • bladeRF/x64 para bladeRF.lib
6. Especifica el nombre de las librerías adicionales en Configuration Properties -> Linker -> Input -> Additional Dependencies:
   • pthreadVC2.lib
   • bladeRF.lib
7. Selecciona Release en la lista desplegable Configuraciones de solución
8. Selecciona X64 en la lista desplegable Plataformas de solución
9. Ejecuta Build -> Build Solution

Después de una compilación exitosa, puedes encontrar el ejecutable en la carpeta Release. Debes colocar las copias de las siguientes DLL en la misma carpeta para ejecutar el código:

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

Compilar en Linux (Ubuntu 20.04)

1. Obtén el código fuente de bladeRF en un directorio junto al directorio actual

   root@kitploit:~

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

2. Compila la librería host de bladeRF

   root@kitploit:~

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

3. Compila bladeGPS

   root@kitploit:~

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

Compilar en Mac OS X (Catalina)

1. Instala Xcode

2. Instala las herramientas de línea de comandos de Xcode

   root@kitploit:~

    $ xcode-select --install
   

3. Instala MacPorts

4. Crea un enlace simbólico a port

   root@kitploit:~

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

5. Instala bladeRF

   root@kitploit:~

    $ sudo port install bladeRF +tecla
   

6. Instala cmake

   root@kitploit:~

    $ sudo port install cmake
   

7. Obtén el código fuente de bladeRF en un directorio junto al directorio actual

   root@kitploit:~

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

8. Compila la librería host de bladeRF

   root@kitploit:~

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

9. Instala libomp y wget

   root@kitploit:~

    $ sudo port install libomp
    $ sudo port install wget
   

10. Compila para _MACOSX con la ruta de OpenMP y compila bladeGPS

    root@kitploit:~

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

Docker

Se creó un Dockerfile a partir de la imagen de Ubuntu 20.04 que permite iniciar un contenedor docker en segundos.

1. Construir la imagen docker

   root@kitploit:~

    $ cd docker
    $ docker build -t bladegps .
   

2. Ejecutar el comando bladegps directamente

   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. Ejecutar el comando bladegps desde el cli de 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

Se proporciona un ejemplo de docker-compose.yml, si deseas ejecutar bladegps como un servicio, reiniciándose cuando llegue al final de la duración. Edita el comando y el nombre del dispositivo antes de iniciar el servicio usando docker-compose.

1. Ejecutar el servicio docker-compose en segundo plano

   root@kitploit:~

    $ cd docker
    $ docker-compose up -d
   

2. Verificar el estado del proceso docker-compose

   root@kitploit:~

    $ docker-compose ps
   

3. Conectarse al contenedor que ejecuta el servicio, si se desea

   root@kitploit:~

    $ docker-compose exec bladegps /bin/bash
   

4. Detener el servicio cuando termine

   root@kitploit:~

    $ docker-compose down
   

Licencia

Copyright © 2015-2022 Takuji Ebinuma
Distribuido bajo la Licencia MIT.