sebastian
/
gr-satnogs
mirror of https://gitlab.com/LongHairedHacker/gr-satnogs.git
1
0
Fork 0
Code Issues Releases Wiki Activity
gr-satnogs/apps/flowgraphs
History
Sebastian 274f5027d4 Fixed missing FM decoding stage 2019-07-30 20:32:16 +02:00
..
satellites Adapt FSK improvements for the Reaktor flowgraph 2019-07-19 14:39:55 +03:00
README.md Add example flowgraph and documentation 2018-04-27 11:32:07 +03:00
afsk1200_ax25.grc Improve FSK/MSK flowgraphs sensitivity 2019-07-18 18:48:15 +03:00
apt_demod.grc Fix deprecated variable blocks 2017-11-19 11:46:20 +02:00
ax25_transceiver_qt.grc Add UDP sink for real time propagation of frames 2018-02-23 21:38:35 +02:00
bpsk_ax25.grc Fix BPSK issue on low baudrates 2018-12-21 17:32:11 +02:00
bpsk_decoder.grc Add a BPSK decoder Script 2018-07-18 12:11:23 +03:00
bpsk_demod.grc Fix deprecated variable blocks 2017-11-19 11:46:20 +02:00
cw_decoder.grc Increase CW sensitivity 2019-01-06 20:14:32 +02:00
device_args_handler.py Add libfec as external project 2018-03-24 21:43:18 +02:00
example_flowgraph.grc Add example flowgraph and documentation 2018-04-27 11:32:07 +03:00
fm_demod.grc Fix deprecated variable blocks 2017-11-19 11:46:20 +02:00
fsk9600_ax25.grc remove audio_gain from remaining gr scripts 2018-11-24 22:00:23 -05:00
fsk9600_g3ruh_ax25.grc remove audio_gain from remaining gr scripts 2018-11-24 22:00:23 -05:00
fsk_ax25.grc Fix resampling ratio 2019-07-19 22:48:43 +03:00
fsk_ax25.py Add parametric FSK and MSK AX.25 decoders 2018-11-24 00:25:32 +02:00
generic_iq_receiver.grc Fix deprecated variable blocks 2017-11-19 11:46:20 +02:00
msk_ax25.grc Fix resampling ratio 2019-07-19 22:48:43 +03:00
msk_ax25.py Add parametric FSK and MSK AX.25 decoders 2018-11-24 00:25:32 +02:00
satnogs_afsk1200_ax25.py Improve FSK/MSK flowgraphs sensitivity 2019-07-18 18:48:15 +03:00
satnogs_apt_demod.py Fix deprecated variable blocks 2017-11-19 11:46:20 +02:00
satnogs_bpsk_ax25.py Fix BPSK issue on low baudrates 2018-12-21 17:32:11 +02:00
satnogs_bpsk_decoder.py Add a BPSK decoder Script 2018-07-18 12:11:23 +03:00
satnogs_bpsk_demod.py Fix deprecated variable blocks 2017-11-19 11:46:20 +02:00
satnogs_cw_decoder.py Increase CW sensitivity 2019-01-06 20:14:32 +02:00
satnogs_example_flowgraph.py Add example flowgraph and documentation 2018-04-27 11:32:07 +03:00
satnogs_fm_demod.py Fix deprecated variable blocks 2017-11-19 11:46:20 +02:00
satnogs_fsk9600_ax25.py remove audio_gain from remaining gr scripts 2018-11-24 22:00:23 -05:00
satnogs_fsk9600_g3ruh_ax25.py remove audio_gain from remaining gr scripts 2018-11-24 22:00:23 -05:00
satnogs_fsk_ax25.py Fix resampling ratio 2019-07-19 22:48:43 +03:00
satnogs_generic_iq_receiver.py Fix deprecated variable blocks 2017-11-19 11:46:20 +02:00
satnogs_msk_ax25.py Fix resampling ratio 2019-07-19 22:48:43 +03:00
satnogs_sstv_pd120_demod.py Fixed missing FM decoding stage 2019-07-30 20:32:16 +02:00
sstv_pd120_demod.grc Fixed missing FM decoding stage 2019-07-30 20:32:16 +02:00

README.md

SatNOGS flowgraphs

This directory contains all the available flowgraphs that can be executed from the satnogs-client.

Contribution guide

Flowgraphs are placed inside the apps/flowgraphs directory. If a decoding flowgraph targets only specific satellite/mission, the flowgraph should be placed inside the apps/flowgraphs/satellites directory.

Each flowgraph should have a representative name (eg voyager_decoder) and both the GNU Radio file (.grc) and the generated pythons script should be available. Python auto-generared flowgraph scripts should have the satnogs_ prefix. This can be performed by setting properly the ID field of the Options block of the flowgraph. For example the voyager_decoder.grc should generate a python executable named satnogs_voyager_decoder.py

NOTE:: Custom python GNU Radio scripts are not allowed. Each flowgraph should be able to be generated from the corresponding .grc file.

All generated python scripts should be installed using the CMake build system. To do so, edit properly the apps/CMakeLists.txt or apps/flowgraphs/satellites/CMakeLists.txt file.

In the apps/flowgraphs directory, the is an example flowgraph called example_flowgraph.grc that can be used as a base.

Execution arguements interface

The stanogs-client and the gr-satnogs communicate through a set of predefined command line arguments. Depending the decoding flowgraph, additional arguments may exist or missing. However, there is a set of mandatory arguments.

  • --antenna: The name of the antenna to use
  • --dev-args: SDR device specific arguments
  • --bb-gain: Baseband gain
  • --if-gain: Intermediate frequency gain
  • --rf-gain: RF gain
  • --ppm: The PPM correction
  • --rx-freq: RX frequency
  • --rx-sdr-device: The RX SDR device identification name (e.g uhd, airspy, etc)
  • --rigctl-port: The rigctld port
  • --doppler-correction-per-sec: Number of Doppler corrections per second
  • --lo-offset: Offset from the desired center frequency. The flowgraph should tune the SDR with this offset from the center frequency and digitally compensate it. This eliminate the problem of the DC leakage, expressed in the majority of the SDR devices.