Mobile » History » Version 8
jolly, 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 | 8 | jolly | * Send and receive SMS |
14 | * Perform supplementary services like USSD or call forwarding |
||
15 | * hook it up to a PBX |
||
16 | 1 | laforge | |
17 | In the spirit of all Osmocom projects, the user interface of {{{mobile}}} is based on text commands issued on the command line. |
||
18 | |||
19 | == Prerequirements == |
||
20 | |||
21 | It is assumed that you have already obtained the OsmocomBB source code and compiled both the host programs as well as the firmware |
||
22 | (using a cross-compiler). Please see the general OsmocomBB GettingStarted for guidance. |
||
23 | |||
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 | 6 | laforge | * uses the configuration file {{{~/.osmocom/bb/osmocom.cfg}}} |
30 | 3 | tsaitgaist | * creates a {{{vty}}} (virtual terminal) on port 4247 (per default) |
31 | * prints the debug messages to stdout |
||
32 | * sends debug messages using [wiki:GSMTAP] |
||
33 | 1 | laforge | |
34 | 3 | tsaitgaist | To start {{{mobile}}}: |
35 | {{{ |
||
36 | cd osmocom-bb/src/host/layer23/src/mobile/ |
||
37 | ./mobile -i 127.0.0.1 |
||
38 | 1 | laforge | }}} |
39 | 7 | laforge | |
40 | Note: |
||
41 | You should: |
||
42 | 5 | laforge | * start {{{mobile}}} |
43 | * 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 | laforge | To capture sent and received packets: |
46 | * launch wireshark: $ nc -u -l -p 4729 > /dev/null & wireshark -k -i lo -f 'port 4729' |
||
47 | 3 | tsaitgaist | |
48 | To connect to the {{{vty}}}: |
||
49 | {{{ |
||
50 | telnet localhost 4247 |
||
51 | Trying 127.0.0.1... |
||
52 | Connected to localhost. |
||
53 | 1 | laforge | Escape character is '^]'. |
54 | 8 | jolly | Welcome to the OsmocomBB Control interface |
55 | 3 | tsaitgaist | OsmocomBB> |
56 | }}} |
||
57 | |||
58 | 1 | laforge | == Command Reference == |
59 | |||
60 | 3 | tsaitgaist | {{{mobile}}} usage: |
61 | {{{ |
||
62 | Usage: ./mobile |
||
63 | Some help... |
||
64 | -h --help this text |
||
65 | -i --gsmtap-ip The destination IP used for GSMTAP. |
||
66 | -v --vty-port The VTY port number to telnet to. (default 4247) |
||
67 | -d --debug Change debug flags. |
||
68 | }}} |
||
69 | 1 | laforge | |
70 | {{{vty}}} usage: |
||
71 | 4 | laforge | TODO |
72 | |||
73 | 1 | laforge | == Missing features == |
74 | 4 | laforge | |
75 | 8 | jolly | * Handover support |
76 | 4 | laforge | |
77 | |||
78 | 1 | laforge | == Authors == |
79 | |||
80 | {{{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. |