Project

General

Profile

WikiStart » History » Version 122

Anonymous, 02/19/2016 10:47 PM

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