{{>toc}}

<pre>

<pre>
extended in many ways with features interesting to researchers.

<pre>
* perform cell (re)selection according to TS 03.22
* MM procedures like location updating, authentication, encryption
* Establish MT and MO voice calls
* Send and receive SMS
* Perform supplementary services like USSD or call forwarding
* hook it up to a PBX

<pre>

h2. Prerequirements

It is assumed that you have already obtained the [[OsmocomBB]] source code and compiled both the host programs as well as the firmware
(using a cross-compiler).  Please see the general [[OsmocomBB]] GettingStarted for guidance.

<pre>

<pre>

<pre>
<pre>
<pre>
* prints the debug messages to stdout
* sends debug messages using [[GSMTAP]]

<pre>
<pre>
cd osmocom-bb/src/host/layer23/src/mobile/
./mobile -i 127.0.0.1
</pre>

Note: 
You should:
<pre>
<pre>
* press the start button on your phone
To capture sent and received packets:
* launch wireshark: $ nc -u -l -p 4729 > /dev/null & wireshark -k -i lo -f 'port 4729'

<pre>
<pre>
telnet localhost 4247
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
Welcome to the [[OsmocomBB]] Control interface
[[OsmocomBB]]>
</pre>

h2. Command Reference

<pre>
<pre>
Usage: ./mobile
 Some help...
  -h --help        this text
  -i --gsmtap-ip    The destination IP used for GSMTAP.
  -v --vty-port        The VTY port number to telnet to. (default 4247)
  -d --debug        Change debug flags.
</pre>

<pre>
TODO

h2. Missing features

* Handover support

h2. Authors

<pre>