WikiStart » History » Version 74
laforge, 02/19/2016 10:47 PM
add field tests, update news
1 | 65 | laforge | [[PageOutline]] |
---|---|---|---|
2 | 68 | laforge | = Welcome to OpenBSC = |
3 | 1 | ||
4 | 25 | laforge | This is a project aiming to create a Free Software, GPL-licensed Abis (plus BSC/MSC/HLR) implementation for experimentation and research purpose. |
5 | |||
6 | 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. |
7 | |||
8 | 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). |
||
9 | |||
10 | 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. |
11 | 1 | ||
12 | 72 | laforge | ''We are looking for [wiki:HardwareDonations] of any kind of GSM / 3G related carrier equipment.'' |
13 | |||
14 | 65 | laforge | == OpenBSC Software == |
15 | * [wiki:OpenBSC] -- The Free Software project implementing various parts of the GSM network |
||
16 | * [wiki:BscHack] -- A stand-alone gsm-network-in-a-box program implementing minimal subset of BSC, MSC, HLR, AuC and EIR. |
||
17 | 54 | laforge | * [wiki:bsc_hack_VTY] -- Reference for the interactive command line and config file |
18 | 28 | laforge | * [wiki:bs11_config] -- A small tool for configuring the BS-11 using RS232 |
19 | 38 | laforge | * [wiki:ipaccess-find] -- A small tool to find nanoBTS in your network |
20 | * [wiki:ipaccess-config] -- A small tool to set NVRAM configuration of the nanoBTS |
||
21 | 45 | dexter | * [wiki:isdnsync] -- A small tool to use the PSTN as frequency standard |
22 | 60 | * [wiki:bsc_msc_ip] -- A utility to connect to a MSC via A over IP |
|
23 | * [wiki:bsc_mgcp] -- A stupid MediaGatewayControlProtocol (MGCP) gateway |
||
24 | * [wiki:bsc_mgcp_VTY] -- Reference for the interactive command line and config file |
||
25 | 1 | * [wiki:bsc_nat] -- a BSC NAT/Multiplexer |
|
26 | 66 | laforge | * [wiki:bsc_nat_VTY] -- Reference for the interactive command line and config file |
27 | 73 | * [wiki:bsc_nat_release] -- Release testing for the BSC NAT. |
|
28 | 1 | * [wiki:osmo-gbproxy] -- A proxy/gateway for aggregating multiple Gb links betwen BSS and SGSN |
|
29 | 66 | laforge | * [wiki:osmo-gbproxy_VTY] -- Reference for the interactive command line and config file |
30 | 65 | laforge | * [wiki:osmo-sgsn] -- A work-in-progress SGSN |
31 | 70 | tnt | * [wiki:osmo-sgsn_VTY] -- Reference for the interactive command line and config file |
32 | 65 | laforge | |
33 | === Information related to a specific BTS model === |
||
34 | 38 | laforge | * [wiki:BS11] -- The Siemens microBTS |
35 | 53 | laforge | * [wiki:BS11_Sales] -- BS-11 units are sold out by now, sorry. |
36 | 10 | * [wiki:BS11_Package_List] -- Make sure everything is in the package |
|
37 | 5 | laforge | * [wiki:BS11_Configuration] -- How to use / setup the hardware |
38 | 1 | * [wiki:BS11_LMT] -- The local maintenance Terminal |
|
39 | 29 | laforge | * [wiki:BS11_Getting_Started] -- Getting started with your BS-11 |
40 | 31 | * [wiki:BS11_Troubleshooting] -- When something doesn't work |
|
41 | 42 | laforge | * [wiki:BS11_Internals] -- Details like PCB photographs |
42 | 27 | laforge | * [wiki:nanoBTS] -- the ip.access nanoBTS |
43 | 49 | tnt | * [wiki:nanoBTS_Models] -- Known models |
44 | 1 | * [wiki:nanoBTS_Internals] -- Details like PCB photographs and debug port |
|
45 | * [wiki:nanoBTS_multiTRX] -- Creating a nanoBTS multi-TRX setup |
||
46 | 65 | laforge | |
47 | === Miscellaneous Information === |
||
48 | 11 | laforge | * [wiki:HFC-E1 HFC-E1 Evaluation Board] -- The E1 card we use for our software |
49 | 48 | tnt | * [wiki:GSMStandards] -- The specifications for GSM |
50 | * A5: Authentication & Ciphering |
||
51 | 74 | laforge | * [wiki:A5_GSM_AT_tricks] |
52 | 12 | laforge | * [wiki:mISDN] -- The Linux ISDN stack |
53 | 14 | zecke | * [wiki:LegalNotes] -- Important Legal notes on operating GSM base stations |
54 | 16 | laforge | * [wiki:HandsetBugs] -- Things we have observed during development |
55 | 1 | * [wiki:GSM_Security] -- The GSM security issues that we find |
|
56 | |||
57 | 74 | laforge | * [wiki:FieldTests] -- The OpenBSC field tests and their reports |
58 | 1 | ||
59 | 74 | laforge | |
60 | 65 | laforge | === Howtos === |
61 | 55 | laforge | |
62 | 57 | dexter | * Standard configuration: |
63 | 67 | laforge | * [wiki:Building_OpenBSC] -- Getting started with OpenBSC under Debian |
64 | 57 | dexter | * Advanced topics: |
65 | 55 | laforge | * [wiki:OpenBSC_LCR] -- OpenBSC+LCR with Asterisk |
66 | * [wiki:E1-to-RJ45] -- Howto build your E1<>RJ45 cable |
||
67 | 1 | * [wiki:Isdnsync] -- Howto use the PSTN as frequency standard |
|
68 | * [wiki:OpenBSCWithSCCP] -- Howto use OpenBSC with a separate/real MSC |
||
69 | 71 | dexter | * [wiki:OpenBSC_GPRS] -- Howto add data support to your OpenBSC setup |
70 | 1 | * [wiki:OpenBSC_Crypto] -- Howto add A5/x cryptography support to your OpenBSC setup |
|
71 | 71 | dexter | |
72 | 74 | laforge | * RF Topics: |
73 | 58 | dexter | * [wiki:cable_antenna] -- Build new antennas for your BTS |
74 | 59 | dexter | * [wiki:ethernet_dummyload] -- Use an old ethernet terminator as dummyload |
75 | 33 | * [wiki:10db_attenuator] -- Turn 30mW into 3 mW |
|
76 | 4 | laforge | |
77 | == Developers == |
||
78 | 36 | laforge | |
79 | 1 | * git checkout is available via {{{git clone git://bs11-abis.gnumonks.org/openbsc.git}}} |
|
80 | 67 | laforge | * you now also need libosmocore to build openbsc: {{{git clone git://git.osmocom.org/libosmocore.git}}} |
81 | 1 | * Mailinglist is at [http://lists.gnumonks.org/mailman/listinfo/openbsc] |
|
82 | 62 | * [wiki:Tarballs] of libosmocore and OpenBSC |
|
83 | 6 | laforge | * Wiki is right here ;) |
84 | |||
85 | 65 | laforge | === Tools for developers === |
86 | 6 | laforge | |
87 | 1 | * [wiki:WandelGoltermannMA10] -- a GSM protocol analyzer ISA card |
|
88 | 30 | * [wiki:TektronixK1103] -- GSM protocol tester and analyzer |
|
89 | 18 | * [wiki:PacketDump] -- Using wireshark on PCAP files |
|
90 | 19 | laforge | * [wiki:MagicSIM] -- SIM cards where you can program the Ki |
91 | |||
92 | 41 | laforge | == News == |
93 | |||
94 | 74 | laforge | * OpenBSC was running an experimental GSM network at [http://events.ccc.de/congress/2010 27c3] in December 2010 |
95 | 61 | 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]. |
96 | * 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] |
||
97 | 19 | laforge | |
98 | 32 | laforge | == Thanks == |
99 | |||
100 | * to [http://netzing.de] for funding part of the OpenBSC development |
||
101 | * to [http://junghanns.net] for supporting us with discounted E1 boards |
||
102 | 50 | * to [http://www.on-waves.com] for funding part of the OpenBSC development |
|
103 | 32 | laforge | |
104 | 13 | laforge | == Related projects == |
105 | 32 | laforge | |
106 | 13 | laforge | * [http://gnuradio.org/trac/wiki/OpenBTS OpenBTS] |
107 | * [http://wiki.thc.org/gsm/ The THC GSM project] |
||
108 | 39 | laforge | * [http://airprobe.org/ airprobe.org] |
109 | 1 | * [http://www2.informatik.hu-berlin.de/~goeller/ Homepage of Dr.-Ing. Joachim Goeller] |
|
110 | 58 | dexter | |
111 | 2 | laforge | == Starting Points about trac == |
112 | 1 | ||
113 | 2 | laforge | * About WikiFormatting |
114 | 1 | * TracGuide -- Built-in Documentation |
|
115 | * [http://trac.edgewall.org/ The Trac project] -- Trac Open Source Project |
||
116 | * [http://trac.edgewall.org/wiki/TracFaq Trac FAQ] -- Frequently Asked Questions |
||
117 | * TracSupport -- Trac Support |
||
118 | |||
119 | For a complete list of local wiki pages, see TitleIndex. |