Mobile » History » Revision 10
Revision 9 (Anonymous, 02/19/2016 10:49 PM) → Revision 10/15 (Anonymous, 02/19/2016 10:49 PM)
{{>toc}} <pre> <pre> <pre> [[PageOutline]] = The {{{mobile}}} program = 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. {{{mobile}}} is the most sophisticated OsmocomBB application so far. It implements most of the behavior of a regular GSM telephone, but is extended in many ways with features interesting to researchers. <pre> Using {{{mobile}}}, you can e.g. * perform cell (re)selection according to TS 03.22 * MM procedures like location updating, authentication, encryption * Establish MT and MO voice calls * Send and receive SMS * Perform supplementary services like USSD or call forwarding * hook it up to a PBX <pre> h2. In the spirit of all Osmocom projects, the user interface of {{{mobile}}} is based on text commands issued on the command line. == Prerequirements == It is assumed that you have already obtained the [[OsmocomBB]] OsmocomBB source code and compiled both the host programs as well as the firmware (using a cross-compiler). Please see the general [[OsmocomBB]] OsmocomBB GettingStarted for guidance. <pre> <pre> <pre> <pre> <pre> == Getting started with {{{mobile}}} == You need to follow the usual procedure using a CalypsoSerialCable, [wiki:osmocon] and the {{{layer1.*.bin}}} firmware image for your phone. {{{mobile}}} working: * uses the configuration file {{{~/.osmocom/bb/mobile.cfg}}} * creates a {{{vty}}} (virtual terminal) on port 4247 (per default) * prints the debug messages to stdout * sends debug messages using [[GSMTAP]] [wiki:GSMTAP] <pre> <pre> To start {{{mobile}}}: {{{ cd osmocom-bb/src/host/layer23/src/mobile/ ./mobile -i 127.0.0.1 </pre> }}} Note: You should: <pre> <pre> * start {{{mobile}}} * start [wiki:osmocon] and load the {{{layer1.*.bin}}} firmware image for your phone * press the start button on your phone To capture sent and received packets: * launch wireshark: $ nc -u -l -p 4729 > /dev/null & wireshark -k -i lo -f 'port 4729' <pre> <pre> To connect to the {{{vty}}}: {{{ telnet localhost 4247 Trying 127.0.0.1... Connected to localhost. Escape character is '^]'. Welcome to the [[OsmocomBB]] OsmocomBB Control interface [[OsmocomBB]]> OsmocomBB> </pre> h2. }}} == Command Reference <pre> <pre> == {{{mobile}}} usage: {{{ Usage: ./mobile Some help... -h --help this text -i --gsmtap-ip The destination IP used for GSMTAP. -v --vty-port The VTY port number to telnet to. (default 4247) -d --debug Change debug flags. </pre> <pre> }}} {{{vty}}} usage: TODO h2. == Missing features == * Handover support h2. == Authors <pre> == {{{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.