Project

General

Profile

Mobile » History » Version 3

tsaitgaist, 02/19/2016 10:49 PM
usage information

1 1 laforge
[[PageOutline]]
2 1 laforge
= The {{{mobile}}} program =
3 1 laforge
4 1 laforge
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.
5 1 laforge
6 1 laforge
{{{mobile}}} is the most sophisticated OsmocomBB application so far.  It implements the behavior of a regular GSM telephone, but is
7 1 laforge
extended in many ways with features interesting to researchers.
8 1 laforge
9 2 laforge
Using {{{mobile}}}, you can e.g.
10 1 laforge
 * perform cell (re)selection according to TS 03.22
11 1 laforge
 * MM procedures like location updating, authentication, encryption
12 1 laforge
 * send and receive SMS
13 1 laforge
 * Establish MT and MO voice calls
14 1 laforge
15 1 laforge
In the spirit of all Osmocom projects, the user interface of {{{mobile}}} is based on text commands issued on the command line.
16 1 laforge
17 1 laforge
== Prerequirements ==
18 1 laforge
19 1 laforge
It is assumed that you have already obtained the OsmocomBB source code and compiled both the host programs as well as the firmware
20 1 laforge
(using a cross-compiler).  Please see the general OsmocomBB GettingStarted for guidance.
21 1 laforge
22 2 laforge
== Getting started with {{{mobile}}} ==
23 1 laforge
24 2 laforge
You need to follow the usual procedure using a CalypsoSerialCable, [wiki:osmocon] and the {{{layer1.*.bin}}} firmware image for your phone.
25 1 laforge
26 3 tsaitgaist
{{{mobile}}} working:
27 3 tsaitgaist
 * uses the configuration file {{{/etc/osmocom/osmocom.cfg}}}
28 3 tsaitgaist
 * creates a {{{vty}}} (virtual terminal) on port 4247 (per default)
29 3 tsaitgaist
 * prints the debug messages to stdout
30 3 tsaitgaist
 * sends debug messages using [wiki:GSMTAP]
31 1 laforge
32 3 tsaitgaist
To start {{{mobile}}}:
33 3 tsaitgaist
{{{
34 3 tsaitgaist
cd osmocom-bb/src/host/layer23/src/mobile/
35 3 tsaitgaist
./mobile -i 127.0.0.1
36 3 tsaitgaist
}}}
37 3 tsaitgaist
38 3 tsaitgaist
To connect to the {{{vty}}}:
39 3 tsaitgaist
{{{
40 3 tsaitgaist
telnet localhost 4247
41 3 tsaitgaist
Trying 127.0.0.1...
42 3 tsaitgaist
Connected to localhost.
43 3 tsaitgaist
Escape character is '^]'.
44 3 tsaitgaist
Welcome to the OpenBSC Control interface
45 3 tsaitgaist
OsmocomBB>
46 3 tsaitgaist
}}}
47 3 tsaitgaist
48 1 laforge
== Command Reference ==
49 1 laforge
50 3 tsaitgaist
{{{mobile}}} usage:
51 3 tsaitgaist
{{{
52 3 tsaitgaist
Usage: ./mobile
53 3 tsaitgaist
 Some help...
54 3 tsaitgaist
  -h --help		this text
55 3 tsaitgaist
  -i --gsmtap-ip	The destination IP used for GSMTAP.
56 3 tsaitgaist
  -v --vty-port		The VTY port number to telnet to. (default 4247)
57 3 tsaitgaist
  -d --debug		Change debug flags.
58 3 tsaitgaist
}}}
59 1 laforge
60 3 tsaitgaist
{{{vty}}} usage:
61 3 tsaitgaist
TODO
62 1 laforge
== Authors ==
63 1 laforge
64 1 laforge
{{{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.