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. أنشئ مشروعًا فارغًا لتطبيق وحدة التحكم (console application)
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. قم ببناء مكتبة host الخاصة بـ 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

   root@kitploit:~

    $ xcode-select --install
   

3. قم بتثبيت MacPorts

4. أنشئ رابطًا رمزيًا (symlink) إلى 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. قم ببناء مكتبة host الخاصة بـ 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 من خلال واجهة سطر أوامر 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
   

الترخيص

حقوق النشر © 2015-2022 Takuji Ebinuma
موزع تحت رخصة MIT.