Project

General

Profile

Mobile » History » Version 3

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

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