bladeGPS

Implementação experimental muito rudimentar do gps-sdr-sim para geração de sinais em tempo real. O código funciona com bladeRF e foi testado no 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

Compilar no Windows com Visual Studio

Siga as instruções na página da wiki do Nuand e compile a biblioteca bladeRF a partir do código fonte com o Visual Studio 2013 Express para Windows Desktop. Suponha que você já baixou os arquivos pthread e libusb e compilou com sucesso a biblioteca bladeRF para o seu ambiente Windows.

1. Inicie o Visual Studio
2. Crie um projeto vazio para uma aplicação de console
3. No Solution Explorer à direita, adicione os seguintes arquivos ao projeto:
   • bladegps.c e bladegps.h
   • gpssim.c e gpssim.h
   • getopt.c e getopt.h
4. Adicione os caminhos para as seguintes pastas em 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. Adicione os caminhos para as seguintes pastas em 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. Especifique o nome das bibliotecas adicionais em Configuration Properties -> Linker -> Input -> Additional Dependencies:
   • pthreadVC2.lib
   • bladeRF.lib
7. Selecione Release na lista suspensa Solution Configurations
8. Selecione X64 na lista suspensa Sofution Platforms (Nota: erro original "Sofution" mantido como no original)
9. Execute Build -> Build Solution

Após uma compilação bem-sucedida, você pode encontrar o executável na pasta Release. Você deve colocar as cópias das seguintes DLLs na mesma pasta para executar o código:

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

Compilar no Linux (Ubuntu 20.04)

1. Obtenha o código fonte do bladeRF em um diretório próximo ao diretório atual

   root@kitploit:~

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

2. Compile a biblioteca host do bladeRF

   root@kitploit:~

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

3. Compile o bladeGPS

   root@kitploit:~

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

Compilar no Mac OS X (Catalina)

1. Instale o Xcode

2. Instale as Ferramentas de Linha de Comando do Xcode

   root@kitploit:~

    $ xcode-select --install
   

3. Instale o MacPorts

4. Crie um link simbólico para o port

   root@kitploit:~

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

5. Instale o bladeRF

   root@kitploit:~

    $ sudo port install bladeRF +tecla
   

6. Instale o cmake

   root@kitploit:~

    $ sudo port install cmake
   

7. Obtenha o código fonte do bladeRF em um diretório próximo ao diretório atual

   root@kitploit:~

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

8. Compile a biblioteca host do bladeRF

   root@kitploit:~

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

9. Instale libomp e wget

   root@kitploit:~

    $ sudo port install libomp
    $ sudo port install wget
   

10. Compile para _MACOSX com o caminho OpenMP e construa o bladeGPS

    root@kitploit:~

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

Docker

Um Dockerfile foi criado a partir da imagem Ubuntu 20.04 que permite criar um container docker em segundos.

1. Construa a imagem docker

   root@kitploit:~

    $ cd docker
    $ docker build -t bladegps .
   

2. Execute o comando bladegps diretamente

   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. Execute o comando bladegps a partir do 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

Um exemplo de docker-compose.yml é fornecido, caso queira executar o bladegps como um serviço, reiniciando quando atingir o fim da duração. Edite o comando e o nome do dispositivo antes de iniciar o serviço usando docker-compose.

1. Execute o serviço docker-compose em segundo plano

   root@kitploit:~

    $ cd docker
    $ docker-compose up -d
   

2. Verifique o status do processo docker-compose

   root@kitploit:~

    $ docker-compose ps
   

3. Conecte-se ao container que está executando o serviço, se desejado

   root@kitploit:~

    $ docker-compose exec bladegps /bin/bash
   

4. Encerre o serviço quando terminar

   root@kitploit:~

    $ docker-compose down
   

Licença

Copyright © 2015-2022 Takuji Ebinuma
Distribuído sob a Licença MIT.