Skip to content
web visualizer for gr-iridium frames
C# HTML CSS JavaScript Python
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
ComponentsLibrary
IridiumLive added some explanations and clarifications Jan 19, 2020
.gitattributes first commit Dec 15, 2019
.gitignore Added publishing profiles. Dec 25, 2019
IridiumLive.sln first commit Dec 15, 2019
LICENSE added github format license Dec 15, 2019
README.md Update README.md Jan 6, 2020
prerelease1.jpg replaced readme picture Jan 1, 2020
udp-for-il.py minor additions Dec 15, 2019

README.md

IridiumLive

Welcome to IridiumLive!

IridiumLive is a Blazor server application which allows for the real-time vizualization of the iridium satellites as they pass above your location.

It is another tool which allows for the visualization of live data coming from gr-iridium. Will not work without it.

You install the application in your local network, and use the browser to interact with it.

Setup

Binaries: https://github.com/microp11/iridiumlive/releases

At this time the following ports have been hard coded:

 7777: IridiumLive server port,
15007: udp port for receiving data from gr-iridium and iridium-toolkit.

The data will be provided by your personal install of gr-iridium and iridium-toolkit (see gr-iridium and iridium-toolkit). See bottom of page for quick instructions.

  1. On the same machine as gr-iridium download and extract the python udp transmitter udp-for-il.py. Please install in the same folder as gr-iridium.
  2. Depending of your intended OS target, download and extract the appropriate IridiumLive archive. There is no installation needed, simply extract in a folder of its own. You can extract either on the same machine or to a different one.
  3. In the udp-for-il.py script, the server_address (192.168.2.10) denotes the machine where IridiumLive is installed. Modify it accordingly. This address is also where you will open your browser to later on:
...
import socket

ap = ("192.168.2.10", 15007)
sk = socket.socket(family=socket.AF_INET, type=socket.SOCK_DGRAM)
def sendOverUdp(line):
...
  1. Change the center frequency of the gr-iridium decoder to include the Ring Alert band as described at min 9 in the Stefan “Sec” Zehl, schneider during their presentation at The Eleventh HOPE (2016): Iridium Satellite Hacking.
  2. Instantiate the iridium receiver and pipe through decoder, filter and udp transmitter adapting the following command line:
user@computer:~/gr-iridium$ iridium-extractor --offline --multi-frame examples/hackrf.conf | ~/iridium-toolkit/iridium-parser.py -p /dev/stdin /dev/stdout | grep "sat:" | python udp-for-il.py
  1. Only continue to next step if you see udp lines being transmitted:
191
1576397118 | i:  68/s | i_avg:  19/s | q:    0 | q_max:    7 | o: 106/s | ok:  63% | ok:  43/s | ok_avg:  51% | ok:      32064 | ok_avg:   9/s | d: 0
1576397119 | i:  67/s | i_avg:  19/s | q:    0 | q_max:    6 | o: 103/s | ok:  64% | ok:  43/s | ok_avg:  51% | ok:      32108 | ok_avg:   9/s | d: 0
1576397120 | i:  58/s | i_avg:  19/s | q:    0 | q_max:    5 | o:  91/s | ok:  57% | ok:  33/s | ok_avg:  51% | ok:      32142 | ok_avg:   9/s | d: 0
1576397121 | i:  69/s | i_avg:  19/s | q:    0 | q_max:    4 | o: 115/s | ok:  61% | ok:  42/s | ok_avg:  51% | ok:      32185 | ok_avg:   9/s | d: 0
169
173
191
169 <- the length of one blob sent over UDP
173
191
169
  1. Run IridiumLive.
  2. Set up time accurately on the gr-iridium machine!
  3. Open any browser at http://server_address:7777 and enjoy!

Credits

Disclaimer

This is my first .NET Core web app. Blazor on top of it. Be merciless and gentle!

Screenshot

Quick install on gr-iridium and iridium-toolkit for Rapberry Pi

The following has been tested on RPi 3b running Raspbian Buster Lite Minimal image based on Debian Buster.

sudo apt update
sudo apt upgrade -y

sudo apt install python-pip python-dev build-essential
sudo -H pip install --upgrade pip
sudo -H pip install --upgrade virtualenv
sudo -H pip install --upgrade setuptools

sudo apt install libboost-all-dev

sudo -H pip install pyBOMBS

sudo apt install pypy

sudo apt install gnuradio gr-osmosdr

sudo apt install hackrf

sudo apt-get install git
sudo apt-get install cmake
sudo apt-get install swig
sudo apt-get install doxygen

git clone https://github.com/muccc/gr-iridium.git
cd gr-iridium
mkdir build
cd build
cmake ..
make
sudo make install
sudo ldconfig

git clone https://github.com/muccc/iridium-toolkit.git
You can’t perform that action at this time.