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