Articles
LTE Base Station Control Service Documentation
This article describes the parameters that can be configured in the OMF AM service "LTErf", for controlling and managing the LTE Base Station parameters. The service is able to change LTE EPC parameters and the datapath for the traffic generated from the LTE network. This article focuses only on the base station parameters.
Base Station services
-
bs/config/list
Example:wget -qO- http://lterf:5054/lterf/bs/config/list
Usage: Lists available Base Station configurations.
In the case of a successful call, an appropriate XML response is returned listing all available Base Station configuration files, otherwise an error message is returned.
-
bs/config/load?node=...&&name=...
Example:wget -qO- http://lterf:5054/lterf/bs/config/load?node=1&&name=demo
Usage: Loads Base Station configuration from a file.
Arguments |
node, name |
|
|
node |
The AP number of the Base Station that the configuration is to be loaded on. The mapping of available Base Stations to AP numbers is defined in the Nitlab pages. |
name |
Name of the configuration file to be loaded. |
Depending on the success or failure of the configuration loading, an appropriate XML response is returned.
-
bs/config/save?node=...&&name=...
Example:wget -qO- http://lterf:5054/lterf/bs/config/save?node=1&&name=demo
Usage: Saves current Base Station configuration to a file.
Arguments |
node, name |
|
|
node |
The AP number of the Base Station whose configuration is to be saved. The mapping of available Base Stations to AP numbers is defined in the Nitlab pages. |
name |
Name of the configuration file that the current Base Station configuration is to be saved to. |
Depending on the success or failure of the configuration saving, an appropriate XML response is returned.
-
bs/config/delete?name=...
Example:wget -qO- http://lterf:5054/lterf/bs/config/delete?name=demo
Usage: Deletes the Base Station configuration file specified by the argument 'name'.
Arguments |
name |
|
|
name |
Name of the Base Station configuration file to be deleted. |
Depending on the success or failure of the configuration file deletion, an appropriate XML response is returned.
-
bs/get?param&&node=...
Example:wget -qO- http://lterf:5054/lterf/bs/get?freqBandIndicator&&node=1
Usage: Retrieves Base Station parameters. The parameter to be retrieved is specified by the argument 'param' and the Base Station from which the parameter value is retrieved is specified by the argument 'node'.
Arguments |
[param], node |
|
|
param |
This parameter may be one of the parameters (strings) listed on the following table. |
node |
The AP number of the Base Station, the configuration of which contains the parameter to be retrieved. The mapping of available Base Stations to AP numbers is defined in the Nitlab pages. |
Wireless Parameters |
|
|
|
Parameter |
Info |
freqBandIndicator |
Setup of the LTE band (Supported bands are 7 and 13) - You will have to set the DL and UL EARFCN values (Band 7 -> 3100/21100, band 13 -> 5230/23230) |
earFcnDl |
Setup the X_000295_EARFCNDL (Downlink) parameter (Initial config: band 7 -> 3100, band 13 -> 5230) |
earFcnUl |
Setup the X_000295_EARFCNUL (Uplink) parameter (Initial config: band 7 - 21100, band 13 - 23230) |
DlBandwidth |
Setup the downlink bandwidth, 2 for 5MHz - 3 for 10MHz. (Must be set the same and the uplink) |
UlBandwidth |
Setup the Uplink bandwidth, 2 for 5MHz - 3 for 10MHz. (Must be set the same and the downlink) |
PhyCellID |
Physicall Cell ID which determines the PSS and SSS of the cell (default is 270, ranges from 0 to 503) |
PBCHPowerOffset |
Setup the Power Offset of the Physical Broadcast Channel with respect to the Reference Signal Power in dB. Set the desired value multiplied by 10 (default is 0, ranges from -350 to 150) |
PSCHPowerOffset |
Setup the Power Offset of the Primary Synchronisation Channel with respect to the Reference Signal Power in dB. Set the desired value multiplied by 10 (default is 30, ranges from -350 to 150) |
SSCHPowerOffset |
Setup the Power Offset of the Secondary Synchronisation Channel with respect to the Reference Signal Power in dB. Set the desired value multiplied by 10 (default is 30, ranges from -350 to 150) |
RefSignalPower |
Setup the Downlink Reference Signal Transmit Power in dBm. (default is -15 -> 13dBm, ranges -15 - -26) |
NumOfRACHPreambles |
Set the number of preambles to be used for contention based RACH, rest are used for contention free RACH. (default is 64, ranges from 0 to 64) |
TxMode |
Set the number of enabled antenna ports for transmission. In all cases, both Rx paths will be enabled. (default is 1, both antennas -> 0, Tx1 only -> 1, Tx2 only -> 2) |
MCSDl |
Set the DL MCS profile to use (available profiles are 0-28). CQI reporting must be disabled |
MCSUl |
Set the UL MCS profile to use (available profiles are 0-26). CQI reporting must be disabled |
AdminState |
Set the cell state to LOCKED (0 - Not Transmitting) or UNLOCKED (1 - Transmitting) |
Reporting for CQI and UEs |
|
|
|
Parameter |
Info |
CQIReport |
Enable or Disable periodic CQI reporting. (Enable -> 1, Disable -> 0) |
UEReport |
Enable or Disable periodic UE measurement reporting. (Enable -> 1, Disable -> 0) |
|
|
Power Control Parameters |
|
|
|
Parameter |
Info |
PUSCHPowerControl |
Enable or Disable PUSCH power control. (default is 1, Enable -> 1, Disable -> 0) |
PDCCHPowerControl |
Enable or Disable PDCCH power control and aggregation. (default is 1, Enable -> 1, Disable -> 0) |
SINRPUCCHPowerControl |
Enable or Disable SINR based PUCCH power control. (default is 0, Enable -> 1, Disable -> 0) |
HARQPUCCHPowerControl |
Enable or Disable HARQs BLER based PUCCH power control. (default is 0, Enable -> 1, Disable -> 0) |
FreqPUSCHPowerControl |
Enable or Disable Frequency Selective PUSCH power control. (default is 0, Enable -> 1, Disable -> 0) |
PUCCHSINRTarget |
Set PUCCH SINR Target. (default is 154) |
pucchBLERTarget |
Set PUCCH BLER Target. (default is 1) |
|
|
EPC parameters (set to the LTE Base Station) |
|
|
|
Parameter |
Info |
epcIpAddress |
IP address pf the MME the AP should use to establish S1-MME signalling connection (default is 10.64.44.121 - LTEnet by SiRRAN) |
epcSctpPort |
Port to use for the S1-MME signalling connection (3GPP has assigned 36412 port but can be changed) |
pgwIpAddress |
IP address of the PDN-GW (default is 10.64.44.121 - LTEnet by SiRRAN) |
|
|
LTE AP parameters (set to the eNB) |
|
|
|
Parameter |
Info |
localSctpPort |
Local port to use for SCTP (default = 36412) |
trackingAreaCode |
Tracking Area Code to be used by the LTE AP |
plmnId |
Public Lan Mobile Netork identity to be used (NITOS uses the test PLMN id of 00101) |
eNBName |
Name used by the eNB |
eci |
The 28-bit E-UTRA Cell Id used to identify a cell within a PLMN |
eNBType |
Flag indicates whether it is a macro or home eNodeB (0 -> Macro, 1-> Home) |
maxERABperUE |
Value defines the maximum number of admitted ERABs per UE (multi-ERAB not tested by ip.access). Default value is 1. |
|
|
Air interface parameters (set to the LTE Base Station) |
|
|
|
Parameter |
Info |
ueInactivityTimer |
The time (in milliseconds) after which a UE will be released if inactive. The value zero disables the inactivity timer operation. (default is 60000) |
cipherAlgo |
The ciphering algorithm to be used by RRM for all bearers is configurable. A preference-ordered list of algorithms can be configured, with the algorithms being EEA0, 128-EEA1, and 128-EEA2. (Names are Case sensitive) |
Table 1
Depending on the success or failure of the call, an appropriate XML response is returned.
-
bs/set?param=...&&node=...
Example:wget -qO- http://lterf:5054/lterf/bs/set?freqBandIndicator=7&&node=1
Usage: Sets the parameter specified by the argument 'param' of the Base Station specified by the argument 'node' to a specific value. Table 1 lists all possible parameters and respective values.
Arguments |
Name |
|
|
param |
This parameter should be one of the parameters (strings) listed on Table 1. The possible values for each parameter are also given in Table 1. |
node |
The AP number of the Base Station whose parameter is to be retrieved. The mapping of available Base Stations to AP numbers is defined in the Nitlab pages. |
Depending on the success or failure of the call, an appropriate XML response is returned.
-
bs/status?node=...
Example:wget -qO- http://lterf:5054/lterf/bs/status?node=1
Usage: Retrieves status of the Base Station specified by the argument 'node'.
Arguments |
name |
|
|
node |
The AP number of the Base Station whose status is to be retrieved. The mapping of available Base Stations to AP numbers is defined in the Nitlab pages. |
Depending on the success or failure of the call, an appropriate XML response is returned.
-
bs/info?node=...
Example:wget -qO- http://lterf:5054/lterf/bs/info?node=1
Usage: Gets information about the Base Station specified by the argument 'node'.
Arguments |
name |
|
|
node |
The AP number of the Base Station about which information is to be retrieved. |
Depending on the success or failure of the call, an appropriate XML response is returned.
-
bs/restart?node=...
Example:wget -qO- http://lterf:5054/lterf/bs/info?node=1
Usage: Restarts the Base Station specified by the argument 'node'.
Arguments |
name |
|
|
node |
The AP number of the LTE Base Station to be restarted. |
Depending on the success or failure of the call, an appropriate XML response is returned.