gr-gsm

History

Piotr Krysik fcb64a8adf grgsm_trx: Migrated argument parsing to argparse Argparse makes adding new parameters easier and adds consistent way of handling default values of parameters and printing of their help info. Change-Id: Idf99fd7a581464aa2f77fe01e721dbd162686811		2018-09-13 15:35:44 +02:00
..
apps_data	Added *.desktop files installation a'la GNU Radio.	2017-08-31 21:58:48 +02:00
helpers	Removed all references to 'band'	2017-09-11 10:38:40 +02:00
CMakeLists.txt	Placing grcc compilation utils in separate files	2018-09-13 15:35:44 +02:00
README	Added short description of grgsm_trx	2018-05-05 13:06:22 +02:00
grgsm_decode	Remove 'band' option from grgsm_decode altogether	2017-09-11 10:38:40 +02:00
grgsm_livemon.grc	Fixing missing callback to set_fc in clock_offset_control block	2018-01-23 15:07:08 +01:00
grgsm_livemon_headless.grc	Making arfcn<->freq conversions more robust and uptading apps depending on it	2017-09-06 17:48:38 +02:00
grgsm_scanner	Commenting out a line causeing crash on HackRF	2018-09-13 15:35:44 +02:00
grgsm_trx	grgsm_trx: Migrated argument parsing to argparse	2018-09-13 15:35:44 +02:00

README

This directory contains programs based on gr-gsm:
* grgsm_decode     (old name: airprobe_decode.py) - program for decoding C0 channel 
                    which is most close in terms of functionality to the old gsm-receiver 
                    from Airprobe project, with ability to decode signalling channels and traffic channels with speech 
                    (analysis of the data can be performed in Wireshark, decoded sound is stored to an audio file),
* grgsm_livemon    (old name: airprobe_rtlsdr.py) - interactive monitor of a single C0 channel with analysis 
                    performed by Wireshark (command to run wireshark: sudo wireshark -k -f udp -Y gsmtap -i lo),
* grgsm_scanner    (old name: airprobe_rtlsdr_scanner.py) - an application that scans GSM bands and prints 
                    information about base transceiver stations transmitting in the area.

There are following helper programs for grgsm_decode program:

* grgsm_capture    (old name: airprobe_rtlsdr_capture.py) - program for capturing GSM signal to a file 
                    that can be later processed by grgsm_decode,
* grgsm_channelize (old name: gsm_channelize.py) - splits wideband capture file into multiple files - each contain 
                  single GSM channel.

* grgsm_livemon_headless - command line version of grgsm_livemon.  It
                  is created by changing grgsm_livemon.grc like this:

                   - Change Options block->Generate Options from 'QT
                     GUI' to 'No GUI'.
                   - Set Options block->Run Options to 'Run to
                     Completion'.
                   - Remove the blocks 'QT GUI Range' (gain_slider,
                     fc_slider, ppm_slider) and the 'QT GUI Frequency
                     Sink'.
                   - Change all occurances of <param>_slider to
                     <param> in the XML file.

                  After these changes are done, build the
                  grgsm_livemon_headless python code using the grcc
                  compiler.

* grgsm_trx - a transceiver that together with Osmocom-BB (throught trxcon application)
              forms a GSM mobile station. Currently it works on non-hopping channels only.