WikiStart » History » Version 120
ipse, 02/19/2016 10:47 PM
Fix copy-paste error
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 | 1 | ||
89 | === Miscellaneous Information === |
||
90 | 103 | * [wiki:GSM] -- Some links for starting to understand GSM |
|
91 | 75 | laforge | * [wiki:HFC-E1 HFC-E1 Evaluation Board] -- The E1 card we use for attaching classic E1 based A-bis links |
92 | 1 | * [wiki:GSMStandards] -- The specifications for GSM |
|
93 | 75 | laforge | * [wiki:A5_GSM_AT_tricks] -- A5: Authentication & Ciphering |
94 | 65 | laforge | * [wiki:mISDN] -- The Linux ISDN stack |
95 | 55 | laforge | * [wiki:HandsetBugs] -- Things we have observed during development |
96 | 57 | dexter | * [wiki:GSM_Security] -- The GSM security issues that we find |
97 | 67 | laforge | |
98 | 75 | laforge | * [wiki:LegalNotes] -- Important Legal notes on operating GSM base stations |
99 | 55 | laforge | * [wiki:FieldTests] -- The OpenBSC field tests and their reports |
100 | |||
101 | 1 | === Howtos === |
|
102 | 71 | dexter | * Standard configuration: |
103 | 1 | * [wiki:Building_OpenBSC] -- Getting started with OpenBSC under Debian |
|
104 | 113 | ipse | * [wiki:network_from_scratch] -- Getting started with SDR hardware |
105 | 119 | * [wiki:multi-BTS_with_handover] -- Connecting 2x BTS to a single BSC/NITB and enabling handover |
|
106 | 118 | ||
107 | 71 | dexter | * Advanced topics: |
108 | 104 | manatails | * [wiki:OpenBSC_with_Asterisk] -- A comprehensive tutorial on setting up OpenBSC with Asterisk |
109 | * [wiki:OpenBSC_LCR] -- OpenBSC+LCR with Asterisk (obsolete) |
||
110 | 58 | dexter | * [wiki:OpenBSC_LCR_Ubuntu12.04] -- Short installation guide for OpenBSC with Asterisk on Ubuntu 12.04 |
111 | 117 | * [wiki:OpenBSC_Crypto] -- Howto add A5/x cryptography support to your OpenBSC setup |
|
112 | 59 | dexter | |
113 | 33 | * RF Topics: |
|
114 | 4 | laforge | * [wiki:cable_antenna] -- Build new antennas for your BTS |
115 | * [wiki:ethernet_dummyload] -- Use an old ethernet terminator as dummyload |
||
116 | 36 | laforge | * [wiki:10db_attenuator] -- Turn 30mW into 3 mW |
117 | 1 | ||
118 | 67 | laforge | == Developers == |
119 | 1 | ||
120 | 79 | laforge | * git checkout is available via {{{git clone git://git.osmocom.org/openbsc.git}}} |
121 | 6 | laforge | * you now also need libosmocore to build openbsc: {{{git clone git://git.osmocom.org/libosmocore.git}}} |
122 | 110 | * and libosmo-abis {{{git clone git://git.osmocom.org/libosmo-abis.git}}} |
|
123 | * and optionally libosmo-sccp {{{git clone git://git.osmocom.org/libosmo-sccp.git}}} |
||
124 | * Browse the repositories at http://git.osmocom.org/ |
||
125 | 6 | laforge | * Mailinglist is at [http://lists.gnumonks.org/mailman/listinfo/openbsc] |
126 | 65 | laforge | * [wiki:Tarballs] of libosmocore and OpenBSC |
127 | 91 | * [wiki:Jenkins Continuous Integration efforts] |
|
128 | 6 | laforge | * Wiki is right here ;) |
129 | 105 | * [wiki:OsmoDevCon2013] -- Osmocom Developer Conference (last year: [wiki:OsmoDevCon2012]) |
|
130 | 1 | * [wiki:Tasks] -- Tasks/Internships/Junior Jobs for OpenBSC and Osmocom |
|
131 | 105 | * [wiki:Devtools] -- Various tools to find/fix errors, send patches, etc |
|
132 | 107 | * [wiki:Coding_standards] -- Coding standards |
|
133 | 1 | ||
134 | 30 | === Tools for developers === |
|
135 | 18 | ||
136 | 19 | laforge | * [wiki:WandelGoltermannMA10] -- a GSM protocol analyzer ISA card |
137 | * [wiki:TektronixK1103] -- GSM protocol tester and analyzer |
||
138 | 41 | laforge | * [wiki:PacketDump] -- Using wireshark on PCAP files |
139 | * [wiki:MagicSIM] -- SIM cards where you can program the Ki |
||
140 | 74 | laforge | |
141 | 61 | laforge | == News == |
142 | |||
143 | 114 | ipse | * ''OpenBSC ran many more experimental and commercial networks, but no one bothered to update this section...'' |
144 | 90 | * OpenBSC was running an experimental GSM network at [http://events.ccc.de/camp/2011/wiki/GSM CCC Camp] in the Summer of 2011 |
|
145 | 19 | laforge | * OpenBSC was running an experimental GSM network at [http://events.ccc.de/congress/2010 27c3] in December 2010 |
146 | 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]. |
147 | * 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] |
||
148 | |||
149 | |||
150 | 13 | laforge | == Related projects == |
151 | |||
152 | 76 | laforge | * [http://bb.osmocom.org/] -- OsmocomBB - Free Software GSM protocol stack for mobile phones |
153 | 88 | * [http://gnuradio.org/redmine/projects/gnuradio/wiki/OpenBTS OpenBTS] |
|
154 | 1 | * [http://wiki.thc.org/gsm/ The THC GSM project] |
|
155 | * [http://airprobe.org/ airprobe.org] |
||
156 | * [http://www2.informatik.hu-berlin.de/~goeller/ Homepage of Dr.-Ing. Joachim Goeller] |
||
157 | |||
158 | 76 | laforge | == Thanks == |
159 | |||
160 | * to [http://netzing.de] for funding part of the OpenBSC development |
||
161 | * to [http://junghanns.net] for supporting us with discounted E1 boards |
||
162 | * to [http://www.on-waves.com] for funding part of the OpenBSC development |
||
163 | 92 | laforge | * to Kevin Redon for the osmocom logo |
164 | 76 | laforge | |
165 | 1 | == Starting Points about trac == |
|
166 | |||
167 | * About WikiFormatting |
||
168 | * TracGuide -- Built-in Documentation |
||
169 | * [http://trac.edgewall.org/ The Trac project] -- Trac Open Source Project |
||
170 | * [http://trac.edgewall.org/wiki/TracFaq Trac FAQ] -- Frequently Asked Questions |
||
171 | * TracSupport -- Trac Support |
||
172 | |||
173 | For a complete list of local wiki pages, see TitleIndex. |