bladeGPS

Очень грубая экспериментальная реализация gps-sdr-sim для генерации сигнала в реальном времени. Код работает с bladeRF и протестирован на Windows 10 и 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

Сборка в Windows с помощью Visual Studio

Следуйте инструкциям на странице Nuand wiki и соберите библиотеку bladeRF из исходников с помощью Visual Studio 2013 Express for Windows Desktop. Предполагается, что вы уже загрузили файлы pthread и libusb и успешно собрали библиотеку bladeRF для вашей среды Windows.

1. Запустите Visual Studio
2. Создайте пустой проект для консольного приложения
3. В Solution Explorer справа добавьте следующие файлы в проект:
   • bladegps.c и bladegps.h
   • gpssim.c и gpssim.h
   • getopt.c и getopt.h
4. Добавьте пути к следующим папкам в Configuration Properties -> C/C++ -> General -> Additional Include Directories:
   • pthreads-w32-2-9-1-release/Pre-built.2/include для pthread.h
   • bladeRF/include для libbladeRF.h
5. Добавьте пути к следующим папкам в Configuration Properties -> Linker -> General -> Additional Library Directories:
   • pthreads-w32-2-9-1-release/Pre-built.2/lib/x64 для pthreadVC2.lib
   • bladeRF/x64 для bladeRF.lib
6. Укажите имена дополнительных библиотек в Configuration Properties -> Linker -> Input -> Additional Dependencies:
   • pthreadVC2.lib
   • bladeRF.lib
7. Выберите Release в раскрывающемся списке Solution Configurations
8. Выберите X64 в раскрывающемся списке Sofution Platforms
9. Выполните Build -> Build Solution

После успешной сборки вы найдете исполняемый файл в папке Release. Для запуска кода поместите копии следующих DLL в ту же папку:

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

Сборка в Linux (Ubuntu 20.04)

1. Получите исходный код bladeRF в каталоге рядом с текущим

   root@kitploit:~

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

2. Соберите хост-библиотеку bladeRF

   root@kitploit:~

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

3. Соберите bladeGPS

   root@kitploit:~

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

Сборка в Mac OS X (Catalina)

1. Установите Xcode

2. Установите Xcode Command Line Tools

   root@kitploit:~

    $ xcode-select --install
   

3. Установите MacPorts

4. Создайте символическую ссылку на port

   root@kitploit:~

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

5. Установите bladeRF

   root@kitploit:~

    $ sudo port install bladeRF +tecla
   

6. Установите cmake

   root@kitploit:~

    $ sudo port install cmake
   

7. Получите исходный код bladeRF в каталоге рядом с текущим

   root@kitploit:~

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

8. Соберите хост-библиотеку bladeRF

   root@kitploit:~

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

9. Установите libomp и wget

   root@kitploit:~

    $ sudo port install libomp
    $ sudo port install wget
   

10. Скомпилируйте для _MACOSX с путём OpenMP и соберите bladeGPS

    root@kitploit:~

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

Docker

Был создан Dockerfile на основе образа Ubuntu 20.04, который позволяет запустить docker-контейнер за секунды.

1. Соберите docker-образ

   root@kitploit:~

    $ cd docker
    $ docker build -t bladegps .
   

2. Запустите команду bladegps напрямую

   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 из 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

Предоставлен пример docker-compose.yml, если вы хотите запустить bladegps как сервис, который перезапускается по достижении конца длительности. Отредактируйте команду и имя устройства перед запуском сервиса с помощью docker-compose.

1. Запустите docker-compose сервис в фоне

   root@kitploit:~

    $ cd docker
    $ docker-compose up -d
   

2. Проверьте статус процесса docker-compose

   root@kitploit:~

    $ docker-compose ps
   

3. Подключитесь к контейнеру с работающим сервисом, если необходимо

   root@kitploit:~

    $ docker-compose exec bladegps /bin/bash
   

4. Остановите сервис, когда закончите

   root@kitploit:~

    $ docker-compose down
   

Лицензия

Copyright © 2015-2022 Takuji Ebinuma
Распространяется под лицензией MIT.