Mobile » History » Version 7
Anonymous, 02/19/2016 10:49 PM
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 | 7 | laforge | |
37 | Note: |
||
38 | You should: |
||
39 | 5 | laforge | * start {{{mobile}}} |
40 | * start [wiki:osmocon] and load the {{{layer1.*.bin}}} firmware image for your phone |
||
41 | 1 | laforge | * press the start button on your phone |
42 | 7 | laforge | To capture sent and received packets: |
43 | * launch wireshark: $ nc -u -l -p 4729 > /dev/null & wireshark -k -i lo -f 'port 4729' |
||
44 | 3 | tsaitgaist | |
45 | To connect to the {{{vty}}}: |
||
46 | {{{ |
||
47 | telnet localhost 4247 |
||
48 | Trying 127.0.0.1... |
||
49 | Connected to localhost. |
||
50 | Escape character is '^]'. |
||
51 | Welcome to the OpenBSC Control interface |
||
52 | OsmocomBB> |
||
53 | }}} |
||
54 | |||
55 | 1 | laforge | == Command Reference == |
56 | |||
57 | 3 | tsaitgaist | {{{mobile}}} usage: |
58 | {{{ |
||
59 | Usage: ./mobile |
||
60 | Some help... |
||
61 | -h --help this text |
||
62 | -i --gsmtap-ip The destination IP used for GSMTAP. |
||
63 | -v --vty-port The VTY port number to telnet to. (default 4247) |
||
64 | -d --debug Change debug flags. |
||
65 | }}} |
||
66 | 1 | laforge | |
67 | {{{vty}}} usage: |
||
68 | TODO |
||
69 | 4 | laforge | |
70 | == Missing features == |
||
71 | |||
72 | * SMS support is lacking |
||
73 | |||
74 | |||
75 | 1 | laforge | == Authors == |
76 | |||
77 | {{{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. |