WikiStart » History » Version 146
laforge, 03/23/2018 12:53 PM
1 | 1 | h1. Welcome to Osmocom [[OpenBSC]] |
|
---|---|---|---|
2 | 129 | laforge | |
3 | 146 | laforge | {{include(cellular-infrastructure:MacroLegacy)}} |
4 | |||
5 | 135 | laforge | {{>toc}} |
6 | 1 | ||
7 | We have started with an A-bis (plus BSC/MSC/HLR) implementation for experimentation and research purpose, but have since moved way beyond that. |
||
8 | |||
9 | 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. |
||
10 | 129 | laforge | |
11 | 1 | [[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). |
|
12 | 129 | laforge | |
13 | 135 | 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]] family of hardware or SDR based hardware with [[OsmoTRX:]] like the [[UmTRX:]] or "UmSITE":https://fairwaves.co/wp/products/. |
14 | 129 | laforge | |
15 | 135 | laforge | _We are always looking for [[cellular-infrastructure:HardwareDonations]] of any kind of GSM / 3G related carrier equipment._ |
16 | 1 | ||
17 | 129 | laforge | h1. Overview Diagram |
18 | |||
19 | |||
20 | 1 | Please see the below overview diagram about common possible configurations of the Osmocom software. |
|
21 | |||
22 | 134 | laforge | !osmocom-gsm.png! |
23 | 1 | ||
24 | |||
25 | 129 | laforge | h2. Getting started |
26 | 1 | ||
27 | 129 | laforge | [[UnderstandingOpenBSC]] -- Where to start learning about [[OpenBSC]], what it does, and how. |
28 | 1 | ||
29 | 129 | laforge | h2. [[OpenBSC]] Software |
30 | 1 | ||
31 | 129 | laforge | * Software for running a full minimal GSM Network in a Box: |
32 | ** [[OpenBSC]] -- The Free Software project implementing various parts of the GSM network |
||
33 | *** [[osmo-nitb]] -- A stand-alone gsm-network-in-a-box program implementing minimal subset of BSC, MSC, HLR, AuC and EIR. |
||
34 | **** [[osmo-nitb_VTY]] -- Reference for the interactive command line and config file |
||
35 | * Software utilities for BTS configuration, provisioning and the like |
||
36 | ** [[bs11_config]] -- A small tool for configuring the BS-11 using RS232 |
||
37 | ** [[ipaccess-find]] -- A small tool to find nanoBTS in your network |
||
38 | ** [[ipaccess-config]] -- A small tool to set NVRAM configuration of the nanoBTS |
||
39 | ** [[isdnsync]] -- A small tool to use the PSTN as frequency standard |
||
40 | * Software for running in pure _BSC only_ mode, attaching via A/SCCP to a MSC |
||
41 | ** [[osmo-bsc]] -- [[OpenBSC]] in BSC-only mode |
||
42 | ** [[bsc_mgcp]] -- A stupid [[MediaGatewayControlProtocol]] (MGCP) gateway |
||
43 | *** [[bsc_mgcp_VTY]] -- Reference for the interactive command line and config file |
||
44 | * Software for UMA/GAN (Unified Mobile Access) |
||
45 | ** [[osmo-ganc]] -- [[OpenBSC]] in GANC mode |
||
46 | * Special purpose software for aggregating multiple A or Gb links |
||
47 | ** [[bsc_nat]] -- a BSC NAT/Multiplexer |
||
48 | *** [[bsc_nat_VTY]] -- Reference for the interactive command line and config file |
||
49 | *** [[bsc_nat_release]] -- Release testing for the BSC NAT. |
||
50 | ** [[osmo-gbproxy]] -- A proxy/gateway for aggregating multiple Gb links betwen BSS and SGSN |
||
51 | *** [[osmo-gbproxy_VTY]] -- Reference for the interactive command line and config file |
||
52 | ** [[release-testing|Testing]] -- Comments and what makes sense to test for releases |
||
53 | 142 | laforge | * [[OpenBSC]] related [[PortNumbers]] -- A list of TCP port numbers as they are used by [[OpenBSC]] and related programs |
54 | 129 | laforge | * Protocol extensions |
55 | 142 | laforge | **[[MgcpExtensions]] -- Extensions to MGCP |
56 | 129 | laforge | * [[simulation]] -- Running [[OpenBSC]] without a GSM Basestation |
57 | * Important legal information on [[SoftwareLicensing]] |
||
58 | * [[meas_web]] -- Web based measurement utility for [[OpenBSC]] |
||
59 | |||
60 | 144 | laforge | h3. Supported BTSs |
61 | |||
62 | |||
63 | h2. BTS Support |
||
64 | |||
65 | {{graphviz_link() |
||
66 | graph G { |
||
67 | |||
68 | nanoBTS [label="ip.access\nnanoBTS", shape=box]; |
||
69 | OsmoBTS; |
||
70 | sysmoBTS [label="sysmocom sysmoBTS\n(many models)", shape=box]; |
||
71 | LC15 [label="Nuran\nLitecell 1.5", shape=box]; |
||
72 | OCT [label="Octasic\nOCTBTS", shape=box]; |
||
73 | TRX [label="OsmoTRX"]; |
||
74 | OtherSDR [label="Other SDR HW", shape=box, style=dashed]; |
||
75 | OtherPHY [label="Other GSM PHY", shape=box, style=dashed]; |
||
76 | UmTRX [label="Fairwaves\nUmTRX", shape=box]; |
||
77 | USRP [label="Ettus USRP\nFamily", shape=box]; |
||
78 | |||
79 | BSC -- nanoBTS [label="Abis/IP"]; |
||
80 | BSC -- OsmoBTS [label="Abis/IP"]; |
||
81 | |||
82 | BSC -- BS11 [label="Siemens\nAbis/E1"]; |
||
83 | BSC -- RBS2K [label="Ericsson\nAbis/E1"]; |
||
84 | BSC -- Nokia [label="Nokia\nAbis/E1"]; |
||
85 | |||
86 | subgraph cluster_2 { |
||
87 | BSC [label="BSC\n(OsmoBSC, OsmoNITB, 3rd party)" color=red]; |
||
88 | color=white |
||
89 | } |
||
90 | |||
91 | subgraph cluster_0 { |
||
92 | BS11 [label="Siemens BS-11", shape=box]; |
||
93 | SIU [label="Ericsson SIU"]; |
||
94 | RBS2K [label="Ericsson RBS 2000\n(many models)", shape=box]; |
||
95 | Nokia [label="Nokia InSite, MetroSite", shape=box]; |
||
96 | |||
97 | BSC -- L2TPD [label="Unix Socket"]; |
||
98 | L2TPD -- SIU [label="Ericsson\nL2TP/IP"]; |
||
99 | SIU -- RBS2K [label="Ericsson\nAbis/E1"]; |
||
100 | |||
101 | { rank=same; BS11 RBS2K Nokia } |
||
102 | |||
103 | label = "Classic E1/T1"; |
||
104 | } |
||
105 | |||
106 | subgraph cluster_1 { |
||
107 | |||
108 | OsmoBTS -- sysmoBTS [label="osmo-bts-sysmo"]; |
||
109 | OsmoBTS -- LC15 [label="osmo-bts-lc15"]; |
||
110 | OsmoBTS -- OCT [label="osmo-bts-octphy"]; |
||
111 | OsmoBTS -- TRX [label="osmo-bts-trx"]; |
||
112 | OsmoBTS -- OtherPHY [style=dashed]; |
||
113 | |||
114 | TRX -- USRP; |
||
115 | TRX -- UmTRX; |
||
116 | TRX -- OtherSDR [style=dashed]; |
||
117 | |||
118 | { rank=same; nanoBTS sysmoBTS LC15 OCT UmTRX } |
||
119 | |||
120 | label = "IP/Ethernet based"; |
||
121 | } |
||
122 | |||
123 | } |
||
124 | }} |
||
125 | |||
126 | |||
127 | 78 | laforge | h3. Information related to a specific BTS model |
128 | 1 | ||
129 | 130 | laforge | {{child_pages(BTS_Hardware,depth=1)}} |
130 | 103 | ||
131 | 135 | laforge | h3. Topics related to BTSs with classic E1 interface (non-IP based): |
132 | 132 | laforge | |
133 | 129 | laforge | {{child_pages(E1-Interface)}} |
134 | |||
135 | h3. Miscellaneous Information |
||
136 | |||
137 | 131 | laforge | * [[GSM]] -- Some links for starting to understand GSM |
138 | 129 | laforge | * [[LegalNotes]] -- Important Legal notes on operating GSM base stations |
139 | * [[FieldTests]] -- The [[OpenBSC]] field tests and their reports |
||
140 | |||
141 | h3. Howtos |
||
142 | |||
143 | * Standard configuration: |
||
144 | 1 | *** [[Building_OpenBSC]] -- Getting started with [[OpenBSC]] under Debian |
|
145 | *** [[multi-BTS_with_handover]] -- Connecting 2x BTS to a single BSC/NITB and enabling handover |
||
146 | 129 | laforge | |
147 | 1 | * Advanced topics: |
|
148 | 129 | laforge | *** [[OpenBSC_with_Asterisk]] -- A comprehensive tutorial on setting up [[OpenBSC]] with Asterisk |
149 | *** [[OpenBSC_LCR]] -- [[OpenBSC]]+LCR with Asterisk (obsolete) |
||
150 | *** [[OpenBSC_LCR_Ubuntu1204]] -- Short installation guide for [[OpenBSC]] with Asterisk on Ubuntu 12.04 |
||
151 | *** [[OpenBSC_Crypto]] -- Howto add A5/x cryptography support to your [[OpenBSC]] setup |
||
152 | *** [[SDR_OsmoTRX_network_from_scratch]] -- Building everything from scratch for SDR based hardware with [[OsmoTRX]], [[OsmoBTS]] and [[OsmoNITB]]. |
||
153 | |||
154 | * RF Topics: |
||
155 | *** [[cable_antenna]] -- Build new antennas for your BTS |
||
156 | *** [[ethernet_dummyload]] -- Use an old ethernet terminator as dummyload |
||
157 | *** [[10db_attenuator]] -- Turn 30mW into 3 mW |
||
158 | |||
159 | 145 | laforge | |
160 | {{include(cellular-infrastructure:MacroBinaryPackages)}} |
||
161 | |||
162 | 129 | laforge | h2. Developers |
163 | |||
164 | * Browse the repositories at http://git.osmocom.org/ |
||
165 | 139 | neels | * "Mailinglist":https://lists.osmocom.org/mailman/listinfo |
166 | ** For voice/SMS/..., use "OpenBSC":https://lists.osmocom.org/mailman/listinfo/openbsc |
||
167 | ** For GPRS/SGSN/data-comms related discussions, use "osmocom-net-gprs":https://lists.osmocom.org/mailman/listinfo/osmocom-net-gprs |
||
168 | * [[Jenkins|Continuous Integration efforts]] |
||
169 | 129 | laforge | * Wiki is right here ;) |
170 | 135 | laforge | * Developer conferences: [[OsmoDevCon]] |
171 | 129 | laforge | * [[Tasks]] -- Tasks/Internships/Junior Jobs for [[OpenBSC]] and Osmocom |
172 | * [[Devtools]] -- Various tools to find/fix errors, send patches, etc |
||
173 | * [[Coding_standards]] -- Coding standards |
||
174 | * [[PacketDump]] -- Using wireshark on PCAP files |
||
175 | 13 | laforge | |
176 | 129 | laforge | h2. News |
177 | 76 | laforge | |
178 | 88 | * _OpenBSC ran many more experimental and commercial networks, but no one bothered to update this section..._ |
|
179 | 129 | laforge | * [[OpenBSC]] was running an experimental GSM network at "CCC Camp":http://events.ccc.de/camp/2011/wiki/GSM in the Summer of 2011 |
180 | * [[OpenBSC]] was running an experimental GSM network at "27c3":http://events.ccc.de/congress/2010 in December 2010 |
||
181 | * The slides of the "25C3 presentation _Running your own GSM network_":http://events.ccc.de/congress/2008/Fahrplan/events/3007.en.html "are available":http://events.ccc.de/congress/2008/Fahrplan/attachments/1259_25C3-OpenBSC.pdf. |
||
182 | * The slides of the "26C3 presentation _Fuzzing GSM handsets using [[OpenBSC]]_":http://events.ccc.de/congress/2009/Fahrplan/events/3535.en.html "are available":http://events.ccc.de/congress/2009/Fahrplan/attachments/1503_openbsc_gsm_fuzzing.pdf |
||
183 | 76 | laforge | |
184 | 129 | laforge | h2. Related projects |
185 | 1 | ||
186 | * [[simplehlr]] -- A web interface for the [[OpenBSC]] HLR database |
||
187 | 138 | laforge | * [[OsmocomBB:]] - Free Software GSM protocol stack for mobile phones |
188 | * "OpenBTS":http://gnuradio.org/redmine/projects/gnuradio/wiki/OpenBTS |
||
189 | 129 | laforge | * "The THC GSM project":http://wiki.thc.org/gsm/ |
190 | * "airprobe.org":http://airprobe.org/ |
||
191 | * "Homepage of Dr.-Ing. Joachim Goeller":http://www2.informatik.hu-berlin.de/~goeller/ |
||
192 | |||
193 | h2. Thanks |
||
194 | 1 | ||
195 | 136 | laforge | * to "On-Waves ehf":http://on-waves.com/ and "sysmocom GmbH":http://sysmocom.de/ for funding part of the development and maintennance |
196 | * to http://junghanns.net for supporting us with discounted E1 boards |
||
197 | * to "Netzing AG":http://netzing.de/ for funding part of the earlier [[OpenBSC:]] development |
||
198 | * to Kevin Redon for the Osmocom logo |