7100 Command Reference Manual
7100 Command Reference Manual
ii
Contents
iii
Contents
iv
Contents
v
1 Introduction
1.1 Purpose
The purpose of this document is to describe in detail the command interfaces and commands of
the 7100 Long Term Evolution (LTE) Digital Radio Test Set (DRTS).
1.2 Scope
This document describes various commands that can be passed onto the 7100 DRTS. The 7100
accepts these text-based commands and passes them to the Test Entity (TE) for parsing. The
parsed commands are then mapped to different layer APIs.
6
Introduction
Abbreviation/acronym Description
rd
3GPP 3 Generation Partnership
ACK Acknowledgement
API Application Program Interface
BCH Broadcast Channel
BER Bit Error Rate
BLER Block Error Rate
BSE Base Station Emulator
TE Test Entity
CAZAC Constant Amplitude Zero Auto-Correlation
CFI Control Format Indicator
CQI Channel Quality Indicator
DCI Downlink Control information
DL Downlink
DL-SCH Downlink Shared Channel
DMRS Demodulator Reference Signal
DSP Digital Signal Processor
DTX Discontinuous Transmission
EPRE Energy Per Resource Element
FDD Frequency Division Duplex
HARQ Hybrid Automatic Repeat-reQuest
L0 Layer 0
L1 Layer 1
LTE Long Term Evolution
MAC Medium Access Control
MBMS Multimedia Broadcast Multicast Service
MCS Modulation and Coding Scheme
MIMO Multiple Input and Multiple Output
NACK Non-Acknowledgement
NAS Non-Access Stratum
NDI New Data Indicator
P-BCH Physical Broadcast Channel
PDCCH Physical Downlink Control Channel
PDCP Packet Data Convergence Protocol
PDSCH Physical Downlink Shared Channel
7
Introduction
Abbreviation/acronym Description
PHY Physical Layer
PMI Pre-coding Matrix (Vector) Indicator
PPC Power PC Card
PUCCH Physical Uplink Control Channel
PUSCH Physical Uplink Shared Channel
QdB Quarter decibel = 0.25 dB
RACH Random Access Channel
RB Resource Block
RLC Radio Link Control
RRC Radio Resource Control
SFN System Frame Number
SISO Single Input and Single Output
SLCA Sub-Layer Configuration Agent
SRS Sounding Reference Signal
TB Transport Block
TDD Time Division Duplex
TE Test Entity
TFRI Transport Format Resource Indicator
TMA Test Mobile Application
TPC Transmit Power Control
TTI Transmission Time Interval
UCI Uplink Control Information
UE User Equipment
UL Uplink
UL-SCH Uplink Shared Channel
8
2 Introduction to the 7100 Command Interface
This chapter describes the 7100 Command Interface.
Term Meaning
Description
Gives detailed information on the corresponding command, including its purpose, usage scenarios
and any special considerations.
Syntax
FORW TE CommandPrototype <PARAMETERS>
9
Introduction to the 7100 Command Interface
Parameters
Description of Parameter 1
Parameter 2 Enum 0 5
Description of Parameter 2
Parameter 3 Enum 0, 2, 4, 6
Description of Parameter 3
Here, the difference between the two enum value specifications is that parameter 2 can take any
value between 0 and 5, while parameter 3 can take only one of the following values: 0, 2, 4, and 6.
Delimiter notations used in this manual are given below.
>>>
Example command
FORW TE SCHEDULERADDULSCHCTRLTABLEENTRY 0 2 {0 0 1 (1 0 1 1 0 1 0 1) }
For parameter details, see the command definition of
SCHEDULERADDULSCHCTRLTABLEENTRY in Section 11.5 of this document.
Here, the second parameter corresponding to the ‘Number of Entries’ is 2, which indicates two
sequences of items enclosed within braces ({}), and each separated by a comma delimiter {0 0 1 (1
0 1 1 0 1 0 1) }.
As mentioned in the above table for delimiter notations, conditional parameters may or may not be
present subject to the value of some other preceding parameter. In the example given above, the
fifth parameter (that is, the parameter corresponding to ‘Grant operation’) is the one based on
which subsequent conditional parameters may or may not be present. In the first sequence of items
‘0 0 1 (1 0 1 1 0 1 0 1)’, since the value of ‘Grant operation’ is 1, conditional parameters (6th – 13th
parameters) are present and are enclosed within parentheses (()). Note that if a conditional
parameter is not present, empty parentheses are not required.
Note that even if an optional parameter is not present, empty square brackets ([]) are required.
10
Introduction to the 7100 Command Interface
Example
A successful confirmation to the command FORW TE
SCHEDULERADDULSCHCTRLTABLEENTRY 0 2 {0 0 1 (1 0 1 1 0 1 0 1)} is:
C: FORW 0x00 Ok TE SCHEDULERADDULSCHCTRLTABLEENTRY: Return Code: 0
SUCCEEDED
11
3 Administrative commands
This chapter describes the System Control Interface commands that are used to configure and
manage the 7100.
3.1 CESC
NOTE: This command is not currently supported.
Clear error status condition
Description
This command clears an Error Status Condition (ERSC) in the 7100. When several consecutive ERSCs
occur with the same error status condition ID, the 7100 sends only one ERSC message and ignores the
subsequent ERSCs until the first one is cleared (using CESC).
Syntax
CESC <PARAMETER>
Request parameters
ERROR_STATUS_CONDITION_ID Int - - -
Confirm parameters
3.2 CHOW
NOTE: This command is not currently supported.
Link verification
Description
This command checks whether the User Interface can communicate with the 7100. It tests the
Ethernet connection between the PC on which the user interface is running and the 7100.
Syntax
CHOW
Request parameters
None
12
Administrative commands
Confirm parameters
3.3 DERR
NOTE: This command is not currently supported.
Display errors
Description
This command displays a list of errors detected since start-up or RSET.
Syntax
DERR
Request parameters
None
Confirm parameters
Example
DERR Output: No Errors
>DERR
C: DERR 0x00 Ok
No PPC error reports
No PQ error reports
No DSP error reports
PPC/PQ Errors
>DERR
C: DERR 0x00 Ok
PPC ASSERT: C:/Tornado_II/target/proj/assert/assert.c: 24: : ASSERT failed (BLACK == WHITE)
PQ-1 ASSERT: C:/Tornado_II/target/proj/assert/assert.c: 24: : ASSERT failed (BLACK == WHITE)
No DSP error reports
DSP Errors
>DERR
13
Administrative commands
C: DERR 0x00 Ok
No PPC error reports
No PQ error reports
PQ-0: DSP-1
Assert string: EOP read timeout
PQ-0: DSP-0
Assert string:../../../../dspkernel/code/kernel.c, 721: 'Process not registered'
PQ-0: DSP-2
Assert string:EOP read timeout
3.4 FORW
Forward Command
Description
Although this is not a utility command in the way that STRT is, for example, this command is
described here in general terms because it is a class of the System Control Interface administration
command. The FORW command routes a text command to a specific component within the 7100
either to configure the component or to cause tests to be executed.
Syntax
FORW <COMPONENT_ALIAS> <COMMAND_STRING>
Request parameters
Confirm parameters
14
Administrative commands
3.5 GCFG
Get configuration
Description
This command gets information about the configuration mode.
Syntax
GCFG
Request parameters
None
Confirm parameters
MODE_ALIAS Text that indicates the mode in which the 7100 has been
configured.
3.6 GSTS
Get status
Description
This command gets information about the current status of the 7100.
Syntax
GSTS
Request parameters
None
Confirm parameters
3.7 GVER
Get version
Description
This command gets version information. It lists the versions of all loaded software components.
Note: Version compatibility between the various software components is checked when the mode
is configured.
15
Administrative commands
Syntax
GVER
Request parameters
None
Confirm parameters
3.8 HELP
NOTE: This command is not currently supported.
System control interface command help
Description
This command invokes the System Control Interface command help.
Syntax
HELP
Request parameters
None
Confirm parameters
3.9 RBOT
NOTE: This command is not currently supported.
Reboot
Description
This command forces a software reload by the 7100 software (that is, a reboot). This request is
equivalent to powering OFF and then powering ON again, and causes all cards within the 7100 to
be reset and execute their normal boot routine.
16
Administrative commands
Note: This command causes loss of the System Control Interface socket connection a few seconds
after the Command confirmation is issued. The application using the System Control Interface
closes its socket immediately on receipt of the confirmation and does not reconnect until the 7100
has booted up again.
Syntax
RBOT
Request parameters
None
Confirm parameters
3.10 RSET
Reset
Description
This command resets the 7100 mode, enabling a new mode to be subsequently set. Each
component within the 7100 responds to the RSET request, but only one overall confirmation
message is sent to the user. The 7100 derives the overall RETURN_CODE and RETURN_TEXT
fields in the confirmation message from the return code response of all components in the system.
If all components return 0, the overall return code is 0. If one or more components respond with a
non-zero return code, the return code for each failed component is returned to indicate the failure
condition.
Syntax
RSET <PARAMETER>
Request parameters
None
Confirm parameters
3.11 SCFG
Note: This command is listed for information only. It is not normally issued explicitly. Instead, configure
the mode of the 7100 directly or remotely.
Description
This command sets the 7100 mode. One or more MODE_ALIAS values can be used in various
combinations according to the required mode. For example: SCFG MAC_MODE.
17
Administrative commands
This command requires up to 60 seconds before a confirmation is returned. If this command fails,
the 7100 may be in an indeterminate state. Power off and then power on again before attempting
another SCFG command.
Mode extensions govern the additional functionality that can be configured in the 7100.
Syntax
SCFG <PARAMETERS>
Request parameters
7100 mode
SWL = Software Licence Component
MAC_MODE = LTE Stack terminates at the
MAC
RLC_MODE = LTE Stack terminates at the
RLC
PDCP_MODE = LTE Stack terminates at the
PDCP
FULL_PROTOCOL_MODE = LTE Stack
terminates at the NAS
LTE_HRPD_MODE = LTE stack terminates
at NAS on the first cell; the second cell runs
the HRPD stack.
HRPD_MODE_ONLY = Two cells run their
instances of the HRPD stack.
Confirm parameters
3.12 SetActiveCell
Activate a cell
Scope
The cell number passed in the command should have been created before using in the command. This
command can be used in all the modes except FULL_PROTOCOL_MODE.
Description
This command is used to activate a cell that already exists.
18
Administrative commands
Syntax
FORW L1 SETACTIVECELL <PARAMETERS>
Request parameters
Confirm parameters
3.13 SPCM
Note: This command is listed for information only. It is not normally issued explicitly. Instead,
configure the mode of the 7100 directly or remotely. It is only used for multi-box scenarios.
Description
This command sets the 7100 operating mode.
Syntax
SPCM <PARAMETERS>
Request parameters
Mode Int 0 1 -
Confirm parameters
19
Administrative commands
3.14 STIP
Note: This command is listed for information only. It is not normally issued explicitly. Instead,
configure the mode of the 7100 directly or remotely. It is only used for multi-box scenarios in
conjunction with the SPCM command.
Description
This command binds the socket of the master box to the slave box or vice versa.
Syntax
STIP <PARAMETERS>
Request parameters
IPversion Int 4 6 -
4- IP version 4
6- IP version 6
Note: Value 6 is not currently supported
Confirm parameters
20
Administrative commands
3.15 STRT
Description
This command starts up the 7100 operation. It is used to indicate the start of normal operation after
a 7100 mode has been configured and default parameter values have been amended.
Each component within the 7100 responds to the STRT request, but only one overall confirmation
message is sent to the user. The 7100 derives the overall RETURN_CODE and RETURN_TEXT
field in the confirmation message from the return code response of all components in the system. If
all components return 0, the overall return code is 0. If one or more components respond with a
non-zero return code, then the return code for each failed component is returned to indicate the
failure condition.
Syntax
STRT
Request parameters
None
Confirm parameters
21
4 General commands
This chapter describes the Test Entity (TE) commands that are used to configure and manage the
7100. These commands can be used in MAC_MODE, RLC_MODE, PDCP_MODE and
FULL_PROTOCOL _MODE. Unless stated otherwise in the command description, these must be
used after the STRT has been issued.
4.1 Activate
Activate the pending configuration
Scope
This command can only be used as part of a sequence of commands that need activation.
Description
This command is used to finalize and activate the currently pending configuration set by one or
several Activate-dependent commands at a particular time. This manual indicates when commands
are Activate-dependent in Scope sections.
The test modes, MAC_MODE, RLC_MODE, PDCP_MODE and other modes, are set using the
command SCFG, and each layer associated with that mode must be configured as part of an
Activate-dependent sequence.
Note: On issuing the Activate command following a set of commands, if the return code is ‘Failure’,
the user must re-issue the complete set of commands followed by the Activate command.
For example:
This script transcript (where x denotes parameters) configures the BCCH in MAC_MODE
immediately:
PHYCONFIGPBCH x
PHYCONFIGBCH x
MACCONFIGDLBCCH x
ACTIVATE -1
Syntax
FORW TE ACTIVATE <PARAMETERS>
Request parameters
0…1023 = SFN
Omit if ‘Timing type’ is -1
22
General commands
Confirm parameters
Indication parameters
4.2 ReInit
NOTE: This command is not currently supported.
Re-initialize the 7100 configuration
Scope
No prerequisites. The effects of this command are immediate.
Description
This command is used to reinitialize the 7100’s configuration without changing the mode. Apart
from the test mode, any configurations that have been set are reset.
Syntax
FORW TE REINIT
Request parameters
None
Confirm parameters
23
5 Measurement commands
This chapter describes the TE commands that are used to request measurements from the 7100
on the System Control Interface. These commands can be used in MAC_MODE, RLC_MODE,
PDCP_MODE and FULL_PROTOCOL_MODE. Unless stated otherwise in the command
description, these commands must be used after the STRT has been issued.
5.1 ClearStats
NOTE: This command is not currently supported.
Initialize 7100 statistical information
Scope
No prerequisites. The effects of this command are immediate.
Description
This command is used to initialize statistical information for all configured 3GPP layers.
Syntax
FORW TE CLEARSTATS <PARAMETERS>
Request parameters
[ UE context Id ] Int -1 0 -1
-1 = ALL
Confirm parameters
5.2 GetStats
Get 7100 statistical information
Scope
No prerequisites.
Description
This command is used to retrieve statistical information from a requested 3GPP layer or all layers.
Syntax
FORW TE GETSTATS <PARAMETERS>
24
Measurement commands
Request parameters
NONE
Confirm parameters
25
6 Physical layer commands
These commands can be used in the following modes MAC_MODE, RLC_MODE, PDCP_MODE
and FULL_PROTOCOL_MODE where explicitly stated. Unless stated otherwise in the command
description, these can only be used after STRT has been issued.
6.2 PhyConfigOCNG
Configures the OFDMA Channel Noise Generator
Scope
This command can be issued before/after any physical layer physical channel commands are
issued. The effects of this command are immediate.
Description
This command is used to configure OCN in unused RBs.
Syntax
FORW TE PHYCONFIGOCNG <PARAMETERS>
Request parameters
1 – OCNG ON
0 – OCNG OFF
( Int -52 16
26
Physical layer commands
In Q dB.
If unspecified, equal to PDSCH_Rb of the UE under test.
6.3 PhyConfigRefSignal
NOTE: This command is not currently supported.
Configures the Reference signal
Scope
This command should be called before configuring any other channels. The effects of this
command are immediate.
Description
This command is used to configure the reference signal corresponding to the N Cell ID.
Syntax
FORW TE PHYCONFIGREFSIGNAL <PARAMETERS>
Request parameters
0 = Cell Specific
1 = MBSFN Specific
2 = UE-Specific
27
Physical layer commands
6.4 PhyConfigSyncSignals
Configures the synchronization signals.
Scope
This command should be called before configuring any other channels. The effects of this
command are immediate.
Description
This command is used to configure the primary and secondary synchronization signals
corresponding to the N Cell ID.
Syntax
FORW TE PHYCONFIGSYNCSIGNALS <PARAMETERS>
Request parameters
6.5 PhyConfigUESysCap
Configure UE physical layer capabilities
Scope
This command can only be run before any physical layer physical channel commands are issued.
The effects of this command are immediate.
Description
This command is used to configure or modify the capabilities of the physical layer.
Syntax
FORW TE PHYCONFIGUESYSCAP <PARAMETERS>
Request parameters
UE Category Int 1 5 1
28
Physical layer commands
enable64QAM Int 0 1 0
6.6 PhyDeleteCell
Deletes the physical channels configured in a cell.
Scope
This command can only be used if a cell is already created. This is a self-activated command and
the effects of this command are immediate.
Description
This command is used to delete the configuration done in the physical layer of a cell (using the
commands described in Chapter 6) as well as the physical channels configured in the cell.
Syntax
FORW TE PHYDELETECELL <PARAMETERS>
Request parameters
6.7 PhySetRFParams
NOTE: This command is not currently supported.
Set the system RF parameters
Scope
This command must be used prior to configuring any channel.
Description
This command is used to set the system RF parameters.
Syntax
FORW TE PHYSETRFPARAMS <PARAMETERS>
Request parameters
29
Physical layer commands
6.8 PhySetSystemParams
Set the system level parameters
Scope
This is a mandatory command and must be configured before configuring any other
commands/channels, and can be used in all the modes of operation. This command sets the 7100
to transmit synchronization and reference signals. The effects of this command are immediate.
Description
This command enables the 7100 to get configured with the system level parameters listed in the
Requested parameters below. Once a cell is configured using the command, these parameters can
be modified only after deleting the cell using the PhyDeleteCell command.
Syntax
FORW TE PHYSETSYSTEMPARAMS <PARAMETERS>
Request parameters
30
Physical layer commands
Defines the 8 most significant bits of the SFN. The 2 least significant
bits of the SFN are acquired implicitly in the P-BCH decoding, that is,
timing of 40ms P-BCH TTI indicates 2 least significant bits (within
40ms P-BCH TTI, the first radio frame: 00, the second radio frame: 01,
the third radio frame: 10, the last radio frame: 11).
Used to set the offset between two cells. The values are interpreted as
the number of time domain symbols.
The offset between the two cells can vary from No Offset (0) to 1
Radio Frame (307199)
31
7 Physical layer physical channels
These commands can be used in the following modes MAC_MODE, RLC_MODE, PDCP_MODE
and FULL_PROTOCOL_MODE where explicitly stated. Unless stated otherwise in the command
description, these can only be used after STRT has been issued.
7.1 PhyAddUlPowerCtrlTableEntry
NOTE: This command is not currently supported.
Add an entry to the UL power control override table
Scope
This command must be used with the PhyConfigUlPowerCtrlTable command as part of a sequence
of Activate-dependent commands.
Description
This command is used to add an entry to the UL power control table. The maximum number of
entries available is 6000. This command can be used more than once to add more than 255 entries
to the profile.
Syntax
FORW TE PHYADDULPOWERCTRLTABLEENTRY <PARAMETERS>
Request parameters
{ Enum -2 3
> UL grant TPC command
TPC command index: 0, 1, 2, 3 mapping onto the power control delta
values in dB.
-1 = DTX
-2 = Signalled value
This is the TPC command received in DCI Format 0.
32
Physical layer physical channels
Confirm parameters
7.2 PhyConfigDlPrs
Configure Positional Reference Signal parameters
Scope
This command can be used only after the PhyConfigPbch command is successfully executed. This
is a self-activated command and the effects of this command are immediate. This command is
supported only in FDD MAC Mode.
Description
This command is used to configure the parameters required for OTDOA Measurement.
Syntax
Request parameters
0-Disabled
1-Enabled
( Int 6,15,25,50,75,100 50
PRS Bandwidth
This field specifies the bandwidth that is used to configure the
positioning reference signals on. These values are specified in number
of resource blocks and define 1.4, 3, 5, 10, 15 and 20 MHz bandwidth.
Note: This field is currently not supported. Bandwidth is taken from
PHYSETSYSTEMPARAMS
33
Physical layer physical channels
[ Int 2,4,8,6 2
PRS Muting Periodicity
Section 6.5.1.2 36.355 v9.6.0
Note: This field is currently not supported
PRS Muting Pattern Bit field Int 0 65535 0
]
Section 6.5.1.2 36.355 v9.6.0
Note :This field is currently not supported
CPLength bool 0 1 0
0 -Normal
1-Extended
)
Note: This field is not currently supported
Confirm parameters
7.3 PhyConfigPbch
Configure the P-BCH physical channel parameters
Scope
This command can be used only after the cell is configured using PhySetSystemParams
command. This is a self-activated command and the effects of this command are immediate.
Description
This command is used to configure an existing P-BCH physical channel at the physical layer. This
command sets the 7100 to transmit the broadcast information pertaining to the cell number given in
the command.
Syntax
FORW TE PHYCONFIGPBCH <PARAMETERS>
34
Physical layer physical channels
Request parameters
Confirm parameters
7.4 PhyConfigPdcch
Configures or modifies a PDCCH physical channel parameters
Scope
This command can only be used with a dependent transport channel command as part of a
sequence of Activate-dependent commands.
Activation time is controlled by the Activate command.
Description
This command is used to configure or modify an existing PDCCH physical channel at the physical
layer, also known as the downlink L1 L2 control channel. This command also implicitly configures
the PCFICH and the PHICH.
Syntax
FORW TE PHYCONFIGPDCCH <PARAMETERS>
Request parameters
[ Int 0 65535
UE-RNTI
Used for normal DL-SCH reception.
35
Physical layer physical channels
Specified in QdB.
Specified in QdB.
Confirm parameters
7.5 PhyConfigPdsch
Configures or modifies PDSCH physical channel parameters
Scope
This command can only be used with a dependent transport channel command as part of a
sequence of Activate-dependent commands. Activation time is controlled by the Activate
command.
Description
This command is used to configure or modify an existing PDSCH physical channel at the physical
layer.
Syntax
FORW TE PHYCONFIGPDSCH <PARAMETERS>
36
Physical layer physical channels
Request parameters
0 = Disabled
1 = Enabled
( Int -52 16 0
> EPRE Ra
In QdB
Single antenna case: Ra = Pax4;
Two antennas case: Ra = (p+3) x4;
Confirm parameters
7.6 PhyConfigPrach
Configures the PRACH physical channel
Scope
The BCH must have been configured, using PhyConfigPbch, prior to using this command. This
command must be used with the PhyConfigPdcch, PhyConfigPdsch, and PhyConfigDlSch
commands as part of a sequence of Activate-dependent commands. Activation time is controlled
by the Activate command.
Description
This command configures the PRACH physical channel parameters
Syntax
FORW TE PHYCONFIGPRACH <PARAMETERS>
Request parameters
37
Physical layer physical channels
Currently unused.
Indicates the format of the preamble and hence defines the preamble
length.
Confirm parameters
38
Physical layer physical channels
7.7 PhyConfigPucch
Configures or modifies PUCCH parameters
Scope
This command can only be used with a dependent transport channel command (PhyConfigUlSch)
as part of a sequence of Activate-dependent commands. Activation time is controlled by the
Activate command.
Description
This command is used to configure or modify the existing PUCCH physical channel parameters at
the physical layer. These parameters are needed when an UL-SCH or a DL-SCH transport channel
is configured.
Syntax
FORW TE PHYCONFIGPUCCH <PARAMETERS>
Request parameters
ΔShiftPUCCH Int 1 3
δOffsetPUCCH Int 0 2
Used to derive the Cyclic Shift for formats 1, 1a and 1b. Must not
exceed (ΔShift PUCCH - 1)
39
Physical layer physical channels
NCS(1) Int 0 7
The PUCCH resource index, which was used for the transmission of
SR by UE. Used to derive nPUCCH (1).
NRB(2) Int 0 98
( Int 0 1185
> PUCCH Resource Index for
CQI The PUCCH resource index used for the transmission of CQI. Used
to derive nPUCCH(2). The maximum value of this parameter
depends upon NRB(2) and NCS(1) as specified in 36.211 v8.6.0
Section 5.4.
DLHarqAckNackFeedbackMode Int 0 1 0
0= Bundling Mode
1 = Multiplexing Mode
Note: Mandatory parameter for TDD mode.
Should not be present for FDD mode.
40
Physical layer physical channels
Confirm parameters
7.8 PhyConfigPusch
Configures or modifies the PUSCH parameters
Scope
This command must be used with the PhyConfigUlSch command as part of a sequence of
Activate-dependent commands.
Activation time is controlled by the Activate command.
Description
This command is used to configure or modify the existing PUSCH physical channel parameters at
the physical layer.
These parameters are only needed when the UL-SCH is configured.
Syntax
FORW TE PHYCONFIGPUSCH <PARAMETERS>
Request parameters
0 = inter-subframe
1 = inter and intra-subframe
Nsb Int 1 4
41
Physical layer physical channels
(1)
Used to derive nDMRS
In dB
Used to derive the number of coded symbols for HARQ-ACK
Note: Value 15 is reserved.
∆ Offset RI Int 0 15
In dB
Used to derive the number of coded symbols for Rank indicator
Note: Values 13, 14 and 15 are reserved.
In dB
Used to derive the number of coded symbols for channel quality
Note: Values 0 and 1 are reserved.
[ Int 0 63 98
HO
PUSCH Hopping Offset (NRB )
] The offset used for PUSCH hopping expressed in number of
resource blocks.
Confirm parameters
7.9 PhyConfigUlPowerCtrlTable
NOTE: This command is not currently supported.
Configures or modifies the UL power control override table
42
Physical layer physical channels
Scope
This command must be used with the PhyConfigUlSch command as part of a sequence of
Activate-dependent commands.
Description
This provides scripting of the power control bits for UL signalled on the DL L1/L2 control channel.
When used to modify, all the entries of the table are cleared and must be re-applied.
Syntax
FORW TE PHYCONFIGULPOWERCTRLTABLE <PARAMETERS>
Request parameters
Confirm parameters
7.10 PhyConfigUlSrs
Configures or modifies uplink sounding reference signal
Scope
This command must be used with the PhyConfigPusch and PhyConfigPucch commands as part of
a sequence of Activate-dependent commands. Activation time is controlled by the Activate
command.
Description
This command is used to configure, or modify the existing, uplink sounding reference signal at the
physical layer.
Syntax
FORW TE PHYCONFIGULSRS <PARAMETERS>
Request parameters
43
Physical layer physical channels
Bool 0 1
SRS Enable Flag
0 – SRS OFF
1 – SRS ON
( Int 0 15 14
SRS Sub-frame Configuration
Table 5.5.3.3-1 36.211
Only values in the range 5...7 are permitted for 3 MHz system
bandwidth
Only values in the range 3...7 are permitted for 5 MHz system
bandwidth
44
Physical layer physical channels
0 = single
1 = Indefinite (until disabled)
Confirm parameters
7.11 PhyDeleteUlSrs
NOTE: This command is not currently supported.
Deletes the UL sounding reference signal
Scope
An uplink reference signal must be active. An uplink reference signal must be active. If an UL-SCH
has been configured, the UL SRS must not be deleted without also deleting the UL-SCH. Deletion
time of the reference signal is controlled by the Activate command.
Description
This command is used to delete the uplink reference signal at the physical layer. This command
fails if the uplink reference signal is not yet active.
Syntax
FORW TE PHYDELETEULSRS <PARAMETERS>
Request parameters
None.
45
Physical layer physical channels
Confirm parameters
7.12 PhyOverrideReceivedCQI
NOTE: This command is not currently supported.
Overrides the transmitted rank indicator, PMI and CQI values
Scope
The effects of this command are immediate.
Description
This command is used to override the received rank indicator, PMI, and CQI values. The PMI can
only be overridden if the rank indicator is overridden and the CQI values can only be overridden if
the PMI is overridden.
Syntax
FORW TE PHYOVERRIDECQI <PARAMETERS>
Request parameters
( Int -1 3 -
PMI override
-1 = Use normal calculated PMI
The maximum value depends upon the specified 'Rank indicator
override':
0 … 3 = PMI reported in CQI when 'Rank indicator override' is 1
0 … 1 = PMI reported in CQI when 'Rank indicator override' is 2
{ Int 0 15
46
Physical layer physical channels
{ Int 0 15
>>>> CQI for Codeword 0
Confirm parameters
7.13 PhyReConfigUlSrs
Reconfigures uplink sounding reference signal
Scope
This command must be used after the cell has been created (FULL_PROTOCOL_MODE) or initial
configurations have been applied (MAC_MODE/RLC_MODE/PDCP_MODE). The effects of this
command are immediate and hence the Activate command is not required.
Description
This command is used to reconfigure or modify the existing uplink sounding reference signal at the
physical layer.
Syntax
FORW TE PHYRECONFIGULSRS <PARAMETERS>
Request parameters
47
Physical layer physical channels
Bool 0 1
SRS Enable Flag
0 – SRS OFF
1 – SRS ON
( Int 0 15 14
SRS Sub-frame Configuration
Table 5.5.3.3-1 36.211
Only values in the range 5...7 are permitted for 3 MHz system
bandwidth
Only values in the range 3...7 are permitted for 5 MHz system
bandwidth
48
Physical layer physical channels
0 = single
1 = Indefinite (until disabled)
Confirm parameters
7.14 PhySendUlTpcSequence
Modifies the Uplink Transmission Power based on the configuration values.
Scope
The command has to be followed by an Activate command and can be issued along with the group
of Activate-dependent commands or also as a single stand-alone command. This command cannot
be issued along with the Scheduler reconfiguration commands.
Description
This command is used to control the UL Transmit Power by sending the UL TPC values in only DL
grants, only UL grants or either of them. To achieve persistent power values, the Accumulation
option has to be enabled in the PhyConfigPusch command.
It is recommended that the TPC values are 0 in the SchedulerAddUlSchCtrlTableEntry command
when this command is used.
For example, to increase the PUSCH transmit power by 10dB through UL grants, this command
can be issued with 10 entries, with each entry corresponding to a 1dB power increase, and with the
applicability set to 1.
The TPC values in the SchedulerAddUlSchCtrlTableEntry command are used only before and after
(but not during) all TPC values in this command are used up. The 10 values in the above example
correspond to 10 TTIs after activation if the UL grant is present in all TTIs.
For immediate effect of this command, activate immediately.
Syntax
FORW TE PHYSENDULTPCSEQUENCE <PARAMETERS>
49
Physical layer physical channels
Request parameters
Applicability Int 1 3
{ Int 0 3
> TPC value
0 = -1dB
}
1 = 0dB
2 = 1dB
3 = 3dB
Confirm parameters
50
8 Physical layer transport channels
These commands can be used in the following modes MAC_MODE, RLC_MODE, PDCP_MODE and
FULL_PROTOCOL_MODE where explicitly stated. Unless stated otherwise in the command description,
these can only be used after STRT has been issued.
8.1 PhyConfigDlSch
Configures or modifies a DL-SCH transport channel to encode
Scope
The PDCCH, PUCCH and PDSCH must be configured for this transport channel to be activated.
This command must be used with the PhyConfigPdcch, PhyConfigPucch and PhyConfigPdsch
commands as part of a sequence of Activate-dependent commands. Activation time is controlled
by the Activate command.
Description
This command is used to configure or modify an existing DL-SCH transport channel at the physical
layer.
Syntax
FORW TE PHYCONFIGDLSCH <PARAMETERS>
Request parameters
0 = Reserved
1 = single antenna port – port 0
2 = Transmit Diversity
3 = Open-loop Spatial Multiplexing
4 = Closed-loop Spatial Multiplexing
5 = Multi-user MIMO
6 = Closed-loop Rank=1 Precoding
7 = Single Antenna Port – port 5
Note: Only modes 1 to 4 and mode 7 are supported in the current
release.
Confirm parameters
51
Physical layer transport channels
8.2 PhyConfigDlSchCqi
Configure DL-SCH CQI parameters
Scope
This command must be used with the PhyConfigDlSch command as part of a sequence of
Activate-dependent commands. Activation time is controlled by the Activate command.
Description
This command is used to configure the DL-SCH CQI parameters at the physical layer.
Syntax
FORW TE PHYCONFIGDLSCHCQI <PARAMETERS>
Request parameters
0 = Wideband
1 = UE Selected Subband
This parameter is only used if Periodic CQI is enabled (using the
‘CQI/PMI Periodicity and Offset Configuration Index’ parameter in this
command)
0 = Mode 1-2
1 = Mode 2-0
2 = Mode 2-2
3 = Mode 3-0
4 = Mode 3-1
The allowed mode is dependent on the PDSCH transmission mode as
follows:
Single-antenna port; port 0 Modes 2-0, 3-0
Transmit diversity Modes 2-0, 3-0
Open-loop spatial multiplexing Modes 2-0, 3-0
Closed-loop spatial multiplexing Modes 1-2, 2-2, 3-1
Multi-user MIMO Mode 3-1
Closed-loop Rank=1 Precoding Modes 1-2, 2-2, 3-1
Single-antenna port ; port 5 Modes 2-0, 3-0
Choice 'PeriodicityCQI/PMI Periodicity and Offset Configuration Index' is less than 317
( Int 1 4 -
52
Physical layer transport channels
Int 0 1023 -
> RI Config Index (IRI)
966 = Periodic Rank indication disabled. The parameter is used to derive
) MRI and CQI Rank Indication Subframe Offset (N OFFSET, RI).
Parameter range (0, 4, 5, 6 ... 16). This parameter indicates the delay in
applying the PMI report and/or Rank.
0 – Disable application/feedback of PMI report and rank in DL
Value other than 0 – Enable application/feedback of PMI report and rank in
DL
Parameters
8.3 PhyConfigUlSch
Configures or modifies a UL-SCH transport channel to decode.
Scope
The PDCCH, PUCCH and PUSCH must be configured for this transport channel to be activated.
This command must be used with the PhyConfigPdcch, PhyConfigPucch and PhyConfigPusch
commands as part of a sequence of Activate-dependent commands. Activation time is controlled
by the Activate command.
Description
This command is used to configure or modify an existing UL-SCH transport channel at the physical
layer.
Syntax
FORW TE PHYCONFIGULSCH <PARAMETERS>
53
Physical layer transport channels
Request parameters
Confirm parameters
54
Physical layer transport channels
8.4 PhyReConfigDlSchCqi
Reconfigures DL-SCH CQI parameters
Scope
This command must be used after the cell has been created (FULL_PROTOCOL_MODE) or initial
configurations have been applied (MAC_MODE/RLC_MODE/PDCP_MODE). The effects of this
command are immediate and hence the Activate command is not required.
Description
This command is used to reconfigure or modify the DL-SCH CQI parameters at the physical layer.
Syntax
FORW TE PHYRECONFIGDLSCHCQI <PARAMETERS>
Request parameters
0 = Wideband
1 = UE Selected Subband
This parameter is only used if Periodic CQI is enabled (using the ‘CQI/PMI
Periodicity and Offset Configuration Index’ parameter in this command)
0 = Mode 1-2
1 = Mode 2-0
2 = Mode 2-2
3 = Mode 3-0
4 = Mode 3-1
The allowed mode is dependent on the PDSCH transmission mode as
follows:
Single-antenna port; port 0 Modes 2-0, 3-0
Transmit diversity Modes 2-0, 3-0
Open-loop spatial multiplexing Modes 2-0, 3-0
Closed-loop spatial multiplexing Modes 1-2, 2-2, 3-1
Multi-user MIMO Mode 3-1
Closed-loop Rank=1 Precoding Modes 1-2, 2-2, 3-1
Single-antenna port ; port 5 Modes 2-0, 3-0
Choice 'PeriodicityCQI/PMI Periodicity and Offset Configuration Index' is less than 317
55
Physical layer transport channels
( Int 1 4 -
> CQI Number of cycles of
bandwidth parts This parameter corresponds to K in 36.213 $7.2.2 The parameter is only
used if the CQI Periodic Reporting Method is UE Selected Subband.
Int 0 1023 -
> RI Config Index (IRI)
966 = Periodic Rank indication disabled. The parameter is used to derive
) MRI and CQI Rank Indication Subframe Offset (N OFFSET, RI).
Parameters
56
9 Channel emulation commands
All commands in this chapter can be used only if radio channel emulation is enabled. By default, radio
channel emulation is disabled. If fading models need to be simulated, the command,
PhyConfigRadioChannel must be activated. Similarly, by default, AWGN generation is disabled. To
enable AWGN generation, the command PhyConfigAwgn should be issued and activated. The activation
of AWGN and fading models are independent.
If cross paths are not enabled in the 2x2 mode, the channel that is simulated is . The
AWGN level is not affected by this condition. The user can reduce the AWGN level by 3dB to
maintain the SNR in each receive-antenna.
If cross-paths are not enabled, the channel that is simulated is [1 0; 0 -1] for 2 Tx antennas and [1 0
0 0; 0 -1 0 0] for 4 Tx antennas.
There are two ways to use the 4x2 fading mode without closed-loop operation. (Not using CQI/PMI
feedback)
1. If a pre-coding index has been fixed, ~1 second after starting the fading channel simulation
without specifying a static channel, the links (Tx1-Rx1, Tx2-Rx1 etc.) de-correlate enough to be
able to decode the data.
2. Depending on the precoding index selected, the user should configure a suitable static channel
by setting the “Channel Model” = 1 in the PhyConfigRadioChannel command. Another instance of
PhyConfigRadioChannel should follow with the required fading profile and velocity pattern. The
fading simulation starts from the specified channel condition and continues from there. For a
different precoding index, repeat this procedure with a matching static channel.
Notes: Deleting a cell and creating another one with two transmit antennas defaults to the 3GPP channel
(and if fading is enabled, the channel changes dynamically starting from this channel condition.)
PhyConfigRadioChannel Command is modified to configure static channel from command. After Creating
a cell in 4X2 Fading, PhyConfigRadioChannel command with static channel ‘ON’ should be run before
performing registration when four transmit antennas are used otherwise registration fails. Below are the
sample commands that should be used for various transmission modes:
Transmit Diversity and OL MIMO:
Either FORW TE PhyConfigRadioChannel 0 2 2140 [1 ( { 1000 0,1000 0,1000 0,1000
0,1000 0,1000 180,1000 180,1000 0 } )] or FORW TE PhyConfigRadioChannel 0 2 2140
[] can be used.
CL MIMO:
For precoding indices 0,1,3,6,7,9,12,13,14,15:
57
Channel emulation commands
9.1 PhyConfigRadioChannel
Configure the path-independent radio channel simulation parameters
Scope
This command must be activated independently. Activation time is controlled by the Activate
command.
Description
This command is used to configure or modify existing radio channel simulation parameters.
Syntax
FORW TE PHYCONFIGRADIOCHANNEL <PARAMETERS>
Notes:
When the velocity of the UE is zero, the static channel that is simulated is as per Section B.1 of
If cross paths are not enabled, the channel that is simulated is . The AWGN level is not
affected by this condition. The user can reduce the AWGN level by 3dB to maintain the SNR in
each receive-antenna
Request parameters
[ Int 0 63 0
58
Channel emulation commands
( Enum 0 63 0
>> MIMO Correlation Model
>> ( Enum 0 1 0
>>>> MIMO Correlation
Scope
[ Int 0 6000 0
Velocity
Reference velocity of the UE in decikmph.
0: None
1: Periodic
2: Random Set
[Note] : If ‘Path Type’ is 2, the value of this parameter is 0
( Enum 0 2 0
>>[
0: Sine
>>Velocity Pattern Shape
1: Square
59
Channel emulation commands
Peak to peak amplitude in decikmph for the velocity pattern. ‘Velocity’ +/-
½*‘Peak to peak amplitude’) should be within the range given for ‘Velocity’.
Int 0 359 0
( Int 0 6000 0
>>[
Range in decikmph of random velocities in set
>> Set Range
{ Int 33000 0
>>Delay 0
Path delay in ns
[Note] : If ‘Path Type’ is 2, the value of this parameter should be given as 0
60
Channel emulation commands
0: None
1: Periodic
2 From a random set
[Note] : If ‘Path Type’ is 2, the value of this parameter is 0
>>( Enum 0 2 0
>>>>[
0: Sine
>>>>Delay Pattern Shape
1: Square
2: Triangle
Int 0 255 0
61
Channel emulation commands
>>>>Exclusions Enum 0 2 0
>>>>]
0: No exclusions
>>)
1: Self
2: All
Reference path gain in centidB. At least one path must have 0 dB gain.
0: None
1: Periodic
2: log-normal
[Note] : If ‘Path Type’ is 2, the value of this parameter must be given as 0
>>( Enum 2 0
>>>>[ 0
>>>>Gain Pattern Shape
0: Sine
1: Square
2: Triangle
62
Channel emulation commands
In dB
>>[ Enum 1 1
0
>>Path Type
0: Pure Doppler
1: Rayleigh
2: High Speed Train
Seed
>>)
0: Classical
1: Flat
>>>> ds
Twice the initial distance of the train from the eNodeB in centimetres
>>)
>>]
The eNodeB-Railway track distance in centimetres
63
Channel emulation commands
(
> For each ‘Number of Receive Antennas supplied (1..RxN) where RxN can be 4. Second parameter of this API
>>( GainFactor in terms of initial Gain. GainFactor should be in steps of 10. This
>>>> GainFactor11 value is scaled by 1000 to get resolution of 0.01. Value 10 means 0.01.
Value 1000 means multiplication factor 1.
>>>> GainFactor21
GainFactor in terms of initial Gain. GainFactor should be in steps of 10. This
value is scaled by 1000 to get resolution of 0.01. Value 10 means 0.01.
Value 1000 means multiplication factor 1.
>>>> GainFactorM1
GainFactor in terms of initial Gain. GainFactor should be in steps of 10. This
value is scaled by 1000 to get resolution of 0.01. Value 10 means 0.01.
Value 1000 means multiplication factor 1.
>>)
Theta in terms of degrees
}
Where M is Number of Transmitters Configured in PhySetSystemParams
>>>> GainFactor2N
GainFactor in terms of initial Gain.GainFactor should be in steps of 10. This
value is scaled by 1000 to get resolution of 0.01. Value 10 means 0.01.
Value 1000 means multiplication factor 1.
64
Channel emulation commands
>>>> GainFactorMN
GainFactor in terms of initial Gain.GainFactor should be in steps of 10. This
value is scaled by 1000 to get resolution of 0.01. Value 10 means 0.01.
Value 1000 means multiplication factor 1.
Where M is Number of Transmitters Configured in PhySetSystemParams
and N is Number of Receivers Configured in PhyConfigRadioChannel
>>)
Theta in terms of degrees
)
Where M is Number of Transmitters Configured in PhySetSystemParams
} and N is Number of Receivers Configured in PhyConfigRadioChannel
Confirm parameters
9.2 PhyConfigAwgn
Configures the AWGN parameters
Scope
This command must be activated independently. Activation time is controlled by the Activate
command.
Description
This command is used to configure or modify existing AWGN simulation parameters.
It is necessary to issue PhyConfigRadioChannel command before configuring AWGN.
Syntax
FORW TE PHYCONFIGAWGN <PARAMETERS>
65
Channel emulation commands
Request parameters
AWGN Level in dB
The value -100 implies that no noise is added.
-99 to -57: Reserved
-56.0 to 5.0 in steps of 0.1 dB: Noise level with respect to the
nominal LTE signal which corresponds to all subcarriers being
occupied with equal power as the reference signal.
Floating point numbers up to the first decimal place are accepted.
Any digits beyond one decimal place are ignored.
Confirm parameters
66
10 HARQ commands
Refer to the individual commands to see the modes in which they are used. Each command can
only be used after STRT is issued.
10.1 HarqAddDlSchAckTableEntry
NOTE: This command is not currently supported.
Add entry to DL-SCH ACK override table
Scope
This command can be used in MAC_MODE, RLC_MODE, PDCP_MODE and FULL_PROTOCOL_
MODE. This command must be used with the MAC Layer Logical Channels Commands as part of
a sequence of Activate-dependent commands. Activation time is controlled by the Activate
command.
Description
This command is used to add an entry to the DL-SCH ACK table. This enables the forcing of the
DL-SCH reception results signalled on the uplink. The maximum number of 'Forced Time' data
entries available is 8000 TTIs, or 1000 'Forced Event' data entries per HARQ process per
codeword (that is, 16000). This command can be used more than once to add more than 255
entries to the profile and must be issued at least once for each codeword and HARQ for which
'Forced Event' data entries are required to be specified.
If no 'Forced Event' ACK/NACK result override is specified for a given HARQ process and
codeword, then the real result is transmitted.
Syntax
FORW TE HARQADDDLSCHACKTABLEENTRY <PARAMETERS>
Request parameters
( Int 1 255
Number of Entries
Number of entries supplied in this command
{ Enum 6 93
>Downlink Channel Number (nCCE)
Used to derive the PUCCH resource for transmission of HARQ
result
67
HARQ commands
-1 = DTX
0 = NACK
1 = ACK
Codeblock identifier
0 = First transport block
1 = Second transport block
DL Harq Id Int 0 7
DL HARQ id = 0 … 7
{ Enum -2 1
>DL HARQ result
}
-2 = Derived result
)
-1 = DTX
0 = NACK
1 = ACK
Confirm parameters
10.2 HarqConfigDlSch
NOTE: This command is not currently supported.
Configures or modifies the DL-SCH HARQ
Scope
This command must be used with the PhyConfigDlSch command as part of a sequence of
Activate-dependent commands.
Activation time is controlled by the Activate command.
Description
This command is used to configure or modify an existing HARQ for the DL-SCH. The number of
HARQ processes are assumed according to 3GPP 36.213.
68
HARQ commands
Syntax
FORW TE HARQCONFIGDLSCH <PARAMETERS>
Request parameters
[ Bool 0 1 0
Reset all HARQs
This parameter is ignored if not modifying
]
1 = Clear all HARQ buffers
0 = Maintain all HARQ buffers
Confirm parameters
10.3 HarqConfigDlSchAckTable
NOTE: This command is not currently supported.
Configures or modifies DL-SCH ACK override table
Scope
This command can be used in MAC_MODE, RLC_MODE, PDCP_MODE and FULL_PROTOCOL_
MODE. This command must be used with the HarqConfigDlSch command as part of a sequence of
Activate-dependent commands. Activation time is controlled by the Activate command.
Description
This command is used to configure the DL-SCH ACK table test feature. This enables the forcing of
the DL-SCH reception control signal results as signalled on the PUCCH control channel.
When using forced event operation, the ACK/NACK result overrides the real-world result produced
by the HARQ process. This mode is intended to be used to enable a defined DL-SCH BLER or
ACK/NACK sequence to be simulated.
When using forced time operation, the ACK/NACK result is transmitted independently on the
HARQ process. This mode is intended to be used to generate test data for the UCI carried on the
PUCCH/PUSCH.
When this command is used to modify the DL-SCH ACK table test feature, all the entries of the
table are cleared and must be re-applied.
Table entries are added using HarqAddDlSchAckTableEntry command.
Syntax
FORW TE HARQCONFIGDLSCHACKTABLE <PARAMETERS>
69
HARQ commands
Request parameters
Confirm parameters
10.4 HarqConfigTransmission
Configures or modifies HARQ Transmission
Scope
This command can be used in MAC_MODE, RLC_MODE, PDCP_MODE and FULL_PROTOCOL_
MODE. This command is Activation-dependent command. Activation time is controlled by the
Activate command.
Description
This command is used to configure the HARQ Transmission feature.
Syntax
FORW TE HARQCONFIGTRANSMISSION <PARAMETERS>
Request parameters
0 = Downlink transmission,
1 = Uplink transmission,
2 = MSG3 transmission.
70
HARQ commands
{ Integer 0 3
RV INDEX
Redundancy version.
}
Confirm parameters
10.5 HarqConfigUlSch
NOTE: This command is not currently supported.
Configures or modifies the UL-SCH HARQ
Scope
This command must be used with the PhyConfigUlSch command as part of a sequence of
Activate-dependent commands.
Activation time is controlled by the Activate command.
Description
This command is used to configure or modify an existing HARQ for the UL-SCH. The number of
HARQ processes are assumed as per 3GPP 36.213.
Syntax
FORW TE HARQCONFIGULSCH <PARAMETERS>
Request parameters
71
HARQ commands
[ Bool 0 1 0
Reset all HARQs
This parameter is ignored if not modified.
]
1 = Clear all HARQ buffers
0 = Maintain all HARQ buffers
Confirm parameters
10.6 HarqConfigUlSchOverride
NOTE: This command is not currently supported.
Overrides the UL-SCH HARQ
Scope
This command can be used any time. The effects of this command are immediate.
Description
This command is used to override the UL-SCH HARQ.
Use of this command affects the inclusion of transport blocks with CRC failures, in the calculation
of the ‘Total Bit errors’ and ‘BER’ statistics.
Note: Command applicable to all HARQ processes.
Syntax
FORW TE HARQCONFIGULSCHOVERRIDE <PARAMETERS>
Request parameters
72
HARQ commands
Confirm parameters
73
11 Scheduler commands
Scheduler commands let you configure the 7100 to schedule DL and UL transmissions according
to your test scenario. These commands can be used for varying the following parameters on a TTI
basis:
• CFI
• Presence of DL grant
• Presence of UL grant
• DL scheduling information that is signaled on the PDCCH
• UL scheduling information signaled on the PDCCH
• PDCCH aggregation level, search space and candidate index
• HARQ ACK to be used for each DL transmission
• HARQ ACK to be used for each UL transmission.
Every TTI from the activation time of the scheduler commands, the CFI is read from the values in
the ConfigCfiValue command and wrapped around until the command is reconfigured or stopped.
The presence of the DL grant is indicated by the command ConfigDlGrant. The entries in this
command are read every TTI from the activation time and are wrapped around until reconfigured or
stopped. For every TTI where a grant is present or a retransmission is needed, the HARQ process
number is incremented and the next entry for that HARQ process from the
SchedulerAddDlSchCtrlTableEntry is used. If no grant is present for a TTI, the information in
SchedulerAddDlSchCtrlTableEntry is not used. A similar mechanism is applied for the
ConfigUlGrant and the SchedulerAddUlSchCtrlTableEntry except that the HARQ process number
is incremented every TTI irrespective of the ConfigUlGrant status for that TTI. However,
autonomous scheduler decisions are made in the following cases:
• For a PCH, D-BCH or RAR transmission, the presence of a DL grant and the entry from the
SchedulerAddDlSchCtrlTableEntry are ignored (if already used, that is. if ConfigDlGrantStatus
showed the presence of a DL grant) and MAC decides what DL grant parameters to be used.
When message 3 is expected, the cyclic shift DMRS parameters for the PUSCH are forced to
zero.
• If a special RNTI (SI-RNTI and RA-RNTI) is used in the DL, both the DL and UL grants (if
present) are sent in the common search space of aggregation level 2 in candidate indices 0 and 1
respectively.
• If the DL grant is present in a TTI, and is for a DL-SCH transmission on the C-RNTI or TC-RNTI,
the search space and candidate index is taken from the corresponding entry specified in
SchedulerAddDlSchCtrlTableEntry.
• If the DL grant is present, the UL uses the same search space as the DL. The candidate index is
1 away from the DL candidate index.
• If the DL grant is not present, the UL grant is sent in the UE-specific search space at candidate
index 0.
Retransmissions
The mechanism described above also applies to retransmissions, but with the following exceptions:
• For the DL, the pattern specified in SchedulerAddDlSchCtrlTableEntry is adhered to as far
as possible, but if previous transmissions are pending, the entry corresponding to that TTI
is stored until a free HARQ process is found. The entry corresponding to the TTI where this
data was actually transmitted is used next. To guarantee the exact use of entries as
specified, force all ACKs in the DL.
• Even if the UL grant is not present in SchedulerAddUlSchCtrlTableEntry for the TTI where
a retransmission is due, the UL grant for a retransmission is sent.
74
Scheduler commands
• For each HARQ process, the grant parameters in the entry following any that has a NACK
(to be used in future releases for adaptive retransmissions) are ignored unless the
maximum number of retransmissions has been reached.
• When cells are reconfigured, up to 17 TTIs force new transmissions (provided data is
present).
UL Power Control
The TPC command PUCCH/PUSCH is specified as given in the following table:
Mapping of TPC Command Field in DCI Format 0/1/1/1A/2/2A/3
75
Scheduler commands
11.1 ConfigCfiValue
Configures the CFI (Control Format Indication) value.
Scope
This is a mandatory command. You must use this command with the PhyConfigPdcch,
PhyConfigPdsch, PhyConfigPusch, SchedulerAddUlSchCtrlTableEntry,
SchedulerConfigDlSchCtrlTable, SchedulerAddDlSchCtrlTableEntry, ConfigUlGrant and
ConfigDlGrant as part of a sequence of Activate–dependent commands. Activation time is
controlled by the Activate command.
Description
This command configures the CFI value for the number of entries specified up to a maximum of
255. CFI specifies the number of OFDM symbols occupied by PDCCH in a subframe.
Syntax
FORW TE CONFIGCFIVALUE <PARAMETERS>
Request parameters
{ Int 1, 2, 3 2
CFI Value
1...3 = Number of OFDM symbols for PDCCH.
}
If extended PHICH duration is configured, only value 3 is allowed.
Confirm parameters
11.2 ConfigDlGrant
Configures the presence/absence of DL Grant
Scope
This is a mandatory command.
This command must be used along with the PhyConfigPdcch, PhyConfigPdsch, PhyConfigPusch,
SchedulerAddUlSchCtrlTableEntry, SchedulerConfigDlSchCtrlTable,
SchedulerAddDlSchCtrlTableEntry, ConfigUlGrant and ConfigCfiValue as part of a sequence of
Activate–dependent commands. Activation time is controlled by the Activate command.
76
Scheduler commands
Description
This command configures the status of DL grant, whether present or not.
Syntax
FORW TE CONFIGDLGRANT <PARAMETERS>
Request parameters
{ Int 0, 1 0
DL Grant Status
Specifies the type of Grant
}
0 = No Grant
1 = DL Grant present
Confirm parameters
11.3 ConfigUlGrant
Configures the presence or absence of UL Grant.
Scope
This is a mandatory command. This command must be used along with the PhyConfigPdcch,
PhyConfigPdsch, PhyConfigPusch, SchedulerAddUlSchCtrlTableEntry,
SchedulerConfigDlSchCtrlTable, SchedulerAddDlSchCtrlTableEntry, ConfigDlGrant and
ConfigCfiValue as part of a sequence of Activate–dependent commands Activation time is
controlled by the Activate command.
Description
This command configures the status of UL grant, whether present or not.
Syntax
FORW TE CONFIGULGRANT <PARAMETERS>
77
Scheduler commands
Request parameters
{ Int 0, 1 0
UL Grant Status
Specifies the type of Grant
}
0 = No Grant
1 = UL Grant present
Confirm parameters
11.4 SchedulerAddDlSchCtrlTableEntry
Add an entry to the DL-SCH control override table
Scope
This command must be used with the SchedulerConfigDlSchCtrlTable command as part of a
sequence of Activate-dependent commands for the first time. Next time this command can be
independently given with Activate command. Activation time is controlled by the Activate command.
Description
This command is used to add an entry to the DL-SCH control table.
For each HARQ the maximum number of entries available is 255. This command can be used
more than once to pass up to maximum of 255 entries to the profile.
Syntax
FORW TE SCHEDULERADDDLSCHCTRLTABLEENTRY <PARAMETERS>
Request parameters
78
Scheduler commands
{ Enum 0 14
> Downlink HARQ ID
Downlink HARQ ID
FDD: The accepted range is 0..7
TDD: The accepted range is 0... (n-1), where n is the number of DL
HARQ processes depending on the UL/DL configuration (see Table
7-1 of 3GPP TS 36.213).
( Enum 0…2
> Downlink Resource
Allocation type Info 0 to 2 = Resource Allocation Type
( Int 0 335544 0
31
>> Resource Block Groups
(Or
) 0x1FFF
FFF)
( Int 0 3 0
>> Resource Block Group
sub-set RBG sub-set index.
For 1.4MHz BW, this can take only value ‘0’.
For 3MHz BW, this can take value ‘0’ or ‘1’
For 5MHz BW, this can take value ‘0’ or ‘1’
For 10MHz BW, this can take any value from ‘0’ to ‘2’
For 15MHz BW, this can take value any from ‘0’ to ‘3’
For 20MHz BW, this can take value any from ‘0’ to ‘3’
79
Scheduler commands
( Enum 0 … 99 0
>> RB start
Resource Blocks star index
0 to 99 = RB start
[ Int 0 2
>> NGap Type
0 -- DVRB Off
]
1 or 2 --- Distribution of VRBs to be done with this gap type.
)
1 = Only codeword 0
2 = Codeword 0 and 1
80
Scheduler commands
[ Int 0..1 0
> codeword swap
0 = no swap. Other values are not supported in this release
]
1 = swap. The behaviour is as follows:
If 2 codeword’s are transmitted then the transport blocks are
swapped.
If 1 codeword is transmitted (always on codeword 0) then it is
transport block 2.
[ Int 0 0
> Reserved
] This parameter is unused.
)
Note:
0,1 are supported in Single Antenna Port and Open Loop Spatial
Multiplexing
-2 indicate signalled value from UE. 0,1,-2 are supported in closed
loop spatial multiplexing if the number of transmit antennas is 2
0,1,9,12,13,14,15 are supported in closed loop spatial multiplexing if
the number of transmit antennas is 4
Note: This field is not being used currently. DCI Format is decided
depending on RA type and transmission mode
1 - DCI Format1
2 - DCI Format1a
3-9 - Reserved
81
Scheduler commands
Defines the PDCCH format for UL and DL grants. For MIMO, a format
of at least 2 is recommended. PDCCH format 3 is recommended for
closed loop MIMO tests.
See Section 9.1.1 in 36.213 v8.6.0.
Confirm Parameters
11.5 SchedulerAddUlSchCtrlTableEntry
Add an entry to the UL-SCH control override table
Scope
This command must be used with the SchedulerConfigUlSchCtrlTable command as part of a
sequence of Activate commands for the first time. Next time this command can be independently
given with the Activate command.
Description
This command is used to add an entry to the UL-SCH control table. The maximum number of
entries available is 255 for each HARQ process. This command can be used more than once to
pass up to maximum of 255 entries to the profile.
Syntax
FORW TE SCHEDULERADDULSCHCTRLTABLEENTRY <PARAMETERS>
Request Parameters
82
Scheduler commands
{ Int 0 7
> Uplink HARQ id
Uplink HARQ id
HARQs not populated are set to indicate no grant. (In this release,
every HARQ Id has to be populated with at least one entry.)
TDD: 0.. (n-1), where n is the number of UL HARQ processes
depending on the UL/DL configuration (See Table 8-1 of 3GPP TS
36.213.)
( Enum 0, 1
> Hopping flag
0 = Hopping disabled
1 = Hopping enabled
1..100 = The values within this range that can be used for a
transmission are 1 or products of the primes 2, 3 and/or 5
83
Scheduler commands
Confirm Parameters
11.6 SchedulerConfigDlSchCtrlTable
Configure or Modify the DL-SCH control override table
Scope
Activation time is controlled by the Activate command.
Description
This command is used to configure the DL-SCH scheduling pattern.
When used to modify, all the entries of the table are cleared and must be re-applied. The table
entries are added using the SchedulerAddDlSchCtrlTableEntry command.
Syntax
FORW TE SCHEDULERCONFIGDLSCHCTRLTABLE <PARAMETERS>
Request Parameters
Confirm parameters
84
Scheduler commands
11.7 SchedulerConfigUlSchCtrlTable
Configures or modifies the UL-SCH control override table
Scope
Activation time is controlled by the Activate command.
Description
This provides scripting of the UL-SCH scheduling.
When used as a command to modify, all the entries of the table are cleared and must be re-
applied.
The table data entries are added using the SchedulerAddUlSchCtrlTableEntry command.
Syntax
FORW TE SCHEDULERCONFIGULSCHCTRLTABLE <PARAMETERS>
Request parameters
Confirm parameters
85
12 MAC layer commands
These commands can be used in the following modes MAC_MODE, RLC_MODE, PDCP_MODE and
FULL_PROTOCOL_MODE where explicitly stated. Unless stated otherwise in the command description,
these can only be used after STRT has been issued.
Logical channel identities can be associated with any logical channel type. However, any specified logical
channel identity must be consistently associated with the same logical channel type across all
commands.
12.1 MacConfigBCHGRANT
Scope
This command must be used with the MacConfigDlSch command as part of a sequence of
Activate-dependent commands. Activation time is controlled by the Activate command.
Syntax
FORW TE MacConfigBCHGRANT <PARAMETERS>
Request parameters
0 – DCI Format 1A
1- DCI Format 1 C
86
MAC layer commands
0 -- DVRB Off
1 or 2 --- Distribution of VRBs to be done with this gap type.
Int 0 1
Sib Repetition
0 – Disable
1 - Enable
Reserved Int 0
Reserved
Reserved Int 0
Reserved
Reserved Int 0
Reserved
Reserved Int 0
Reserved
Reserved Int 0
Reserved
Reserved Int 0
Reserved
Confirm parameters
12.2 MacConfigCQI
Configures MAC CQI parameters
Scope
This command must be used with the MacConfigDlSch command as part of a sequence of
Activate-dependent commands. Activation time is controlled by the Activate command.
Description
This command is used to change the MCS level at MAC based on CQI reported by UE
Syntax
FORW TE MacConfigCQI<PARAMETERS>
87
MAC layer commands
Request parameters
Band Int 0 1
0 -Wide Band
1 - Sub Band
( Int 0 1
CQI Selection Case
1- Worst
0 - Best
Confirm parameters
12.3 MacConfigDlCcch
Configures or modifies DL CCCH logical channel to decode
Scope
This command must be used with the PhyConfigDlSch command as part of a sequence of
Activate-dependent commands. Activation time is controlled by the Activate command.
Description
This command is used to configure or modify an existing DL CCCH logical channel at the MAC
layer.
Syntax
FORW TE MACCONFIGDLCCCH <PARAMETERS>
Request parameters
88
MAC layer commands
[ Bool 0 1 0
DLCCCHWithCRNTI
0 – Disable sending DL CCCH Data using C-RNTI. In this case the DL CCCH
] Data can be sent using Temp C-RNTI only
1 – Enable sending DL CCCH Data using C-RNTI. In this case the DL CCCH
Data can be sent using Temp CRNTI and C-RNTI
Confirm parameters
12.4 MacConfigDlDBcch
Configures or modifies dynamic BCCH logical channel to decode
Scope
This command must be used with the MacConfigDlSch command as part of a sequence of
Activate-dependent commands. Activation time is controlled by the Activate command.
Description
This command is used to configure or modify an existing dynamic BCCH logical channel at the
MAC layer. One SI is configured on sending one command. If multiple SI has to be configured then
multiple commands has to be issued with different Order of entry.
Syntax
FORW TE MACCONFIGDLDBCCH <PARAMETERS>
Request parameters
BCCH-Type Int 1 4
89
MAC layer commands
Choice ‘BCCH-Type’ is 1
( Int 0 9
>Sub FrameId
)
Sub Frame Id – To be provided for Sib1
Choice ‘BCCH-Type’ is 2 or 3 or
4
( Int 1 11
>OrderOfEntry
OrderOfEntry - Order of entry in the SIB1
To be provided for SI Data
rf8 – 8, rf16 – 16, rf32 – 32, rf64 – 64, rf128 – 128, rf256 – 256, rf512 –
512
To be provided for SI Data
ms1 – 1, ms2 - 2, ms5 - 5, ms10 - 10, ms15 - 15, ms20 - 20, ms40 –
40
To be provided for SI Data
Choice ‘BCCH-Type’ is 3
( Int 0 1
>cdma-EUTRA-
Synchronization 0 - indicates that the E-UTRA and CDMA2000 networks are not
synchronized
)
1 - indicates that the E-UTRA and CDMA2000 networks are synchronized
Choice ‘BCCH-Type’ is 4
( Int 0 63
>segment-number
Indicates the segment number being transmitted
)
)
Data
HEX STRING
90
MAC layer commands
Confirm parameters
12.5 MacConfigDlDcch
Configures or modifies DL DCCH logical channel to decode
Scope
This command must be used with the MacConfigDlSch command as part of a sequence of
Activate-dependent commands. Activation time is controlled by the Activate command.
Description
This command is used to configure or modify an existing DL DCCH logical channel at the MAC
layer.
Syntax
FORW TE MACCONFIGDLDCCH <PARAMETERS>
Request parameters
{ Int 0 27
> Logical Channel Identity
logical channel identity for DL-DCCH
Note: Only Logical Channel Identity 1 – 10 are valid. The rest of the
identities are left for the user to test their own scenarios
RESERVED
RESERVED
> Bucket Size Duration Int 50, 100, 150, 300, 500, 1000
}
RESERVED
91
MAC layer commands
Confirm parameters
12.6 MacConfigDlDtch
Configures or modifies DL DTCH logical channel to decode
Scope
This command must be used with the MacConfigDlSch command as part of a sequence of
Activate-dependent commands. Activation time is controlled by the Activate command.
Description
This command is used to configure or modify an existing DL DTCH logical channel at the MAC
layer.
Syntax
FORW TE MACCONFIGDLDTCH <PARAMETERS>
Request parameters
{ Int 0 27
> Logical Channel Identity
Logical channel identity for DL-DTCH
NOTE: ONLY Logical Channel Identity 1 – 10 is valid. Rest of the Identities
are left for the user to test their own scenarios.
RESERVED
RESERVED
> Bucket Size Duration Int 50, 100, 150, 300, 500, 1000
}
RESERVED
92
MAC layer commands
Confirm parameters
12.7 MacConfigDlPcch
Configures or modifies DL PCCH logical channel
Scope
Activation time is controlled by the Activate command.
Description
This command is used to configure or modify an existing downlink PCCH logical channel at the
MAC layer.
Syntax
FORW TE MACCONFIGDLPCCH <PARAMETERS>
Request parameters
Specified in ms.
nB Enum 0 7
93
MAC layer commands
Confirm parameters
12.8 MacConfigDlSch
Configures or modifies MAC DL-SCH parameters
Scope
This command must be used with the PhyConfigDlSch command as part of a sequence of
Activate-dependent commands. Activation time is controlled by the Activate command.
Description
This command must be used if a logical channel uses a transport channel type of DL-SCH.
Syntax
FORW TE MACCONFIGDLSCH <PARAMETERS>
Request parameters
0 = Reserved
1 = single antenna port – port 0
2 = Transmit Diversity
3 = Open-loop Spatial Multiplexing
4 = Closed-loop Spatial Multiplexing
5 = Multi-user MIMO
6 = Closed-loop Rank=1 Precoding
7 = Single Antenna Port – port 5
Note: Only modes 1 to 4 and mode 7 are supported in the current
release.
14-1.4 MHz, 3-3 MHz, 5-5MHz, 10-10 MHz, 15-15 MHz, 20-20 MHz
[ Int 0 1 0
94
MAC layer commands
[ Int 0 9 9
DBCH MCS
MCS value used for the transmission of SIB messages.
]
[ Int 1,2,3,4,1001,1004 3
DBCH NRB
Number of resource blocks used for the transmission of SIB messages.
]
1 - Use the value N1ARb – 2 and NRB – 1
2 - Use the value N1ARb – 2 and NRB – 2
3 - Use the value N1ARb – 3 and NRB – 3
4 - Use the value N1ARb – 2 and NRB – 4
1001- Use the value N1ARb – 3 and NRB – 1
1004- Use the value N1ARb – 3 and NRB – 4
Maximum value depends on the DL bandwidth configured in Section 6.2.
[ Int 0 9 9
PCH MCS
MCS value used for the transmission of paging messages.
]
[ Int 0 9 9
95
MAC layer commands
[ Int 0 15 4
RACH Msg3 MCS
MCS value used for the transmission of RACH Msg3.
]
[ Int 3 100 10
RACH Msg3 NRB
Number of resource blocks used for the transmission of RACH Msg3.
]
Maximum value depends on the DL bandwidth configured in Section 6.2.
[ Int 0 28 9
Msg4 MCS
MCS value used for the transmission of Msg4.
]
Note: Value 28 is reserved for this release
[ Int 3 100 36
RACH Msg4 NRB
Number of resource blocks used for the transmission of Msg4.
]
Maximum value depends on the DL bandwidth configured in Section 6.2.
MacOverrideDataTableEntry Int 0 1
Enable
0 – False
1 – True
( Int 0 8640
> Downlink Guaranteed Bit
Rate Downlink guaranteed bit rate in kbps
96
MAC layer commands
-1 – Infinity,
500 – sf500,
750 – sf750,
1280 – sf1280,
1920 – sf1920,
2560 – sf2560,
10240 – sf10240
TimeAdvanceExplicit Int 0 1
0 – False
1 – True
TimeAdvanceValue Int 0 63
Confirm parameters
12.9 MacConfigDlSPS
Configures or modifies MAC SPS parameters
Scope
This command must be used with MacConfigDlSch commands as part of a sequence of Activate-
dependant commands.
Description
This command must be used if a logical channel uses semi-persistent scheduling.
97
MAC layer commands
Syntax
FORW TE MACCONFIGDLSPS <PARAMETERS>
Request parameters
sf10 = 10
sf20 = 20
sf32 = 32
sf40 = 40
sf64 = 64
sf80 = 80
sf128 = 128
sf160 = 160
sf320 = 320
sf640 = 640
Number of Transmissions.
Enum -2, 0 … 2
> Downlink Resource Allocation
type Info -2 = Use signalled value (not available if ‘DL-SCH control table
override operation’ is ‘forced time’)
0...2 = Resource allocation type
( Int 0 335544 0
31
>> Resource Block Groups
(Or
) 0x1FFF
FFF)
98
MAC layer commands
( Int 0 3 0
>> Resource Block Group sub-set
RBG sub-set index.
For 1.4MHz BW, this can take only value ‘0’.
For 3MHz BW, this can take value ‘0’ or ‘1’
For 5MHz BW, this can take value ‘0’ or ‘1’
For 10MHz BW, this can take any value from ‘0’ to ‘2’
For 15MHz BW, this can take value any from ‘0’ to ‘3’
For 20MHz BW, this can take value any from ‘0’ to ‘3’
( Enum -0 … 99 0
99
MAC layer commands
> For each ‘Number of downlink codewords’ supplied (1...2), note that when ‘Number of downlink codewords’ is
-2 (i.e. in ‘forced event’ mode) all codewords must be specified
{ Int 0...3
>> RV
Redundancy version.
0...3 = RSN value
[ Int 0...1 0
> codeword swap
0 = no swap
]
1 = swap. The behaviour is as follows:
If 2 codewords are transmitted, then the transport blocks are
swapped.
If 1 codeword is transmitted (always on codeword 0), then it is
transport block 2.
100
MAC layer commands
NOTE:
0,1 are supported in single antenna port and open loop spatial
multiplexing
-2 indicate signalled value from UE. 0,1,-2 are supported in closed
loop spatial multiplexing if the number of transmit antennas is 2
0,1,9,12,13,14,15 are supported in closed loop spatial multiplexing if
the number of transmit antennas is 4
Confirm parameters
12.10 MacConfigDrx
Scope
This command must be used with the MacConfigDlSch command as part of a sequence of
Activate-dependent commands. Activation time is controlled by the Activate command.
Description
This command must be used if a logical channel uses a transport channel type of DL-SCH.
Syntax
FORW TE MACCONFIGDRX <PARAMETERS>
Request parameters
101
MAC layer commands
Reserved Int 0 0
Reserved Int 0 0
Reserved
Reserved Int 0 0
shotDrxEnable Int 0 1
102
MAC layer commands
0 - Disable
1 – Enable
(
2, 5, 8, 10, 16, 20, 32, 40, 64, 80,
shortDRX-Cycle Enum 128, 160, 256, 320, 512, 640
drxShortCycleTimer Int 1 16
Reserved Int 0 0
Reserved
Reserved Int 0 0
Reserved Int 0 0
Reserved Int 0 0
Reserved Int 0 0
Reserved Int 0 0
)
Reserved for future use
Confirm parameters
103
MAC layer commands
12.11 MacConfigPCHGRANT
Scope
This command must be used with the MacConfigDlSch command as part of a sequence of
Activate-dependent commands. Activation time is controlled by the Activate command.
Syntax
FORW TE MacConfigPCHGRANT <PARAMETERS>
Request parameters
DCI Format
Int 0,1
0 – DCI Format 1A
1- DCI Format 1 C
0 -- DVRB Off
1 or 2 --- Distribution of VRBs to be done with this gap type.
Reserved Int 0
Reserved
104
MAC layer commands
Reserved Int 0
Reserved
Reserved Int 0
Reserved
Reserved Int 0
Reserved
Reserved Int 0
Reserved
Reserved Int 0
Reserved
Reserved Int 0
Reserved
Confirm parameters
12.12 MacConfigRACH
Configures or modifies MAC RACH parameters
Scope
This command must be used with the PhyConfigPrach command as part of a sequence of Activate-
dependent commands. Activation time is controlled by the Activate command.
Description
This command must be used if a logical channel uses a transport channel type of DL-SCH.
Syntax
FORW TE MACCONFIGRACH <PARAMETERS>
105
MAC layer commands
Request parameters
RA ResponseWindowSize Enum 2 10
[ Bool 0 1 0
] Enable – 1
Disable - 0
Confirm parameters
12.13 MacConfigRAR
MAC CONFIG RAR parameters
Scope
This command must be used with the MacConfigDlSch command as part of a sequence of
Activate-dependent commands. Activation time is controlled by the Activate command.
Description
This command must be used to configure RAR at MAC level. The maximum number of entries
available is 20 for different configurations of RAR.
Syntax
FORW TE MACCONFIGRAR <PARAMETERS>
106
MAC layer commands
Request parameters
[ Int 1 20
Number of Entries
Number of entries supplied in this command
]
[ Int 0 15 0
Backoff Indication
Back off indication value used for the transmission of random access
] response.
[ Int 0 1 0
Hopping Flag
Hopping flag value used in random access response.
]
CQI Request Flag Int -1,0,1
107
MAC layer commands
[ Int 0 99 0
Msg3 RB Start
RB Start value used in Random Access Response.
]
TPC Int -1,0...7
[ Int 0 1 0
UL Delay
UL delay flag used for the transmission of MSG3.
]
DCI Format Int 0 1 0
DCI Format
0 – DCI 1A
1- DCI 1C
Int 0 2 0
NGap Type
0 -- DVRB Off
1 or 2 --- Distribution of VRBs to be done with this gap type.
doNotSendRAR Int 0 1 0
Reserved Int 0 0 0
Reserved Int 0 0 0
Reserved Int 0 0 0
}
Reserved for future use
108
MAC layer commands
Confirm parameters
12.14 MacConfigSchdBaseSr
Scope
This command is used to configure MAC to handle Scheduling request and must be used with the
MacConfigDlSch command as part of a sequence of Activate-dependent commands. Activation
time is controlled by the Activate command.
Syntax
FORW TE MacConfigSchdBaseSr <PARAMETERS>
Request parameters
Sr Enabled Int 0 1
0 – Disabled SR
1- Enabled SR
(If SR is enabled)
( Enum 1, 4,8,16,32,64
NumGrants
1 – sf1
4 – sf4
8 – sf8,
16 – sf16,
32 – sf32,
64 – sf64
SR prohibit timer
)
Reference: Spec 36.321 and 36.331
[ Int 0 155
SR ConfigIndex
sr-ConfigIndex
]
Reference: Spec 36.321 and 36.331
109
MAC layer commands
[ Int 0 2047
PucchResourceIndex
sr-PUCCH-ResourceIndex
]
Reference: Spec 36.321 and 36.331
Confirm parameters
12.15 MacConfigUlCcch
Configures or modifies a UL CCCH logical channel to decode
Scope
This command must be used with the MacConfigUlSch command as part of a sequence of
Activate-dependent commands. Activation time is controlled by the Activate command.
Description
This command is used to configure or modify an existing UL CCCH logical channel at the MAC
layer.
Syntax
FORW TE MACCONFIGULCCCH <PARAMETERS>
Request parameters
Confirm parameters
110
MAC layer commands
12.16 MacConfigUlDcch
Configures or modifies UL DCCH logical channel to decode
Scope
This command must be used with the MacConfigUlSch command as part of a sequence of Activate
commands. Activation time is controlled by the Activate command.
Description
This command is used to configure or modify an existing UL DCCH logical channel at the MAC
layer.
Syntax
FORW TE MACCONFIGULDCCH <PARAMETERS>
Request parameters
{ Int 0 27
> Logical channel identity
Uplink logical channel identity for DCCH
}
NOTE: ONLY Logical Channel Identities 1 – 10 are valid. Rest of the
Identities are left for the user to test their own scenarios
Confirm parameters
12.17 MacConfigUlDtch
Configures or modifies UL DTCH logical channel to decode
Scope
This command must be used with the MacConfigUlSch command as part of a sequence of
Activate-dependent commands. Activation time is controlled by the Activate command.
Description
This command is used to configure or modify an existing UL DTCH logical channel at the MAC
layer.
111
MAC layer commands
Syntax
FORW TE MACCONFIGULDTCH <PARAMETERS>
Request parameters
{ Int 0 27
> Logical channel identity
Uplink logical channel identity for DTCH
}
NOTE: Only a logical channel identity of 1 – 10 is valid. The rest of the
Identities are left for the user to test their own scenarios.
Confirm parameters
12.18 MacConfigUlsch
Configures or modifies MAC UL-SCH parameters
Scope
This command must be used with the PhyConfigUlSch command as part of a sequence of
Activate-dependent commands. Activation time is controlled by the Activate command.
Description
This command must be used if a logical channel uses a transport channel type of UL-SCH.
Syntax
FORW TE MACCONFIGULSCH <PARAMETERS>
Request parameters
112
MAC layer commands
14-1.4 MHz, 3-3 MHz, 5-5MHz, 10-10 MHz, , 15-15 MHz, 20-20 MHz
[ Int 0 1 0
Dynamic Scheduling
]
Confirm parameters
12.19 MacConfigUlSPS
Configures or modifies MAC SPS parameters
Scope
This command must be used with MacConfigDlSch commands as part of a sequence of Activate-
dependent commands.
Description
This command must be used if a logical channel uses semi-persistent scheduling.
Syntax
FORW TE MACCONFIGULSPS <PARAMETERS>
Request parameters
113
MAC layer commands
sf10 = 10,
sf20 = 20,
sf32 = 32,
sf40 = 40,
sf64 = 64,
sf80 = 80,
sf128 = 128,
sf160 = 160,
sf320 = 320,
sf640 = 640
Number RB Int 1 98
1...98 = The values within this range that can be used for a
transmission are 1 or products of the primes 2, 3 and/or 5
This parameter is ignored if the ‘RB Start’ parameter is set to
‘Signalled value’.
114
MAC layer commands
Confirm parameters
12.20 MacDeConfigDRX
Deconfigures MAC DRX parameters
Scope
This command must be used with the PhyConfigDlSch command as part of a sequence of
Activate-dependent commands. Activation time is controlled by the Activate command.
Description
This command must be used to deconfigure discontinuous reception.
Syntax
FORW TE MacDeConfigDRX<PARAMETERS>
Request parameters
115
MAC layer commands
Confirm parameters
12.21 MacDeConfigSPS
Deconfigures MAC SPS parameters
Scope
This command must be used with the PhyConfigDlSch command as part of a sequence of
Activate-dependent commands. Activation time is controlled by the Activate command.
Description
This command must be used to deconfigure semi-persistent scheduling (SPS).
Syntax
FORW TE MacDeConfigSPS<PARAMETERS>
Request parameters
Confirm parameters
12.22 MacDeleteLogCh
Deletes the logical channel of type and identity
Scope
This command is available only in MAC_MODE. This command fails if the specified logical channel
is not yet active. Deletion time of the specified logical channel is controlled by the Activate
command.
Description
This command is used to delete a logical channel at the MAC layer, transport channels, physical
channels, HARQ entities and data entities associated with this logical channel, but are not
associated with another logical channel, are also deleted.
116
MAC layer commands
Syntax
FORW TE MACDELETELOGCH <PARAMETERS>
Request parameters
Confirm parameters
117
13 RLC layer commands
These commands can be used in the following modes MAC_MODE, RLC_MODE, PDCP_MODE
and FULL_PROTOCOL_MODE where explicitly stated. Unless stated otherwise in the command
description, these can only be used after STRT has been issued. Radio bearer identities may be
reused to create bidirectional radio bearers with one radio bearer identity
13.1 RlcConfigAmRb
Configures or modifies bidirectional AM radio bearer
Scope
This command must be used with the MacConfigUlDtch or MacConfigUlDcch command together
with the MacConfigDlDtch or MacConfigDlDcch command as part of a sequence of Activate-
dependent commands. Activation time is controlled by the Activate command.
Description
This command is used to configure or modify an existing AM radio bearer at the RLC layer.
When modifying a radio bearer, the logical channel identities cannot be modified.
Syntax
FORW TE RLCCONFIGAMRB <PARAMETERS>
Request parameters
{ Int 0 34
> Radio Bearer Identity
0 = SRB0
1 = SRB1
2 = SRB2
3...34 = DRB1…DRB32(DTCH)
118
RLC layer commands
> Reordering timer Int 0, 5, 10, 15, 20, 25, 30, 35,
40, 45, 50, 55, 60, 65, 70, 75,
80, 85, 90, 95, 100, 110, 120,
130, 140, 150, 160, 170, 180,
190, 200
In ms.
Detection time of residual HARQ error
0 = Disabled
> Status prohibit timer Int 0, 5, 10, 15, 20, 25, 30, 35,
40, 45, 50, 55, 60, 65, 70, 75,
80, 85, 90, 95, 100, 105, 110,
115, 120, 125, 130, 135, 140,
145, 150, 155, 160, 165, 170,
175, 180, 185, 190, 195, 200,
205, 210, 215, 220, 225, 230,
235, 240, 245, 250, 300, 350,
400, 450, 500
In ms
Minimum time between status receptions of a status PDU.
0 = Disabled
> Transmit SDU discard timer Int 0, 10, 20, 30, 40, 50, 60, 70,
80, 90, 100, 250, 300, 500,
750, 1000, 1250, 1500, 1750,
2000, 3000, 3500, 4000,
4500, 5000, 7500
In ms.
Timer based SDU discard
0 = Disabled
In PDCP mode this must be set to '0'.
> Poll retransmit Int 0, 5, 10, 15, 20, 25, 30, 35,
40, 45, 50, 55, 60, 65, 70, 75,
80, 85, 90, 95, 100, 105, 110,
115, 120, 125, 130, 135, 140,
145, 150, 155, 160, 165, 170,
175, 180, 185, 190, 195, 200,
205, 210, 215, 220, 225, 230,
235, 240, 245, 250, 300, 350,
400, 450, 500
In ms.
Time between retransmission of a poll
0 = Disabled
> Maximum Retransmission Int 0, 1, 2, 3, 4, 6, 8, 16, 32
Threshold
Indicates the limit of the number of retransmissions of a PDU.
0 = unlimited retransmissions
> Poll Bytes Int 0 , 25, 50, 75, 100, 125, 250,
375, 500, 750, 1000, 1250,
1500, 2000, 3000
Indicates the value of constant Poll Bytes in Kbytes.
0 = infinite Poll Bytes
> Poll PDU Int 0, 4, 8, 16, 32, 128, 256, 384
} Indicates the number of PDUs for which a poll is triggered.
0 = Polling disabled.
[ Bool 0 1 0
Reset This parameter is ignored if not modifying
] 1 = Clear radio bearer state
0 = Maintain radio bearer state
119
RLC layer commands
Confirm parameters
13.2 RlcConfigDlTmRb
Configures or modifies DL TM radio bearer
Scope
This command must be used with the MacConfigDlDBcch, MacConfigDlDtch, MacConfigDlCcch or
MacConfigDlDcch command as part of a sequence of Activate-dependent commands. Activation
time is controlled by the Activate command.
Description
This command is used to configure or modify an existing downlink TM radio bearer at the RLC
layer.
When modifying a radio bearer, you cannot amend the logical channel identity.
Syntax
FORW TE RLCCONFIGDLTMRB <PARAMETERS>
Request parameters
{ Int -3 34
> Radio Bearer Identity
-3 = BCCH-DL-SCH
-2 = BCCH
-1 = PCCH
0 = SRB0
1 = SRB1
2 = SRB2
3...34 = DRB1…DRB32(DTCH)
120
RLC layer commands
Confirm parameters
13.3 RlcConfigDlUmRb
Configures or modifies DL UM radio bearer
Scope
This command must be used with the MacConfigDlDtch, MacConfigDlCcch or MacConfigDlDcch
command as part of a sequence of Activate-dependent commands. Activation time is controlled by
the Activate command.
Description
This command is used to configure or modify an existing downlink UM radio bearer at the RLC
layer.
When modifying a radio bearer, you cannot amend the logical channel identity.
Syntax
FORW TE RLCCONFIGDLUMRB <PARAMETERS>
Request parameters
121
RLC layer commands
{ Int 0 34
> Radio Bearer Identity
0 = SRB0
1 = SRB1
2 = SRB2
3...34 = DRB1…DRB32(DTCH)
Confirm parameters
13.4 RlcConfigUlTmRb
Configures or modifies UL TM radio bearer
Scope
This command must be used with the MacConfigUlDtch, MacConfigUlDcch or MacConfigUlCcch
command as part of a sequence of Activate-dependent commands. Activation time is controlled by
the Activate command.
Description
This command is used to configure and, or modify an existing uplink TM radio bearer at the RLC
layer.
122
RLC layer commands
When modifying a radio bearer, you cannot amend the logical channel identity.
Syntax
FORW TE RLCCONFIGULTMRB <PARAMETERS>
Request parameters
{ Int 0 34
> Radio Bearer Identity
0 = SRB0
1 = SRB1
2 = SRB2
3...34 = DRB1…DRB32(DTCH)
Confirm parameters
13.5 RlcConfigUlUmRb
Configures or modifies UL UM radio bearer
Scope
This command must be used with the MacConfigUlDtch, MacConfigUlDcch or MacConfigUlCcch
command as part of a sequence of Activate-dependent commands. Activation time is controlled by
the Activate command.
Description
This command is used to configure or modify an existing uplink UM radio bearer at the RLC layer.
When modifying a radio bearer, you cannot amend the logical channel identity.
123
RLC layer commands
Syntax
FORW TE RLCCONFIGULUMRB <PARAMETERS>
Request parameters
{ Int 0 34
> Radio Bearer Identity
0 = SRB0
1 = SRB1
2 = SRB2
3...34 = DRB1…DRB32(DTCH)
In ms.
Detection time of loss of RLC PDUs at lower layer.
0 = Disabled
[ Bool 0 1 0
Reset This parameter is ignored if not modifying
] 1 = Clear radio bearer state
0 = Maintain radio bearer state
Confirm parameters
124
RLC layer commands
13.6 RlcDeleteRb
Deletes the radio bearer
Scope
This command is only available in RLC_MODE. This command fails if the specified radio bearer is
not active. Deletion time of the specified radio bearer is controlled by the Activate command.
Description
This command is used to delete a radio bearer at the RLC layer.
Logical channels, transport channels, physical channels, HARQ entities and data entities
associated with this radio bearer that are not associated with another radio bearer, are also
deleted. Bidirectional radio bearers delete their uplink and downlink components.
Syntax
FORW TE RLCDELETERB <PARAMETERS>
Request parameters
Confirm parameters
125
14 PDCP layer access bearer commands
These commands can only be used in PDCP_MODE and FULL_PROTOCOL_MODE, and only
after STRT is issued.
14.1 PdcpActivateSecurity
Activate security at PDCP
Scope
This command must be used with the PdcpConfigAb and PdcpConfigSecurity command as part of
a sequence of Activate-dependent commands. This command is only available in PDCP_MODE
and FULL_PROTOCOL_MODE. This command fails if the specified access bearer is not active.
Description
This command is used to configure the security on an access bearer, or modify the activated
security of an existing access bearer at the PDCP layer. This command is only available in
PDCP_MODE and FULL_PROTOCOL_MODE.
This command is used to activate the security at the PDCP layer.
Syntax
FORW TE PDCPACTIVATESECURITY <PARAMETERS>
Request parameters
{ Int 1 34
> PDCP access bearer id
Access bearer identity
1 … 34 = DCCH, DTCH
126
PDCP layer access bearer commands
0 = Disable
1 = Enable
2 = Reconfigure
Option 2 should only be used if user wants to perform handover using
DLSIGDATAREQ with delivery indication set to 3 and
PDCPCONFIGSECURITY with Ciphering Info Present and Integrity Info
Present set to 2
} 0 = Bidirectional
1 = Uplink
2 = Downlink
Confirm parameters
14.2 PdcpConfigAb
Configures or modifies PDCP access bearer
Scope
This command must be used with the RlcConfigDlTmRb, RlcConfigDlUmRb, RlcConfigUlTmRb,
RlcConfigUlUmRb or RlcConfigAmRb command as part of a sequence of Activate-dependent
commands. Activation time is controlled by the Activate command.
Description
This command is used to configure or modify an existing access bearer at the PDCP layer. A radio
bearer is needed to activate this access bearer.
Syntax
FORW TE PDCPCONFIGAB <PARAMETERS>
Request parameters
{ Int -3 34
127
PDCP layer access bearer commands
128
PDCP layer access bearer commands
( Int 1 16383 15
> Max CID Indicates the value of the MAX_CID parameter as specified in 36.323
)
} A bit field of 8 bits indicating the required RoHC profiles.
The bit allocation is as follows, where setting the bit indicates that the
profile is required:
Confirm parameters
14.3 PdcpConfigSecurity
Configures or modifies security at PDCP
This command is only available in PDCP_MODE and FULL_PROTOCOL_MODE. This command
fails if the specified access bearer is not active.
Scope
This command is only available in PDCP_MODE and FULL_PROTOCOL_MODE.
Description
This command is used to configure the security at the PDCP layer.
Syntax
FORW TE PDCPCONFIGSECURITY <PARAMETERS>
Request parameters
Note: Either of Ciphering Info or Integrity Info must be present.
129
PDCP layer access bearer commands
( HEX STRING
Enum 0 1 0
Supported Ciphering
Algorithm
0 = NULL
)
1= Encryption algorithm SNOW 3G
2 = EPS encryption algorithm AES-128
( HEX STRING
Integrity Key [16]
Integrity Key of length 16 octets
Enum 0 1 0
Supported Integrity
Algorithm
) 0 = NULL
1= Encryption algorithm SNOW 3G
2 = EPS encryption algorithm AES-128
Confirm parameters
130
PDCP layer access bearer commands
14.4 PdcpDeleteAb
Deletes the PDCP access bearer
Scope
This command is only available in PDCP_MODE and FULL_PROTOCOL_MODE. This command
fails if the specified access bearer is not active. Deletion time of the specified access bearer is
controlled by the Activate command.
Description
This command is used to delete an access bearer at the PDCP layer. radio bearers, logical
channels, transport channels, physical channels, HARQ entities and data entities associated with
this access bearer that are not associated with another access bearer, are also deleted.
Syntax
FORW TE PDCPDELETEAB <PARAMETERS>
Request parameters
Confirm parameters
131
PDCP layer access bearer commands
14.5 ResetPdcpAb
Deletes the PDCP access bearer
Scope
This command is only available in PDCP_MODE and FULL_PROTOCOL_MODE. This command
fails if the specified access bearer is not active.
Description
This command is used to delete the PDCP access bearer
Syntax
FORW L2 PDCP RESETPDCPAB <PARAMETERS>
Request parameters
Confirm parameters
132
15 Data entity commands
This set of commands is used to set up data entities and to define whether they are uplink,
downlink or bidirectional. Data entities are defined as follows:
15.1 DeAddDlDataProfileEntry
NOTE: This command is not currently supported.
Configure data profile entry to add to a data profile
Scope
This command is only available in RLC_MODE, PDCP_MODE and FULL_PROTOCOL_MODE.
This command must be used with the DeConfigDlDataProfile command as part of a sequence of
Activate-dependent commands. Activation time is controlled by the Activate command.
Description
This command is used to add a data profile entry to a data profile of a data entity. The maximum
number of entries allowed for a data profile is 10,000. However, this command can be used more
than once to add more than 255 entries to the profile.
Note: If the number of SDUs to generate in a period exceeds the time allowed for generation in a
period, then the number of SDUs is truncated for that period.
Syntax
FORW TE DEADDDLDATAPROFILEENTRY <PARAMETERS>
133
Data entity commands
Request parameters
{ Int 0 1500
The ‘Number of SDUs’ multiplied by ‘Size of SDU’ must not exceed 4500
bytes
This field is ignored if 'Number of SDUs' is zero.
Int -1, 0…
> Time period to wait 1000
before using next entry
}
-1 = One shot (does not perform another profile entry)
0 = allows different SDU sizes to be added to the last non-zero entry
period
1…1000 = Time period to wait before using next entry in 1ms increments
Confirm parameters
15.2 DeAddToFfeBuffer
Add bytes to FFE buffer
Scope
This command must be used with the DeConfigFfeAttrib command as part of a sequence of
Activate-dependent commands. Activation time is controlled by the Activate command.
Description
This command is used to add bytes to a buffer of an FFE data entity and can be used more than
once to add more than 255 bytes to the buffer.
Syntax
FORW TE DEADDTOFFEBUFFER <PARAMETERS>
134
Data entity commands
Request parameters
Buffer identifier
{ Int 0 255
Confirm parameters
15.3 DeAddToFfgBuffer
Add bytes to FFG buffer
Scope
This command must be used with the DeConfigFfgAttrib command as part of a sequence of
Activate-dependent commands. Activation time is controlled by the Activate command.
Description
This command is used to add bytes to a buffer of an FFG data entity and can be used more than
once, to add more than 255 bytes to the buffer. The maximum size of a buffer is 3125 bytes.
Syntax
FORW TE DEADDTOFFGBUFFER <PARAMETERS>
Request parameters
135
Data entity commands
Buffer identifier
{ Int 0 255
Confirm parameters
15.4 DeConfigAb
Configure access bearer data entity
Scope
This command is only available in PDCP_MODE and FULL_PROTOCOL_MODE. This command
must be used with the PdcpConfigAb command as part of a sequence of Activate-dependent
commands. Activation time is controlled by the Activate command.
Description
This command is used to configure an access bearer data entity. When used to modify the data
entity of an access bearer, all of the associated attributes are cleared and must be re-applied. For
bidirectional access bearers, where the same access bearer ID is used for uplink and downlink, a
bidirectional data entity type must be applied to the data entity using DeConfigTdiAttrib or
DeConfigIPAttrib, or a generator using DeConfigFfgAttrib or DeConfigPngAttrib, and evaluator type
using DeConfigPneAttrib or DeConfigFfeAttrib.
Syntax
FORW TE DECONFIGAB <PARAMETERS>
Request parameters
136
Data entity commands
[ Enum 0 2 0
Direction
Direction of data entity
]
0 = Bidirectional
1 = Uplink
2 = Downlink
Confirm parameters
15.5 DeConfigDlDataProfile
NOTE: This command is not currently supported.
Configure data entity as data profile
Scope
This command is only available in RLC_MODE, PDCP_MODE and FULL_PROTOCOL_MODE.
This command must be used with the DeConfigFfgAttrib or DeConfigPngAttrib command as part of
a sequence of Activate-dependent commands. Activation time is controlled by the Activate
command.
Description
This command is used to configure a data profile for a data entity. Entries can be added to the
profile using the DeAddDlDataProfileEntry command.
Syntax
FORW TE DECONFIGDLDATAPROFILE <PARAMETERS>
Request parameters
137
Data entity commands
Confirm parameters
15.6 DeConfigEDIPAttrib
NOTE: This command is not currently supported.
Configure TCP/IP data interface with external application
Scope
This command must be used with the DeConfigRb or DeConfigAb command as part of a sequence
of Activate-dependent commands. Activation time is controlled by the Activate command.
Description
This command is used to configure a TCP socket to a data entity for either user plane or control
plane data transmission to or from an external application. When this is used for Signalling Radio
Bearer data transmission, the same port number must be used in TEDIP Attributes.
Syntax
FORW TE DECONFIGEDIPATTRIB <PARAMETERS>
Request parameters
Confirm parameters
138
Data entity commands
15.7 DeConfigFfeAttrib
Configure FFE attribute for a data entity
Scope
This data entity attribute may only be associated with an uplink or bidirectional channel or bearer.
This command must be used with the DeConfigLogCh, DeConfigRb or DeConfigAb command as
part of a sequence of Activate-dependent commands. Activation time is controlled by the Activate
command.
Description
This command is used to configure a FFE for a data entity. The buffer of the FFE is filled using the
DeAddToFfeBuffer command.
Syntax
FORW TE DECONFIGFFEATTRIB <PARAMETERS>
Request parameters
[ Bool 0 1 0
[ Int 0 100 0
Number of bits to skip Number of bits to skip from the start of the PDU in the evaluation
[ Int -1 160000 -1
Number of bits to check Number of bits to check of the PDU in the evaluation following the last
skipped bit.
]
If zero bits are skipped, the checked bits start with the first bit of the PDU.
-1 = Check all un-skipped bits in PDU
Confirm parameters
139
Data entity commands
15.8 DeConfigFfgAttrib
Configure FFG attribute for a data entity
Scope
This data entity attribute may only be associated with a downlink or bidirectional channel or bearer. This
command must be used with the DeConfigLogCh, DeConfigRb or DeConfigAb command as part of a
sequence of Activate-dependent commands. Activation time is controlled by the Activate command.
Description
This command is used to configure a FFG for a data entity. The buffer of the FFG is filled using the
DeAddToFfgBuffer command.
Syntax
FORW TE DECONFIGFFGATTRIB <PARAMETERS>
Request parameters
[ Int 0 255 0
Padding byte value
Padding byte value to use on under run
]
Confirm parameters
15.9 DeConfigIPAttrib
Configure IP driver routes attribute for data entity
Scope
This command is only available in RLC_MODE, PDCP_MODE and FULL_PROTOCOL_MODE.
This data entity attribute can be bidirectional. This command must be used with the
DeConfigLogCh, DeConfigRb or DeConfigAb command as part of a sequence of Activate-
dependent commands. Activation time is controlled by the Activate command.
140
Data entity commands
Description
This command is used to configure an IP driver route for a data entity.
Syntax
FORW TE DECONFIGIPATTRIB <PARAMETERS>
Request parameters
0 – IPV4
1 – IPV6
2- IPV4V6
3 – nackIPV6
4 – nackIPV4V6
Int 0 1
(
IP Version Info
)
)
String 0.0.0.0 or 255.255
0:0:0:0:0:0: .255.25
> IP address 0:0 5 or
ffff:ffff:fff
f:ffff:ffff:f
fff:ffff:ffff
IP address in dotted notation in decimal format for IPv4 and in hexadecimal
format for IPv6.
This is the IP address of the source or destination field in the IP packet
header to route to a particular ‘data entity id’ in the UL.
Use 0.0.0.0 or 0:0:0:0:0:0:0:0 when specifying an entry for a UL channel.
141
Data entity commands
[ Enum 0 1 0
[ Bool 0 1 0
[ Int 0 65535 0
[ Int 0 65535 0
Confirm parameters
15.10 DeConfigLogCh
Configure logical channel data entity
Scope
This command is only available in MAC_MODE. This command must be used with the
MacConfigDlDBcch, MacConfigDlDtch, MacConfigDlDcch, MacConfigUlDtch or MacConfigUlDcch
command as part of a sequence of Activate-dependent commands. Activation time is controlled by
the Activate command.
142
Data entity commands
Description
This command is used to configure a logical channel data entity. When used to modify a data entity
for a logical channel, all the associated attributes are cleared and must be re-applied. For
bidirectional logical channels where the same logical channel identity is used for uplink and
downlink, a bidirectional data entity type must be applied to the data entity using DeConfigTdiAttrib,
or a generator using DeConfigFfgAttrib or DeConfigPngAttrib, and evaluator type using
DeConfigPneAttrib or DeConfigFfeAttrib.
Syntax
FORW TE DECONFIGLOGCH <PARAMETERS>
Request parameters
[ Enum 0, 1, 2, 5, 6, 8
( Int 0 27
>DL logical channel identity
) Logical channel identifier
[ Enum 3,4,7
UL logical channel type
Logical channel type
3 = Uplink DCCH
4 = Uplink DTCH
7 = Uplink CCCH
143
Data entity commands
Confirm parameters
15.11 DeConfigPneAttrib
Configure PNE attribute for data entity
Scope
This data entity attribute can only be associated with an uplink or bidirectional channel or bearer.
This command must be used with the DeConfigLogCh, DeConfigRb or DeConfigAb command as
part of a sequence of Activate-dependent commands. Activation time is controlled by the Activate
command.
Description
This command is used to configure a PNE for a data entity.
Syntax
FORW TE DECONFIGPNEATTRIB <PARAMETERS>
Request parameters
0 = PN32
1 = PN15
2 = PN9
3 = Inverse PN32
4 = Inverse PN15
5 = Inverse PN9
[ Bool 0 1 0
[ Bool 0 1 0
[ Int 0 100 0
144
Data entity commands
Number of bits to skip Number of bits of skip at the start of the PDU in the evaluation
[ Int -1 160000 -1
Number of bits to check Number of bits to check of the PDU in the evaluation following the last
] skipped bit.
If zero bits are skipped, the checked bits start with the first bit of the PDU.
-1 = Check all un-skipped bits in PDU
Confirm parameters
15.12 DeConfigPngAttrib
Configure PNG attribute for data entity
Scope
This data entity attribute may only be associated with a downlink or bidirectional channel or bearer.
This command must be used with the DeConfigLogCh, DeConfigRb or DeConfigAb command as
part of a sequence of Activate-dependent commands. Activation time is controlled by the Activate
command.
Description
This command is used to configure a PNG for a data entity.
Syntax
FORW TE DECONFIGPNGATTRIB <PARAMETERS>
Request parameters
145
Data entity commands
0 = PN32
1 = PN15
2 = PN9
3 = Inverse PN32
4 = Inverse PN15
5 = Inverse PN9
[ Bool 0 1 0
Restart sequence
0 = Continuous sequence
]
1 = Restart on every SDU boundary
Confirm parameters
15.13 DeConfigPPPoEAttrib
Configure an IP port attribute for a data entity
Scope
This data entity attribute is bidirectional. This command must be used with DeConfigAb command
as part of a sequence of Activate-dependent commands. Activation time is controlled by the
Activate command. This command can be used only in FULL_PROTOCOL_MODE or
PDCP_MODE.
Description
This command is used to configure a TCP/IP socket for a data entity.
Syntax
FORW TE DECONFIGPPPOEATTRIB <PARAMETERS>
Request parameters
0 = Default
1 = Dedicated
146
Data entity commands
Confirm parameters
15.14 DeConfigRb
Configure radio bearer data entity
Scope
This command is only available in RLC_MODE. This command must be used with the
RlcConfigDlTmRb, RlcConfigDlUmRb, RlcConfigUlTmRb, RlcConfigUlUmRb or RlcConfigAmRb
command as part of a sequence of Activate-dependent commands. Activation time is controlled by
the Activate command.
Description
This command is used to configure a radio bearer data entity. When used to modify the data entity
for a radio bearer, all the associated attributes are cleared and must be re-applied. For bidirectional
radio bearers, where the same radio bearer ID is used for uplink and downlink, a bidirectional data
entity type must be applied to the data entity using DeConfigTdiAttrib or DeConfigIPAttrib, or both
unidirectional attribute types of a generator using DeConfigFfgAttrib or DeConfigPngAttrib, and
evaluator type using DeConfigPneAttrib or DeConfigFfeAttrib.
Syntax
FORW TE DECONFIGRB <PARAMETERS>
Request parameters
[ Enum 0 2 0
147
Data entity commands
Confirm parameters
15.15 DeConfigTdiAttrib
NOTE: This command is not currently supported.
Configure TCP/IP port attribute for a data entity
Scope
This data entity attribute can be bidirectional. This command must be used with the
DeConfigLogCh, DeConfigRb or DeConfigAb command as part of a sequence of Activate-
dependent commands. Activation time is controlled by the Activate command.
Description
This command is used to configure a TCP socket for a data entity. On the downlink, only whole
SDUs are filled. If there is not enough data from the socket to fill the SDU, then the padding byte
value is used to fill the entire SDU.
Syntax
FORW TE DECONFIGTDIATTRIB <PARAMETERS>
Request parameters
148
Data entity commands
[ Int 1 1500 2
[ Int 0 255 0
Padding byte value Padding byte value to use on under-run on the uplink
Confirm parameters
15.16 DeConfigUdiAttrib
Configure a UDP/IP port attribute for a data entity
Scope
This data entity attribute can be bidirectional. This command must be used with the
DeConfigLogCh, DeConfigRb or DeConfigAb command as part of a sequence of Activate-
dependent commands. Activation time is controlled by the Activate command.
Description
This command is used to configure a UDP socket for a data entity. On the downlink, only whole
SDUs are filled. If there is not enough data in the packet from the socket to fill the SDU then the
padding byte value is used to fill the entire SDU.
Syntax
FORW TE DECONFIGUDIATTRIB <PARAMETERS>
Request parameters
149
Data entity commands
Unique UDP/IP port number used for DL data for this data entity.
Use 0 when specifying an entry for a UL only channel.
Maximum source UDP Int 1 12500
packet size
Maximum UDP packet size for DL data.
Packets received for the DL that are greater than this size are discarded.
Ignored if ‘Source UDP port number’ is zero.
[ Int 0, 0
10 … 12
Uplink UDP segment size 500
] 0 = Each transport block in the UL is sent to destination IP in one UDP
packet
10…12500 = Segment transport block into multiple UDP packets. The
numbers of UDP packets sent are equal to ‘TrBlk size’ divided by ‘Uplink
UDP segment size’ rounded up to the closest integer value.
Ignored if not using HARQ_MODE or if ‘Destination UDP port number’ is
zero.
[ Int 0 6250 0
[ Int 0 150 0
[ Int 0 255 0
Padding byte value Padding byte value to use on under-run on the uplink.
]
Confirm parameters
150
16 RRC signaling commands/indications
16.1 DlSigDataReq
RRC Downlink signaling data Request command
Scope
This command is only available in FULL_PROTOCOL_MODE. This command must be used when
the signaling path from RRC to L1 has been established. It is independent of the Activate
command.
Description
This command sends the RRC signaling data from the 7100 to the UE.
Syntax
FORW TE DLSIGDATAREQ <PARAMETERS>
Request parameters
Length of data
Confirm parameters
151
RRC signaling commands/indications
CELL_NUMBER Identification of the Cell using which signalling data path has
been established
TRANSACTION ACCEPTANCE Indicates whether or not the test entity accepted the
received PDU
1 = TE accepted the PDU
0 = TE rejected the received PDU
16.2 UlSigDataAck
RRC Downlink Signalling Data Acknowledgement
Note: UlSigDataAck is not a command and, as such it cannot be issued from the UI. This has been
included in the CRM only to show that such an ACK can come from the UE.
Scope
This ACK is only available in FULL_PROTOCOL_MODE.
Description
This ACK is sent by the UE to the 7100 in response to the RRC downlink data being sent in AM
mode with delivery indication set to True.
Syntax
ULSIGDATAACK <PARAMETERS>
Indication parameters
deliveryInd Int 0 1
152
RRC signaling commands/indications
16.3 UlSigDataInd
RRC Uplink signalling data Indication
Note: UlSigDataInd is not a command, and as such it cannot be issued from the UI. This has been
included in the CRM only to give an understanding that such an indication can come from the UE.
Scope
This indication is only available in FULL_PROTOCOL_MODE.
Description
After successfully transmitting signalling data, the UE sends an IND message to the 7100.
Syntax
ULSIGDATAIND <PARAMETERS>
Indication parameters
Length of data
16.4 SetByPassMode
SetByPassMode is not a command and hence does not yield any result in the command window. It is just
a way to tell the RRCLibrary in 7100 that, all it needs to do is to stop handling the RRC messages as they
are taken care of by another entity.
16.5 ResetByPassMode
ResetByPassMode is not a command and hence does not yield any result in the command window. It
resets the ByPassMode, so that the RRCLibrary in 7100 starts handling the RRC messages again.
153
17 Layer 2 commands
17.1 DrbDataInd
Indication of MAC, RLC or PDCP data PDUs received on the DRB.
Description
Indication of MAC, RLC or PDCP data PDUs received on the DRB. It is received when you enable the
reception of MAC/RLC/PDCP PDUs using RECEIVEINDICATIONS command.
Syntax
DRBDATAIND <cellId> <Rbid> <PduSduType> <No of TTI> <No of PDUs> <{length, pdu}> <sfn> <FN>
Parameters
cellId Int 0 63
Rbid Int 0 10
PduSduType Int 1 4
1 – Mac PDU
2 – RLC PDU
3 – PDCP PDU
4 – PDCP SDU
No of TTI Int 1 65535
FN Int 0 9
154
Layer 2 commands
17.2 GetCQIStats
Gets the CQI periodic or aperiodic status report from the UE.
Description
This command gets the CQI status report from the UE.
Syntax
FORW L2 MAC GETCQISTATS<PARAMETERS>
Request parameter
Indication
CMPI L2 CQISTATINDICATION <PARAMETER>
155
Layer 2 commands
156
Layer 2 commands
17.3 GetCRCStats
Gets the CRC (UL BLER) and HARQ (DL BLER) status
Description
This command is used to get the uplink and down link BLER status.
Syntax
Request parameter
This is the time interval in millisecond for which HARQ and CRC status are calculated for one CRC
HARQ status indication.
Indication
157
Layer 2 commands
17.4 ReceiveIndications
Enables UL data indications
Scope
It can be used in any mode.
Description:
This command enables or disables the reception of UL data for MAC, RLC or PDCP data to the script.
Syntax
FORW L2 <SubLayer> RECEIVEINDICATIONS <cellNum> <enable>
Sublayer
Parameters
enable Int 0 1
158
Layer 2 commands
17.5 ResetPdcpAb
Resets the PDCP access bearer
Scope
This command is only available in PDCP_MODE and FULL_PROTOCOL_MODE. This command
fails if the specified access bearer is not active.
Description
This command is used to reset the PDCP buffer for the particular bearer id.
Syntax
FORW L2 PDCP RESETPDCPAB <PARAMETERS>
Request parameters
Confirm parameters
17.6 SendConfigUlGrant
Sets the UL Grant pattern
Description
Specifies the period and cycle for UL grant.
Syntax
FORW L2 MAC SENDCONFIGULGRANT<PARAMETERS>
Request parameters
159
Layer 2 commands
Subframe Int -1 9
Subframe Number
Period Int 1 50
NoOfGrants Int 1 50
Confirm parameters
17.7 SendCustomMacPdu
Sends the customized data to the on DLSCH channel to the UE
Description
This command is used to send a MAC PDU to the UE from the script.
Syntax
FORW L2 MAC SENDCUSTOMMACPDU <PARAMETERS>
Request parameters
Int 0 63
Cell Number
Identification of cell from user perspective
Int 0 1
Enable
1 – Enable
0 – Disable
Choice ‘Enable’ is 1
160
Layer 2 commands
If Number of Code Word=2, then provide Data Length Code Word 2 and
Data Code Word 2 as next 2 parameters after Data Length Code Word 1
and Data Code Word 1
Length of data
Length of data
Confirm parameters
17.8 SendCustomPDU
Sends PDUs at the specified SFN and SubFrameNumber.
Scope
For sending RLC or PDCP PDUs, the RLC and PDCP have to be configured in TM mode. For MAC
PDUs it can be in any mode.
Description
The command is used for sending the multiple PDUs (at a maximum of 10 at a time) at specified SFN and
SubFrameNumber. In one command you can send one PDU can be sent, so for sending multiple
commands you need to issue the command many times.
Syntax
FORW L2 <SubLayer> SENDCUSTOMPDU <cellNum>
<RBId>
<HarqProcessId>
<SFN>
<SubFrameNumber>
< flagSuppressPdcchForC_RNTI>
<NumberOfCodeWords>
<PDULength>
<Pdu>
161
Layer 2 commands
Sublayer
Parameters:
RBId Int 0 10
HarqProcessId Int
SubFrameNumber Int 0 9
aflagSuppressPdcchFor Int
C_RNTI
Need to be sent only for MAC PDUs. Not currently in use.
NumberOfCodeWords Int 1 2
Length of PDU
PDU
Length of PDU
162
Layer 2 commands
Note: If the NumberOfCodeWords = 2, then there has to be two (PDULength, PDU) pair and this can only
be in case of MAC PDUs.
17.9 SendHarqAckNackStatus
Sends the HARQ ACK or NACK status
Description
This command is used to send the HARQ ACK or NACK status on the command line interface.
After the required number of indications has been received this command has to be sent again with
enable field set to false.
Syntax
FORW L2 MAC SENDHARQACKNACKSTATUS <PARAMETERS>
Request parameters
0-Disable
1-Enable
This is the required interval in ms within which ACK or NACK status is sent.
Indication
CMPI L2 HARQSTATSINDICATION <Parameters>
Indication parameters
,
NumberofNACKCodeword0 Int 0 65535
,
163
Layer 2 commands
17.10 SendMacIndication
Sends the MAC indication
Description
This command is used to send the MAC indications.
Syntax
FORW L2 MAC SENDMACINDICATION<PARAMETERS>
Request parameters
sendRachRarIndication Int 0 1
17.11 SendPDU
Sends PDUs buffered due to the one or more instances of command SENDCUSTOMPDU to the
respective layer (RLC or PDCP or MAC).
Scope
For sending RLC or PDCP PDUs, the RLC and PDCP have to be configured in TM mode. For MAC
PDUs it can be any mode.
Description
For giving all the PDUs buffered to the respective layer.
Syntax
FORW L2 <SubLayer> SENDPDU <cellNum>
Sublayer
164
Layer 2 commands
Parameters
17.12 SetCountReq
Sets the PDCP count
Description
This command is used to set the PDCP count for one or more ABs configured at the PDCP layer.
Syntax
FORW L2 PDCP SETCOUNTREQ <PARAMETERS>
Request parameters
{ Int 0 10
>RB Id
AB Id whose PDCP count is to be set.
The UL PDCP Count to be set. Set this field to -1 in case UL PDCP Count is
not required to be set.
165
Layer 2 commands
17.13 SetPagingOccasion
Specifies the paging occasion on which paging is to be transmitted from the BSE
Description
This command is used to specify paging occasion on which paging is to be transmitted from the BSE
Syntax
FORW L2 MAC SETPAGINGOCCASSION <PARAMETERS>
Request parameters
SystemFrameNumber
TTI
17.14 GetSystemTimeReq
Get the current value of SFN and Sub Frame Number
Description
This command is used to get the current value of SFN and Sub Frame Number of the Indication
Syntax
FORW L1 GETSYSTEMTIMEREQ <PARAMETERS>
Request parameters
166