From ea9a44dade04598047187147d622473b512063d6 Mon Sep 17 00:00:00 2001 From: Neels Hofmeyr Date: Thu, 19 Oct 2017 05:11:57 +0200 Subject: refactor Makefile build rules, don't use the FORCE The initial goal was to make sure we don't have overall FORCE rules causing unnecessary rebuilds -- annoying while writing documentation. As I looked through possible dependencies, I finally understood what's going on here. Remove code dup and nicely sort which belongs where in build/Makefile.*.inc. In each, describe in a top comment how to use it, and also unify how they are used: - Rename Makefile.inc to Makefile.docbook.inc and refactor - Add Makefile.vty-reference.inc - Add Makefile.common.inc Make sure that we accurately pick up all dependencies. Drop use of the macro called 'command', that silenced the actual command lines invoked and replaced them with short strings: it obscures what is actually going on and makes the Makefiles hard to read and understand. Each manual's makefile is greatly reduced to few definitions and a Makefile include, e.g. one for asciidoc, one for VTY reference. Move common/bsc_vty_additions.xml to OsmoBSC/vty/libbsc_vty_additions.xml, link from OsmoNITB. It applies only to OsmoBSC and OsmoNITB. Add a script that combines a VTY reference file with *all* additions files found in a manual's vty/ dir. Call this from Makefile.vty-reference.inc. Change-Id: I9758e04162a480e28c7dc83475b514cf7fd25ec0 --- doc/manuals/Makefile | 55 +------ doc/manuals/vty/libbsc_vty_additions.xml | 244 +++++++++++++++++++++++++++++++ 2 files changed, 250 insertions(+), 49 deletions(-) create mode 100644 doc/manuals/vty/libbsc_vty_additions.xml diff --git a/doc/manuals/Makefile b/doc/manuals/Makefile index 35f50da00..153348258 100644 --- a/doc/manuals/Makefile +++ b/doc/manuals/Makefile @@ -1,54 +1,11 @@ -# XSL stylesheets downloaded from http://docbook.sourceforge.net/release/xsl/current/html/ -# Makefile from BitBake/OpenEmbedded manuals - - -EXTRA_DEPS = gen-bsc-vty-docbook - -topdir = . -bsc_reference = $(topdir)/osmobsc-vty-reference.xml -manuals = $(bsc_reference) -# types = pdf txt rtf ps xhtml html man tex texi dvi -# types = pdf txt -types = $(docbooktotypes) -docbooktotypes = pdf -# htmlcssfile = -# htmlcss = - -TOPDIR := .. -ASCIIDOCS := osmobsc-usermanual osmux-reference aoip-mgw-options +TOPDIR = .. +ASCIIDOC = osmobsc-usermanual.adoc osmux-reference.adoc aoip-mgw-options.adoc include $(TOPDIR)/build/Makefile.asciidoc.inc -include $(TOPDIR)/build/Makefile.inc - osmobsc-usermanual.pdf: chapters/*.adoc -osmux-reference.pdf: osmux-reference.adoc -aoip-mgw-options.pdf: aoip-mgw-options.adoc +aoip-mgw-options.pdf: aoip-mgw-options.adoc mgw/*.msc -clean: - -rm -rf $(cleanfiles) - -rm osmobsc-usermanual__*.png - -rm osmobsc-usermanual__*.svg - -rm osmobsc-usermanual*.check - -rm osmux-reference*.check - -rm aoip-mgw-options*.png - -rm aoip-mgw-options*.svg - -rm aoip-mgw-options*.check - -rm osmux-reference__*.svg - -rm osmux-reference__*.png - -rm osmux-reference__*.check +VTY_REFERENCE = osmobsc-vty-reference.xml +include $(TOPDIR)/build/Makefile.vty-reference.inc -gen-bsc-vty-docbook: FORCE - $(call command,xsltproc -o generated/combined1.xml \ - --stringparam with $(PWD)/../common/vty_additions.xml \ - $(MERGE_DOC) vty/bsc_vty_reference.xml, \ - XSLTPROC,Merging Common VTY) - $(call command,xsltproc -o generated/combined2.xml \ - --stringparam with $(PWD)/../common/bsc_vty_additions.xml \ - $(MERGE_DOC) generated/combined1.xml, \ - XSLTPROC,Merging Common BSC VTY) - $(call command,xsltproc -o generated/combined3.xml \ - --stringparam with $(PWD)/vty/bsc_vty_additions.xml \ - $(MERGE_DOC) generated/combined2.xml, \ - XSLTPROC,Merging BSC VTY) - $(call command,xsltproc ../vty_reference.xsl generated/combined3.xml > generated/docbook_vty.xml, \ - XSLTPROC,Converting BSC VTY to DocBook) +include $(TOPDIR)/build/Makefile.common.inc diff --git a/doc/manuals/vty/libbsc_vty_additions.xml b/doc/manuals/vty/libbsc_vty_additions.xml new file mode 100644 index 000000000..868539850 --- /dev/null +++ b/doc/manuals/vty/libbsc_vty_additions.xml @@ -0,0 +1,244 @@ + + + + GSM Network Configuration + This is the base node for all configuration of + GSM network related configuration, it includes the LAC, CI + access criteria but also the configuration of each BTS in this + network. + + + + BTS Configuration + This is the configuration of a single BTS. + + + Set the IPA stream identifier for the OML link within the IPA + multiplex. Must be the same as on the BTS side. The default + value is 255. Only applies to BTSs connected via Abis/IP + interface. + + + + + Only applies to Ericsson OML2000 based BTSs. + + + + + Only applies to Ericsson OML2000 based BTSs. + + + + + Only applies to Ericsson OML2000 based BTSs. + + + + + Configure whether the IMSI ATTACH (and DETACH) procedures + shall be used by MS in this cell. The default should be enabled. + + + + + Configure the IP address of the BSC used for RSL. Abis/IP + BTSs, including OsmoBTS and the nanoBTS will be instructed to + connect their RSL links to that IP address. + + + + + Configure the BSIC of the cell. It is a 6-bit value + consisting of a 3-bit NCC (network color code) in the upper 3 + bits, and a 3-bit BCC (base station color code) in the lower 3 + bits. + + + + + Configure the default TSC for all timeslots on all TRX of the BTS. + The normal default is to use the BCC part of the BSIC as TSC. + Not all BTS models support a TSC != BCC. + + + + + Add or remove an ARFCN to/from the list of neighbor cells + advertised in dedicated mode via SACCH. This command is only + available in manual-si5 neighbor-list mode. + + + + + Add or remove an ARFCN to/from the list of neighbor cells. + This command is only available in manual neighbor-list mode. + + + + + + + + + If a cell advertises a cell reselection offset (CRO), it will + become more attractive during cell re-selection, despite not + being received at a higher level than other cells. The CRO + of each neighbor cell is added to the respective received + signal level before comparing their values for re-selection. + + + + + The Cell Re-Selection Hysteresis determines how many dB a + neighbor cell must be stronger than the current serving cell + before the MS considers that neighbor cell as a candidate for + re-selection. + + + + + The ip.access unit ID is a parameter of the IPA + Signalling-over-IP multiplex. It is administratively + configured on the BTS side, and used by the BTS to identify + itself to the BSC. The BSC then selects the BTS configuration + for this Unit ID. It consists of three parts, the Site ID, + the BTS ID and the TRX ID. The TRX ID automatically + corresponds to to the transceiver number and is thus not + configurable here. + + + + + Configures the maximum transmit power (in dBm) that any MS may + use within this cell. + + + + + The periodic location updating interval determines how often + the MS will periodically perform a LOCATION UPDATE procedure, + despite not having actuall changed location. The value is + specified in minutes. + + + + + Using this command, you can enable/disable barring of the cell. + Barred cells are not visible/accessible to regular phones. + Only some special operator testing phones can be configured in + a way to ignore cell barring. + + + + + Using this command, you can determine the minimum downlink + signal receive level (RxLev), at which the BTS must be + received by the MS in order to attempt establishing dedicated + channels via the RACH. + + + + + Using this command, you can configure which access control + classes are permitted to access this cell. The access control + class of a MS is determined by the contents of the EF.ACC file + on the SIM card. + + Access Control Class 10 corresponds to Emergency Calls, and is + thus not configurable this way. + + + + + Using this command, you can determine if this cell permits the + use of the 'EMERGENCY CALL' feature. + + Unless you operate a public network with connection to the + public emergency services in compliance with applicable regulatory + requirements, you should always have emergency calls disabled (allowed + 0) - which is also the default configuration. + + + + + Using this command, you can specify how many blocks of the + downlink CCCH should be reserved for exclusive usage as AGCH. + + Not all BTS models currently support non-default configuration + of this parameter. + + + + + Set the LAPD TEI used for the OML connection of this BTS. + Only applies to classic E1 based A-bis. + + + + + + TRX Configuration + This is the configuration of a TRX. + + + Inform the BSC about the nominal RF transmit power of the BTS in dBm. + This value must be entered depending on the BTS model and + external setup such as amplifiers. Changing this value will + not change the actually transmitted power, it will just affect + the reporting in the BSC VTY. + + + + + Request the actual RF transmit power of the BTS to be reduced + by the specified number of dB. + + + + + Set the LAPD TEI used for the RSL connection of this TRX. + Only applies to classic E1 based A-bis. + + + + + Enable (1) or disable (0) the RF locking for this TRX. RF + locking is a mechanism by which the transmitter can be shut + down by administrative means, e.g. via the control interface. + + + + + + TS Configuration + This is the configuration of a TS. + + + Configure the timeslot to run on a different TSC than the + default TSC of the BTS (which is derived from the BCC part of the BSIC). + Please note that not all BTS models support timeslot-specific TSC! + + + + + Enable or disable frequency hopping for this timeslot. Please + note that not all BTS models may support frequency hopping, + and that frequency hopping is only permitted for secondary + TRXs, so TRX 0 must always be non-hopping. + + + + + + OML Commands + This node allows to manipulate the OML state of + a connected BTS. It is meant for testing during development. + + + + OML2000 Commands + This node allows to issue OML2000 commands for + Ericsson BTS. It is meant for testing during development. + + -- cgit v1.2.3