Project

General

Profile

Wiki » History » Version 25

neels, 10/19/2017 03:57 PM

1 13 laforge
h1. Intro: Osmocom Cellular Network Infrastructure
2 1 laforge
3 7 laforge
{{>toc}}
4
5 13 laforge
This is a project aiming to create a [[Free / Open Source Software]], (A)GPL-licensed software implementations for the GSM/3GPP protocol stacks and network elements, preferably as pure software implementations running on general-purpose computers.  All our software is available in source code form, to anyone.
6 1 laforge
7 13 laforge
This is very contrary to classic telecom vendors, where every network element is implemented as proprietary hardware and software, without the ability to understand or modify then, and where each and every feature is subject to license fees.
8 1 laforge
9 13 laforge
We had originally started with an A-bis (plus BSC/MSC/HLR) implementation for experimentation and research purpose (now called [[OpenBSC:]], but have since moved way beyond that and implemented many other interfaces and network elements of GSM, GPRS, EDGE and UMTS/HSPA networks.
10 1 laforge
11 13 laforge
At the heart of most installations is the OpenBSC project with its two flavors
12
* [[OsmoNITB:]] - a _GSM network in a box_ software, implementing the minimal necessary parts to build a small, self-contained GSM network.
13
* [[OsmoBSC:]] - a pure _GSM Base Station Controller_ with support for many different BTS vendors and models attached via Abis (over E1 and IP).
14 1 laforge
15 13 laforge
The actual radio interface of such a network can be provided by classic GSM BTS equipment from classic Vendors like Siemens, Nokia, Ericsson, ip.access.  However, a variety of more modern BTS options are avalable, based on our [[OsmoBTS:]] software using hardware from sysmocom ([[openbsc:sysmoBTS]]), Fairwaves ([[UmTRX:]]) or Ettus (USRP)
16 1 laforge
17 24 laforge
In addition, the Osmocom project also develops and maintains the [[OsmoPCU:]], [[OsmoSGSN:]] and [[OpenGGSN:OsmoGGSN]] programs for adding GPRS and EDGE capabilities.
18 1 laforge
19 13 laforge
Most recently, there is a project for adding 3G (UMTS, HSPA) support.  Specifically, this is adding Iu-CS and Iu-PS support to [[OsmoNITB:]], as well as a new [[OsmoHNBGW:]] to offer an Iuh interface towards hNodeBs (femtocells, small cells)
20 6 laforge
21 11 laforge
_We are always looking for [[HardwareDonations]] of any kind of 2G / 3G / LTE related carrier equipment._
22 6 laforge
23 13 laforge
There is also work on creating SS7 / SIGTRAN / TCAP / MAP protocol stacks, both in the [[erlang-core-network-signalling-projects:Erlang]] programming language as well as in Smalltalk.
24 6 laforge
25 13 laforge
There are many other side projects like the "SIMtrace":http://simtrace.osmocom.org/ protocol tracer/sniffer for (U)SIM APDUs.
26 6 laforge
27 13 laforge
28 6 laforge
h1. Overview Diagram
29
30
Please see the below overview diagram about common possible configurations of the Osmocom software.
31
32 4 laforge
!osmocom-gsm.png!
33 6 laforge
34
h2. Getting started
35 1 laforge
36 25 neels
The recommended way of installing Osmocom software is by [[Nightly Builds]] (for Debian and Ubuntu based systems).
37 20 neels
38 1 laforge
The alternative is to [[Build from Source]].
39 20 neels
40 25 neels
To pick wich Osmocom components you need and where to go from there, take a look at the [[Configuration Guide]].
41
42
If you have an OsmoNITB installation and would like to move to having separate OsmoMSC and OsmoBSC with the new M3UA SIGTRAN, see the [[OsmoNITB Migration Guide]].
43 6 laforge
44
h2. Software
45
46
h3.  Software for a Base Transceiver Station
47
48
* [[OsmoBTS:]] -- A BTS implementation
49
** [[OsmoTRX:]] -- A transceiver for [[OsmoBTS:]] to use with SDR hardware
50 8 laforge
* [[OsmoPCU:]] -- A packet control unit for GPRS/EDGE enabling the BTS.
51 6 laforge
52
h3. Software for running a full minimal GSM Network in a Box
53
54
* [[OsmoNITB:]] -- A stand-alone gsm-network-in-a-box program implementing minimal subset of BSC, MSC, HLR, AuC and EIR.
55
56
h3. Software for running in pure _BSC only_ mode, attaching via A/SCCP to a MSC
57
58 16 laforge
* [[OsmoBSC:]] -- [[OpenBSC:]] in BSC-only mode (with external MSC)
59
* [[bsc_mgcp|osmo-bsc_mgcp]] -- A stupid [[MediaGatewayControlProtocol]] (MGCP) gateway for OsmoBSC
60
61 6 laforge
62
h3.  Software for UMA/GAN (Unified Mobile Access)
63
64
* [[OpenBSC:osmo-ganc]] -- [[OpenBSC:]] in GANC mode
65
66
h3.  Special purpose software for aggregating multiple A or Gb links
67 1 laforge
68
** [[bsc_nat]] -- a BSC NAT/Multiplexer
69 6 laforge
** [[osmo-gbproxy]] -- A proxy/gateway for aggregating multiple Gb links betwen BSS and SGSN
70
** [[release-testing|Testing]] -- Comments and what makes sense to test for releases
71
72
h3. GPRS/EDGE related software
73
74 13 laforge
* [[OsmoPCU:]] -- A GPRS + EDGE RLC/MAC and PCU implementation to be used with [[OsmoBTS:]]
75
* [[OsmoSGSN:]] -- A Serving GPRS Support Node
76 24 laforge
* [[OpenGGSN:OsmoGGSN]] -- A Gateway GPRS Support Node
77 6 laforge
78 13 laforge
There's also a tutorial at [[OpenBSC_GPRS]] explaining how to add data support to your [[OsmoNITB:]] setup
79 6 laforge
80 13 laforge
81 9 laforge
* Important legal information on [[SoftwareLicensing]]
82 6 laforge
* [[meas_web]] -- Web based measurement utility for [[OpenBSC:]]
83
84
h2. Developers
85
86 9 laforge
* Browse the repositories at http://git.osmocom.org/
87 13 laforge
* Mailinglists at http://lists.osmocom.org/mailman/listinfo/
88
* Jenkins (continuous integration at http://jenkins.osmocom.org/jenkins/
89 9 laforge
* Wiki is right here ;)
90
* Developer conferences: [[OpenBSC:OsmoDevCon]]
91 22 neels
* [[OpenBSC:Tasks]] -- Tasks/Internships/Junior Jobs for [[OpenBSC:]] and Osmocom
92 6 laforge
* [[Devtools]] -- Various tools to find/fix errors, send patches, etc
93
* [[Coding_standards]] -- Coding standards
94 21 neels
* [[Make a new release]]
95 6 laforge
96
h2. Related projects
97
98
99 1 laforge
* [[OsmocomBB:]] - Free Software GSM protocol stack for mobile phones
100 18 laforge
* OpenBTS:http://gnuradio.org/redmine/projects/gnuradio/wiki/OpenBTS
101 6 laforge
* "The THC GSM project":http://wiki.thc.org/gsm/
102
* "airprobe.org":http://airprobe.org/
103
* "Homepage of Dr.-Ing. Joachim Goeller":http://www2.informatik.hu-berlin.de/~goeller/
104
105
h2. Thanks
106 9 laforge
107 23 pespin
* to "On-Waves ehf":http://on-waves.com/ and "sysmocom GmbH":http://sysmocom.de/ for funding part of the development and maintenance
108 9 laforge
* to http://junghanns.net for supporting us with discounted E1 boards
109 6 laforge
* to "Netzing AG":http://netzing.de/ for funding part of the earlier [[OpenBSC:]] development
110
* to Kevin Redon for the Osmocom logo
111
 
112 4 laforge
---
113 5 laforge
114
Please check the project/wiki pages of the respecitve sub-projects.
115 4 laforge
116
h2. This Wiki
117
118
This wiki contains information that is shared by the various sub-projects.  
119
120 1 laforge
A full list of wiki pages is listed below:
121 3 laforge
122 1 laforge
{{child_pages}}
Add picture from clipboard (Maximum size: 48.8 MB)