Project

General

Profile

Mobile » History » Version 7

loretta, 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 6 laforge
 * uses the configuration file {{{~/.osmocom/bb/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 1 laforge
}}}
36 7 loretta
37 7 loretta
Note: 
38 7 loretta
You should:
39 5 loretta
 * start {{{mobile}}}
40 5 loretta
 * start [wiki:osmocon] and load the {{{layer1.*.bin}}} firmware image for your phone  
41 1 laforge
 * press the start button on your phone
42 7 loretta
To capture sent and received packets:
43 7 loretta
 * launch wireshark: $ nc -u -l -p 4729 > /dev/null & wireshark -k -i lo -f 'port 4729'
44 3 tsaitgaist
45 3 tsaitgaist
To connect to the {{{vty}}}:
46 3 tsaitgaist
{{{
47 3 tsaitgaist
telnet localhost 4247
48 3 tsaitgaist
Trying 127.0.0.1...
49 3 tsaitgaist
Connected to localhost.
50 3 tsaitgaist
Escape character is '^]'.
51 3 tsaitgaist
Welcome to the OpenBSC Control interface
52 3 tsaitgaist
OsmocomBB>
53 3 tsaitgaist
}}}
54 3 tsaitgaist
55 1 laforge
== Command Reference ==
56 1 laforge
57 3 tsaitgaist
{{{mobile}}} usage:
58 3 tsaitgaist
{{{
59 3 tsaitgaist
Usage: ./mobile
60 3 tsaitgaist
 Some help...
61 3 tsaitgaist
  -h --help		this text
62 3 tsaitgaist
  -i --gsmtap-ip	The destination IP used for GSMTAP.
63 3 tsaitgaist
  -v --vty-port		The VTY port number to telnet to. (default 4247)
64 3 tsaitgaist
  -d --debug		Change debug flags.
65 3 tsaitgaist
}}}
66 1 laforge
67 1 laforge
{{{vty}}} usage:
68 1 laforge
TODO
69 4 sylvain
70 4 sylvain
== Missing features ==
71 4 sylvain
72 4 sylvain
 * SMS support is lacking
73 4 sylvain
74 4 sylvain
75 1 laforge
== Authors ==
76 1 laforge
77 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.