Project

General

Profile

OpenBSC » History » Version 26

ipse, 02/19/2016 10:47 PM
s/hardware/SDR hardware/ in graphs

1 13 laforge
[[PageOutline]]
2 1 laforge
'''OpenBSC''' is the current name for a software program that started with the name bs11-abis.
3
4
== What is OpenBSC ==
5 2 laforge
It is a [wiki:BSC] (Base Station Controller) side implementation of the A-bis protocol, as implemented in the GSM Technical Specification 08.5x and 12.21.  It implements a minimal subset of the [wiki:BSC], [wiki:MSC] and [wiki:HLR].  It does not implement ant of the interfaces (like the A and B interfaces) between the higher-order GSM network components.
6 1 laforge
7
The goal of the project is to
8
 * provide a basis for experimentation and security research with GSM from the network side
9
 * document, publicized and point out any security related issues that we find as part of that
10
 * learn more about GSM networks on a lower level, particularly the practical aspects with real-world equipment
11
12 17 laforge
We '''are not primarily interested''' in
13 14 laforge
 * building a stable/reliable BSC/MSC for deployment in networks requiring high-9 (99.999....) availability
14 1 laforge
 * building something that follows the GSM spec to the last detail
15
 * disrupting actual commercial GSM network
16
17
== Requirements ==
18 13 laforge
19 17 laforge
While OpenBSC is mainly written in portable C99 code, there are is one non-portable parts: The E1 input driver requires a Linux kernel with mISDN support and an [wiki:E1] interface card compatible with [wiki:mISDN].  You only need this if you have an E1 based BTS.
20 1 laforge
21 25 ipse
To operate a GSM network, you not only need OpenBSC but of course also some kind of GSM [wiki:BTS].  The only currently tested configurations are with a
22 1 laforge
 * sysmocom [http://www.sysmocom.de/products/sysmobts sysmoBTS] (by means of [wiki:OsmoBTS])
23 25 ipse
 * [https://fairwaves.ru fairwaves] UmSITE and UmDESK (using [wiki:OsmoBTS])
24 1 laforge
 * Siemens [wiki:BS11 BS-11] microBTS
25
 * [wiki:nanoBTS ip.access nanoBTS]
26 25 ipse
27
IF you feel geeky, you could also build a BTS yourself, using [http://code.google.com/p/umtrx/ UmTRX] SDR (Software Defined Radio) hardware and a usual PC with [wiki:OsmoBTS] software. The software installation is described at the [wiki:network_from_scratch] page.
28 1 laforge
29 17 laforge
== Configurations / Modes ==
30
31
=== OpenBSC network-in-the-box (NITB) mode ===
32
33
This is ''very different'' from a classic GSM network in which the BSC is only one minor element in the distributed network consisting
34
of many different elements like BSC, MSC, HLR, etc.  Nonetheless, it is the ''classic'' mode to operate OpenBSC.  In this configuration, you only need (at least) one BTS and OpenBSC.  There is no need for a MSC, HLR, VLR, AuC or any other traditional GSM network components.
35
36
{{{
37
#!graphviz
38
digraph G {
39
rankdir=LR 
40
bs11->OpenBSC    [ label="Abis/E1" ]
41
nanobts->OpenBSC [ label="Abis/IP" ]
42 22 laforge
sysmobts->OpenBSC [ label="Abis/IP" ]
43 23 ipse
osmobts->OpenBSC [ label="Abis/IP" ]
44 17 laforge
bs11    [ label = "Siemens\nBS-11" ]
45
nanobts [ label = "ip.access\nnanoBTS" ]
46 22 laforge
sysmobts [ label = "sysmocom\nsysmoBTS" ]
47 26 ipse
osmobts [ label = "osmoBTS +\nSDR hardware" ]
48 17 laforge
OpenBSC [ label = "OpenBSC\nNITB" ]
49
}
50
}}}
51
52 19 laforge
In order to use the NITB mode, you will use the [wiki:osmo-nitb] program.
53 1 laforge
54 24 ipse
==== Interconnecting OpenBSC with an ISDN or SIP PBX ====
55
If you want to connect calls outside of your OpenBSC based GSM network, you can have [http://isdn.eversberg.eu/ Linux Call Router] and OpenBSC
56 18 laforge
work together to create a setup like this:
57
58
{{{
59
#!graphviz
60
digraph G {
61
rankdir=LR 
62
bs11->OpenBSC    [ label="Abis/E1" ]
63
nanobts->OpenBSC [ label="Abis/IP" ]
64 22 laforge
sysmobts->OpenBSC [ label="Abis/IP" ]
65 23 ipse
osmobts->OpenBSC [ label="Abis/IP" ]
66 1 laforge
OpenBSC->LCR     [ label="MNCC Socket" ]
67 18 laforge
LCR->ISDN        [ label="E1/PRI/BRI" ]
68 24 ipse
LCR->SIP         [ label="SIP/RTP" ]
69 18 laforge
bs11    [ label = "Siemens\nBS-11" ]
70
nanobts [ label = "ip.access\nnanoBTS" ]
71 22 laforge
sysmobts [ label = "sysmocom\nsysmoBTS" ]
72 26 ipse
osmobts [ label = "osmoBTS +\nSDR hardware" ]
73 18 laforge
OpenBSC [ label = "OpenBSC\nNITB" ]
74
}
75
}}}
76
77 17 laforge
=== OpenBSC in BSC-only mode ===
78 1 laforge
79 17 laforge
If you want to use OpenBSC as a classic GSM BSC, you can do that as well.  However, you will need all other parts of the GSM
80 18 laforge
network and a MSC that can provide an A-over-IP interface using SCCP-lite
81 17 laforge
82
{{{
83
#!graphviz
84
digraph G {
85
rankdir=LR;
86
bs11->OpenBSC    [ label="Abis/E1" ];
87
nanobts->OpenBSC [ label="Abis/IP" ];
88 22 laforge
sysmobts->OpenBSC [ label="Abis/IP" ]
89 23 ipse
osmobts->OpenBSC [ label="Abis/IP" ]
90 17 laforge
OpenBSC->MSC     [ label="A/SCCP-Lite/IP" ];
91 1 laforge
subgraph core {
92
  MSC->VLR;
93 17 laforge
  MSC->HLR;
94
  HLR->AUC;
95 18 laforge
  label = "not included";
96
  color = blue;
97 17 laforge
}
98
bs11    [ label = "Siemens\nBS-11" ];
99 1 laforge
nanobts [ label = "ip.access\nnanoBTS" ];
100 22 laforge
sysmobts [ label = "sysmocom\nsysmoBTS" ]
101 1 laforge
OpenBSC [ label = "OpenBSC\nosmo-bsc" ];
102 26 ipse
osmobts [ label = "osmoBTS +\nSDR hardware" ]
103 1 laforge
}
104 17 laforge
}}}
105 18 laforge
106
In order to use the BSC-only mode, you will use the [wiki:osmo-bsc] program.
107
108 12 laforge
== Source code ==
109 13 laforge
110 1 laforge
=== Releases ===
111
As we're a mostly research oriented project, we don't really have any releases yet.  This will likely change soon.
112
113
=== Development Version ===
114
You can check out the source code via
115 15 laforge
{{{
116 1 laforge
git clone git://git.osmocom.org/openbsc.git
117
}}}
118 18 laforge
or browse it at http://cgit.osmocom.org/cgit/openbsc/
119 1 laforge
120 3 laforge
== Mailing list ==
121 16 laforge
122 18 laforge
There's a '''developer''' mailing list called openbsc@lists.osmocom.org
123 1 laforge
Subscription is available at [http://lists.osmocom.org/mailman/listinfo/openbsc/]
124
125
== IRC (Internet Relay Chat) ==
126 13 laforge
127 1 laforge
We have an IRC channel where some developers and users hang out.  You can find it at:
128
irc.freenode.net/#openbsc
129
130
== Project status ==
131
132 13 laforge
=== Things that work ===
133 1 laforge
 * Housekeeping
134
  * [wiki:OML] Initialization of the BTS
135 14 laforge
  * Support for frequency hopping channels on BTS equipment that supports it (like BS-11)
136 13 laforge
  * [wiki:RSL] bringup, channel allocation, Channel required / Immediate Assign
137
 * Mobility Management
138
  * Very simplistic [wiki:HLR] implemented as sqlite database
139
  * Non-secure Authentication using [wiki:IMEI]/[wiki:IMSI] and regular SIM cards.
140 18 laforge
  * Authentication using COMP128v1 if you have SIM cards with known Ki
141 1 laforge
  * [wiki:IMEI]/[wiki:IMSI] skimming of all phones that try to register with OpenBSC
142 13 laforge
  * Transmission of MM INFO packets with operator name and local time / timezone
143
  * paging of mobiles that are registered to the BTS
144
  * keeping track of which location area a phone has last performed location updating
145
  * in-call handover between multiple cells inside one BSC
146
 * SMS Support
147
  * [wiki:SMS] reception and [wiki:SMS] sending, including routing between subscribers
148 18 laforge
  * Sending of SMS from OpenBSC command line
149 13 laforge
  * Sending of SMS from external applications by writing to the SQL tables
150
 * Voice Call Support
151
  * MO (Mobile Originated) and MT (Mobile Terminated) calls
152
  * TCH/F support with FR and EFR codec
153
  * TCH/H support with AMR codec (in BSC-only configuration)
154
 * E1 support
155
  * demultiplex of the four 16k sub-channels with voice data contained in one [wiki:E1] timeslot
156
  * support for multiple [wiki:TRX] in one [wiki:BTS]
157
  * support for multiple [wiki:BTS] connected to the same E1 link (multi-loop configuration)
158 1 laforge
 * Abis/IP support
159 13 laforge
  * Abis/IP protocol for nanoBTS
160
  * RTP gateway to interoperate E1 based BTS and nanoBTS on one BSC and switch calls between them
161
 * GPRS/EDGE support
162
  * configuring the nanoBTS OML objects/attributes for GPRS and EDGE
163
  * setting SYSTEM INFORMATION 13 via RSL
164
  * configurable RAID/CGI/NSVCI/NSEI/BVCI
165 1 laforge
  * have the BTS interoperate a SGSN with Gb (NS-over-IP) interface
166 18 laforge
  * beta state [wiki:OsmoSGSN] included along OpenBSC
167 1 laforge
168 11 laforge
=== Things that are implemented but don't work yet or aren't tested yet ===
169 20 laforge
 * dynamic PDCH / TCH switching
170 7 laforge
171
=== Things being worked at ===
172 1 laforge
 *  GPS/DCF77 disciplined quartz reference for the HFC-E1 card (via HS-Esslingen, Student Research Project)
173
174 20 laforge
=== Things that are not implemented ===
175 2 laforge
 * Cell Broadcast
176 20 laforge
 * Any type of transcoding of voice data
177
 * TCH/H voice calls (they work in [wiki:osmo-bsc], but not in [wiki:osmo-nitb])
178 2 laforge
 * [wiki:CSD] calls
179 20 laforge
 * emergency call handling (works in [wiki:osmo-bsc], but not in [wiki:osmo-nitb])
180 4 laforge
 * Discontinuous TX and RX ([wiki:DTX] / [wiki:DRX]) support
181 2 laforge
182 1 laforge
== Authors ==
183
184 19 laforge
OpenBSC was mainly developed by [http://laforge.gnumonks.org/ Harald Welte] and Holger Freyther. Contributions by Dieter Spaar, Stefan Schmidt, Daniel Willmann, Jan Luebbe, Thomas Seiler and Andreas Eversberg.
185 1 laforge
186 11 laforge
Special thanks to Dieter Spaar for [wiki:BS11-Init] and tons of feedback and comments, without which we would not have been able to make progress as quickly as we did.
Add picture from clipboard (Maximum size: 48.8 MB)