Project

General

Profile

Building OpenBSC » History » Version 41

wirelesss, 12/09/2016 10:57 AM

1 35
{{>toc}}
2 1
3 41 wirelesss
bq. *Before you consider building from source, be aware that there are [[cellular-infrastructure:Nightly Builds]]
4 38 wirelesss
available for Debian + Ubuntu platforms. These are recommended for normal users.*
5 1
6 38 wirelesss
7 35
h2. [[OpenBSC]] build guide
8 1
9 35
10
This page will describe the entire installation process of [[OpenBSC]] under GNU/Linux.
11
12 1
This tutorial is based on Debian Netinstall 5.0 but will work more or less the same with other GNU/Linux
13
distributions.
14
15
16 35
h3. Compiling + running [[OpenBSC]]
17 1
18 35
19
20
h4. Dependencies
21
22
23
Installing software that [[OpenBSC]] depends upon is distribution-dependent.  On Debian (or Debian-derived) systems,
24 1
you should install the following Debian packages before you start:
25 41 wirelesss
26 35
* libdbi0
27 1
* libdbi0-dev
28 41 wirelesss
* libdbi-dev
29 35
* libdbd-sqlite3
30
* libortp-dev
31
* build-essential
32
* libtool
33
* autoconf
34
* automake
35
* git-core
36 1
* pkg-config
37 41 wirelesss
* libtalloc-dev
38
* libpcsclite-dev 
39
* libpcap-dev
40 1
(The list may be incomplete)
41
42
On Debian, you can install those packages with
43 35
<pre>
44 37 msuraev
sudo apt install libdbi-dev libdbd-sqlite3 libortp-dev build-essential libtool autoconf automake git-core pkg-config libtalloc-dev libpcsclite-dev libpcap-dev
45 35
</pre>
46 1
47 37 msuraev
h4. Installation via packages
48 1
49 37 msuraev
It is always better to use your distribution's package management system for installing stuff. Only use "make install" as a last resort. For example, almost all Osmocom projects include metadata required for building .deb packages (contributions for other package systems are more than welcomed). So if you're installing OpenBSC on .deb based system (Debian, Ubuntu, Mint etc) the right way to do it is:
50
<pre>
51
git clone git://git.osmocom.org/XXX
52
cd XXX
53
dpkg-buildpackage -uc -us -tc
54
cd ..
55 35
sudo dpkg -i *.deb
56 1
</pre>
57 38 wirelesss
58 1
h4. Building 
59 35
60 41 wirelesss
Please follow instructions as per [[cellular-infrastructure:Build from Source]] to build following projects:
61 3
62 38 wirelesss
* libosmocore
63
* libosmo-abis
64
* libosmo-netif
65
* openbsc
66 35
67 14 laforge
68 35
Congratulations, you should now have the [[OpenBSC]] programs like _[[osmo-nitb]]_, _ipaccess-config_ and others in the subdirectories of 'src/',
69 17 laforge
like
70 35
* src/ipaccess/ipaccess-config (see [[ipaccess-config]])
71
* src/ipaccess/ipaccess-find (see [[ipaccess-find]])
72
* src/osmo-nitb/osmo-nitb (see [[osmo-nitb]])
73 11 laforge
74
To proceed from here, you typically would
75 35
* set-up your BTS (see [[BS11Getting_Started]] or [[nanoBTSGetting_Started]])
76
* configure and start [[osmo-nitb]]
77 17 laforge
78 11 laforge
79 35
h4. mISDN enabled kernel in case of E1 based BTS like BS-11
80 1
81
82 35
If you want to use a E1-based BTS (like the BS-11), you will need to install mISDN (or DAHDI).
83 1
84 35
*If you have an IP/Ethernet based BTS (like the ip.access nanoBTS), you don't need this section!*
85 1
86 35
Because [[OpenBSC]]'s E1 support relies on mISDN (named ISDN4Linux before) and hfcmulti as an interface to the BS11, it has to be integrated as a module into the kernel.
87 1
88 35
First of all you will need to download the 2.6.31 Linux kernel from "Change to */usr/src/* on your [[OpenBSC]] machine.
89
90 1
Unpack the archive:
91 39 wirelesss
92 35
<pre>
93 25 laforge
tar --bzip2 -xvf linux-2.6.31.tar.bz2
94 35
</pre>
95 25 laforge
and create a symlink to fit the Linux standard conventions: 
96 35
<pre>
97 25 laforge
ln -s linux-2.6.30 linux
98 35
</pre>
99 26 laforge
100
Now change to linux-2.6.30 typing
101 35
<pre>
102 26 laforge
cd linux-2.6.30
103 35
</pre>
104 26 laforge
105 1
You are ready now to prepare for the main part:
106
107
Install some tools needed to build the kernel.
108
109 35
<pre>
110 1
apt-get install libncurses5-dev kernel-package
111 35
</pre>
112 1
113
Now configure the kernel modules with
114 35
<pre>
115 1
make menuconfig
116 35
</pre>
117 1
118 35
Include the _mISDN_ modules and _hfcmulti / hfc e1 drivers_.
119 1
120 35
Save the new configuration to *.config* .
121 1
122
You can now try to build the Debian kernel package:
123 35
<pre>
124 1
make-kpkg linux-image --initrd --revision=openbsc01.0
125 35
</pre>
126 1
127
Go a directory higher
128 35
<pre>
129 1
cd ..
130 35
</pre>
131 1
132
and install the new kernel package typing:
133
134 35
<pre>
135 1
dpkg -i  kernelpackagename.deb
136 35
</pre>
137 1
138
Now you only have to add the dslot=1 parameter for hfcmulti to load with this parameter.
139 35
Otherwise [[OpenBSC]] will talk on signalling timeslot 15 where BS11 uses 1.
140 1
141 35
Simply add the following in */boot/grub/menu.lst* :
142 1
143
Add this line to the "Kernel"-line
144
145 35
*hfcmulti.dslot=1*
146 1
147
Save changes and reboot your machine with your new kernel.
148
149
150 35
h4. DAHDI kernel in case of E1 based BTS like BS-11
151
152
153 1
This is an alternative to the mISDN drivers.  For DAHDI installation, please check with the Asterisk / DAHDI homepage.
154
155 35
<pre>
156 1
dchan=1
157
bchan=2-30
158 35
</pre>
159
160
<pre>
161 1
e1_input
162
 e1_line 0 driver dahdi
163 35
</pre>
Add picture from clipboard (Maximum size: 48.8 MB)