Project

General

Profile

Wiki » History » Version 35

pespin, 07/19/2019 11:38 AM
Fix link to bscnat

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 32 osmith
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 them, 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 31 daniel
While previous installations mostly used [[OsmoNITB:]] from the OpenBSC project as a monolithic core development has now shifted to individual projects performing the different tasks that were previously united inside the [[OsmoNITB:]], such as:
12 1 laforge
13 31 daniel
* [[OsmoMSC:]] - a _GSM/UMTS Mobile Switching Center_ with support for AoIP as well as IuCS. SCCPlite support is work in progress
14
* [[OsmoBSC:]] - a _GSM Base Station Controller_ with support for many different BTS vendors and models attached via Abis (over E1 and IP).
15
* [[OsmoSTP:]] - a _SS7 Transfer Point_ to connect MSC and BSC
16
* [[OsmoHLR:]] - a minimal implementation of a _Home Location Register_
17
* [[OsmoMGW:]] - _Media GateWay_ to relay RTP streams
18 1 laforge
19 31 daniel
This is more in line with the way a traditional GSM network is operated.
20
21
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 available, based on our [[OsmoBTS:]] software using hardware from sysmocom ([[openbsc:sysmoBTS]]), Fairwaves ([[UmTRX:]]) or Ettus (USRP)
22
23 24 laforge
In addition, the Osmocom project also develops and maintains the [[OsmoPCU:]], [[OsmoSGSN:]] and [[OpenGGSN:OsmoGGSN]] programs for adding GPRS and EDGE capabilities.
24 1 laforge
25 31 daniel
Most recently, there is a project for adding 3G (UMTS, HSPA) support.  Specifically, this is adding Iu-CS and Iu-PS support to [[OsmoMSC:]] and [[OsmoSGSN:]], as well as a new [[OsmoHNBGW:]] to offer an Iuh interface towards hNodeBs (femtocells, small cells)
26 6 laforge
27
_We are always looking for [[HardwareDonations]] of any kind of 2G / 3G / LTE related carrier equipment._
28 13 laforge
29 6 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.
30 13 laforge
31 6 laforge
There are many other side projects like the "SIMtrace":http://simtrace.osmocom.org/ protocol tracer/sniffer for (U)SIM APDUs.
32 1 laforge
33 6 laforge
h1. Overview Diagram
34 1 laforge
35 33 osmith
Please see the below overview diagram about common possible configurations of the Osmocom software. If you are overwhelmed by all the abbreviations, have a look at the [[glossary]].
36 6 laforge
37 31 daniel
!osmocom-cni.png!
38 6 laforge
39 29 lynxis
h1. Getting started
40 1 laforge
41 30 neels
A self-contained setup with minimal config of your core network is described at [[Osmocom Network In The Box]].
42 20 neels
43 30 neels
For a more general overview of your options, take a look at the [[Configuration Guide]].
44 25 neels
45 26 neels
If you have an OsmoNITB installation and would like to move to separate OsmoMSC and OsmoBSC with the new M3UA SIGTRAN, see the [[OsmoNITB Migration Guide]].
46 6 laforge
47
h2. Software
48
49
h3.  Software for a Base Transceiver Station
50
51
* [[OsmoBTS:]] -- A BTS implementation
52
** [[OsmoTRX:]] -- A transceiver for [[OsmoBTS:]] to use with SDR hardware
53 8 laforge
* [[OsmoPCU:]] -- A packet control unit for GPRS/EDGE enabling the BTS.
54 6 laforge
55
h3. Software for running a full minimal GSM Network in a Box
56
57 27 neels
These circuit-switched (voice) related core network components can all run on the same box:
58
59
* [[OsmoHLR:]]
60
* [[OsmoMSC:]]
61
* [[OsmoMGW:]]
62
* [[OsmoSTP:]]
63
* [[OsmoBSC:]]
64
65
They replace the old
66
67 6 laforge
* [[OsmoNITB:]] -- A stand-alone gsm-network-in-a-box program implementing minimal subset of BSC, MSC, HLR, AuC and EIR.
68
69
h3. Software for running in pure _BSC only_ mode, attaching via A/SCCP to a MSC
70
71 16 laforge
* [[OsmoBSC:]] -- [[OpenBSC:]] in BSC-only mode (with external MSC)
72
* [[bsc_mgcp|osmo-bsc_mgcp]] -- A stupid [[MediaGatewayControlProtocol]] (MGCP) gateway for OsmoBSC
73
74 6 laforge
75
h3.  Software for UMA/GAN (Unified Mobile Access)
76
77
* [[OpenBSC:osmo-ganc]] -- [[OpenBSC:]] in GANC mode
78
79
h3.  Special purpose software for aggregating multiple A or Gb links
80 1 laforge
81 35 pespin
** [[osmo-bscnat:]] -- a BSC NAT/Multiplexer
82 6 laforge
** [[osmo-gbproxy]] -- A proxy/gateway for aggregating multiple Gb links betwen BSS and SGSN
83
** [[release-testing|Testing]] -- Comments and what makes sense to test for releases
84
85
h3. GPRS/EDGE related software
86
87 13 laforge
* [[OsmoPCU:]] -- A GPRS + EDGE RLC/MAC and PCU implementation to be used with [[OsmoBTS:]]
88
* [[OsmoSGSN:]] -- A Serving GPRS Support Node
89 24 laforge
* [[OpenGGSN:OsmoGGSN]] -- A Gateway GPRS Support Node
90 6 laforge
91 13 laforge
There's also a tutorial at [[OpenBSC_GPRS]] explaining how to add data support to your [[OsmoNITB:]] setup
92 6 laforge
93 13 laforge
94 9 laforge
* Important legal information on [[SoftwareLicensing]]
95 6 laforge
* [[meas_web]] -- Web based measurement utility for [[OpenBSC:]]
96
97
h2. Developers
98
99 34 osmith
* Browse the repositories at https://git.osmocom.org/
100
* Mailinglists at https://lists.osmocom.org/mailman/listinfo/
101
* Jenkins (continuous integration) at https://jenkins.osmocom.org/jenkins/
102 9 laforge
* Wiki is right here ;)
103
* Developer conferences: [[OpenBSC:OsmoDevCon]]
104 22 neels
* [[OpenBSC:Tasks]] -- Tasks/Internships/Junior Jobs for [[OpenBSC:]] and Osmocom
105 6 laforge
* [[Devtools]] -- Various tools to find/fix errors, send patches, etc
106
* [[Coding_standards]] -- Coding standards
107 21 neels
* [[Make a new release]]
108 6 laforge
109
h2. Related projects
110
111
112 1 laforge
* [[OsmocomBB:]] - Free Software GSM protocol stack for mobile phones
113 18 laforge
* OpenBTS:http://gnuradio.org/redmine/projects/gnuradio/wiki/OpenBTS
114 6 laforge
* "The THC GSM project":http://wiki.thc.org/gsm/
115
* "airprobe.org":http://airprobe.org/
116
* "Homepage of Dr.-Ing. Joachim Goeller":http://www2.informatik.hu-berlin.de/~goeller/
117
118
h2. Thanks
119 9 laforge
120 23 pespin
* to "On-Waves ehf":http://on-waves.com/ and "sysmocom GmbH":http://sysmocom.de/ for funding part of the development and maintenance
121 9 laforge
* to http://junghanns.net for supporting us with discounted E1 boards
122 6 laforge
* to "Netzing AG":http://netzing.de/ for funding part of the earlier [[OpenBSC:]] development
123
* to Kevin Redon for the Osmocom logo
124
 
125 4 laforge
---
126 5 laforge
127
Please check the project/wiki pages of the respecitve sub-projects.
128 4 laforge
129
h2. This Wiki
130
131
This wiki contains information that is shared by the various sub-projects.  
132
133 1 laforge
A full list of wiki pages is listed below:
134 3 laforge
135 1 laforge
{{child_pages}}
Add picture from clipboard (Maximum size: 48.8 MB)