PageOutline

This page is a reference fo all VTY commands that you can use interactively on the OpenBSC VTY telnet interface.

In addition, the same commands are used for the configuration file.

configuration reference

=== network level ===

At the network level, we specify parameters that are global for an entire GSM network.

==== network country code ====

The network country code (NCC) to be used for this network. Default is 1.

==== mobile network code ====

The mobile network code (MNC) to be used for this network. Default is 1.

==== short name ====

This is the short network name to be used in the GSM 04.08 MM INFO message.

==== long name ====

This is the long network name to be used in the GSM 04.08 MM INFO message.

==== auth policy ====

This defines the authentication policy of the network. Possible values are:

• ''closed'': Don't allow anyone who is not marked as authorized=1 in the hlr database
• ''accept-all': Accept everyone into the network
• ''token'': Use a special [wiki:TokenAuthPolicy]

==== encryption a5 (0|1|2) ====

• Enable/Disable A5/X encryption on the network.

==== neci (0|1) ====

Changes the Cell Selection Parameter called NECI Half Rate Support.

• "0": New establishment causes are not supported.
• "1": New establishment causes are supported.

==== timer t3101 <0-65535> ==== * Started after IMMEDIATE ASSIGMENT, should be higher than the time for a L2 establishment attempt

==== timer t3103 <0-65535> ==== * Started by sending a HANDOVER message. This timer is currently not in use.

==== timer t3105 <0-65535> ==== * Used for the repetition of the PHYSICAL INFORMATION message during handover. This timer is currently not in use.

==== timer t3107 <0-65535> ==== * Started after ASSIGMENT COMMAND to keep the old channel long enough alive. This timer is currently not in use due the usage of very early assignment in Call Control

==== timer t3109 <0-65535> ==== * The purpose of this timer is to release channels in case of loss of communucation.

==== timer t3111 <0-65535> ==== * This timer value is equal to T3110 and is used to delay the channel deactivation after disconnecting the manin signalling link.

==== timer t3113 <0-65535> ==== * This timer is used for the PAGING REQUEST

==== timer t3115 <0-65535> ====

• This timer is used for the repetition of the VGCS UPLINK GRANT message, it is currently not in use.

==== timer t3117 <0-65535> ==== ==== timer t3119 <0-65535> ====

• This is started after sending the RR-CELL CHANGE ORDER message.

==== timer t3141 <0-65535> ====

==== [bsc_msc_ip] ipacc rtp_payload <0-256> ==== * This option is currently only available in the on-waves/bsc-master branch (but it will be merged in one way or another). * This configuration will override the RTP Payload in the MDCX message to not use the returned value by the nanoBTS but use this network setting.

==== [bsc_msc_ip] "rtp base <0-65534> ==== * This option is currently only available in the on-waves/bsc-master branch (but it will be merged in one way or another). * In the bsc_msc_ip sceneriao the BSC and the MGCP do not communicate with each other. To make it work they will need to share the secret of the base port.

=== bts level ===

At the BTS level, we define parameters that are global for this particular BTS.

==== type ====

The type of the BTS. Currently supported;

• ''bs-11''
• ''nanobts''

==== band ====

The GSM band of the BTS. Currently supported:

• GSM400
• GSM850
• GSM900
• DCS1800
• PCS1900

==== cell_identity <0-65535> ====

The Cell Identity of this BTS

==== location area code ====

The LAC of the location area to which this BTS belongs.

==== training_sequence_code <0-255> ====

Set the Training Sequence Code (TSC) of this BTS

==== base station id code ====

The BSIC of this BTS within the location area.

==== ms max power ====

maximum transmit power (in dBm) to be used by MS in this BTS. This is used in the System Information on the BCCH as
well as for the MS power level at the time a dedicated channel is activated.

==== periodic location update ====

Specify the number of seconds at which periodic location updating shall be performed by MS in this BTS (T3212)

==== channel allocator ====

Whether the channels should be allocated in ascending or descending order.

If the channel allocator is in ascending mode, it will first allocate timeslot 0, then timeslot 1, ... of TRX0. If TRX0 is full, it will switch to TRX1. In descending order, it is the other way around.

==== cell barred ====

Whether this BTS is barred from access or not.

==== ip.access unit_id ====

The ip.access Unit ID. Unit ID is used to identify the BTS to the BSC. You set the Unit ID of the BTS by using the [wiki:ipaccess-config] program. Make sure you use the same Unit ID in the nanoBTS as well as in OpenBSC.

==== oml e1 tei ====

The Q.921 TEI to be used for the A-bis OML link of this BTS.

Make sure you use the same value than you have set in the BTS (by bs11-config or LMT).

==== oml e1 line E1_LINE timeslot <1-31> sub-slot (0|1|2|3|full) ====

Set the E1 line, E1 timeslot and E1 sub-slot for the OML link to this BTS.

Make sure you use the same value than you have set in the BTS (by bs11-config or LMT).

==== periodic location update <0-1530> ====

Periodic Location Updating interval in minutes.

If you set this to a non-zero value, every MS will perform a periodic location updating procedure at the given interval.

A value of 0 will deactivate periodic location updating.

=== trx level ===

At the trx level, we specify parameters for one particular TRX (transceiver).

==== arfcn ====

The ARFCN of a non-hopping TRX.

==== max_power_red ====

How many dB the nominal transmit power of the TRX should be reduced from its maximum.

If your transmitter is set to e.g. 24 dBm and you set this to 10, your actual output power will be 14 dBm.

==== rf_locked (0|1) ====

This option can be used at start and at runtime to enable/disable RF of the transceiver.

• "0": RF is not locked (enabled)
• "1": RF is locked (disabled)

==== rsl e1 tei ====

The Q.921 TEI to be used for the A-bis RSL link between BTS and BSC.

Make sure you don't use the same TEI twice in one E1 Link!

==== rsl e1 line E1_LINE timeslot <1-31> sub-slot (0|1|2|3|full) ====

Set the E1 Line, E1 timeslot and E1 sub-slot for the RSL link to this BTS.

=== timeslot level ===

The timeslot level lists parameters for one specific on-air timeslot.

==== phys_chan_config ====

Set the physical channel configuration of this GSM on-air timeslot:

• ''NONE'': do not use this timeslot
• ''CCCH'': regular CCCH configuration (BCCH+RACH+PCH+AGCH)
• ''CCCH+SDCCH4'': CCCH plus SDCCH/4 combination
• ''TCH/F'': Full TCH
• ''TCH/H'': Half TCH
• ''SDCCH8'': SDCCH/8 combination

===== e1 line e1 line E1_LINE timeslot <1-31> sub-slot (0|1|2|3) =====

Set the E1 line, E1 timeslot and E1 sub-slot to be used for this on-air timeslot if it is used as a TCH.

The TRAU frames for this on-air timeslot will be sent to the sub-slot you have specified here.