Project

General

Profile

WikiStart » History » Version 129

laforge, 02/19/2016 10:48 PM

1 129 laforge
{{>toc}}
2 1
3 129 laforge
h1. Welcome to Osmocom [[OpenBSC]]
4
5
6 1
This is a project aiming to create a Free Software, (A)GPL-licensed software implementations for the GSM/3GPP protocol stacks and elements.
7
8
We have started with an A-bis (plus BSC/MSC/HLR) implementation for experimentation and research purpose, but have since moved way beyond that.
9
10 129 laforge
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.
11 1
12 129 laforge
[[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).
13 95 laforge
14 129 laforge
In addition, the Osmocom project also develops and maintains the [[osmo-sgsn]] and [[OpenGGSN]] programs for adding GPRS/EDGE capabilities.
15 124 laforge
16 129 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":http://www.sysmocom.de/products/sysmobts family of hardware or SDR based hardware with [[OsmoTRX]] like the "UmSITE":https://fairwaves.co/wp/products/.
17 1
18 129 laforge
_We are always looking for [[HardwareDonations]] of any kind of GSM / 3G related carrier equipment._
19 94 laforge
20 1
[[BlogList(format=float,recent=5,max_size=350)]]
21
22 129 laforge
There is also continued work on creating a Free Software / Open Source software SS7 (M3UA, SUA, SCCP, TCAP, MAP) protocol stack in Erlang, as well as a number of other side projects like the "SIMtrace":http://simtrace.osmocom.org/ protocol tracer/sniffer for (U)SIM APDUs.
23 1
24
25 129 laforge
h1. Overview Diagram
26
27
28 1
Please see the below overview diagram about common possible configurations of the Osmocom software.
29
30
[[Image(osmocom-gsm.png)]]
31
32
33 129 laforge
h2. Getting started
34 1
35 129 laforge
[[UnderstandingOpenBSC]] -- Where to start learning about [[OpenBSC]], what it does, and how.
36 1
37
38 129 laforge
h2. [[OpenBSC]] Software
39 1
40 129 laforge
* Software for running a full minimal GSM Network in a Box:
41
** [[OpenBSC]] -- The Free Software project implementing various parts of the GSM network
42
*** [[osmo-nitb]] -- A stand-alone gsm-network-in-a-box program implementing minimal subset of BSC, MSC, HLR, AuC and EIR.
43
**** [[osmo-nitb_VTY]] -- Reference for the interactive command line and config file
44
* Software utilities for BTS configuration, provisioning and the like
45
** [[bs11_config]] -- A small tool for configuring the BS-11 using RS232
46
** [[ipaccess-find]] -- A small tool to find nanoBTS in your network 
47
** [[ipaccess-config]] -- A small tool to set NVRAM configuration of the nanoBTS
48
** [[isdnsync]] -- A small tool to use the PSTN as frequency standard
49
* Software for running a BTS
50
** [[OsmoBTS]] -- A BTS implementation
51
** [[OsmoTRX]] -- A transceiver for [[OsmoBTS]] to use with SDR hardware
52
* Software for running in pure _BSC only_ mode, attaching via A/SCCP to a MSC
53
** [[osmo-bsc]] -- [[OpenBSC]] in BSC-only mode
54
** [[bsc_msc_ip]] -- A previous utility to connect to a MSC via A over IP
55
*** [[OpenBSCWithSCCP]] -- Howto use [[OpenBSC]] with a separate/real MSC
56
** [[bsc_mgcp]] -- A stupid [[MediaGatewayControlProtocol]] (MGCP) gateway
57
*** [[bsc_mgcp_VTY]] -- Reference for the interactive command line and config file
58
* Software for UMA/GAN (Unified Mobile Access)
59
** [[osmo-ganc]] -- [[OpenBSC]] in GANC mode
60
* Special purpose software for aggregating multiple A or Gb links
61
** [[bsc_nat]] -- a BSC NAT/Multiplexer
62
*** [[bsc_nat_VTY]] -- Reference for the interactive command line and config file
63
*** [[bsc_nat_release]] -- Release testing for the BSC NAT.
64
** [[osmo-gbproxy]] -- A proxy/gateway for aggregating multiple Gb links betwen BSS and SGSN
65
*** [[osmo-gbproxy_VTY]] -- Reference for the interactive command line and config file
66
** [[release-testing|Testing]] -- Comments and what makes sense to test for releases
67
* GPRS related software
68
** [[osmo-sgsn]] -- A work-in-progress SGSN
69
*** [[osmo-sgsn_VTY]] -- Reference for the interactive command line and config file
70
*** [[OpenBSC_GPRS]] -- Howto add data support to your [[OpenBSC]] setup
71
** [[osmo-pcu]] -- A work-in-progress RLC/MAC and PCU implementation
72
* [[OpenBSC]] related
73
*** [[cellmgr_ng]] -- The cellmgr_ng project to bring old equipment to the world of IP
74
*** [[simplehlr]] -- A web interface for the [[OpenBSC]] HLR database
75
* [[PortNumbers]] -- A list of TCP port numbers as they are used by [[OpenBSC]] and related programs
76
* Protocol extensions
77
*** [[MgcpExtensions]] -- Extensions to MGCP
78
* [[simulation]] -- Running [[OpenBSC]] without a GSM Basestation
79
* Important legal information on [[SoftwareLicensing]]
80
* [[meas_web]] -- Web based measurement utility for [[OpenBSC]]
81 78 laforge
82 1
83 129 laforge
h3. Information related to a specific BTS model
84 84 laforge
85 129 laforge
* [[BS11]] -- The Siemens BS-11 microBTS
86
** [[BS11Sales]] -- BS-11 units are sold out by now, sorry.
87
** [[BS11Package_List]] -- Make sure everything is in the package
88
** [[BS11Configuration]] -- How to use / setup the hardware
89
** [[BS11LMT]] -- The local maintenance Terminal
90
** [[BS11Getting_Started]] -- Getting started with your BS-11
91
** [[BS11Troubleshooting]] -- When something doesn't work
92
** [[BS11Internals]] -- Details like PCB photographs
93
** [[E1-to-RJ45]] -- Howto build your E1<>RJ45 cable
94
** [[BS11RJ45mod]] -- How to add RJ45 connectors to your BS-11
95
** [[Isdnsync]] -- Howto use the PSTN as frequency standard
96
* [[nanoBTS]] -- the ip.access nanoBTS
97
** [[nanoBTSGetting_Started]] -- How to get started with a nanoBTS
98
** [[nanoBTSModels]] -- Known models
99
** [[nanoBTSInternals]] -- Details like PCB photographs and debug port
100
** [[nanoBTSmultiTRX]] -- Creating a nanoBTS multi-TRX setup
101
* [[HSL_Femto]] -- the HSL 2.75G Femtocell
102
* [[Ericsson_RBS]] -- Ericsson BTSs (RBS2308, RBS2401)
103
* [[Motorola_Horizon_macro]] -- Motorola Horizon macro BTS
104
* [[Nokia_Site_family]] -- Nokia Site family BTS
105
* [[Ettus_USRP_B2xx_family]] -- Ettus USRP B2xx family
106 103
107 75 laforge
108 129 laforge
h3. Miscellaneous Information
109
110
* [[GSM]] -- Some links for starting to understand GSM
111
* [[HFC-E1|HFC-E1 Evaluation Board]] -- The E1 card we use for attaching classic E1 based A-bis links
112
* [[GSMStandards]] -- The specifications for GSM
113
* [[A5_GSM_AT_tricks]] -- A5: Authentication & Ciphering
114
* [[mISDN]] -- The Linux ISDN stack
115
* [[HandsetBugs]] -- Things we have observed during development
116
* [[GSM_Security]] -- The GSM security issues that we find
117
118
* [[LegalNotes]] -- Important Legal notes on operating GSM base stations
119
* [[FieldTests]] -- The [[OpenBSC]] field tests and their reports
120
121
122
h3. Howtos
123
124
* Standard configuration:
125
*** [[Building_OpenBSC]] -- Getting started with [[OpenBSC]] under Debian
126
*** [[multi-BTS_with_handover]] -- Connecting 2x BTS to a single BSC/NITB and enabling handover 
127
128
* Advanced topics:
129
*** [[OpenBSC_with_Asterisk]] -- A comprehensive tutorial on setting up [[OpenBSC]] with Asterisk
130
*** [[OpenBSC_LCR]] -- [[OpenBSC]]+LCR with Asterisk (obsolete)
131
*** [[OpenBSC_LCR_Ubuntu1204]] -- Short installation guide for [[OpenBSC]] with Asterisk on Ubuntu 12.04
132
*** [[OpenBSC_Crypto]] -- Howto add A5/x cryptography support to your [[OpenBSC]] setup
133
*** [[SDR_OsmoTRX_network_from_scratch]] -- Building everything from scratch for SDR based hardware with [[OsmoTRX]], [[OsmoBTS]] and [[OsmoNITB]].
134
135
* RF Topics:
136
*** [[cable_antenna]] -- Build new antennas for your BTS
137
*** [[ethernet_dummyload]] -- Use an old ethernet terminator as dummyload
138
*** [[10db_attenuator]] -- Turn 30mW into 3 mW
139
140
141
h2. Developers
142
143
144
<pre>
145
<pre>
146
<pre>
147
<pre>
148
*** Browse the repositories at http://git.osmocom.org/
149
* Mailinglist is at "* [[Jenkins|Continuous Integration efforts"httplistsgnumonksorgmailmanlistinfoopenbsc]]
150
* Wiki is right here ;)
151
* Developer conferences: [[OsmoDevCon2016]], [[OsmoDevCon2015]], [[OsmoDevCon2014]], [[OsmoDevCon2013]], [[OsmoDevCon2012]]
152
* [[Tasks]] -- Tasks/Internships/Junior Jobs for [[OpenBSC]] and Osmocom
153
* [[Devtools]] -- Various tools to find/fix errors, send patches, etc
154
* [[Coding_standards]] -- Coding standards
155
156
157
h3. Tools for developers
158
159 90
 
160 129 laforge
* [[WandelGoltermannMA10]] -- a GSM protocol analyzer ISA card
161
* [[TektronixK1103]] -- GSM protocol tester and analyzer
162
* [[PacketDump]] -- Using wireshark on PCAP files
163
* [[MagicSIM]] -- SIM cards where you can program the Ki
164 32 laforge
165 13 laforge
166 129 laforge
h2. News
167 76 laforge
168 88
169 129 laforge
* _OpenBSC ran many more experimental and commercial networks, but no one bothered to update this section..._
170
* [[OpenBSC]] was running an experimental GSM network at "CCC Camp":http://events.ccc.de/camp/2011/wiki/GSM in the Summer of 2011
171
* [[OpenBSC]] was running an experimental GSM network at "27c3":http://events.ccc.de/congress/2010 in December 2010
172
* 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.
173
* 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
174 76 laforge
175
176
177 129 laforge
h2. Related projects
178
179
180
* "-- [[OsmocomBB]] - Free Software GSM protocol stack for mobile phones
181
* [http://gnuradio.org/redmine/projects/gnuradio/wiki/OpenBTS [[OpenBTS]]":http://bb.osmocom.org/]
182
* "The THC GSM project":http://wiki.thc.org/gsm/
183
* "airprobe.org":http://airprobe.org/
184
* "Homepage of Dr.-Ing. Joachim Goeller":http://www2.informatik.hu-berlin.de/~goeller/
185
186
187
h2. Thanks
188
189
190
* to "for funding part of the [[OpenBSC]] development
191
* to [http://junghanns.net":http://netzing.de] for supporting us with discounted E1 boards
192
* to "for funding part of the [[OpenBSC]] development
193
* to Kevin Redon for the osmocom logo
194 1
 
195
196 129 laforge
h2. Starting Points about trac
197 1
198 129 laforge
199
* About [[WikiFormatting]]
200
* [[TracGuide]] --  Built-in Documentation
201
* [http://trac.edgewall.org/ The Trac project":http://www.on-waves.com] -- Trac Open Source Project
202
* "Trac FAQ":http://trac.edgewall.org/wiki/TracFaq -- Frequently Asked Questions
203
* [[TracSupport]] --  Trac Support
204
205
For a complete list of local wiki pages, see [[TitleIndex]].
Add picture from clipboard (Maximum size: 48.8 MB)