Project

General

Profile

Wiki » History » Version 8

laforge, 02/21/2016 03:14 PM

1 1 laforge
h1. Osmocom Cellular Network Infrastructure
2 1 laforge
3 7 laforge
{{>toc}}
4 7 laforge
5 6 laforge
This is a project aiming to create a Free Software, (A)GPL-licensed software implementations for the GSM/3GPP protocol stacks and network elements.
6 6 laforge
7 6 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.
8 6 laforge
9 6 laforge
10 6 laforge
11 6 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.
12 6 laforge
13 6 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).
14 6 laforge
15 6 laforge
In addition, the Osmocom project also develops and maintains the [[OsmoPCU:]], [[OsmoSGSN:]] and [[OpenGGSN:]] programs for adding GPRS/EDGE capabilities.
16 6 laforge
17 6 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/.
18 6 laforge
19 6 laforge
_We are always looking for [[HardwareDonations]] of any kind of GSM / 3G related carrier equipment._
20 6 laforge
21 6 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.
22 6 laforge
23 6 laforge
24 6 laforge
h1. Overview Diagram
25 6 laforge
26 6 laforge
Please see the below overview diagram about common possible configurations of the Osmocom software.
27 6 laforge
28 4 laforge
!osmocom-gsm.png!
29 6 laforge
30 6 laforge
31 6 laforge
h2. Getting started
32 6 laforge
33 6 laforge
[[UnderstandingOpenBSC]] -- Where to start learning about [[OpenBSC]], what it does, and how.
34 6 laforge
35 6 laforge
36 6 laforge
h2. Software
37 6 laforge
38 6 laforge
h3.  Software for a Base Transceiver Station
39 6 laforge
40 6 laforge
* [[OsmoBTS:]] -- A BTS implementation
41 6 laforge
** [[OsmoTRX:]] -- A transceiver for [[OsmoBTS:]] to use with SDR hardware
42 8 laforge
* [[OsmoPCU:]] -- A packet control unit for GPRS/EDGE enabling the BTS.
43 6 laforge
44 6 laforge
h3. Software for running a full minimal GSM Network in a Box
45 6 laforge
46 6 laforge
* [[OsmoNITB:]] -- A stand-alone gsm-network-in-a-box program implementing minimal subset of BSC, MSC, HLR, AuC and EIR.
47 6 laforge
48 6 laforge
h3. Software for running in pure _BSC only_ mode, attaching via A/SCCP to a MSC
49 6 laforge
50 6 laforge
* [[OsmoBSC:]] -- [[OpenBSC]] in BSC-only mode
51 6 laforge
** [[OpenBSCWithSCCP]] -- Howto use [[OpenBSC]] with a separate/real MSC
52 6 laforge
* [[bsc_mgcp]] -- A stupid [[MediaGatewayControlProtocol]] (MGCP) gateway
53 6 laforge
** [[bsc_mgcp_VTY]] -- Reference for the interactive command line and config file
54 6 laforge
55 6 laforge
h3.  Software for UMA/GAN (Unified Mobile Access)
56 6 laforge
57 6 laforge
* [[osmo-ganc]] -- [[OpenBSC]] in GANC mode
58 6 laforge
59 6 laforge
h3.  Special purpose software for aggregating multiple A or Gb links
60 6 laforge
61 6 laforge
** [[bsc_nat]] -- a BSC NAT/Multiplexer
62 6 laforge
*** [[bsc_nat_VTY]] -- Reference for the interactive command line and config file
63 6 laforge
*** [[bsc_nat_release]] -- Release testing for the BSC NAT.
64 6 laforge
** [[osmo-gbproxy]] -- A proxy/gateway for aggregating multiple Gb links betwen BSS and SGSN
65 6 laforge
*** [[osmo-gbproxy_VTY]] -- Reference for the interactive command line and config file
66 6 laforge
** [[release-testing|Testing]] -- Comments and what makes sense to test for releases
67 6 laforge
68 6 laforge
h3. GPRS/EDGE related software
69 6 laforge
70 6 laforge
* [[OsmoSGSN:]] -- A work-in-progress SGSN
71 6 laforge
** [[OsmoSGSN:osmo-sgsn_VTY]] -- Reference for the interactive command line and config file
72 6 laforge
** [[OpenBSC_GPRS]] -- Howto add data support to your [[OpenBSC]] setup
73 6 laforge
** [[OsmoPCU:]] -- A work-in-progress RLC/MAC and PCU implementation
74 6 laforge
75 6 laforge
76 6 laforge
* Important legal information on [[SoftwareLicensing]]
77 6 laforge
* [[meas_web]] -- Web based measurement utility for [[OpenBSC]]
78 6 laforge
79 6 laforge
* Software utilities for BTS configuration, provisioning and the like
80 6 laforge
** [[bs11_config]] -- A small tool for configuring the BS-11 using RS232
81 6 laforge
** [[ipaccess-find]] -- A small tool to find nanoBTS in your network 
82 6 laforge
** [[ipaccess-config]] -- A small tool to set NVRAM configuration of the nanoBTS
83 6 laforge
** [[isdnsync]] -- A small tool to use the PSTN as frequency standard
84 6 laforge
85 6 laforge
h2. Developers
86 6 laforge
87 6 laforge
* Browse the repositories at http://git.osmocom.org/
88 6 laforge
* Mailinglist is at "* [[Jenkins|Continuous Integration efforts"httplistsgnumonksorgmailmanlistinfoopenbsc]]
89 6 laforge
* Wiki is right here ;)
90 6 laforge
* Developer conferences: [[OsmoDevCon2016]], [[OsmoDevCon2015]], [[OsmoDevCon2014]], [[OsmoDevCon2013]], [[OsmoDevCon2012]]
91 6 laforge
* [[Tasks]] -- Tasks/Internships/Junior Jobs for [[OpenBSC]] and Osmocom
92 6 laforge
* [[Devtools]] -- Various tools to find/fix errors, send patches, etc
93 6 laforge
* [[Coding_standards]] -- Coding standards
94 6 laforge
95 6 laforge
96 6 laforge
h3. Tools for developers
97 6 laforge
98 6 laforge
 
99 6 laforge
* [[WandelGoltermannMA10]] -- a GSM protocol analyzer ISA card
100 6 laforge
* [[TektronixK1103]] -- GSM protocol tester and analyzer
101 6 laforge
* [[PacketDump]] -- Using wireshark on PCAP files
102 6 laforge
* [[MagicSIM]] -- SIM cards where you can program the Ki
103 6 laforge
104 6 laforge
105 6 laforge
106 6 laforge
h2. Related projects
107 6 laforge
108 6 laforge
109 6 laforge
* [[OsmocomBB:]] - Free Software GSM protocol stack for mobile phones
110 6 laforge
* [http://gnuradio.org/redmine/projects/gnuradio/wiki/OpenBTS [[OpenBTS]]":http://bb.osmocom.org/]
111 6 laforge
* "The THC GSM project":http://wiki.thc.org/gsm/
112 6 laforge
* "airprobe.org":http://airprobe.org/
113 6 laforge
* "Homepage of Dr.-Ing. Joachim Goeller":http://www2.informatik.hu-berlin.de/~goeller/
114 6 laforge
115 6 laforge
116 6 laforge
h2. Thanks
117 6 laforge
118 6 laforge
* to "for funding part of the [[OpenBSC:]] development
119 6 laforge
* to [http://junghanns.net":http://netzing.de] for supporting us with discounted E1 boards
120 6 laforge
* to "for funding part of the [[OpenBSC:]] development
121 6 laforge
* to Kevin Redon for the Osmocom logo
122 6 laforge
 
123 6 laforge
---
124 4 laforge
125 5 laforge
Please check the project/wiki pages of the respecitve sub-projects.
126 5 laforge
127 4 laforge
h2. This Wiki
128 4 laforge
129 4 laforge
This wiki contains information that is shared by the various sub-projects.  
130 4 laforge
131 4 laforge
A full list of wiki pages is listed below:
132 1 laforge
133 3 laforge
{{child_pages}}