Cellular Network Infrastructure

[[PageOutline]]

= Installing a GSM network from scratch =

This document describes how to install, configure and run BTS transceiver, OsmoBTS, OpenBSC and LCR.

In order to use this quick howto, you must have basic knowledge about GIT and be familiar with compiling packages from source.

== Prerequisite ==

=== opencore-amr ===

This package installs GSM adaptive multirate codecs

It can downloaded at [http://sourceforge.net/projects/opencore-amr/files/opencore-amr/]

{{{

tar xvzf opencore-amr-x.x.x.tar.gz

cd opencore-amr-x.x.x

./configure

make

make install

ldconfig

cd ..

}}}

=== Sip-Sofia ===

This package installs the open source SIP stack of Nokia Research Center.

It can downloaded at [http://sourceforge.net/projects/sofia-sip/files/sofia-sip/].

{{{

tar xvzf sofia-sip-x.xx.xx.tar.gz

cd sofia-sip-x.xx.xx

./configure

make

make install

ldconfig

cd ..

}}}

=== oRTP ===

This package installs the open source RTP protocol required for libosmo-abis.

It can downloaded at [http://download.savannah.gnu.org/releases/linphone/ortp/sources/].

{{{

tar xvzf ortp-x.xx.x.tar.gz

cd ortp-x.xx.x

./configure

make

make install

ldconfig

cd ..

}}}

=== others ===

sqlite3 and libdbi should be available from your distribution.

== Installing  ==

=== Linux-Call-Router (LCR) ===

This package installs the open source PBX software to bridge ISDN (DSS1) / SIP / GSM (MNCC protocol)

The latest version can downloaded via git:

{{{

git clone git://git.misdn.eu/lcr.git/

}}}

{{{

cd lcr

autoreconf -i

./configure --with-sip --with-gsm-bs --with-gsm-ms --enable-gsm-hr

}}}

Sometimes it is necessary to point to different .../lib/pkgconfig/ path: PKG_CONFIG_PATH=/usr/local/lib/pkgconfig/ ./configure .....)

result should include:

configure: Compiled with GSM network side support

configure: Compiled with GSM mobile side support

configure: Compiled with GSM half rate codec support

configure: Compiled with GSM AMR codec support

configure: Compiled with SIP support

make

make install

ldconfig

cd ..

libosmocore: (core utility library for various osmocom projects)

load via git: git clone git://git.osmocom.org/libosmocore.git

cd libosmocore

git checkout -b

autoreconf -i

./configure

make

make install

ldconfig

cd ..

libosmo-abis: (library for openbsc)

load via git: git clone git://git.osmocom.org/libosmo-abis.git

cd libosmo-abis

autoreconf -i

./configure

(sometimes it is necessary to point to different .../lib/pkgconfig/ path: PKG_CONFIG_PATH=/usr/local/lib/pkgconfig/ ./configure .....)

make

make install

ldconfig

cd ..

openbsc: (GSM base station controller)

load via git: git clone git://git.osmocom.org/openbsc.git

cd openbsc/openbsc/

change repository: git checkout -b jolly/testing origin/jolly/testing

autoreconf -i

./configure

(sometimes it is necessary to point to different .../lib/pkgconfig/ path: PKG_CONFIG_PATH=/usr/local/lib/pkgconfig/ ./configure .....)

make

make install

cd ../..

osmo-bts: (BTS software)

load via git: git clone git://git.osmocom.org/osmo-bts.git

cd osmo-bts

change repository: git checkout -b jolly/trx origin/jolly/trx

autoreconf -i

./configure --enable-trx

(sometimes it is necessary to point to different .../lib/pkgconfig/ path: PKG_CONFIG_PATH=/usr/local/lib/pkgconfig/ ./configure .....)

make

make install

cd ..

configuration examples:

-----------------------

mkdir ~/.osmocom

~/.osmocom/osmo-bts.cfg

bts 0

 band DCS1800

 ipa unit-id 1801 0

 oml remote-ip 127.0.0.1

 rtp bind-ip 127.0.0.1

 rtp jitter-buffer 0

 paging lifetime 0

 radio-link-timeout 32

 gsmtap-sapi bcch

 gsmtap-sapi ccch

 gsmtap-sapi rach

 gsmtap-sapi agch

 gsmtap-sapi pch

 gsmtap-sapi sdcch

 gsmtap-sapi pacch

 gsmtap-sapi pdtch

 gsmtap-sapi sacch

 fn-advance 20

 ms-power-loop -10

 timing-advance-loop

 trx 0

  rxgain 0

  power 0