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

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

2. Compila la librería host de bladeRF

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

3. Compila bladeGPS

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

Compilar en Mac OS X (Catalina)

1. Instala Xcode

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

    $ xcode-select --install
   

3. Instala MacPorts

4. Crea un enlace simbólico a port

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

5. Instala bladeRF

    $ sudo port install bladeRF +tecla
   

6. Instala cmake

    $ sudo port install cmake
   

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

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

8. Compila la librería host de bladeRF

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

9. Instala libomp y wget

    $ sudo port install libomp
    $ sudo port install wget
   

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

    $ 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

    $ cd docker
    $ docker build -t bladegps .
   

2. Ejecutar el comando bladegps directamente

    $ 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

    $ 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

    $ cd docker
    $ docker-compose up -d
   

2. Verificar el estado del proceso docker-compose

    $ docker-compose ps
   

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

    $ docker-compose exec bladegps /bin/bash
   

4. Detener el servicio cuando termine

    $ docker-compose down
   

Licencia

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