WikiStart » History » Version 107
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 | 100 | laforge | 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 or the [http://www.sysmocom.de/products/sysmobts sysmoBTS]. |
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 | 106 | There is also continued work on creating a Free Software / Open Source sUnderstandingOpenBSCrteoftware 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 | |||
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 | 99 | laforge | * Software for running a BTS |
36 | * [wiki:osmo-bts] -- A BTS implementation primarily targetted at the sysmoBTS |
||
37 | 75 | laforge | * Software for running in pure ''BSC only'' mode, attaching via A/SCCP to a MSC |
38 | 86 | laforge | * [wiki:osmo-bsc] -- OpenBSC in BSC-only mode |
39 | * [wiki:bsc_msc_ip] -- A previous utility to connect to a MSC via A over IP |
||
40 | 75 | laforge | * [wiki:OpenBSCWithSCCP] -- Howto use OpenBSC with a separate/real MSC |
41 | 1 | * [wiki:bsc_mgcp] -- A stupid MediaGatewayControlProtocol (MGCP) gateway |
|
42 | 75 | laforge | * [wiki:bsc_mgcp_VTY] -- Reference for the interactive command line and config file |
43 | 98 | laforge | * Software for UMA/GAN (Unified Mobile Access) |
44 | * [wiki:osmo-ganc] -- OpenBSC in GANC mode |
||
45 | 75 | laforge | * Special purpose software for aggregating multiple A or Gb links |
46 | 1 | * [wiki:bsc_nat] -- a BSC NAT/Multiplexer |
|
47 | 75 | laforge | * [wiki:bsc_nat_VTY] -- Reference for the interactive command line and config file |
48 | * [wiki:bsc_nat_release] -- Release testing for the BSC NAT. |
||
49 | 66 | laforge | * [wiki:osmo-gbproxy] -- A proxy/gateway for aggregating multiple Gb links betwen BSS and SGSN |
50 | 75 | laforge | * [wiki:osmo-gbproxy_VTY] -- Reference for the interactive command line and config file |
51 | 89 | * [wiki:release-testing Testing] -- Comments and what makes sense to test for releases |
|
52 | 75 | laforge | * GPRS related software |
53 | 65 | laforge | * [wiki:osmo-sgsn] -- A work-in-progress SGSN |
54 | 75 | laforge | * [wiki:osmo-sgsn_VTY] -- Reference for the interactive command line and config file |
55 | * [wiki:OpenBSC_GPRS] -- Howto add data support to your OpenBSC setup |
||
56 | 99 | laforge | * [wiki:osmo-pcu] -- A work-in-progress RLC/MAC and PCU implementation |
57 | 82 | * OpenBSC related |
|
58 | * [wiki:cellmgr_ng] -- The cellmgr_ng project to bring old equipment to the world of IP |
||
59 | 96 | * [wiki:simplehlr] -- A web interface for the OpenBSC HLR database |
|
60 | 102 | laforge | * [wiki:PortNumbers] -- A list of TCP port numbers as they are used by OpenBSC and related programs |
61 | 78 | laforge | * Important legal information on [wiki:SoftwareLicensing] |
62 | |||
63 | 1 | === Information related to a specific BTS model === |
|
64 | 75 | laforge | * [wiki:BS11] -- The Siemens BS-11 microBTS |
65 | 84 | laforge | * [wiki:BS11/Sales] -- BS-11 units are sold out by now, sorry. |
66 | * [wiki:BS11/Package_List] -- Make sure everything is in the package |
||
67 | * [wiki:BS11/Configuration] -- How to use / setup the hardware |
||
68 | * [wiki:BS11/LMT] -- The local maintenance Terminal |
||
69 | * [wiki:BS11/Getting_Started] -- Getting started with your BS-11 |
||
70 | * [wiki:BS11/Troubleshooting] -- When something doesn't work |
||
71 | * [wiki:BS11/Internals] -- Details like PCB photographs |
||
72 | 1 | * [wiki:E1-to-RJ45] -- Howto build your E1<>RJ45 cable |
|
73 | 84 | laforge | * [wiki:BS11/RJ45mod] -- How to add RJ45 connectors to your BS-11 |
74 | 81 | dexter | * [wiki:Isdnsync] -- Howto use the PSTN as frequency standard |
75 | 75 | laforge | * [wiki:nanoBTS] -- the ip.access nanoBTS |
76 | 85 | laforge | * [wiki:nanoBTS/Getting_Started] -- How to get started with a nanoBTS |
77 | 84 | laforge | * [wiki:nanoBTS/Models] -- Known models |
78 | * [wiki:nanoBTS/Internals] -- Details like PCB photographs and debug port |
||
79 | * [wiki:nanoBTS/multiTRX] -- Creating a nanoBTS multi-TRX setup |
||
80 | 1 | * [wiki:HSL_Femto] -- the HSL 2.75G Femtocell |
|
81 | 16 | laforge | * [wiki:Ericsson_RBS] -- Ericsson BTSs (RBS2308, RBS2401) |
82 | 84 | laforge | * [wiki:Motorola_Horizon_macro] -- Motorola Horizon macro BTS |
83 | 1 | ||
84 | === Miscellaneous Information === |
||
85 | 103 | * [wiki:GSM] -- Some links for starting to understand GSM |
|
86 | 75 | laforge | * [wiki:HFC-E1 HFC-E1 Evaluation Board] -- The E1 card we use for attaching classic E1 based A-bis links |
87 | 1 | * [wiki:GSMStandards] -- The specifications for GSM |
|
88 | 75 | laforge | * [wiki:A5_GSM_AT_tricks] -- A5: Authentication & Ciphering |
89 | 65 | laforge | * [wiki:mISDN] -- The Linux ISDN stack |
90 | 55 | laforge | * [wiki:HandsetBugs] -- Things we have observed during development |
91 | 57 | dexter | * [wiki:GSM_Security] -- The GSM security issues that we find |
92 | 67 | laforge | |
93 | 75 | laforge | * [wiki:LegalNotes] -- Important Legal notes on operating GSM base stations |
94 | 55 | laforge | * [wiki:FieldTests] -- The OpenBSC field tests and their reports |
95 | |||
96 | 1 | === Howtos === |
|
97 | 71 | dexter | * Standard configuration: |
98 | 1 | * [wiki:Building_OpenBSC] -- Getting started with OpenBSC under Debian |
|
99 | 71 | dexter | * Advanced topics: |
100 | 104 | manatails | * [wiki:OpenBSC_with_Asterisk] -- A comprehensive tutorial on setting up OpenBSC with Asterisk |
101 | * [wiki:OpenBSC_LCR] -- OpenBSC+LCR with Asterisk (obsolete) |
||
102 | 97 | * [wiki:OpenBSC_LCR_Ubuntu12.04] -- Short installation guide for OpenBSC with Asterisk on Ubuntu 12.04 |
|
103 | 58 | dexter | * [wiki:OpenBSC_Crypto] -- Howto add A5/x cryptography support to your OpenBSC setup |
104 | 59 | dexter | |
105 | 33 | * RF Topics: |
|
106 | 4 | laforge | * [wiki:cable_antenna] -- Build new antennas for your BTS |
107 | * [wiki:ethernet_dummyload] -- Use an old ethernet terminator as dummyload |
||
108 | 36 | laforge | * [wiki:10db_attenuator] -- Turn 30mW into 3 mW |
109 | 1 | ||
110 | 67 | laforge | == Developers == |
111 | 1 | ||
112 | 79 | laforge | * git checkout is available via {{{git clone git://git.osmocom.org/openbsc.git}}} |
113 | 6 | laforge | * you now also need libosmocore to build openbsc: {{{git clone git://git.osmocom.org/libosmocore.git}}} |
114 | 107 | * Browse the repositories at http://cgit.osmocom.org/ |
|
115 | 6 | laforge | * Mailinglist is at [http://lists.gnumonks.org/mailman/listinfo/openbsc] |
116 | 65 | laforge | * [wiki:Tarballs] of libosmocore and OpenBSC |
117 | 91 | * [wiki:Jenkins Continuous Integration efforts] |
|
118 | 6 | laforge | * Wiki is right here ;) |
119 | 105 | * [wiki:OsmoDevCon2013] -- Osmocom Developer Conference (last year: [wiki:OsmoDevCon2012]) |
|
120 | 1 | * [wiki:Tasks] -- Tasks/Internships/Junior Jobs for OpenBSC and Osmocom |
|
121 | 105 | * [wiki:Devtools] -- Various tools to find/fix errors, send patches, etc |
|
122 | 107 | * [wiki:Coding_standards] -- Coding standards |
|
123 | 1 | ||
124 | 30 | === Tools for developers === |
|
125 | 18 | ||
126 | 19 | laforge | * [wiki:WandelGoltermannMA10] -- a GSM protocol analyzer ISA card |
127 | * [wiki:TektronixK1103] -- GSM protocol tester and analyzer |
||
128 | 41 | laforge | * [wiki:PacketDump] -- Using wireshark on PCAP files |
129 | * [wiki:MagicSIM] -- SIM cards where you can program the Ki |
||
130 | 74 | laforge | |
131 | 61 | laforge | == News == |
132 | |||
133 | 90 | * OpenBSC was running an experimental GSM network at [http://events.ccc.de/camp/2011/wiki/GSM CCC Camp] in the Summer of 2011 |
|
134 | 19 | laforge | * OpenBSC was running an experimental GSM network at [http://events.ccc.de/congress/2010 27c3] in December 2010 |
135 | 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]. |
136 | * 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] |
||
137 | |||
138 | |||
139 | 13 | laforge | == Related projects == |
140 | |||
141 | 76 | laforge | * [http://bb.osmocom.org/] -- OsmocomBB - Free Software GSM protocol stack for mobile phones |
142 | 88 | * [http://gnuradio.org/redmine/projects/gnuradio/wiki/OpenBTS OpenBTS] |
|
143 | 1 | * [http://wiki.thc.org/gsm/ The THC GSM project] |
|
144 | * [http://airprobe.org/ airprobe.org] |
||
145 | * [http://www2.informatik.hu-berlin.de/~goeller/ Homepage of Dr.-Ing. Joachim Goeller] |
||
146 | |||
147 | 76 | laforge | == Thanks == |
148 | |||
149 | * to [http://netzing.de] for funding part of the OpenBSC development |
||
150 | * to [http://junghanns.net] for supporting us with discounted E1 boards |
||
151 | * to [http://www.on-waves.com] for funding part of the OpenBSC development |
||
152 | 92 | laforge | * to Kevin Redon for the osmocom logo |
153 | 76 | laforge | |
154 | 1 | == Starting Points about trac == |
|
155 | |||
156 | * About WikiFormatting |
||
157 | * TracGuide -- Built-in Documentation |
||
158 | * [http://trac.edgewall.org/ The Trac project] -- Trac Open Source Project |
||
159 | * [http://trac.edgewall.org/wiki/TracFaq Trac FAQ] -- Frequently Asked Questions |
||
160 | * TracSupport -- Trac Support |
||
161 | |||
162 | For a complete list of local wiki pages, see TitleIndex. |