WikiStart » History » Version 129
laforge, 02/19/2016 10:48 PM
1 | 129 | laforge | {{>toc}} |
---|---|---|---|
2 | 1 | ||
3 | 129 | laforge | h1. Welcome to Osmocom [[OpenBSC]] |
4 | |||
5 | |||
6 | 1 | This is a project aiming to create a Free Software, (A)GPL-licensed software implementations for the GSM/3GPP protocol stacks and elements. |
|
7 | |||
8 | We have started with an A-bis (plus BSC/MSC/HLR) implementation for experimentation and research purpose, but have since moved way beyond that. |
||
9 | |||
10 | 129 | 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. |
11 | 1 | ||
12 | 129 | 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). |
13 | 95 | laforge | |
14 | 129 | laforge | In addition, the Osmocom project also develops and maintains the [[osmo-sgsn]] and [[OpenGGSN]] programs for adding GPRS/EDGE capabilities. |
15 | 124 | laforge | |
16 | 129 | 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/. |
17 | 1 | ||
18 | 129 | laforge | _We are always looking for [[HardwareDonations]] of any kind of GSM / 3G related carrier equipment._ |
19 | 94 | laforge | |
20 | 1 | [[BlogList(format=float,recent=5,max_size=350)]] |
|
21 | |||
22 | 129 | 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. |
23 | 1 | ||
24 | |||
25 | 129 | laforge | h1. Overview Diagram |
26 | |||
27 | |||
28 | 1 | Please see the below overview diagram about common possible configurations of the Osmocom software. |
|
29 | |||
30 | [[Image(osmocom-gsm.png)]] |
||
31 | |||
32 | |||
33 | 129 | laforge | h2. Getting started |
34 | 1 | ||
35 | 129 | laforge | [[UnderstandingOpenBSC]] -- Where to start learning about [[OpenBSC]], what it does, and how. |
36 | 1 | ||
37 | |||
38 | 129 | laforge | h2. [[OpenBSC]] Software |
39 | 1 | ||
40 | 129 | laforge | * Software for running a full minimal GSM Network in a Box: |
41 | ** [[OpenBSC]] -- The Free Software project implementing various parts of the GSM network |
||
42 | *** [[osmo-nitb]] -- A stand-alone gsm-network-in-a-box program implementing minimal subset of BSC, MSC, HLR, AuC and EIR. |
||
43 | **** [[osmo-nitb_VTY]] -- Reference for the interactive command line and config file |
||
44 | * Software utilities for BTS configuration, provisioning and the like |
||
45 | ** [[bs11_config]] -- A small tool for configuring the BS-11 using RS232 |
||
46 | ** [[ipaccess-find]] -- A small tool to find nanoBTS in your network |
||
47 | ** [[ipaccess-config]] -- A small tool to set NVRAM configuration of the nanoBTS |
||
48 | ** [[isdnsync]] -- A small tool to use the PSTN as frequency standard |
||
49 | * Software for running a BTS |
||
50 | ** [[OsmoBTS]] -- A BTS implementation |
||
51 | ** [[OsmoTRX]] -- A transceiver for [[OsmoBTS]] to use with SDR hardware |
||
52 | * Software for running in pure _BSC only_ mode, attaching via A/SCCP to a MSC |
||
53 | ** [[osmo-bsc]] -- [[OpenBSC]] in BSC-only mode |
||
54 | ** [[bsc_msc_ip]] -- A previous utility to connect to a MSC via A over IP |
||
55 | *** [[OpenBSCWithSCCP]] -- Howto use [[OpenBSC]] with a separate/real MSC |
||
56 | ** [[bsc_mgcp]] -- A stupid [[MediaGatewayControlProtocol]] (MGCP) gateway |
||
57 | *** [[bsc_mgcp_VTY]] -- Reference for the interactive command line and config file |
||
58 | * Software for UMA/GAN (Unified Mobile Access) |
||
59 | ** [[osmo-ganc]] -- [[OpenBSC]] in GANC mode |
||
60 | * Special purpose software for aggregating multiple A or Gb links |
||
61 | ** [[bsc_nat]] -- a BSC NAT/Multiplexer |
||
62 | *** [[bsc_nat_VTY]] -- Reference for the interactive command line and config file |
||
63 | *** [[bsc_nat_release]] -- Release testing for the BSC NAT. |
||
64 | ** [[osmo-gbproxy]] -- A proxy/gateway for aggregating multiple Gb links betwen BSS and SGSN |
||
65 | *** [[osmo-gbproxy_VTY]] -- Reference for the interactive command line and config file |
||
66 | ** [[release-testing|Testing]] -- Comments and what makes sense to test for releases |
||
67 | * GPRS related software |
||
68 | ** [[osmo-sgsn]] -- A work-in-progress SGSN |
||
69 | *** [[osmo-sgsn_VTY]] -- Reference for the interactive command line and config file |
||
70 | *** [[OpenBSC_GPRS]] -- Howto add data support to your [[OpenBSC]] setup |
||
71 | ** [[osmo-pcu]] -- A work-in-progress RLC/MAC and PCU implementation |
||
72 | * [[OpenBSC]] related |
||
73 | *** [[cellmgr_ng]] -- The cellmgr_ng project to bring old equipment to the world of IP |
||
74 | *** [[simplehlr]] -- A web interface for the [[OpenBSC]] HLR database |
||
75 | * [[PortNumbers]] -- A list of TCP port numbers as they are used by [[OpenBSC]] and related programs |
||
76 | * Protocol extensions |
||
77 | *** [[MgcpExtensions]] -- Extensions to MGCP |
||
78 | * [[simulation]] -- Running [[OpenBSC]] without a GSM Basestation |
||
79 | * Important legal information on [[SoftwareLicensing]] |
||
80 | * [[meas_web]] -- Web based measurement utility for [[OpenBSC]] |
||
81 | 78 | laforge | |
82 | 1 | ||
83 | 129 | laforge | h3. Information related to a specific BTS model |
84 | 84 | laforge | |
85 | 129 | laforge | * [[BS11]] -- The Siemens BS-11 microBTS |
86 | ** [[BS11Sales]] -- BS-11 units are sold out by now, sorry. |
||
87 | ** [[BS11Package_List]] -- Make sure everything is in the package |
||
88 | ** [[BS11Configuration]] -- How to use / setup the hardware |
||
89 | ** [[BS11LMT]] -- The local maintenance Terminal |
||
90 | ** [[BS11Getting_Started]] -- Getting started with your BS-11 |
||
91 | ** [[BS11Troubleshooting]] -- When something doesn't work |
||
92 | ** [[BS11Internals]] -- Details like PCB photographs |
||
93 | ** [[E1-to-RJ45]] -- Howto build your E1<>RJ45 cable |
||
94 | ** [[BS11RJ45mod]] -- How to add RJ45 connectors to your BS-11 |
||
95 | ** [[Isdnsync]] -- Howto use the PSTN as frequency standard |
||
96 | * [[nanoBTS]] -- the ip.access nanoBTS |
||
97 | ** [[nanoBTSGetting_Started]] -- How to get started with a nanoBTS |
||
98 | ** [[nanoBTSModels]] -- Known models |
||
99 | ** [[nanoBTSInternals]] -- Details like PCB photographs and debug port |
||
100 | ** [[nanoBTSmultiTRX]] -- Creating a nanoBTS multi-TRX setup |
||
101 | * [[HSL_Femto]] -- the HSL 2.75G Femtocell |
||
102 | * [[Ericsson_RBS]] -- Ericsson BTSs (RBS2308, RBS2401) |
||
103 | * [[Motorola_Horizon_macro]] -- Motorola Horizon macro BTS |
||
104 | * [[Nokia_Site_family]] -- Nokia Site family BTS |
||
105 | * [[Ettus_USRP_B2xx_family]] -- Ettus USRP B2xx family |
||
106 | 103 | ||
107 | 75 | laforge | |
108 | 129 | laforge | h3. Miscellaneous Information |
109 | |||
110 | * [[GSM]] -- Some links for starting to understand GSM |
||
111 | * [[HFC-E1|HFC-E1 Evaluation Board]] -- The E1 card we use for attaching classic E1 based A-bis links |
||
112 | * [[GSMStandards]] -- The specifications for GSM |
||
113 | * [[A5_GSM_AT_tricks]] -- A5: Authentication & Ciphering |
||
114 | * [[mISDN]] -- The Linux ISDN stack |
||
115 | * [[HandsetBugs]] -- Things we have observed during development |
||
116 | * [[GSM_Security]] -- The GSM security issues that we find |
||
117 | |||
118 | * [[LegalNotes]] -- Important Legal notes on operating GSM base stations |
||
119 | * [[FieldTests]] -- The [[OpenBSC]] field tests and their reports |
||
120 | |||
121 | |||
122 | h3. Howtos |
||
123 | |||
124 | * Standard configuration: |
||
125 | *** [[Building_OpenBSC]] -- Getting started with [[OpenBSC]] under Debian |
||
126 | *** [[multi-BTS_with_handover]] -- Connecting 2x BTS to a single BSC/NITB and enabling handover |
||
127 | |||
128 | * Advanced topics: |
||
129 | *** [[OpenBSC_with_Asterisk]] -- A comprehensive tutorial on setting up [[OpenBSC]] with Asterisk |
||
130 | *** [[OpenBSC_LCR]] -- [[OpenBSC]]+LCR with Asterisk (obsolete) |
||
131 | *** [[OpenBSC_LCR_Ubuntu1204]] -- Short installation guide for [[OpenBSC]] with Asterisk on Ubuntu 12.04 |
||
132 | *** [[OpenBSC_Crypto]] -- Howto add A5/x cryptography support to your [[OpenBSC]] setup |
||
133 | *** [[SDR_OsmoTRX_network_from_scratch]] -- Building everything from scratch for SDR based hardware with [[OsmoTRX]], [[OsmoBTS]] and [[OsmoNITB]]. |
||
134 | |||
135 | * RF Topics: |
||
136 | *** [[cable_antenna]] -- Build new antennas for your BTS |
||
137 | *** [[ethernet_dummyload]] -- Use an old ethernet terminator as dummyload |
||
138 | *** [[10db_attenuator]] -- Turn 30mW into 3 mW |
||
139 | |||
140 | |||
141 | h2. Developers |
||
142 | |||
143 | |||
144 | <pre> |
||
145 | <pre> |
||
146 | <pre> |
||
147 | <pre> |
||
148 | *** Browse the repositories at http://git.osmocom.org/ |
||
149 | * Mailinglist is at "* [[Jenkins|Continuous Integration efforts"httplistsgnumonksorgmailmanlistinfoopenbsc]] |
||
150 | * Wiki is right here ;) |
||
151 | * Developer conferences: [[OsmoDevCon2016]], [[OsmoDevCon2015]], [[OsmoDevCon2014]], [[OsmoDevCon2013]], [[OsmoDevCon2012]] |
||
152 | * [[Tasks]] -- Tasks/Internships/Junior Jobs for [[OpenBSC]] and Osmocom |
||
153 | * [[Devtools]] -- Various tools to find/fix errors, send patches, etc |
||
154 | * [[Coding_standards]] -- Coding standards |
||
155 | |||
156 | |||
157 | h3. Tools for developers |
||
158 | |||
159 | 90 | ||
160 | 129 | laforge | * [[WandelGoltermannMA10]] -- a GSM protocol analyzer ISA card |
161 | * [[TektronixK1103]] -- GSM protocol tester and analyzer |
||
162 | * [[PacketDump]] -- Using wireshark on PCAP files |
||
163 | * [[MagicSIM]] -- SIM cards where you can program the Ki |
||
164 | 32 | laforge | |
165 | 13 | laforge | |
166 | 129 | laforge | h2. News |
167 | 76 | laforge | |
168 | 88 | ||
169 | 129 | laforge | * _OpenBSC ran many more experimental and commercial networks, but no one bothered to update this section..._ |
170 | * [[OpenBSC]] was running an experimental GSM network at "CCC Camp":http://events.ccc.de/camp/2011/wiki/GSM in the Summer of 2011 |
||
171 | * [[OpenBSC]] was running an experimental GSM network at "27c3":http://events.ccc.de/congress/2010 in December 2010 |
||
172 | * 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. |
||
173 | * 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 |
||
174 | 76 | laforge | |
175 | |||
176 | |||
177 | 129 | laforge | h2. Related projects |
178 | |||
179 | |||
180 | * "-- [[OsmocomBB]] - Free Software GSM protocol stack for mobile phones |
||
181 | * [http://gnuradio.org/redmine/projects/gnuradio/wiki/OpenBTS [[OpenBTS]]":http://bb.osmocom.org/] |
||
182 | * "The THC GSM project":http://wiki.thc.org/gsm/ |
||
183 | * "airprobe.org":http://airprobe.org/ |
||
184 | * "Homepage of Dr.-Ing. Joachim Goeller":http://www2.informatik.hu-berlin.de/~goeller/ |
||
185 | |||
186 | |||
187 | h2. Thanks |
||
188 | |||
189 | |||
190 | * to "for funding part of the [[OpenBSC]] development |
||
191 | * to [http://junghanns.net":http://netzing.de] for supporting us with discounted E1 boards |
||
192 | * to "for funding part of the [[OpenBSC]] development |
||
193 | * to Kevin Redon for the osmocom logo |
||
194 | 1 | ||
195 | |||
196 | 129 | laforge | h2. Starting Points about trac |
197 | 1 | ||
198 | 129 | laforge | |
199 | * About [[WikiFormatting]] |
||
200 | * [[TracGuide]] -- Built-in Documentation |
||
201 | * [http://trac.edgewall.org/ The Trac project":http://www.on-waves.com] -- Trac Open Source Project |
||
202 | * "Trac FAQ":http://trac.edgewall.org/wiki/TracFaq -- Frequently Asked Questions |
||
203 | * [[TracSupport]] -- Trac Support |
||
204 | |||
205 | For a complete list of local wiki pages, see [[TitleIndex]]. |