Project

General

Profile

Wiki » History » Version 33

osmith, 01/15/2019 02:51 PM
link to glossary

1 13 laforge
h1. Intro: Osmocom Cellular Network Infrastructure
2 1 laforge
3 7 laforge
{{>toc}}
4 7 laforge
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 31 daniel
* [[OsmoBSC:]] - a _GSM Base Station Controller_ with support for many different BTS vendors and models attached via Abis (over E1 and IP).
15 31 daniel
* [[OsmoSTP:]] - a _SS7 Transfer Point_ to connect MSC and BSC
16 31 daniel
* [[OsmoHLR:]] - a minimal implementation of a _Home Location Register_
17 31 daniel
* [[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 31 daniel
21 31 daniel
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 31 daniel
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 6 laforge
_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 6 laforge
h2. Software
48 6 laforge
49 6 laforge
h3.  Software for a Base Transceiver Station
50 6 laforge
51 6 laforge
* [[OsmoBTS:]] -- A BTS implementation
52 6 laforge
** [[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 6 laforge
h3. Software for running a full minimal GSM Network in a Box
56 6 laforge
57 27 neels
These circuit-switched (voice) related core network components can all run on the same box:
58 27 neels
59 27 neels
* [[OsmoHLR:]]
60 27 neels
* [[OsmoMSC:]]
61 27 neels
* [[OsmoMGW:]]
62 27 neels
* [[OsmoSTP:]]
63 27 neels
* [[OsmoBSC:]]
64 27 neels
65 27 neels
They replace the old
66 27 neels
67 6 laforge
* [[OsmoNITB:]] -- A stand-alone gsm-network-in-a-box program implementing minimal subset of BSC, MSC, HLR, AuC and EIR.
68 6 laforge
69 6 laforge
h3. Software for running in pure _BSC only_ mode, attaching via A/SCCP to a MSC
70 6 laforge
71 16 laforge
* [[OsmoBSC:]] -- [[OpenBSC:]] in BSC-only mode (with external MSC)
72 16 laforge
* [[bsc_mgcp|osmo-bsc_mgcp]] -- A stupid [[MediaGatewayControlProtocol]] (MGCP) gateway for OsmoBSC
73 16 laforge
74 6 laforge
75 6 laforge
h3.  Software for UMA/GAN (Unified Mobile Access)
76 6 laforge
77 6 laforge
* [[OpenBSC:osmo-ganc]] -- [[OpenBSC:]] in GANC mode
78 6 laforge
79 6 laforge
h3.  Special purpose software for aggregating multiple A or Gb links
80 1 laforge
81 1 laforge
** [[bsc_nat]] -- a BSC NAT/Multiplexer
82 6 laforge
** [[osmo-gbproxy]] -- A proxy/gateway for aggregating multiple Gb links betwen BSS and SGSN
83 6 laforge
** [[release-testing|Testing]] -- Comments and what makes sense to test for releases
84 6 laforge
85 6 laforge
h3. GPRS/EDGE related software
86 6 laforge
87 13 laforge
* [[OsmoPCU:]] -- A GPRS + EDGE RLC/MAC and PCU implementation to be used with [[OsmoBTS:]]
88 13 laforge
* [[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 6 laforge
97 6 laforge
h2. Developers
98 6 laforge
99 9 laforge
* Browse the repositories at http://git.osmocom.org/
100 13 laforge
* Mailinglists at http://lists.osmocom.org/mailman/listinfo/
101 13 laforge
* Jenkins (continuous integration at http://jenkins.osmocom.org/jenkins/
102 9 laforge
* Wiki is right here ;)
103 9 laforge
* 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 6 laforge
* [[Coding_standards]] -- Coding standards
107 21 neels
* [[Make a new release]]
108 6 laforge
109 6 laforge
h2. Related projects
110 6 laforge
111 6 laforge
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 6 laforge
* "airprobe.org":http://airprobe.org/
116 6 laforge
* "Homepage of Dr.-Ing. Joachim Goeller":http://www2.informatik.hu-berlin.de/~goeller/
117 6 laforge
118 6 laforge
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 6 laforge
* to Kevin Redon for the Osmocom logo
124 6 laforge
 
125 4 laforge
---
126 5 laforge
127 5 laforge
Please check the project/wiki pages of the respecitve sub-projects.
128 4 laforge
129 4 laforge
h2. This Wiki
130 4 laforge
131 4 laforge
This wiki contains information that is shared by the various sub-projects.  
132 4 laforge
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)