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.
Add picture from clipboard (Maximum size: 48.8 MB)