GNU Radio blocks for receiving/transmitting GSM https://osmocom.org/projects/gr-gsm/wiki
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Vadim Yanitskiy 2de47e28ce dists: add PKGBUILD script for Arch Linux 2 years ago
apps Execute python apps with use of python3 2 years ago
cmake Fix grcc compilation with python3 by adding local subdirs to __path__ 2 years ago
dists dists: add PKGBUILD script for Arch Linux 2 years ago
docs cmake: make formatting of install statements follow one pattern 2 years ago
examples@32727fc905 Updated examples pointer 5 years ago
grc cmake: make formatting of install statements follow one pattern 2 years ago
hier_blocks Port compile_demappers helper script to gr3.8 2 years ago
include/grgsm Fix compilation error: '_1' was not declared in this scope 2 years ago
lib Fix compilation error: '_1' was not declared in this scope 2 years ago
python cmake: make formatting of install statements follow one pattern 2 years ago
swig GNU Radio 3.8 support 2 years ago
test_data@e2e5b44bc2 Add tch_f_decoder tests 5 years ago
tests tests: Add test for Ubuntu 20.04 2 years ago
.dockerignore travis: Test in Ubuntu 18.04 container 2 years ago
.gitignore Updates .gitignore and examples pointer 5 years ago
.gitmodules Changed submodule URLs to point to osmocom servers 4 years ago
.gitreview Add .gitreview similar to the other osmocom's projects 4 years ago
.travis.yml tests: Add test for Ubuntu 20.04 2 years ago
CMakeLists.txt Remove local copy of associated osmo libraries 2 years ago
COPYING Big update of copyright statements so they can be automatically processed to produce debian/copyright file 5 years ago
LICENSE Added separate file for short license notice (that is used for example by gr_modtool to add these notices) and longer Copying file with full license. 8 years ago
MANIFEST.md Added more copyright holders 5 years ago
README.md Keep the old mailing list for now 4 years ago
TESTING.md Changed arrangment of directories and names of files for testing 7 years ago

README.md

The gr-gsm project

The gr-gsm project is based on the gsm-receiver written by Piotr Krysik (also the main author of gr-gsm) for the Airprobe project.

The aim is to provide set of tools for receiving information transmitted by GSM equipment/devices.

Installation and usage

Please see project's wiki for information on installation and usage of gr-gsm.

Mailing list

Current gr-gsm project's mailing list address is following:

gr-gsm@googlegroups.com

Mailing list is a place for general discussions, questions about the usage and installation. In case of problem with installation please try to provide full information that will help reproducing it. Minimum information should contain:

  • operating system with version,
  • kind of installation (how gr-gsm and its dependencies were installed: with pybombs, from distibution's repository, compiled manually)
  • version of gnuradio (it can be obtained with: gnuradio-companion --version)
  • error messages (in case of pybombs installation they can be obtained after switching it to verbous mode with -v option).

To join the group with any e-mail address, use this link:

https://groups.google.com/forum/#!forum/gr-gsm/join

Development

New features are accepted through github's pull requests. When creating pull request try to make it adress one topic (addition of a feature x, correction of bug y).

If you wish to develop something for gr-gsm but don't know exactly what, then look for issues with label "Enhancement". Select one that you feel you are able to complete. After that claim it by commenting in the comment section of the issue. If there is any additional information about gr-gsm needed by you to make completing the task easier - just ask.

Videos

Short presentation of Airprobe'like application of gr-gsm:

https://www.youtube.com/watch?v=Eofnb7zr8QE

Credits

Piotr Krysik <ptrkrysik (at) gmail.com> - main author and project maintainer

Roman Khassraf <rkhassraf (at) gmail.com> - blocks for demultiplexing and decoding of voice channels, decryption block supporting all ciphers used in GSM, blocks for storing and reading GSM bursts, project planning and user support

Vadim Yanitskiy <axilirator (at) gmail.com> - control and data interface for the transceiver, grgsm_trx application

Vasil Velichkov <vvvelichkov (at) gmail.com> - automatic compilation of grc applications, fixes and user support

Pieter Robyns <pieter.robyns (at) uhasselt.be> - block reversing channel hopping

Thanks

This work is built upon the efforts made by many people to gather knowledge of GSM.

First very significant effort of public research into GSM and its security vulnerabilities was The Hacker's Choice GSM SCANNER PROJECT. One of the results of this project was creation of a software GSM receiver by Tvoid - gsm-tvoid - which was was the most important predecessor of gr-gsm and of gsm-receiver from the Airprobe project.

Gr-gsm wouldn't be also possible without help and inspiration by Harald Welte, Dieter Spaar and Sylvain Munaut.

Special thanks to Pawel Koszut who generously lent his USRP1 to the author of gr-gsm (Piotr Krysik) in 2007-2010.