Project

General

Profile

Mobile » History » Version 9

ravisharan, 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 8 jolly
 * Send and receive SMS
14 8 jolly
 * Perform supplementary services like USSD or call forwarding
15 8 jolly
 * hook it up to a PBX
16 1 laforge
17 1 laforge
In the spirit of all Osmocom projects, the user interface of {{{mobile}}} is based on text commands issued on the command line.
18 1 laforge
19 1 laforge
== Prerequirements ==
20 1 laforge
21 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
22 1 laforge
(using a cross-compiler).  Please see the general OsmocomBB GettingStarted for guidance.
23 1 laforge
24 2 laforge
== Getting started with {{{mobile}}} ==
25 1 laforge
26 2 laforge
You need to follow the usual procedure using a CalypsoSerialCable, [wiki:osmocon] and the {{{layer1.*.bin}}} firmware image for your phone.
27 1 laforge
28 3 tsaitgaist
{{{mobile}}} working:
29 9 ravisharan
 * uses the configuration file {{{~/.osmocom/bb/mobile.cfg}}}
30 3 tsaitgaist
 * creates a {{{vty}}} (virtual terminal) on port 4247 (per default)
31 3 tsaitgaist
 * prints the debug messages to stdout
32 3 tsaitgaist
 * sends debug messages using [wiki:GSMTAP]
33 1 laforge
34 3 tsaitgaist
To start {{{mobile}}}:
35 3 tsaitgaist
{{{
36 3 tsaitgaist
cd osmocom-bb/src/host/layer23/src/mobile/
37 3 tsaitgaist
./mobile -i 127.0.0.1
38 1 laforge
}}}
39 7 loretta
40 7 loretta
Note: 
41 7 loretta
You should:
42 5 loretta
 * start {{{mobile}}}
43 5 loretta
 * start [wiki:osmocon] and load the {{{layer1.*.bin}}} firmware image for your phone  
44 1 laforge
 * press the start button on your phone
45 7 loretta
To capture sent and received packets:
46 7 loretta
 * launch wireshark: $ nc -u -l -p 4729 > /dev/null & wireshark -k -i lo -f 'port 4729'
47 3 tsaitgaist
48 3 tsaitgaist
To connect to the {{{vty}}}:
49 3 tsaitgaist
{{{
50 3 tsaitgaist
telnet localhost 4247
51 3 tsaitgaist
Trying 127.0.0.1...
52 3 tsaitgaist
Connected to localhost.
53 1 laforge
Escape character is '^]'.
54 8 jolly
Welcome to the OsmocomBB Control interface
55 3 tsaitgaist
OsmocomBB>
56 3 tsaitgaist
}}}
57 3 tsaitgaist
58 1 laforge
== Command Reference ==
59 1 laforge
60 3 tsaitgaist
{{{mobile}}} usage:
61 3 tsaitgaist
{{{
62 3 tsaitgaist
Usage: ./mobile
63 3 tsaitgaist
 Some help...
64 3 tsaitgaist
  -h --help		this text
65 3 tsaitgaist
  -i --gsmtap-ip	The destination IP used for GSMTAP.
66 3 tsaitgaist
  -v --vty-port		The VTY port number to telnet to. (default 4247)
67 3 tsaitgaist
  -d --debug		Change debug flags.
68 3 tsaitgaist
}}}
69 1 laforge
70 1 laforge
{{{vty}}} usage:
71 4 sylvain
TODO
72 4 sylvain
73 1 laforge
== Missing features ==
74 4 sylvain
75 8 jolly
 * Handover support
76 4 sylvain
77 4 sylvain
78 1 laforge
== Authors ==
79 1 laforge
80 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.