- What is OpenBSC
- Configurations / Modes
- Source code
- Mailing list
- Project status
OpenBSC is the current name for a software project that started with the name bs11-abis.BSC (Base Station Controller) side implementation of the A-bis protocol, as implemented in the GSM Technical Specification 08.5x and 12.21. It can run either
- as OsmoBSC, exposing an A interface towards an external MSC, or
- as OsmoNITB (Network In The Box), whert implements a minimal subset of the BSC, MSC. SMSC and HLR.
- provide a basis for experimentation and security research with GSM from the network side
- provide a zero-cost alternative for hands-on experience with GSM systems in education and training
- learn more about GSM networks on a lower level, particularly the practical aspects with real-world equipment
- provide a stable/reliable network-side GSM implementation for small networks that don't need millions of subscribers or 99.99999% availability
While OpenBSC is mainly written in portable C99 code, there are is one non-portable part: The E1 input driver requires a Linux kernel with mISDN support and an E1 interface card compatible with mISDN. You only need this if you have an E1 based BTS!To operate a GSM network, you not only need OpenBSC but of course also some kind of GSM BTS. The only currently tested configurations are with a
- sysmocom sysmoBTS (using OsmoBTS)
- fairwaves UmSITE and UmDESK (using OsmoBTS)
- Siemens BS-11 microBTS
- ipaccess nanoBTS
IF you feel geeky, you could also build a BTS yourself, using full-duplex capable SDR (Software Defined Radio) hardware and a usual PC with OsmoTRX and OsmoBTS software. The software installation is described at the network_from_scratch page.
Configurations / Modes¶
This is very different from a classic GSM network in which the BSC is only one minor element in the distributed network consisting
of many different elements like BSC, MSC, HLR, etc. Nonetheless, it is the classic mode to operate OpenBSC. In this configuration, you only need (at least) one BTS and OpenBSC. There is no need for a MSC, HLR, VLR, AuC or any other traditional GSM network components.
In order to use the NITB mode, you will use the osmo-nitb program.
If you want to use OpenBSC as a classic GSM BSC, you can do that as well. However, you will need all other parts of the GSM
network and a MSC that can provide an A-over-IP interface using SCCP-lite
In order to use the BSC-only mode, you will use the osmo-bsc program.
Information related to a specific BTS model¶
Topics related to BTSs with classic E1 interface (non-IP based):
- HFC-E1 Evaluation Board -- The E1 card we use for attaching classic E1 based A-bis links
- mISDN -- The Linux ISDN stack
- GSM -- Some links for starting to understand GSM
- LegalNotes -- Important Legal notes on operating GSM base stations
- FieldTests -- The OpenBSC field tests and their reports
- Standard configuration:
- Advanced topics:
- OpenBSC_with_Asterisk -- A comprehensive tutorial on setting up OpenBSC with Asterisk
- OpenBSC_LCR -- OpenBSC+LCR with Asterisk (obsolete)
- OpenBSC_LCR_Ubuntu1204 -- Short installation guide for OpenBSC with Asterisk on Ubuntu 12.04
- OpenBSC_Crypto -- Howto add A5/x cryptography support to your OpenBSC setup
- SDR_OsmoTRX_network_from_scratch -- Building everything from scratch for SDR based hardware with OsmoTRX, OsmoBTS and OsmoNITB.
- RF Topics:
The OpenBSC project does not publish official releases. Users are recommended to use the latest git master.
You can check out the source code via
git clone git://git.osmocom.org/openbsc.git
or browse it at http://cgit.osmocom.org/cgit/openbsc/
There's a developer mailing list called firstname.lastname@example.org
Subscription is available at "h2. IRC (Internet Relay Chat)
We have an IRC channel where some developers and users hang out. You can find it at:
Things that work¶
- Mobility Management
- Very simplistic HLR implemented as sqlite database
- Non-secure Authorization using IMEI/IMSI and regular SIM cards.
- Authentication using COMP128v1 if you have SIM cards with known Ki
- IMEI/IMSI skimming of all phones that try to register with OpenBSC
- Transmission of MM INFO packets with operator name and local time / timezone
- paging of mobiles that are registered to the BTS
- keeping track of which location area a phone has last performed location updating
- in-call handover between multiple cells inside one BSC
- SMS Support
- Voice Call Support
- MO (Mobile Originated) and MT (Mobile Terminated) calls
- TCH/F support with FR and EFR codec
- TCH/H support with HR and AMR codec
- Cell Broadcast Support
- USSD (only for built-in USSD commands, no external interface)
- E1 support
- Abis/IP support
- GPRS/EDGE support
Things that are implemented but don't work yet or aren't tested yet¶
- dynamic PDCH / TCH switching
Things that are not implemented¶
- Any type of transcoding of voice data (we leave this to the external MNCC handler / media gateway)
- CSD calls
- emergency call handling (works in osmo-bsc, but not in osmo-nitb)
Contributions (in no specific order) by Dieter Spaar, Stefan Schmidt, Daniel Willmann, Jan Luebbe, Thomas Seiler, Andreas Eversberg, Sylvain Munaut, Ciaby, Alexander Chemeris, Neels Hofmeyr, Nico Golde, Pablo Neira.
Special thanks to Dieter Spaar for BS11-Init and tons of feedback and comments, without which we would not have been able to make progress as quickly as we did.