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