GSM Map Tutorial

This tutorial explains how to populate this GSM security map on gsmmap.org with additional data for your location:

- Download sources into ~/cell_logger

  mkdir -p ~/cell_logger
  cd ~/cell_logger
  git clone git://git.osmocom.org/osmocom-bb.git

- Download ARM cross compiler

  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

- Prepare OsmocomBB's burst_ind branch

  cd ~/cell_logger/osmocom-bb
  git checkout --track origin/luca/gsmmap

- Compile OsmocomBB

  cd src
  export PATH=$PATH:~/cell_logger/gnuarm-3.4.3/bin
  make

- Run OsmocomBB firmware

  # Conect Osmocom phone (eg, Motorola C123) through USB cable
  cd ~/cell_logger/osmocom-bb/src
  ./host/osmocon/osmocon -m c123xor -p /dev/ttyUSB0 ./target/firmware/board/compal_e88/layer1.compalram.bin
  # Switch on Osmocom phone

- Run OsmocomBB host software (in second terminal)  

  mkdir -p ~/cell_logger/captures
  cd ~/cell_logger/captures
  ../osmocom-bb/src/host/layer23/src/misc/cell_log

  # the program runs through all the available cells
  # and never terminates
  # the capturing period for each cell can be set
  # with the command line option -w <seconds>

- Upload to server 

  cd ~/cell_logger/captures
  tar cfz ../captures_`date +%Y%m%d%H%M`.tgz *.dat 

  # open a web browser at:
  # http://gsmmap.org
  # and click on the "contribute data" button
  # fill the file upload dialog or use curl
  # as described on that page 

- Optional: reorganize your files

  # since lots of files are created, you can run
  # a script to organize them in separate folders (by arfcn)
  cd ~/cell_logger/captures
  sh ../osmocom-bb/src/host/layer23/src/misc/arfcn_sort