WikiStart » History » Revision 130

« Previous | Revision 130/146 (diff) | Next »
laforge, 02/20/2016 08:59 PM

Welcome to Osmocom OpenBSC

This is a project aiming to create a Free Software, (A)GPL-licensed software implementations for the GSM/3GPP protocol stacks and elements.

We have started with an A-bis (plus BSC/MSC/HLR) implementation for experimentation and research purpose, but have since moved way beyond that.

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.

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).

In addition, the Osmocom project also develops and maintains the osmo-sgsn and OpenGGSN programs for adding GPRS/EDGE capabilities.

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 UmSITE.

We are always looking for HardwareDonations of any kind of GSM / 3G related carrier equipment.


There is also continued work on creating a Free Software / Open Source software SS7 (M3UA, SUA, SCCP, TCAP, MAP) protocol stack in Erlang, as well as a number of other side projects like the SIMtrace protocol tracer/sniffer for (U)SIM APDUs.

Overview Diagram

Please see the below overview diagram about common possible configurations of the Osmocom software.


Getting started

UnderstandingOpenBSC -- Where to start learning about OpenBSC, what it does, and how.

OpenBSC Software

  • Software for running a full minimal GSM Network in a Box:
    • OpenBSC -- The Free Software project implementing various parts of the GSM network
      • osmo-nitb -- A stand-alone gsm-network-in-a-box program implementing minimal subset of BSC, MSC, HLR, AuC and EIR.
        • osmo-nitb_VTY -- Reference for the interactive command line and config file
  • Software utilities for BTS configuration, provisioning and the like
    • bs11_config -- A small tool for configuring the BS-11 using RS232
    • ipaccess-find -- A small tool to find nanoBTS in your network
    • ipaccess-config -- A small tool to set NVRAM configuration of the nanoBTS
    • isdnsync -- A small tool to use the PSTN as frequency standard
  • Software for running a BTS
  • Software for running in pure BSC only mode, attaching via A/SCCP to a MSC
  • Software for UMA/GAN (Unified Mobile Access)
  • Special purpose software for aggregating multiple A or Gb links
    • bsc_nat -- a BSC NAT/Multiplexer
    • osmo-gbproxy -- A proxy/gateway for aggregating multiple Gb links betwen BSS and SGSN
      • osmo-gbproxy_VTY -- Reference for the interactive command line and config file
    • Testing -- Comments and what makes sense to test for releases
  • GPRS related software
  • OpenBSC related
    • cellmgr_ng -- The cellmgr_ng project to bring old equipment to the world of IP
    • simplehlr -- A web interface for the OpenBSC HLR database
  • PortNumbers -- A list of TCP port numbers as they are used by OpenBSC and related programs
  • Protocol extensions
  • simulation -- Running OpenBSC without a GSM Basestation
  • Important legal information on SoftwareLicensing
  • meas_web -- Web based measurement utility for OpenBSC

Information related to a specific BTS model

Miscellaneous Information



*** Browse the repositories at
* Mailinglist is at "* [[Jenkins|Continuous Integration efforts"httplistsgnumonksorgmailmanlistinfoopenbsc]]
* Wiki is right here ;)
* Developer conferences: [[OsmoDevCon2016]], [[OsmoDevCon2015]], [[OsmoDevCon2014]], [[OsmoDevCon2013]], [[OsmoDevCon2012]]
* [[Tasks]] -- Tasks/Internships/Junior Jobs for [[OpenBSC]] and Osmocom
* [[Devtools]] -- Various tools to find/fix errors, send patches, etc
* [[Coding_standards]] -- Coding standards

h3. Tools for developers

* [[WandelGoltermannMA10]] -- a GSM protocol analyzer ISA card
* [[TektronixK1103]] -- GSM protocol tester and analyzer
* [[PacketDump]] -- Using wireshark on PCAP files
* [[MagicSIM]] -- SIM cards where you can program the Ki

h2. News

* _OpenBSC ran many more experimental and commercial networks, but no one bothered to update this section..._
* [[OpenBSC]] was running an experimental GSM network at "CCC Camp": in the Summer of 2011
* [[OpenBSC]] was running an experimental GSM network at "27c3": in December 2010
* The slides of the "25C3 presentation _Running your own GSM network_": "are available":
* The slides of the "26C3 presentation _Fuzzing GSM handsets using [[OpenBSC]]_": "are available":

h2. Related projects

* "-- [[OsmocomBB]] - Free Software GSM protocol stack for mobile phones
* [ [[OpenBTS]]":]
* "The THC GSM project":
* "":
* "Homepage of Dr.-Ing. Joachim Goeller":

h2. Thanks

* to "for funding part of the [[OpenBSC]] development
* to [":] for supporting us with discounted E1 boards
* to "for funding part of the [[OpenBSC]] development
* to Kevin Redon for the osmocom logo

h2. Starting Points about trac

* About [[WikiFormatting]]
* [[TracGuide]] --  Built-in Documentation
* [ The Trac project":] -- Trac Open Source Project
* "Trac FAQ": -- Frequently Asked Questions
* [[TracSupport]] --  Trac Support

For a complete list of local wiki pages, see [[TitleIndex]].
Files (2)
osmocom-gsm.svg View osmocom-gsm.svg 82.5 KB overview about osmocom GSM network elements laforge, 10/19/2015 11:34 AM
osmocom-gsm.png View osmocom-gsm.png 99.6 KB laforge, 10/19/2015 11:37 AM

Updated by laforge about 8 years ago · 130 revisions

Add picture from clipboard (Maximum size: 48.8 MB)