Project

General

Profile

Mobile » History » Version 4

sylvain, 02/19/2016 10:49 PM

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 4 sylvain
{{{mobile}}} is the most sophisticated OsmocomBB application so far.  It implements most of 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
 * Establish MT and MO voice calls
13 1 laforge
14 1 laforge
In the spirit of all Osmocom projects, the user interface of {{{mobile}}} is based on text commands issued on the command line.
15 1 laforge
16 1 laforge
== Prerequirements ==
17 1 laforge
18 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
19 1 laforge
(using a cross-compiler).  Please see the general OsmocomBB GettingStarted for guidance.
20 1 laforge
21 2 laforge
== Getting started with {{{mobile}}} ==
22 1 laforge
23 2 laforge
You need to follow the usual procedure using a CalypsoSerialCable, [wiki:osmocon] and the {{{layer1.*.bin}}} firmware image for your phone.
24 1 laforge
25 3 tsaitgaist
{{{mobile}}} working:
26 3 tsaitgaist
 * uses the configuration file {{{/etc/osmocom/osmocom.cfg}}}
27 3 tsaitgaist
 * creates a {{{vty}}} (virtual terminal) on port 4247 (per default)
28 3 tsaitgaist
 * prints the debug messages to stdout
29 3 tsaitgaist
 * sends debug messages using [wiki:GSMTAP]
30 1 laforge
31 3 tsaitgaist
To start {{{mobile}}}:
32 3 tsaitgaist
{{{
33 3 tsaitgaist
cd osmocom-bb/src/host/layer23/src/mobile/
34 3 tsaitgaist
./mobile -i 127.0.0.1
35 3 tsaitgaist
}}}
36 3 tsaitgaist
37 3 tsaitgaist
To connect to the {{{vty}}}:
38 3 tsaitgaist
{{{
39 3 tsaitgaist
telnet localhost 4247
40 3 tsaitgaist
Trying 127.0.0.1...
41 3 tsaitgaist
Connected to localhost.
42 3 tsaitgaist
Escape character is '^]'.
43 3 tsaitgaist
Welcome to the OpenBSC Control interface
44 3 tsaitgaist
OsmocomBB>
45 3 tsaitgaist
}}}
46 3 tsaitgaist
47 1 laforge
== Command Reference ==
48 1 laforge
49 3 tsaitgaist
{{{mobile}}} usage:
50 3 tsaitgaist
{{{
51 3 tsaitgaist
Usage: ./mobile
52 3 tsaitgaist
 Some help...
53 3 tsaitgaist
  -h --help		this text
54 3 tsaitgaist
  -i --gsmtap-ip	The destination IP used for GSMTAP.
55 3 tsaitgaist
  -v --vty-port		The VTY port number to telnet to. (default 4247)
56 3 tsaitgaist
  -d --debug		Change debug flags.
57 3 tsaitgaist
}}}
58 1 laforge
59 1 laforge
{{{vty}}} usage:
60 1 laforge
TODO
61 4 sylvain
62 4 sylvain
== Missing features ==
63 4 sylvain
64 4 sylvain
 * SMS support is lacking
65 4 sylvain
66 4 sylvain
67 1 laforge
== Authors ==
68 1 laforge
69 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.