Mobile » History » Version 6
laforge, 02/19/2016 10:49 PM
properly reference to new config file path
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 | 4 | laforge | {{{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 | |||
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 | * Establish MT and MO voice calls |
||
13 | |||
14 | In the spirit of all Osmocom projects, the user interface of {{{mobile}}} is based on text commands issued on the command line. |
||
15 | |||
16 | == Prerequirements == |
||
17 | |||
18 | It is assumed that you have already obtained the OsmocomBB source code and compiled both the host programs as well as the firmware |
||
19 | (using a cross-compiler). Please see the general OsmocomBB GettingStarted for guidance. |
||
20 | |||
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 | * prints the debug messages to stdout |
||
29 | * sends debug messages using [wiki:GSMTAP] |
||
30 | 1 | laforge | |
31 | 3 | tsaitgaist | To start {{{mobile}}}: |
32 | {{{ |
||
33 | cd osmocom-bb/src/host/layer23/src/mobile/ |
||
34 | ./mobile -i 127.0.0.1 |
||
35 | 1 | laforge | }}} |
36 | 5 | laforge | Note: You should |
37 | * start {{{mobile}}} |
||
38 | * start [wiki:osmocon] and load the {{{layer1.*.bin}}} firmware image for your phone |
||
39 | * press the start button on your phone |
||
40 | 3 | tsaitgaist | |
41 | To connect to the {{{vty}}}: |
||
42 | {{{ |
||
43 | telnet localhost 4247 |
||
44 | Trying 127.0.0.1... |
||
45 | Connected to localhost. |
||
46 | Escape character is '^]'. |
||
47 | Welcome to the OpenBSC Control interface |
||
48 | OsmocomBB> |
||
49 | }}} |
||
50 | |||
51 | 1 | laforge | == Command Reference == |
52 | |||
53 | 3 | tsaitgaist | {{{mobile}}} usage: |
54 | {{{ |
||
55 | Usage: ./mobile |
||
56 | Some help... |
||
57 | -h --help this text |
||
58 | -i --gsmtap-ip The destination IP used for GSMTAP. |
||
59 | -v --vty-port The VTY port number to telnet to. (default 4247) |
||
60 | -d --debug Change debug flags. |
||
61 | }}} |
||
62 | 1 | laforge | |
63 | {{{vty}}} usage: |
||
64 | TODO |
||
65 | 4 | laforge | |
66 | == Missing features == |
||
67 | |||
68 | * SMS support is lacking |
||
69 | |||
70 | |||
71 | 1 | laforge | == Authors == |
72 | |||
73 | {{{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. |