WikiStart » History » Version 86
laforge, 02/19/2016 10:47 PM
1 | 65 | laforge | [[PageOutline]] |
---|---|---|---|
2 | 68 | laforge | = Welcome to 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 | 56 | laforge | What this means: OpenBSC is a ''GSM network in a box'' software, implementing the minimal necessary parts to build a small, self-contained GSM network. |
9 | |||
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 | 43 | laforge | Right now we are targeting the '''Siemens BS11 microBTS''' and '''ip.access nanoBTS''' GSM base transceiver station, but we are planning to support different [wiki:BTS] equipment in the future. |
13 | 1 | ||
14 | ''We are looking for [wiki:HardwareDonations] of any kind of GSM / 3G related carrier equipment.'' |
||
15 | |||
16 | 77 | laforge | [[BlogList(format=float,recent=5,max_size=350)]] |
17 | |||
18 | 1 | == OpenBSC Software == |
|
19 | 75 | laforge | * Software for running a full minimal GSM Network in a Box: |
20 | * [wiki:OpenBSC] -- The Free Software project implementing various parts of the GSM network |
||
21 | 83 | laforge | * [wiki:osmo-nitb] -- A stand-alone gsm-network-in-a-box program implementing minimal subset of BSC, MSC, HLR, AuC and EIR. |
22 | * [wiki:osmo-nitb_VTY] -- Reference for the interactive command line and config file |
||
23 | 75 | laforge | * Software utilities for BTS configuration, provisioning and the like |
24 | 45 | dexter | * [wiki:bs11_config] -- A small tool for configuring the BS-11 using RS232 |
25 | 1 | * [wiki:ipaccess-find] -- A small tool to find nanoBTS in your network |
|
26 | * [wiki:ipaccess-config] -- A small tool to set NVRAM configuration of the nanoBTS |
||
27 | * [wiki:isdnsync] -- A small tool to use the PSTN as frequency standard |
||
28 | 75 | laforge | * Software for running in pure ''BSC only'' mode, attaching via A/SCCP to a MSC |
29 | 86 | laforge | * [wiki:osmo-bsc] -- OpenBSC in BSC-only mode |
30 | * [wiki:bsc_msc_ip] -- A previous utility to connect to a MSC via A over IP |
||
31 | 75 | laforge | * [wiki:OpenBSCWithSCCP] -- Howto use OpenBSC with a separate/real MSC |
32 | 1 | * [wiki:bsc_mgcp] -- A stupid MediaGatewayControlProtocol (MGCP) gateway |
|
33 | 75 | laforge | * [wiki:bsc_mgcp_VTY] -- Reference for the interactive command line and config file |
34 | * Special purpose software for aggregating multiple A or Gb links |
||
35 | 1 | * [wiki:bsc_nat] -- a BSC NAT/Multiplexer |
|
36 | 75 | laforge | * [wiki:bsc_nat_VTY] -- Reference for the interactive command line and config file |
37 | * [wiki:bsc_nat_release] -- Release testing for the BSC NAT. |
||
38 | 66 | laforge | * [wiki:osmo-gbproxy] -- A proxy/gateway for aggregating multiple Gb links betwen BSS and SGSN |
39 | 75 | laforge | * [wiki:osmo-gbproxy_VTY] -- Reference for the interactive command line and config file |
40 | * GPRS related software |
||
41 | 65 | laforge | * [wiki:osmo-sgsn] -- A work-in-progress SGSN |
42 | 75 | laforge | * [wiki:osmo-sgsn_VTY] -- Reference for the interactive command line and config file |
43 | * [wiki:OpenBSC_GPRS] -- Howto add data support to your OpenBSC setup |
||
44 | 82 | * OpenBSC related |
|
45 | * [wiki:cellmgr_ng] -- The cellmgr_ng project to bring old equipment to the world of IP |
||
46 | 76 | laforge | |
47 | 78 | laforge | * Important legal information on [wiki:SoftwareLicensing] |
48 | |||
49 | 1 | === Information related to a specific BTS model === |
|
50 | 75 | laforge | * [wiki:BS11] -- The Siemens BS-11 microBTS |
51 | 84 | laforge | * [wiki:BS11/Sales] -- BS-11 units are sold out by now, sorry. |
52 | * [wiki:BS11/Package_List] -- Make sure everything is in the package |
||
53 | * [wiki:BS11/Configuration] -- How to use / setup the hardware |
||
54 | * [wiki:BS11/LMT] -- The local maintenance Terminal |
||
55 | * [wiki:BS11/Getting_Started] -- Getting started with your BS-11 |
||
56 | * [wiki:BS11/Troubleshooting] -- When something doesn't work |
||
57 | * [wiki:BS11/Internals] -- Details like PCB photographs |
||
58 | 1 | * [wiki:E1-to-RJ45] -- Howto build your E1<>RJ45 cable |
|
59 | 84 | laforge | * [wiki:BS11/RJ45mod] -- How to add RJ45 connectors to your BS-11 |
60 | 81 | dexter | * [wiki:Isdnsync] -- Howto use the PSTN as frequency standard |
61 | 75 | laforge | * [wiki:nanoBTS] -- the ip.access nanoBTS |
62 | 85 | laforge | * [wiki:nanoBTS/Getting_Started] -- How to get started with a nanoBTS |
63 | 84 | laforge | * [wiki:nanoBTS/Models] -- Known models |
64 | * [wiki:nanoBTS/Internals] -- Details like PCB photographs and debug port |
||
65 | * [wiki:nanoBTS/multiTRX] -- Creating a nanoBTS multi-TRX setup |
||
66 | 1 | * [wiki:HSL_Femto] -- the HSL 2.75G Femtocell |
|
67 | 16 | laforge | * [wiki:Ericsson_RBS] -- Ericsson BTSs (RBS2308, RBS2401) |
68 | 84 | laforge | * [wiki:Motorola_Horizon_macro] -- Motorola Horizon macro BTS |
69 | 1 | ||
70 | === Miscellaneous Information === |
||
71 | 75 | laforge | * [wiki:HFC-E1 HFC-E1 Evaluation Board] -- The E1 card we use for attaching classic E1 based A-bis links |
72 | 1 | * [wiki:GSMStandards] -- The specifications for GSM |
|
73 | 75 | laforge | * [wiki:A5_GSM_AT_tricks] -- A5: Authentication & Ciphering |
74 | 65 | laforge | * [wiki:mISDN] -- The Linux ISDN stack |
75 | 55 | laforge | * [wiki:HandsetBugs] -- Things we have observed during development |
76 | 57 | dexter | * [wiki:GSM_Security] -- The GSM security issues that we find |
77 | 67 | laforge | |
78 | 75 | laforge | * [wiki:LegalNotes] -- Important Legal notes on operating GSM base stations |
79 | 55 | laforge | * [wiki:FieldTests] -- The OpenBSC field tests and their reports |
80 | |||
81 | 1 | === Howtos === |
|
82 | 71 | dexter | * Standard configuration: |
83 | 1 | * [wiki:Building_OpenBSC] -- Getting started with OpenBSC under Debian |
|
84 | 71 | dexter | * Advanced topics: |
85 | 74 | laforge | * [wiki:OpenBSC_LCR] -- OpenBSC+LCR with Asterisk |
86 | 58 | dexter | * [wiki:OpenBSC_Crypto] -- Howto add A5/x cryptography support to your OpenBSC setup |
87 | 59 | dexter | |
88 | 33 | * RF Topics: |
|
89 | 4 | laforge | * [wiki:cable_antenna] -- Build new antennas for your BTS |
90 | * [wiki:ethernet_dummyload] -- Use an old ethernet terminator as dummyload |
||
91 | 36 | laforge | * [wiki:10db_attenuator] -- Turn 30mW into 3 mW |
92 | 1 | ||
93 | 67 | laforge | == Developers == |
94 | 1 | ||
95 | 79 | laforge | * git checkout is available via {{{git clone git://git.osmocom.org/openbsc.git}}} |
96 | 6 | laforge | * you now also need libosmocore to build openbsc: {{{git clone git://git.osmocom.org/libosmocore.git}}} |
97 | * Mailinglist is at [http://lists.gnumonks.org/mailman/listinfo/openbsc] |
||
98 | 65 | laforge | * [wiki:Tarballs] of libosmocore and OpenBSC |
99 | 6 | laforge | * Wiki is right here ;) |
100 | 1 | ||
101 | 30 | === Tools for developers === |
|
102 | 18 | ||
103 | 19 | laforge | * [wiki:WandelGoltermannMA10] -- a GSM protocol analyzer ISA card |
104 | * [wiki:TektronixK1103] -- GSM protocol tester and analyzer |
||
105 | 41 | laforge | * [wiki:PacketDump] -- Using wireshark on PCAP files |
106 | * [wiki:MagicSIM] -- SIM cards where you can program the Ki |
||
107 | 74 | laforge | |
108 | 61 | laforge | == News == |
109 | |||
110 | 19 | laforge | * OpenBSC was running an experimental GSM network at [http://events.ccc.de/congress/2010 27c3] in December 2010 |
111 | 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]. |
112 | * 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] |
||
113 | |||
114 | |||
115 | 13 | laforge | == Related projects == |
116 | |||
117 | 76 | laforge | * [http://bb.osmocom.org/] -- OsmocomBB - Free Software GSM protocol stack for mobile phones |
118 | 1 | * [http://gnuradio.org/trac/wiki/OpenBTS OpenBTS] |
|
119 | * [http://wiki.thc.org/gsm/ The THC GSM project] |
||
120 | * [http://airprobe.org/ airprobe.org] |
||
121 | * [http://www2.informatik.hu-berlin.de/~goeller/ Homepage of Dr.-Ing. Joachim Goeller] |
||
122 | |||
123 | 76 | laforge | == Thanks == |
124 | |||
125 | * to [http://netzing.de] for funding part of the OpenBSC development |
||
126 | * to [http://junghanns.net] for supporting us with discounted E1 boards |
||
127 | * to [http://www.on-waves.com] for funding part of the OpenBSC development |
||
128 | |||
129 | 1 | == Starting Points about trac == |
|
130 | |||
131 | * About WikiFormatting |
||
132 | * TracGuide -- Built-in Documentation |
||
133 | * [http://trac.edgewall.org/ The Trac project] -- Trac Open Source Project |
||
134 | * [http://trac.edgewall.org/wiki/TracFaq Trac FAQ] -- Frequently Asked Questions |
||
135 | * TracSupport -- Trac Support |
||
136 | |||
137 | For a complete list of local wiki pages, see TitleIndex. |