Improving Free Software based GSM protocol analysis

From WorkOutWiki2008

Contents 1 NEWS 2 Proposer 3 Purpose 4 Abstract 5 Pre-requisites 5.1 Languages, tools to be known 5.2 Getting and compiling the code 5.2.1 gnuradio 5.2.2 gsm related gnuradio code bits 5.2.3 captured GSM signals 5.2.4 wireshark 5.3 Links to overall design/architecture 6 Pre-event planning 6.1 Tasks 6.2 Existing work 6.3 Getting in touch 7 Participants

NEWS

2008-11-26: We're in the BOF TENT BX, from 12:30 onwards till 18:00

2008-11-27: We'll meet in the BOF TENT BX, from 10:30 onwards till 18:00

Proposer

There are a number of different FOSS tools that help with GSM protocol analysis, but their status is not very oood. They don't receive regular maintenance, don't build with current toolchains, don't work with current gnuradio-3.1.x releases, provide patches against ancient wireshark versions, etc.

The idea is to get some people involved to fixing all those issues, make the tools much more useable and complete.

Purpose

Abstract

Pre-requisites

Languages, tools to be known

One or more of the following

• GSM protocols
• wireshark
• signal processing
• gnuradio
• USRP

Some background on GSM

• https://styx.uwaterloo.ca/~jscouria/GSM/gsmreport.html
• http://www.privateline.com/mt_gsmhistory/06_multiple_access_and_channel_structure/iii_burst_structure/

Getting and compiling the code

All the source is collected at FOSS.in at: http://192.168.44.119/gsm/

gnuradio

• you should have a working gnuradio-3.1.3 installation on your system (please don't use gnuradio svn trunk, unless you want to work on fixing all the buidl bugs of gssm/gsm-tvoid/... with it)
• sources are available at ftp://ftp.gnu.org/gnu/gnuradio/gnuradio-3.1.3.tar.gz

gsm related gnuradio code bits

• We've set up a git repository for all our code, please check it out
  • http://git.openezx.org/?p=gsm.git;a=summary
  • 'git clone git://git.openezx.org/gsm.git'
  • please mail your ssh public key to laforge@gnumonks.org if you want write access
  • please send patches otherwise.

captured GSM signals

• TO BE DONE

wireshark

• we want to port the GSM decoder plugin to current mainline wireshark
• please get it from 'svn co http://anonsvn.wireshark.org/wireshark/trunk/ wireshark'
• http://www.wireshark.org/develop.html

Links to overall design/architecture

Pre-event planning

Can document this here and/or add some links to Bugzilla, ML threads, other wiki pages

Tasks

• make sure gsm-tvoid, gssm and gsmsp build+work on current systems and gnuradio-3.1.3
• port wireshark plugin to current wireshark upstream version
• improve wireshark decoding (add more protocol fields/options/...)
• obtain A5/0 traces, if India really has widespread A5/0 adoption
• Make Tvoid's implementation compatible for the TUN device for wireshark (Rakesh Peter)
• Integrating the Viterbi decoder (Rakesh Peter)

Existing work

• http://wiki.thc.org/gsm
• http://wiki.thc.org/gsm/tvoid
• http://wiki.thc.org/gsm/gssm
• http://thre.at/gsm

Getting in touch

• We have a mailing list specifically for the FOSS.in 2008 GSM WorkOut
  • http://lists.gnumonks.org/mailman/listinfo/fossin-gsm
  • post to fossin-gsm@lists.gnumonks.org
• The THC gsm mailing list
  • subscribe at gsm-subscribe@lists.segfault.net

Participants

• Harald Welte
• Rakesh Peter