Mobile Network Assessment Tools

h1. Osmocom + CatcherCatcher tutorial

In this page, you can find all the needed information to set up an IMSI Catcher Catcher based on Osmocom.

If you already have a working Osmocom setup you may skip some steps and just open a new git branch.

All the normal capabilities of an Osmocom-based mobile are available.

For everything not covered on this tutorial you can check the Osmocom wiki:

* http://bb.osmocom.org/trac/wiki/GettingStarted

* http://bb.osmocom.org/trac/wiki/mobile

h2. Download sources into ~/catchercatcher

<pre>

  mkdir -p ~/catchercatcher

  cd ~/catchercatcher

  git clone git://git.osmocom.org/osmocom-bb.git

  wget https://opensource.srlabs.de/attachments/download/63/mobile.cfg

</pre>

h2. Download ARM cross compiler

<pre>

  wget http://gnuarm.com/bu-2.15_gcc-3.4.3-c-c++-java_nl-1.12.0_gi-6.1.tar.bz2

  tar xf bu-2.15_gcc-3.4.3-c-c++-java_nl-1.12.0_gi-6.1.tar.bz2

</pre>

h2. Compile OsmocomBB

<pre>

  cd ~/catchercatcher/osmocom-bb

  git checkout --track origin/luca/catcher

  cd src

  export PATH=$PATH:~/catchercatcher/gnuarm-3.4.3/bin

  make

</pre>

h2. Setup configuration file

<pre>

  mkdir -p ~/.osmocom/bb

  cp ~/catchercatcher/mobile.cfg ~/.osmocom/bb/

</pre>

h2. Run OsmocomBB firmware

<pre>

  # Conect Osmocom phone (eg, Motorola C123) through USB cable

  cd ~/catchercatcher/osmocom-bb/src

  ./host/osmocon/osmocon -m c123xor -p /dev/ttyUSB0 ./target/firmware/board/compal_e88/layer1.compalram.bin

  # Switch on Osmocom phone

</pre>

h2. Run OsmocomBB host software (in second terminal)

  ../osmocom-bb/src/host/layer23/src/mobile/mobile

h2. Connect to console

<pre>

  # every event is reported on the console port

  # (try to connect as soon as possible)

  telnet 127.0.0.1 4247

  # to get the current catcher status

  show catcher <enter>

  # before call or sms you need privileged mode

  en <enter>

  # use help or ? to see the parameters

  help call <enter>

  help sms <enter>

</pre>