Mobile » History » Version 3

Version 2 (laforge, 02/19/2016 10:49 PM) → Version 3/14 (tsaitgaist, 02/19/2016 10:49 PM)

= The {{{mobile}}} program =

The {{{mobile}}} program is one of the various host (PC) based programs that you can use together with the {{{layer1.*.bin}}} firmware images inside the phone.

{{{mobile}}} is the most sophisticated OsmocomBB application so far. It implements the behavior of a regular GSM telephone, but is
extended in many ways with features interesting to researchers.

Using {{{mobile}}}, you can e.g.
* perform cell (re)selection according to TS 03.22
* MM procedures like location updating, authentication, encryption
* send and receive SMS
* Establish MT and MO voice calls

In the spirit of all Osmocom projects, the user interface of {{{mobile}}} is based on text commands issued on the command line.

== 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.

== Getting started with {{{mobile}}} ==

You need to follow the usual procedure using a CalypsoSerialCable, [wiki:osmocon] and the {{{layer1.*.bin}}} firmware image for your phone.

{{{mobile}}} working:
* uses the configuration file {{{/etc/osmocom/osmocom.cfg}}}
* creates a {{{vty}}} (virtual terminal) on port 4247 (per default)
* prints the debug messages to stdout
* sends debug messages using [wiki:GSMTAP]

To start {{{mobile}}}:
cd osmocom-bb/src/host/layer23/src/mobile/
./mobile -i

To connect to the {{{vty}}}:
telnet localhost 4247
Connected to localhost.
Escape character is '^]'.
Welcome to the OpenBSC Control interface

== Command Reference ==

{{{mobile}}} usage:
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.

{{{vty}}} usage:
== Authors ==

{{{mobile}}} was primarily written by Andreas Eversberg, based on some initial work that Harald did on layer23. The list of contributors is long, see the git log for details.