Mobile Network Assessment Tools

h1. Xgoldscanner

This script collects 2G and 3G traces using Samsung Android phones.

The trace log files can be analyzed with Tobias Engel's "xgoldmon":https://github.com/2b-as/xgoldmon tool, which heavily inspired the development of xgoldscanner.

h3. Requirements

* Samsung Galaxy S2 / S3  phone

* Micro-USB cable

* Linux computer

h3. Download

* "Source Code (bash)":https://opensource.srlabs.de/attachments/download/78/xgoldscanner.zip

* "Live System":https://opensource.srlabs.de/projects/mobile-network-assessment-tools/wiki/GSMmap-live

h3. Disclaimer

The tests include an active part. First, your phone will place outgoing calls to a dedicated number. This number will always be busy and never answer in order to rule out voice charges as best as we can.

Second, your phone will send SMS short messages via an invalid SMS-C to an invalid number.

During our tests (in Europe) we have not encounter any network that would charge for these transactions. However, we can not rule out that you may be charged in specific settings.

To control for involuntary charges, we strongly advise the use of a dedicated pre-paid SIM card for these tests.

h3. Instructions

# "Download":https://opensource.srlabs.de/attachments/download/78/xgoldscanner.zip

# unpack: <pre>unzip xgoldscanner.zip</pre>

# run:  <pre>sudo ./xgoldscanner.sh -n [telephone number, e.g. +491234567]</pre>

Optional parameters:

*  -g  conduct GPRS test

*  -d  display debug messages

*  -o  offline mode [skip log upload for manual submission]

*  -3  conduct 3G tests only [skip 2G tests]

*  -y  assume "yes" to questions and confirmation dialogues [for automated testing]

*  -i  <n> repeat each test <n> times (default is 5)

h3. Advanced usage

Use Tobias Engel's "xgoldmon":https://github.com/2b-as/xgoldmon tool to analyze the trace log files.

h3. Mailing list

A public mailing list for discussions is found "here":https://lists.srlabs.de/cgi-bin/mailman/listinfo/gsmmap