Project

General

Profile

WikiStart » History » Version 139

neels, 04/21/2016 03:12 PM

1 1
h1. Welcome to Osmocom [[OpenBSC]]
2 129 laforge
3 135 laforge
{{>toc}}
4 1
5
We have started with an A-bis (plus BSC/MSC/HLR) implementation for experimentation and research purpose, but have since moved way beyond that.
6
7
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.
8 129 laforge
9 1
[[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).
10 129 laforge
11 135 laforge
We have started with the Siemens BS11 microBTS, mainly targetted the ip.access nanoBTS for some years, but has since been extended to support a variety of other [[BTS]] equipment like the Ericsson RBS 2000 family.  Today, most of the users and active developers work not with proprietary BTSs, but with BTSs running our [[OsmoBTS]] software, i.e. either the [[sysmoBTS]] family of hardware or SDR based hardware with [[OsmoTRX:]] like the [[UmTRX:]] or "UmSITE":https://fairwaves.co/wp/products/.
12 129 laforge
13 135 laforge
_We are always looking for [[cellular-infrastructure:HardwareDonations]] of any kind of GSM / 3G related carrier equipment._
14 1
15 129 laforge
h1. Overview Diagram
16
17
18 1
Please see the below overview diagram about common possible configurations of the Osmocom software.
19
20 134 laforge
!osmocom-gsm.png!
21 1
22
23 129 laforge
h2. Getting started
24 1
25 129 laforge
[[UnderstandingOpenBSC]] -- Where to start learning about [[OpenBSC]], what it does, and how.
26 1
27
28 129 laforge
h2. [[OpenBSC]] Software
29 1
30 129 laforge
* Software for running a full minimal GSM Network in a Box:
31
** [[OpenBSC]] -- The Free Software project implementing various parts of the GSM network
32
*** [[osmo-nitb]] -- A stand-alone gsm-network-in-a-box program implementing minimal subset of BSC, MSC, HLR, AuC and EIR.
33
**** [[osmo-nitb_VTY]] -- Reference for the interactive command line and config file
34
* Software utilities for BTS configuration, provisioning and the like
35
** [[bs11_config]] -- A small tool for configuring the BS-11 using RS232
36
** [[ipaccess-find]] -- A small tool to find nanoBTS in your network 
37
** [[ipaccess-config]] -- A small tool to set NVRAM configuration of the nanoBTS
38
** [[isdnsync]] -- A small tool to use the PSTN as frequency standard
39
* Software for running a BTS
40
** [[OsmoBTS]] -- A BTS implementation
41
** [[OsmoTRX]] -- A transceiver for [[OsmoBTS]] to use with SDR hardware
42
* Software for running in pure _BSC only_ mode, attaching via A/SCCP to a MSC
43
** [[osmo-bsc]] -- [[OpenBSC]] in BSC-only mode
44
** [[bsc_msc_ip]] -- A previous utility to connect to a MSC via A over IP
45
*** [[OpenBSCWithSCCP]] -- Howto use [[OpenBSC]] with a separate/real MSC
46
** [[bsc_mgcp]] -- A stupid [[MediaGatewayControlProtocol]] (MGCP) gateway
47
*** [[bsc_mgcp_VTY]] -- Reference for the interactive command line and config file
48
* Software for UMA/GAN (Unified Mobile Access)
49
** [[osmo-ganc]] -- [[OpenBSC]] in GANC mode
50
* Special purpose software for aggregating multiple A or Gb links
51
** [[bsc_nat]] -- a BSC NAT/Multiplexer
52
*** [[bsc_nat_VTY]] -- Reference for the interactive command line and config file
53
*** [[bsc_nat_release]] -- Release testing for the BSC NAT.
54
** [[osmo-gbproxy]] -- A proxy/gateway for aggregating multiple Gb links betwen BSS and SGSN
55
*** [[osmo-gbproxy_VTY]] -- Reference for the interactive command line and config file
56
** [[release-testing|Testing]] -- Comments and what makes sense to test for releases
57
* GPRS related software
58
** [[osmo-sgsn]] -- A work-in-progress SGSN
59
*** [[osmo-sgsn_VTY]] -- Reference for the interactive command line and config file
60
*** [[OpenBSC_GPRS]] -- Howto add data support to your [[OpenBSC]] setup
61
** [[osmo-pcu]] -- A work-in-progress RLC/MAC and PCU implementation
62
* [[OpenBSC]] related
63
* [[PortNumbers]] -- A list of TCP port numbers as they are used by [[OpenBSC]] and related programs
64
* Protocol extensions
65
*** [[MgcpExtensions]] -- Extensions to MGCP
66
* [[simulation]] -- Running [[OpenBSC]] without a GSM Basestation
67
* Important legal information on [[SoftwareLicensing]]
68
* [[meas_web]] -- Web based measurement utility for [[OpenBSC]]
69
70 78 laforge
h3. Information related to a specific BTS model
71 1
72 130 laforge
{{child_pages(BTS_Hardware,depth=1)}}
73 103
74 135 laforge
h3. Topics related to BTSs with classic E1 interface (non-IP based):
75 132 laforge
76 129 laforge
{{child_pages(E1-Interface)}}
77
78
h3. Miscellaneous Information
79
80 131 laforge
* [[GSM]] -- Some links for starting to understand GSM
81 129 laforge
* [[LegalNotes]] -- Important Legal notes on operating GSM base stations
82
* [[FieldTests]] -- The [[OpenBSC]] field tests and their reports
83
84
h3. Howtos
85
86
* Standard configuration:
87 1
*** [[Building_OpenBSC]] -- Getting started with [[OpenBSC]] under Debian
88
*** [[multi-BTS_with_handover]] -- Connecting 2x BTS to a single BSC/NITB and enabling handover 
89 129 laforge
90 1
* Advanced topics:
91 129 laforge
*** [[OpenBSC_with_Asterisk]] -- A comprehensive tutorial on setting up [[OpenBSC]] with Asterisk
92
*** [[OpenBSC_LCR]] -- [[OpenBSC]]+LCR with Asterisk (obsolete)
93
*** [[OpenBSC_LCR_Ubuntu1204]] -- Short installation guide for [[OpenBSC]] with Asterisk on Ubuntu 12.04
94
*** [[OpenBSC_Crypto]] -- Howto add A5/x cryptography support to your [[OpenBSC]] setup
95
*** [[SDR_OsmoTRX_network_from_scratch]] -- Building everything from scratch for SDR based hardware with [[OsmoTRX]], [[OsmoBTS]] and [[OsmoNITB]].
96
97
* RF Topics:
98
*** [[cable_antenna]] -- Build new antennas for your BTS
99
*** [[ethernet_dummyload]] -- Use an old ethernet terminator as dummyload
100
*** [[10db_attenuator]] -- Turn 30mW into 3 mW
101
102
h2. Developers
103
104
* Browse the repositories at http://git.osmocom.org/
105 139 neels
* "Mailinglist":https://lists.osmocom.org/mailman/listinfo
106
** For voice/SMS/..., use "OpenBSC":https://lists.osmocom.org/mailman/listinfo/openbsc
107
** For GPRS/SGSN/data-comms related discussions, use "osmocom-net-gprs":https://lists.osmocom.org/mailman/listinfo/osmocom-net-gprs
108
* [[Jenkins|Continuous Integration efforts]]
109 129 laforge
* Wiki is right here ;)
110 135 laforge
* Developer conferences: [[OsmoDevCon]]
111 129 laforge
* [[Tasks]] -- Tasks/Internships/Junior Jobs for [[OpenBSC]] and Osmocom
112
* [[Devtools]] -- Various tools to find/fix errors, send patches, etc
113
* [[Coding_standards]] -- Coding standards
114
* [[PacketDump]] -- Using wireshark on PCAP files
115 13 laforge
116 129 laforge
h2. News
117 76 laforge
118 88
* _OpenBSC ran many more experimental and commercial networks, but no one bothered to update this section..._
119 129 laforge
* [[OpenBSC]] was running an experimental GSM network at "CCC Camp":http://events.ccc.de/camp/2011/wiki/GSM in the Summer of 2011
120
* [[OpenBSC]] was running an experimental GSM network at "27c3":http://events.ccc.de/congress/2010 in December 2010
121
* The slides of the "25C3 presentation _Running your own GSM network_":http://events.ccc.de/congress/2008/Fahrplan/events/3007.en.html "are available":http://events.ccc.de/congress/2008/Fahrplan/attachments/1259_25C3-OpenBSC.pdf.
122
* The slides of the "26C3 presentation _Fuzzing GSM handsets using [[OpenBSC]]_":http://events.ccc.de/congress/2009/Fahrplan/events/3535.en.html "are available":http://events.ccc.de/congress/2009/Fahrplan/attachments/1503_openbsc_gsm_fuzzing.pdf
123 76 laforge
124 129 laforge
h2. Related projects
125 1
126
* [[simplehlr]] -- A web interface for the [[OpenBSC]] HLR database
127 138 laforge
* [[OsmocomBB:]] - Free Software GSM protocol stack for mobile phones
128
* "OpenBTS":http://gnuradio.org/redmine/projects/gnuradio/wiki/OpenBTS
129 129 laforge
* "The THC GSM project":http://wiki.thc.org/gsm/
130
* "airprobe.org":http://airprobe.org/
131
* "Homepage of Dr.-Ing. Joachim Goeller":http://www2.informatik.hu-berlin.de/~goeller/
132
133
h2. Thanks
134 1
135 136 laforge
* to "On-Waves ehf":http://on-waves.com/ and "sysmocom GmbH":http://sysmocom.de/ for funding part of the development and maintennance
136
* to http://junghanns.net for supporting us with discounted E1 boards
137
* to "Netzing AG":http://netzing.de/ for funding part of the earlier [[OpenBSC:]] development
138
* to Kevin Redon for the Osmocom logo
Add picture from clipboard (Maximum size: 48.8 MB)