Neels Hofmeyr | ea9a44d | 2017-10-19 05:11:57 +0200 | [diff] [blame] | 1 | <vtydoc xmlns='urn:osmocom:xml:libosmocore:vty:doc:1.0'> |
| 2 | <node id='14'> |
| 3 | <child_of nodeid='4' /> |
| 4 | <name>GSM Network Configuration</name> |
| 5 | <description>This is the base node for all configuration of |
| 6 | GSM network related configuration, it includes the LAC, CI |
| 7 | access criteria but also the configuration of each BTS in this |
| 8 | network.</description> |
| 9 | </node> |
| 10 | <node id='15'> |
| 11 | <child_of nodeid='14' /> |
| 12 | <name>BTS Configuration</name> |
| 13 | <description>This is the configuration of a single BTS.</description> |
Eric Wild | 10def2c | 2019-06-04 13:38:28 +0200 | [diff] [blame^] | 14 | <command id='oml ipa stream-id <0-255> line E1_LINE'> |
Neels Hofmeyr | ea9a44d | 2017-10-19 05:11:57 +0200 | [diff] [blame] | 15 | <description> |
| 16 | Set the IPA stream identifier for the OML link within the IPA |
| 17 | multiplex. Must be the same as on the BTS side. The default |
| 18 | value is 255. Only applies to BTSs connected via Abis/IP |
| 19 | interface. |
| 20 | </description> |
| 21 | </command> |
| 22 | <command id='is-connection-list (add|del) <0-2047> <0-2047> <0-255>'> |
| 23 | <description> |
| 24 | Only applies to Ericsson OML2000 based BTSs. |
| 25 | </description> |
| 26 | </command> |
| 27 | <command id='con-connection-list (add|del) <1-255> <0-1023> deconcentrated'> |
| 28 | <description> |
| 29 | Only applies to Ericsson OML2000 based BTSs. |
| 30 | </description> |
| 31 | </command> |
| 32 | <command id='con-connection-list (add|del) <1-255> <0-1023> tei <0-63>'> |
| 33 | <description> |
| 34 | Only applies to Ericsson OML2000 based BTSs. |
| 35 | </description> |
| 36 | </command> |
| 37 | <command id='channel-descrption attach (0|1)'> |
| 38 | <description> |
| 39 | Configure whether the IMSI ATTACH (and DETACH) procedures |
| 40 | shall be used by MS in this cell. The default should be enabled. |
| 41 | </description> |
| 42 | </command> |
Eric Wild | 10def2c | 2019-06-04 13:38:28 +0200 | [diff] [blame^] | 43 | <command id='ipa rsl-ip A.B.C.D'> |
Neels Hofmeyr | ea9a44d | 2017-10-19 05:11:57 +0200 | [diff] [blame] | 44 | <description> |
| 45 | Configure the IP address of the BSC used for RSL. Abis/IP |
| 46 | BTSs, including OsmoBTS and the nanoBTS will be instructed to |
| 47 | connect their RSL links to that IP address. |
| 48 | </description> |
| 49 | </command> |
| 50 | <command id='base_station_id_code <0-63>'> |
| 51 | <description> |
| 52 | Configure the BSIC of the cell. It is a 6-bit value |
| 53 | consisting of a 3-bit NCC (network color code) in the upper 3 |
| 54 | bits, and a 3-bit BCC (base station color code) in the lower 3 |
| 55 | bits. |
| 56 | </description> |
| 57 | </command> |
| 58 | <command id='training_sequence_code <0-7>'> |
| 59 | <description> |
| 60 | Configure the default TSC for all timeslots on all TRX of the BTS. |
| 61 | The normal default is to use the BCC part of the BSIC as TSC. |
| 62 | Not all BTS models support a TSC != BCC. |
| 63 | </description> |
| 64 | </command> |
| 65 | <command id='si5 neighbor-list (add|del) arfcn <0-1023>'> |
| 66 | <description> |
| 67 | Add or remove an ARFCN to/from the list of neighbor cells |
| 68 | advertised in dedicated mode via SACCH. This command is only |
| 69 | available in manual-si5 neighbor-list mode. |
| 70 | </description> |
| 71 | </command> |
| 72 | <command id='neighbor-list (add|del) arfcn <0-1023>'> |
| 73 | <description> |
| 74 | Add or remove an ARFCN to/from the list of neighbor cells. |
| 75 | This command is only available in manual neighbor-list mode. |
| 76 | </description> |
| 77 | </command> |
| 78 | <command id='gprs network-control-order (nc0|nc1|nc2)'> |
| 79 | <description> |
| 80 | </description> |
| 81 | </command> |
| 82 | <command id='cell reselection offset <0-126>'> |
| 83 | <description> |
| 84 | If a cell advertises a cell reselection offset (CRO), it will |
| 85 | become more attractive during cell re-selection, despite not |
| 86 | being received at a higher level than other cells. The CRO |
| 87 | of each neighbor cell is added to the respective received |
| 88 | signal level before comparing their values for re-selection. |
| 89 | </description> |
| 90 | </command> |
| 91 | <command id='cell reselection hysteresis <0-14>'> |
| 92 | <description> |
| 93 | The Cell Re-Selection Hysteresis determines how many dB a |
| 94 | neighbor cell must be stronger than the current serving cell |
| 95 | before the MS considers that neighbor cell as a candidate for |
| 96 | re-selection. |
| 97 | </description> |
| 98 | </command> |
Eric Wild | 10def2c | 2019-06-04 13:38:28 +0200 | [diff] [blame^] | 99 | <command id='ipa unit-id <0-65534> <0-255>'> |
Neels Hofmeyr | ea9a44d | 2017-10-19 05:11:57 +0200 | [diff] [blame] | 100 | <description> |
| 101 | The ip.access unit ID is a parameter of the IPA |
| 102 | Signalling-over-IP multiplex. It is administratively |
| 103 | configured on the BTS side, and used by the BTS to identify |
| 104 | itself to the BSC. The BSC then selects the BTS configuration |
| 105 | for this Unit ID. It consists of three parts, the Site ID, |
| 106 | the BTS ID and the TRX ID. The TRX ID automatically |
| 107 | corresponds to to the transceiver number and is thus not |
| 108 | configurable here. |
| 109 | </description> |
| 110 | </command> |
| 111 | <command id='ms max power <0-40>'> |
| 112 | <description> |
| 113 | Configures the maximum transmit power (in dBm) that any MS may |
| 114 | use within this cell. |
| 115 | </description> |
| 116 | </command> |
| 117 | <command id='periodic location update <6-1530>'> |
| 118 | <description> |
| 119 | The periodic location updating interval determines how often |
| 120 | the MS will periodically perform a LOCATION UPDATE procedure, |
| 121 | despite not having actuall changed location. The value is |
| 122 | specified in minutes. |
| 123 | </description> |
| 124 | </command> |
| 125 | <command id='cell barred (0|1)'> |
| 126 | <description> |
| 127 | Using this command, you can enable/disable barring of the cell. |
| 128 | Barred cells are not visible/accessible to regular phones. |
| 129 | Only some special operator testing phones can be configured in |
| 130 | a way to ignore cell barring. |
| 131 | </description> |
| 132 | </command> |
| 133 | <command id='rxlev access min <0-63>'> |
| 134 | <description> |
| 135 | Using this command, you can determine the minimum downlink |
| 136 | signal receive level (RxLev), at which the BTS must be |
| 137 | received by the MS in order to attempt establishing dedicated |
| 138 | channels via the RACH. |
| 139 | </description> |
| 140 | </command> |
| 141 | <command id='rach access-control-class (0|1|2|3|4|5|6|7|8|9|11|12|13|14|15) (barred|allowed)'> |
| 142 | <description> |
| 143 | Using this command, you can configure which access control |
| 144 | classes are permitted to access this cell. The access control |
| 145 | class of a MS is determined by the contents of the EF.ACC file |
| 146 | on the SIM card. |
| 147 | |
| 148 | Access Control Class 10 corresponds to Emergency Calls, and is |
| 149 | thus not configurable this way. |
| 150 | </description> |
| 151 | </command> |
| 152 | <command id='rach emergency call allowed (0|1)'> |
| 153 | <description> |
| 154 | Using this command, you can determine if this cell permits the |
| 155 | use of the 'EMERGENCY CALL' feature. |
| 156 | |
| 157 | <warning>Unless you operate a public network with connection to the |
| 158 | public emergency services in compliance with applicable regulatory |
| 159 | requirements, you should always have emergency calls disabled (allowed |
| 160 | 0) - which is also the default configuration.</warning> |
| 161 | </description> |
| 162 | </command> |
| 163 | <command id='channel-descrption bs-ag-blks-res <0-7>'> |
| 164 | <description> |
| 165 | Using this command, you can specify how many blocks of the |
| 166 | downlink CCCH should be reserved for exclusive usage as AGCH. |
| 167 | |
| 168 | <warning>Not all BTS models currently support non-default configuration |
| 169 | of this parameter.</warning> |
| 170 | </description> |
| 171 | </command> |
| 172 | <command id='oml e1 tei <0-63>'> |
| 173 | <description> |
| 174 | Set the LAPD TEI used for the OML connection of this BTS. |
| 175 | Only applies to classic E1 based A-bis. |
| 176 | </description> |
| 177 | </command> |
| 178 | </node> |
| 179 | <node id='16'> |
| 180 | <child_of nodeid='15' /> |
| 181 | <name>TRX Configuration</name> |
| 182 | <description>This is the configuration of a TRX.</description> |
| 183 | <command id='nominal power <0-100>'> |
| 184 | <description> |
| 185 | Inform the BSC about the nominal RF transmit power of the BTS in dBm. |
| 186 | This value must be entered depending on the BTS model and |
| 187 | external setup such as amplifiers. Changing this value will |
| 188 | not change the actually transmitted power, it will just affect |
| 189 | the reporting in the BSC VTY. |
| 190 | </description> |
| 191 | </command> |
| 192 | <command id='max_power_red <0-100>'> |
| 193 | <description> |
| 194 | Request the actual RF transmit power of the BTS to be reduced |
| 195 | by the specified number of dB. |
| 196 | </description> |
| 197 | </command> |
| 198 | <command id='rsl e1 tei <0-63>'> |
| 199 | <description> |
| 200 | Set the LAPD TEI used for the RSL connection of this TRX. |
| 201 | Only applies to classic E1 based A-bis. |
| 202 | </description> |
| 203 | </command> |
| 204 | <command id='rf_locked (0|1)'> |
| 205 | <description> |
| 206 | Enable (1) or disable (0) the RF locking for this TRX. RF |
| 207 | locking is a mechanism by which the transmitter can be shut |
| 208 | down by administrative means, e.g. via the control interface. |
| 209 | </description> |
| 210 | </command> |
| 211 | </node> |
| 212 | <node id='17'> |
| 213 | <child_of nodeid='16' /> |
| 214 | <name>TS Configuration</name> |
| 215 | <description>This is the configuration of a TS.</description> |
| 216 | <command id='training_sequence_code <0-7>'> |
| 217 | <description> |
| 218 | Configure the timeslot to run on a different TSC than the |
| 219 | default TSC of the BTS (which is derived from the BCC part of the BSIC). |
| 220 | Please note that not all BTS models support timeslot-specific TSC! |
| 221 | </description> |
| 222 | </command> |
| 223 | <command id='hopping enabled (0|1)'> |
| 224 | <description> |
| 225 | Enable or disable frequency hopping for this timeslot. Please |
| 226 | note that not all BTS models may support frequency hopping, |
| 227 | and that frequency hopping is only permitted for secondary |
| 228 | TRXs, so TRX 0 must always be non-hopping. |
| 229 | </description> |
| 230 | </command> |
| 231 | </node> |
| 232 | <node id='22'> |
| 233 | <child_of nodeid='3' /> |
| 234 | <name>OML Commands</name> |
| 235 | <description>This node allows to manipulate the OML state of |
| 236 | a connected BTS. It is meant for testing during development.</description> |
| 237 | </node> |
| 238 | <node id='26'> |
| 239 | <child_of nodeid='3' /> |
| 240 | <name>OML2000 Commands</name> |
| 241 | <description>This node allows to issue OML2000 commands for |
| 242 | Ericsson BTS. It is meant for testing during development.</description> |
| 243 | </node> |
| 244 | </vtydoc> |