Project

General

Profile

WikiStart » History » Version 144

laforge, 04/19/2017 01:42 PM

1 1
h1. Welcome to Osmocom [[OpenBSC]]
2 129 laforge
3 135 laforge
{{>toc}}
4 1
5
We have started with an A-bis (plus BSC/MSC/HLR) implementation for experimentation and research purpose, but have since moved way beyond that.
6
7
What this means: [[OpenBSC]] is not just a standard BSC, but a _GSM network in a box_ software, implementing the minimal necessary parts to build a small, self-contained GSM network.
8 129 laforge
9 1
[[OpenBSC]] includes functionality normally performed by the following components of a GSM network: BSC (Base Station Controller), MSC (Mobile Switching Center), HLR (Home Location Register), AuC (Authentication Center), VLR (Visitor Location Register), EIR (Equipment Identity Register).
10 129 laforge
11 135 laforge
We have started with the Siemens BS11 microBTS, mainly targetted the ip.access nanoBTS for some years, but has since been extended to support a variety of other [[BTS]] equipment like the Ericsson RBS 2000 family.  Today, most of the users and active developers work not with proprietary BTSs, but with BTSs running our [[OsmoBTS]] software, i.e. either the [[sysmoBTS]] family of hardware or SDR based hardware with [[OsmoTRX:]] like the [[UmTRX:]] or "UmSITE":https://fairwaves.co/wp/products/.
12 129 laforge
13 135 laforge
_We are always looking for [[cellular-infrastructure:HardwareDonations]] of any kind of GSM / 3G related carrier equipment._
14 1
15 129 laforge
h1. Overview Diagram
16
17
18 1
Please see the below overview diagram about common possible configurations of the Osmocom software.
19
20 134 laforge
!osmocom-gsm.png!
21 1
22
23 129 laforge
h2. Getting started
24 1
25 129 laforge
[[UnderstandingOpenBSC]] -- Where to start learning about [[OpenBSC]], what it does, and how.
26 1
27 129 laforge
h2. [[OpenBSC]] Software
28 1
29 129 laforge
* Software for running a full minimal GSM Network in a Box:
30
** [[OpenBSC]] -- The Free Software project implementing various parts of the GSM network
31
*** [[osmo-nitb]] -- A stand-alone gsm-network-in-a-box program implementing minimal subset of BSC, MSC, HLR, AuC and EIR.
32
**** [[osmo-nitb_VTY]] -- Reference for the interactive command line and config file
33
* Software utilities for BTS configuration, provisioning and the like
34
** [[bs11_config]] -- A small tool for configuring the BS-11 using RS232
35
** [[ipaccess-find]] -- A small tool to find nanoBTS in your network 
36
** [[ipaccess-config]] -- A small tool to set NVRAM configuration of the nanoBTS
37
** [[isdnsync]] -- A small tool to use the PSTN as frequency standard
38
* Software for running in pure _BSC only_ mode, attaching via A/SCCP to a MSC
39
** [[osmo-bsc]] -- [[OpenBSC]] in BSC-only mode
40
** [[bsc_mgcp]] -- A stupid [[MediaGatewayControlProtocol]] (MGCP) gateway
41
*** [[bsc_mgcp_VTY]] -- Reference for the interactive command line and config file
42
* Software for UMA/GAN (Unified Mobile Access)
43
** [[osmo-ganc]] -- [[OpenBSC]] in GANC mode
44
* Special purpose software for aggregating multiple A or Gb links
45
** [[bsc_nat]] -- a BSC NAT/Multiplexer
46
*** [[bsc_nat_VTY]] -- Reference for the interactive command line and config file
47
*** [[bsc_nat_release]] -- Release testing for the BSC NAT.
48
** [[osmo-gbproxy]] -- A proxy/gateway for aggregating multiple Gb links betwen BSS and SGSN
49
*** [[osmo-gbproxy_VTY]] -- Reference for the interactive command line and config file
50
** [[release-testing|Testing]] -- Comments and what makes sense to test for releases
51 142 laforge
* [[OpenBSC]] related [[PortNumbers]] -- A list of TCP port numbers as they are used by [[OpenBSC]] and related programs
52 129 laforge
* Protocol extensions
53 142 laforge
**[[MgcpExtensions]] -- Extensions to MGCP
54 129 laforge
* [[simulation]] -- Running [[OpenBSC]] without a GSM Basestation
55
* Important legal information on [[SoftwareLicensing]]
56
* [[meas_web]] -- Web based measurement utility for [[OpenBSC]]
57
58 144 laforge
h3. Supported BTSs
59
60
61
h2. BTS Support
62
63
{{graphviz_link()
64
graph G {
65
66
        nanoBTS [label="ip.access\nnanoBTS", shape=box];
67
        OsmoBTS;
68
        sysmoBTS [label="sysmocom sysmoBTS\n(many models)", shape=box];
69
        LC15 [label="Nuran\nLitecell 1.5", shape=box];
70
        OCT [label="Octasic\nOCTBTS", shape=box];
71
        TRX [label="OsmoTRX"];
72
        OtherSDR [label="Other SDR HW", shape=box, style=dashed];
73
        OtherPHY [label="Other GSM PHY", shape=box, style=dashed];
74
        UmTRX [label="Fairwaves\nUmTRX", shape=box];
75
        USRP [label="Ettus USRP\nFamily", shape=box];
76
77
        BSC -- nanoBTS [label="Abis/IP"];
78
        BSC -- OsmoBTS [label="Abis/IP"];
79
80
        BSC -- BS11 [label="Siemens\nAbis/E1"];
81
        BSC -- RBS2K [label="Ericsson\nAbis/E1"];
82
        BSC -- Nokia [label="Nokia\nAbis/E1"];
83
84
        subgraph cluster_2 {
85
                BSC [label="BSC\n(OsmoBSC, OsmoNITB, 3rd party)" color=red];
86
                color=white
87
        }
88
89
        subgraph cluster_0 {
90
                BS11 [label="Siemens BS-11", shape=box];
91
                SIU [label="Ericsson SIU"];
92
                RBS2K [label="Ericsson RBS 2000\n(many models)", shape=box];
93
                Nokia [label="Nokia InSite, MetroSite", shape=box];
94
95
                BSC -- L2TPD [label="Unix Socket"];
96
                L2TPD -- SIU [label="Ericsson\nL2TP/IP"];
97
                SIU -- RBS2K [label="Ericsson\nAbis/E1"];
98
99
                { rank=same; BS11 RBS2K Nokia }
100
101
                label = "Classic E1/T1";
102
        }
103
104
        subgraph cluster_1 {
105
106
                OsmoBTS -- sysmoBTS [label="osmo-bts-sysmo"];
107
                OsmoBTS -- LC15 [label="osmo-bts-lc15"];
108
                OsmoBTS -- OCT [label="osmo-bts-octphy"];
109
                OsmoBTS -- TRX [label="osmo-bts-trx"];
110
                OsmoBTS -- OtherPHY [style=dashed];
111
112
                TRX -- USRP;
113
                TRX -- UmTRX;
114
                TRX -- OtherSDR [style=dashed];
115
116
                { rank=same; nanoBTS sysmoBTS LC15 OCT UmTRX }
117
118
                label = "IP/Ethernet based";
119
        }
120
121
}
122
}}
123
124
125 78 laforge
h3. Information related to a specific BTS model
126 1
127 130 laforge
{{child_pages(BTS_Hardware,depth=1)}}
128 103
129 135 laforge
h3. Topics related to BTSs with classic E1 interface (non-IP based):
130 132 laforge
131 129 laforge
{{child_pages(E1-Interface)}}
132
133
h3. Miscellaneous Information
134
135 131 laforge
* [[GSM]] -- Some links for starting to understand GSM
136 129 laforge
* [[LegalNotes]] -- Important Legal notes on operating GSM base stations
137
* [[FieldTests]] -- The [[OpenBSC]] field tests and their reports
138
139
h3. Howtos
140
141
* Standard configuration:
142 1
*** [[Building_OpenBSC]] -- Getting started with [[OpenBSC]] under Debian
143
*** [[multi-BTS_with_handover]] -- Connecting 2x BTS to a single BSC/NITB and enabling handover 
144 129 laforge
145 1
* Advanced topics:
146 129 laforge
*** [[OpenBSC_with_Asterisk]] -- A comprehensive tutorial on setting up [[OpenBSC]] with Asterisk
147
*** [[OpenBSC_LCR]] -- [[OpenBSC]]+LCR with Asterisk (obsolete)
148
*** [[OpenBSC_LCR_Ubuntu1204]] -- Short installation guide for [[OpenBSC]] with Asterisk on Ubuntu 12.04
149
*** [[OpenBSC_Crypto]] -- Howto add A5/x cryptography support to your [[OpenBSC]] setup
150
*** [[SDR_OsmoTRX_network_from_scratch]] -- Building everything from scratch for SDR based hardware with [[OsmoTRX]], [[OsmoBTS]] and [[OsmoNITB]].
151
152
* RF Topics:
153
*** [[cable_antenna]] -- Build new antennas for your BTS
154
*** [[ethernet_dummyload]] -- Use an old ethernet terminator as dummyload
155
*** [[10db_attenuator]] -- Turn 30mW into 3 mW
156
157
h2. Developers
158
159
* Browse the repositories at http://git.osmocom.org/
160 139 neels
* "Mailinglist":https://lists.osmocom.org/mailman/listinfo
161
** For voice/SMS/..., use "OpenBSC":https://lists.osmocom.org/mailman/listinfo/openbsc
162
** For GPRS/SGSN/data-comms related discussions, use "osmocom-net-gprs":https://lists.osmocom.org/mailman/listinfo/osmocom-net-gprs
163
* [[Jenkins|Continuous Integration efforts]]
164 129 laforge
* Wiki is right here ;)
165 135 laforge
* Developer conferences: [[OsmoDevCon]]
166 129 laforge
* [[Tasks]] -- Tasks/Internships/Junior Jobs for [[OpenBSC]] and Osmocom
167
* [[Devtools]] -- Various tools to find/fix errors, send patches, etc
168
* [[Coding_standards]] -- Coding standards
169
* [[PacketDump]] -- Using wireshark on PCAP files
170 13 laforge
171 129 laforge
h2. News
172 76 laforge
173 88
* _OpenBSC ran many more experimental and commercial networks, but no one bothered to update this section..._
174 129 laforge
* [[OpenBSC]] was running an experimental GSM network at "CCC Camp":http://events.ccc.de/camp/2011/wiki/GSM in the Summer of 2011
175
* [[OpenBSC]] was running an experimental GSM network at "27c3":http://events.ccc.de/congress/2010 in December 2010
176
* The slides of the "25C3 presentation _Running your own GSM network_":http://events.ccc.de/congress/2008/Fahrplan/events/3007.en.html "are available":http://events.ccc.de/congress/2008/Fahrplan/attachments/1259_25C3-OpenBSC.pdf.
177
* The slides of the "26C3 presentation _Fuzzing GSM handsets using [[OpenBSC]]_":http://events.ccc.de/congress/2009/Fahrplan/events/3535.en.html "are available":http://events.ccc.de/congress/2009/Fahrplan/attachments/1503_openbsc_gsm_fuzzing.pdf
178 76 laforge
179 129 laforge
h2. Related projects
180 1
181
* [[simplehlr]] -- A web interface for the [[OpenBSC]] HLR database
182 138 laforge
* [[OsmocomBB:]] - Free Software GSM protocol stack for mobile phones
183
* "OpenBTS":http://gnuradio.org/redmine/projects/gnuradio/wiki/OpenBTS
184 129 laforge
* "The THC GSM project":http://wiki.thc.org/gsm/
185
* "airprobe.org":http://airprobe.org/
186
* "Homepage of Dr.-Ing. Joachim Goeller":http://www2.informatik.hu-berlin.de/~goeller/
187
188
h2. Thanks
189 1
190 136 laforge
* to "On-Waves ehf":http://on-waves.com/ and "sysmocom GmbH":http://sysmocom.de/ for funding part of the development and maintennance
191
* to http://junghanns.net for supporting us with discounted E1 boards
192
* to "Netzing AG":http://netzing.de/ for funding part of the earlier [[OpenBSC:]] development
193
* to Kevin Redon for the Osmocom logo
Add picture from clipboard (Maximum size: 48.8 MB)