OsmoBSC User Manual i sysmocom - s.f.m.c. GmbH OsmoBSC User Manual by Holger Freyther, Harald Welte, and Neels Hofmeyr Copyright © 2012-2018 sysmocomDRAFT - s.f.m.c. GmbH Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with the Invariant Sections being just ’Foreword’, ’Acknowledgements’ and ’Preface’, with no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License". The Asciidoc source code of this manual can be found at http://git.osmocom.org/osmo-gsm-manuals/ DRAFT 1.7.0-269-g37288, 2021-Sep-27 OsmoBSC User Manual ii HISTORY NUMBER DATE DESCRIPTION NAME 1 February 2016 Initial OsmoBSC manual, recycling OsmoNITB HW sections 2 October 2018 Add Handover chapter: document new neighbor NH configuration, HO algorithm 2 and inter-BSC handover. Copyright © 2012-2018 sysmocom - s.f.m.c. GmbH DRAFT 1.7.0-269-g37288, 2021-Sep-27 OsmoBSC User Manual iii Contents 1 Foreword 1 1.1 Acknowledgements..................................................1 1.2 Endorsements.....................................................2 2 Preface 2 2.1 FOSS lives by contribution!..............................................2 2.2 Osmocom and sysmocom...............................................2 2.3 Corrections......................................................3 2.4 Legal disclaimers...................................................3 2.4.1 Spectrum License...............................................3 2.4.2 Software License...............................................3 2.4.3 Trademarks..................................................3 2.4.4 Liability....................................................3 2.4.5 Documentation License...........................................4 3 Introduction 4 3.1 Required Skills....................................................4 3.2 Getting assistance...................................................4 4 Overview 4 4.1 About OsmoBSC...................................................5 4.2 Software Components.................................................5 4.2.1 A-bis Implementation............................................5 4.2.2 A Implementation..............................................5 4.2.2.1 BSSAP/SCCPlite.........................................5 4.2.2.2 BSSAP/SCCP/M3UA.......................................6 4.2.3 BSC Implementation.............................................6 4.2.4 TRAU mapper / E1 sub-channel muxer...................................7 5 Running OsmoBSC 7 5.1 SYNOPSIS......................................................7 5.2 OPTIONS.......................................................7 5.3 Multiple instances...................................................7 5.4 Configure primary links................................................8 5.4.1 Connect to an MSC’s A interface.......................................8 5.4.1.1 Configure SCCP/M3UA (AoIP)..................................8 5.4.1.2 Configure SCCPlite........................................8 5.4.2 Configure MGCP to connect to an MGW..................................9 5.4.3 Configure Lb to connect to an SMLC....................................9 Copyright © 2012-2018 sysmocom - s.f.m.c. GmbH DRAFT 1.7.0-269-g37288, 2021-Sep-27 OsmoBSC User Manual iv 6 The Osmocom VTY Interface 9 6.1 Accessing the telnet VTY............................................... 10 6.2 VTY Nodes...................................................... 10 6.3 Interactive help.................................................... 11 6.3.1 The question-mark (?) command...................................... 11 6.3.2 TAB completion............................................... 12 6.3.3 The list command............................................. 13 6.3.4 The attribute system............................................. 14 6.3.5 The expert mode............................................... 16 7 libosmocore Logging System 16 7.1 Log categories..................................................... 17 7.2 Log levels....................................................... 17 7.3 Log printing options................................................. 17 7.4 Log filters....................................................... 18 7.5 Log targets...................................................... 18 7.5.1 Logging to the VTY............................................. 18 7.5.2 Logging to the ring buffer.......................................... 19 7.5.3 Logging via gsmtap............................................. 19 7.5.4 Logging to a file............................................... 20 7.5.5 Logging to syslog............................................... 21 7.5.6 Logging to systemd-journal......................................... 21 7.5.7 Logging to stderr............................................... 22 8 Configure SCCP/M3UA 22 8.1 Connect to STP Instance............................................... 24 8.2 Local Point-Code................................................... 24 8.3 Remote Point-Code.................................................. 24 8.4 Point-Code Format.................................................. 25 8.5 AS and ASP...................................................... 25 8.6 Subsystem Number (SSN).............................................. 26 8.7 Routing Context / Routing Key............................................ 26 8.7.1 M3UA without Routing Context IE / Routing Context 0 .......................... 27 9 Reviewing and Provisioning BTS configuration 27 9.1 Reviewing current BTS status and configuration................................... 27 9.2 Provisioning a new BTS............................................... 28 9.3 System Information configuration.......................................... 29 9.4 Neighbor List configuration.............................................. 29 9.5 Configuring GPRS PCU parameters of a BTS.................................... 30 Copyright © 2012-2018 sysmocom - s.f.m.c. GmbH DRAFT 1.7.0-269-g37288, 2021-Sep-27 OsmoBSC User Manual v 9.6 More explanation about the PCU config parameters................................. 30 9.6.1 gprs mode (none|gprs|egprs) ................................... 30 9.6.2 gprs cell bvci <2-65535> ..................................... 30 9.6.3 gprs nsei <0-65535> ......................................... 30 9.6.4 gprs nsvc <0-1> nsvci <0-65535> ............................... 30 9.6.5 gprs nsvc <0-1> local udp port <0-65535> ........................ 31 9.6.6 gprs nsvc <0-1> remote udp port <0-65535> ....................... 31 9.6.7 gprs nsvc <0-1> remote ip A.B.C.D .............................. 31 9.6.8 gprs ns timer (tns-block|tns-block-retries|tns-reset|tns-reset-retries |tns-test|tns-alive|tns-alive-retries) <0-255>..................... 31 9.7 Dynamic Timeslot Configuration (TCH / PDCH).................................. 31 9.7.1 Osmocom Style Dynamic Timeslots (TCH/F_TCH/H_SDCCH8_PDCH)................. 32 9.7.2 ip.access Style Dynamic Timeslots (TCH/F_PDCH)............................ 32 9.7.3 Avoid PDCH Exhaustion........................................... 32 9.7.4 Dynamic Timeslot Configuration Examples................................. 32 9.8 Tuning Access to the BTS.............................................. 33 9.8.1 Access Control Class Load Management.................................. 33 9.9 Configuring FACCH/SACCH repetition....................................... 35 9.9.1 RACH Parameter Configuration....................................... 36 10 OsmoBSC example configuration files 36 10.1 Example configuration for OsmoBSC with one single-TRX nanoBTS....................... 37 10.2 Example configuration for OsmoBSC with multi-TRX nanoBTS.......................... 38 11 BSC level configuration 39 11.1 Hand-over....................................................... 39 11.1.1 Hand-over in GSM.............................................. 39 11.1.2 Configuration of hand-over in OsmoBSC.................................. 39 11.2 Timer Configuration................................................. 40 11.3 Discontinuous Transmission (DTX)......................................... 41 12 Power control 41 12.1 Power control parameters............................................... 41 12.1.1 When the parameters come into effect?................................... 42 12.2 Power control configuration.............................................. 42 12.2.1 Power control mode............................................. 43 12.2.2 Power control interval............................................ 43 12.2.3 Power change step size............................................ 44 12.2.4 RxLev and RxQual thresholds........................................ 45 12.2.5 Carrier-to-Interference (C/I) thresholds................................... 46 Copyright © 2012-2018 sysmocom - s.f.m.c. GmbH DRAFT 1.7.0-269-g37288, 2021-Sep-27 OsmoBSC User Manual vi 12.2.6 Measurement averaging process....................................... 47 12.3 BCCH carrier power reduction operation....................................... 48 12.3.1 Supported BTS models............................................ 48 12.3.2 Interworking with static and dynamic power control............................ 48 12.3.3 Managing BCCH carrier power reduction.................................. 49 13 CS Handover 50 13.1 How Handover Works................................................. 50 13.1.1 Internal / Intra-BSC Handover.......................................