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. |