Piotr Krysik | a8aab32 | 2016-02-13 18:38:12 +0100 | [diff] [blame] | 1 | This directory contains programs based on gr-gsm: |
Piotr Krysik | c3a822e | 2016-02-14 12:06:38 +0100 | [diff] [blame] | 2 | * grgsm_decode (old name: airprobe_decode.py) - program for decoding C0 channel |
| 3 | which is most close in terms of functionality to the old gsm-receiver |
| 4 | from Airprobe project, with ability to decode signalling channels and traffic channels with speech |
| 5 | (analysis of the data can be performed in Wireshark, decoded sound is stored to an audio file), |
| 6 | * grgsm_livemon (old name: airprobe_rtlsdr.py) - interactive monitor of a single C0 channel with analysis |
Piotr Krysik | 77868e4 | 2017-08-23 21:37:24 +0200 | [diff] [blame] | 7 | performed by Wireshark (command to run wireshark: sudo wireshark -k -f udp -Y gsmtap -i lo), |
Piotr Krysik | c3a822e | 2016-02-14 12:06:38 +0100 | [diff] [blame] | 8 | * grgsm_scanner (old name: airprobe_rtlsdr_scanner.py) - an application that scans GSM bands and prints |
| 9 | information about base transceiver stations transmitting in the area. |
Piotr Krysik | a8aab32 | 2016-02-13 18:38:12 +0100 | [diff] [blame] | 10 | |
| 11 | There are following helper programs for grgsm_decode program: |
| 12 | |
Piotr Krysik | 77868e4 | 2017-08-23 21:37:24 +0200 | [diff] [blame] | 13 | * grgsm_capture (old name: airprobe_rtlsdr_capture.py) - program for capturing GSM signal to a file |
Piotr Krysik | c3a822e | 2016-02-14 12:06:38 +0100 | [diff] [blame] | 14 | that can be later processed by grgsm_decode, |
Piotr Krysik | 77868e4 | 2017-08-23 21:37:24 +0200 | [diff] [blame] | 15 | * grgsm_channelize (old name: gsm_channelize.py) - splits wideband capture file into multiple files - each contain |
Piotr Krysik | c3a822e | 2016-02-14 12:06:38 +0100 | [diff] [blame] | 16 | single GSM channel. |
ptrkrysik | a136ff5 | 2014-11-28 23:38:23 +0100 | [diff] [blame] | 17 | |
Petter Reinholdtsen | 5b083ac | 2017-08-28 10:17:44 +0200 | [diff] [blame] | 18 | * grgsm_livemon_headless - command line version of grgsm_livemon. It |
| 19 | is created by changing grgsm_livemon.grc like this: |
| 20 | |
| 21 | - Change Options block->Generate Options from 'QT |
| 22 | GUI' to 'No GUI'. |
| 23 | - Set Options block->Run Options to 'Run to |
| 24 | Completion'. |
| 25 | - Remove the blocks 'QT GUI Range' (gain_slider, |
| 26 | fc_slider, ppm_slider) and the 'QT GUI Frequency |
| 27 | Sink'. |
| 28 | - Change all occurances of <param>_slider to |
| 29 | <param> in the XML file. |
| 30 | |
| 31 | After these changes are done, build the |
| 32 | grgsm_livemon_headless python code using the grcc |
| 33 | compiler. |