100% found this document useful (1 vote)
512 views

7100 Command Reference Manual

Aeroflex 7100 Command Ref Manual

Uploaded by

Pavel Schukin
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
100% found this document useful (1 vote)
512 views

7100 Command Reference Manual

Aeroflex 7100 Command Ref Manual

Uploaded by

Pavel Schukin
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 166

7100 Digital Radio Test Set

Part number 46892/997


7100 Release 18.2.0.0
FDD and TDD Command Reference Manual

© Aeroflex International Ltd. 2012


Longacres House
Six Hills Way
Stevenage SG1 2AN
UK

No part of this document may be reproduced or transmitted in any form


or by any means, electronic or mechanical, including photocopying,
or recorded by any information storage or retrieval system,
without permission in writing by Aeroflex International Ltd.
(hereafter referred to throughout the document as ‘Aeroflex’).

Document part no. 46892/997


Issue 17
30 September 2012
CONTENTS
1  Introduction............................................................................................................................................ 6 
1.1  Purpose.......................................................................................................................................... 6 
1.2  Scope ............................................................................................................................................. 6 
1.3  Intended audience.......................................................................................................................... 6 
1.4  Non-disclosure agreements ........................................................................................................... 6 
1.5  Related documents ........................................................................................................................ 6 
1.6  Abbreviations and acronyms.......................................................................................................... 7 
2  Introduction to the 7100 Command Interface........................................................................................ 9 
2.1  About the command....................................................................................................................... 9 
2.2  Example command description...................................................................................................... 9 
2.2.1  Command prototype ............................................................................................................... 9 
2.2.2  Command confirmations....................................................................................................... 11 
2.2.3  Command indications ........................................................................................................... 11 
3  Administrative commands ................................................................................................................... 12 
3.1  CESC ........................................................................................................................................... 12 
3.2  CHOW.......................................................................................................................................... 12 
3.3  DERR ........................................................................................................................................... 13 
3.4  FORW .......................................................................................................................................... 14 
3.5  GCFG........................................................................................................................................... 15 
3.6  GSTS ........................................................................................................................................... 15 
3.7  GVER ........................................................................................................................................... 15 
3.8  HELP............................................................................................................................................ 16 
3.9  RBOT ........................................................................................................................................... 16 
3.10  RSET ........................................................................................................................................ 17 
3.11  SCFG........................................................................................................................................ 17 
3.12  SetActiveCell ............................................................................................................................ 18 
3.13  SPCM ....................................................................................................................................... 19 
3.14  STIP.......................................................................................................................................... 20 
3.15  STRT ........................................................................................................................................ 21 
4  General commands ............................................................................................................................. 22 
4.1  Activate ........................................................................................................................................ 22 
4.2  ReInit............................................................................................................................................ 23 
5  Measurement commands.................................................................................................................... 24 
5.1  ClearStats .................................................................................................................................... 24 
5.2  GetStats ....................................................................................................................................... 24 
6  Physical layer commands ................................................................................................................... 26 
6.1  Power levels in physical layer commands ................................................................................... 26 
6.2  PhyConfigOCNG.......................................................................................................................... 26 
6.3  PhyConfigRefSignal ..................................................................................................................... 27 
6.4  PhyConfigSyncSignals................................................................................................................. 28 
6.5  PhyConfigUESysCap................................................................................................................... 28 
6.6  PhyDeleteCell .............................................................................................................................. 29 
6.7  PhySetRFParams ........................................................................................................................ 29 
6.8  PhySetSystemParams ................................................................................................................. 30 

ii
Contents

7  Physical layer physical channels......................................................................................................... 32 


7.1  PhyAddUlPowerCtrlTableEntry.................................................................................................... 32 
7.2  PhyConfigDlPrs............................................................................................................................ 33 
7.3  PhyConfigPbch ............................................................................................................................ 34 
7.4  PhyConfigPdcch........................................................................................................................... 35 
7.5  PhyConfigPdsch........................................................................................................................... 36 
7.6  PhyConfigPrach ........................................................................................................................... 37 
7.7  PhyConfigPucch........................................................................................................................... 39 
7.8  PhyConfigPusch........................................................................................................................... 41 
7.9  PhyConfigUlPowerCtrlTable ........................................................................................................ 42 
7.10  PhyConfigUlSrs ........................................................................................................................ 43 
7.11  PhyDeleteUlSrs ........................................................................................................................ 45 
7.12  PhyOverrideReceivedCQI ........................................................................................................ 46 
7.13  PhyReConfigUlSrs.................................................................................................................... 47 
7.14  PhySendUlTpcSequence ......................................................................................................... 49 
8  Physical layer transport channels ....................................................................................................... 51 
8.1  PhyConfigDlSch ........................................................................................................................... 51 
8.2  PhyConfigDlSchCqi...................................................................................................................... 52 
8.3  PhyConfigUlSch ........................................................................................................................... 53 
8.4  PhyReConfigDlSchCqi................................................................................................................. 55 
9  Channel emulation commands............................................................................................................ 57 
9.1  PhyConfigRadioChannel.............................................................................................................. 58 
9.2  PhyConfigAwgn............................................................................................................................ 65 
10  HARQ commands............................................................................................................................ 67 
10.1  HarqAddDlSchAckTableEntry .................................................................................................. 67 
10.2  HarqConfigDlSch...................................................................................................................... 68 
10.3  HarqConfigDlSchAckTable....................................................................................................... 69 
10.4  HarqConfigTransmission.......................................................................................................... 70 
10.5  HarqConfigUlSch...................................................................................................................... 71 
10.6  HarqConfigUlSchOverride........................................................................................................ 72 
11  Scheduler commands ...................................................................................................................... 74 
11.1  ConfigCfiValue.......................................................................................................................... 76 
11.2  ConfigDlGrant........................................................................................................................... 76 
11.3  ConfigUlGrant........................................................................................................................... 77 
11.4  SchedulerAddDlSchCtrlTableEntry .......................................................................................... 78 
11.5  SchedulerAddUlSchCtrlTableEntry .......................................................................................... 82 
11.6  SchedulerConfigDlSchCtrlTable............................................................................................... 84 
11.7  SchedulerConfigUlSchCtrlTable............................................................................................... 85 
12  MAC layer commands ..................................................................................................................... 86 
12.1  MacConfigBCHGRANT ............................................................................................................ 86 
12.2  MacConfigCQI .......................................................................................................................... 87 
12.3  MacConfigDlCcch..................................................................................................................... 88 
12.4  MacConfigDlDBcch .................................................................................................................. 89 
12.5  MacConfigDlDcch..................................................................................................................... 91 
12.6  MacConfigDlDtch...................................................................................................................... 92 
12.7  MacConfigDlPcch ..................................................................................................................... 93 

iii
Contents

12.8  MacConfigDlSch....................................................................................................................... 94 


12.9  MacConfigDlSPS...................................................................................................................... 97 
12.10  MacConfigDrx......................................................................................................................... 101 
12.11  MacConfigPCHGRANT .......................................................................................................... 104 
12.12  MacConfigRACH .................................................................................................................... 105 
12.13  MacConfigRAR....................................................................................................................... 106 
12.14  MacConfigSchdBaseSr .......................................................................................................... 109 
12.15  MacConfigUlCcch................................................................................................................... 110 
12.16  MacConfigUlDcch................................................................................................................... 111 
12.17  MacConfigUlDtch.................................................................................................................... 111 
12.18  MacConfigUlsch ..................................................................................................................... 112 
12.19  MacConfigUlSPS.................................................................................................................... 113 
12.20  MacDeConfigDRX .................................................................................................................. 115 
12.21  MacDeConfigSPS................................................................................................................... 116 
12.22  MacDeleteLogCh.................................................................................................................... 116 
13  RLC layer commands .................................................................................................................... 118 
13.1  RlcConfigAmRb ...................................................................................................................... 118 
13.2  RlcConfigDlTmRb................................................................................................................... 120 
13.3  RlcConfigDlUmRb .................................................................................................................. 121 
13.4  RlcConfigUlTmRb................................................................................................................... 122 
13.5  RlcConfigUlUmRb .................................................................................................................. 123 
13.6  RlcDeleteRb ........................................................................................................................... 125 
14  PDCP layer access bearer commands.......................................................................................... 126 
14.1  PdcpActivateSecurity ............................................................................................................. 126 
14.2  PdcpConfigAb......................................................................................................................... 127 
14.3  PdcpConfigSecurity................................................................................................................ 129 
14.4  PdcpDeleteAb......................................................................................................................... 131 
14.5  ResetPdcpAb.......................................................................................................................... 132 
15  Data entity commands ................................................................................................................... 133 
15.1  DeAddDlDataProfileEntry....................................................................................................... 133 
15.2  DeAddToFfeBuffer ................................................................................................................. 134 
15.3  DeAddToFfgBuffer ................................................................................................................. 135 
15.4  DeConfigAb ............................................................................................................................ 136 
15.5  DeConfigDlDataProfile ........................................................................................................... 137 
15.6  DeConfigEDIPAttrib................................................................................................................ 138 
15.7  DeConfigFfeAttrib ................................................................................................................... 139 
15.8  DeConfigFfgAttrib ................................................................................................................... 140 
15.9  DeConfigIPAttrib..................................................................................................................... 140 
15.10  DeConfigLogCh ...................................................................................................................... 142 
15.11  DeConfigPneAttrib.................................................................................................................. 144 
15.12  DeConfigPngAttrib.................................................................................................................. 145 
15.13  DeConfigPPPoEAttrib ............................................................................................................ 146 
15.14  DeConfigRb ............................................................................................................................ 147 
15.15  DeConfigTdiAttrib ................................................................................................................... 148 
15.16  DeConfigUdiAttrib................................................................................................................... 149 
16  RRC signaling commands/indications ........................................................................................... 151 

iv
Contents

16.1  DlSigDataReq......................................................................................................................... 151 


16.2  UlSigDataAck ......................................................................................................................... 152 
16.3  UlSigDataInd .......................................................................................................................... 153 
16.4  SetByPassMode ..................................................................................................................... 153 
16.5  ResetByPassMode ................................................................................................................. 153 
17  Layer2 commands ......................................................................................................................... 154 
17.1  DrbDataInd ............................................................................................................................. 154 
17.2  GetCQIStats ........................................................................................................................... 155 
17.3  GetCRCStats.......................................................................................................................... 157 
17.4  ReceiveIndications ................................................................................................................. 158 
17.5  ResetPdcpAb.......................................................................................................................... 159 
17.6  SendConfigUlGrant ................................................................................................................ 159 
17.7  SendCustomMacPdu ............................................................................................................. 160 
17.8  SendCustomPDU ................................................................................................................... 161 
17.9  SendHarqAckNackStatus....................................................................................................... 163 
17.10  SendMacIndication................................................................................................................. 164 
17.11  SendPDU................................................................................................................................ 164 
17.12  SetCountReq .......................................................................................................................... 165 
17.13  SetPagingOccasion................................................................................................................ 166 
17.14  GetSystemTimeReq ............................................................................................................... 166 

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.

1.3 Intended audience


This document is meant for:
¾ Customers who are configuring the 7100 for specific test cases in order to test UEs
¾ LTE developers who are designing the software
¾ The GUI team for providing a user-friendly interface to the customer
¾ The RAV team for producing scripts to test the system

1.4 Non-disclosure agreements


This document contains third-party information that is subject to a Non-Disclosure
Agreement (NDA). The sections concerned are clearly annotated. This document must NOT
be disclosed to other parties without appropriate permission from relevant companies.

1.5 Related documents


[1] 3GPP TS 36.331v8.8.0: Evolved Universal Terrestrial Radio Access (E-UTRA); Radio
Resource Control (RRC) protocol specification
[2] 3GPP TS 36.211v8.8.0: Evolved Universal Terrestrial Radio Access (E-UTRA); Physical
Channels and Modulation
[3] 3GPP TS 36.212v8.6.0: Evolved Universal Terrestrial Radio Access (E-UTRA); Multiplexing
and channel coding
[4] 3GPP TS 36.213v8.8.0: Evolved Universal Terrestrial Radio Access (E-UTRA); Physical
layer procedures
[5] 3GPP TS 36.331v9.a.0: Evolved Universal Terrestrial Radio Access (E-UTRA); Radio
Resource Control (RRC) protocol specification

6
Introduction

1.6 Abbreviations and acronyms


The abbreviations and acronyms used in this document are defined below.

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.

2.1 About the command


The System Control Interface is used to send all the scripting commands to the 7100.
The command description includes the scope, usage and the command parameters. Information
about the parameters is presented in tables, in which the following abbreviations are used.

Term Meaning

Int The parameter is an ASCII numeric value


Enum The parameter is an ASCII numeric value where each value is
associated with a specific meaning
Bool The parameter is an ASCII numeric value which can only be a zero or
a one
String The parameter is an ASCII alphanumeric string
HexString The parameter is a hexadecimal string composed of characters a-f (or
A-F) and 0-9
Min The minimum value for a numeric parameter
Max The maximum value for a numeric parameter
Default The default value for a parameter

2.2 Example command description


This section provides an example command, including the syntax and parameter descriptions.

2.2.1 Command prototype


Scope
Describes the test mode in which the command can be used.

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

Parameter name Type Min Max Default


Parameter 1 Int -1 100

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.

[] Denotes an optional parameter


() Denotes a conditional parameter. Conditional Parameters may or may not be present,
subject to the value of some other preceding parameter
{} Denotes a list of parameters
>
>> Meant for indentation purposes

>>>

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

2.2.2 Command confirmations


Confirmation messages returned by the 7100 have the following format:
C: CCCC RETURN_CODE RETURN_TEXT [CONFIRMATION_STRING]
CCCC The four letter administration command (for example, FORW)
RETURN_CODE A hexadecimal code showing success or failure of a command
RETURN_TEXT A text description of RETURN_CODE (there is a one-to-one mapping between
the RETURN_TEXT and the RETURN_CODE)
CONFIRMATION_ST This parameter is command-dependent and it normally echoes relevant Request
RING parameters. In addition, this provides any requested information.
FAILURE_TEXT Is returned by some commands instead of the confirmation string to give explicit
reason for command failure.

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

2.2.3 Command indications


Indication messages originate from the 7100 to inform the user of an event. The 7100 may
therefore send an indication message to the System Control Interface at any time. Indication
messages from the 7100 have the following format:
I: IIII [INDICATION_STRING]
where IIII is the four letter indication message type.

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

Parameter name Type Min Max Default

ERROR_STATUS_CONDITION_ID Int - - -

ID of Error Status Condition to clear

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

ERROR_STATUS_CONDITION_ID ID of Error Status Condition to clear

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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Default Comment

COMPONENT_ALIAS String - An abbreviated component name used to identify a


component. Use the LCOM Command to obtain the set of
component aliases for the current configuration. This
identifies the component for which the command is
intended.

COMMAND_STRING String - A text command string that encapsulates any additional


parameters to be sent to a component This is the command
string intended for the component. It includes the command
itself and any required parameters.

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

14
Administrative commands

3.5 GCFG
Get configuration

Description
This command gets information about the configuration mode.

Syntax
GCFG

Request parameters
None

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

BSE_STATUS Text describing the current BSE status

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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

VERSION_TEXT Text describing the current software version.

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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

COMMAND_LIST The command that has been executed. Each command is


displayed on a new line with a command description. The
response length is software version-dependent.

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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Default Options

MODE_ALIAS operation String - SWL, MAC_MODE, RLC_MODE,


PDCP_MODE, FULL_PROTOCOL_MODE,
LTE_HRPD_MODE, HRPD_MODE_ONLY

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.

Mode extension String ”None” NONE: No mode extension needed


RCE: Enable radio channel emulation for 2X2
Fading
RCE_4x2: Enable radio channel emulation
for 4x2 Fading

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63 0

Identification of cell from the user perspective.


Cell number that is to be made active.

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Mode Int 0 1 -

0 – Set the 7100 into slave mode


1- Set the 7100 into master mode

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

IPversion Int 4 6 -

4- IP version 4
6- IP version 6
Note: Value 6 is not currently supported

String 0.0 255.25


.0. 5.255.
> IP address (Master) 0 255

IP address in dotted notation in decimal format for IPv4


This is the IP address of the master box
Note: The IP address of the master and slave box should be in
the same subnet

String 0.0 255.25


.0. 5.255.
> IP address (Slave) 0 255

IP address in dotted notation in decimal format for IPv4


This is the IP address of the slave box
Note: The IP address of the master and slave box should be in
the same subnet

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Timing Type Enum -1 1 -

Timing type for activation


0 = SFN
1 = Relative
-1 = Immediate

[Timing Value] Int 0 1023 -

0…1023 = SFN
Omit if ‘Timing type’ is -1

22
General commands

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

Indication parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

TIMING Timing value sent in the request

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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

[ UE context Id ] Int -1 0 -1

String All All

-1 = ALL

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.


RETURN_TEXT Text describing the success or failure of the request.
STATS_INFO See Statistics Information; the following items in the table explain
typical column meanings.
‘NumTBs’ The total number of transport blocks including blocks in error
‘BLER’ Block error ratio
‘Total bits’ or ‘NumBits’ Bit count including bits in error
‘NumTBsNACK’ Number of transport blocks NACKed
‘NumTBsACK’ Number of transport blocks ACKed
‘NumBitsACK’ Number of bits ACKed
'Throughput" The effective data rate. Where a retransmission mechanisms exist
(for example, HARQ process), this is the data rate of successfully
acknowledged data.
'Average' Running average throughput evaluated over 5 seconds 'Detects'
'Detects' Count of decodes of PDCCH for the transport channel
'Non-detects' Count of decode failures of the PDCCH for the transport channel

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.1 Power levels in physical layer commands


The power levels in the physical layer commands refer to EPRE and are specified in QdB with respect to
the reference signal EPRE. The reference signal EPRE cannot be controlled through a physical layer
command. Instead, a system level command/GUI setting should be used.
For PHICH, PDCCH, PBCH and PDSCH, two power levels are required. The first (designated Ra)
corresponds to the EPRE for OFDM symbols not containing reference signals, and the second
(designated Rb), corresponds to the EPRE for OFDM symbols that do contain reference signals. For
PCFICH, only Rb can be specified as it cannot be transmitted in OFDM symbols not containing reference
signals and for each of the synchronization signals, only Ra can be specified as these channels/signals
cannot be transmitted in OFDM symbols containing reference signals.
In the 7100, power levels are actually specified as ’Power level indicators‘ usually ranging from -52 to +16
’Quarter decibels (QdB)’, where an increase of 1 in the power level indicator corresponds to a 0.25 dB
increase in the EPRE.
Notes: The PHICH, PCFICH and PDCCH (called ‘control channels’) all have the same power level. For
PCFICH, the Ra value is not used.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

OCNG Flag Bool 0 1

1 – OCNG ON
0 – OCNG OFF

Choice ‘OCNG Flag’ is 1

( Int -52 16

26
Physical layer commands

Parameter name Type Min Max Default


Power Level
Note: Currently, only 0 QdB is supported.

[ Int -52 16 PDSCH_


Ra
OCNG_Ra
In Q dB.
If unspecified, equal to PDSCH_Ra of the UE under test.

OCNG_Rb Int -52 16 PDSCH_


Rb

In Q dB.
If unspecified, equal to PDSCH_Rb of the UE under test.

Gamma_PRB Int -52 16 0


]
In Q dB.
)
Only 0 Q dB is supported.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Reference Signal Type Enum 0 2

0 = Cell Specific
1 = MBSFN Specific
2 = UE-Specific

Tx Power Level Int (Range...TBD)

Defines the Tx power level of the reference signal.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Primary EPRE Rb Int -52 16 0

Primary EPRE Rb in QdB

Secondary EPRE Rb Int -52 16 0

Secondary EPRE Rb in QdB

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

UE Category Int 1 5 1

28
Physical layer commands

Parameter name Type Min Max Default

Defines the combined uplink and downlink capability.


Section 4.1 of 36.306 v8.2.0
UE category up to and including 4 is supported in current release

enable64QAM Int 0 1 0

This is an optional parameter. This parameter enables/disables 64


QAM modulation in UL

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective.

29
Physical layer commands

Parameter name Type Min Max Default

Frequency Band Int (1...64)

Defines the frequency band indicator of the system.

DL EARFCN Int (0...32767)

Defines the DL EARFCN

UL EARFCN Int (0...32767)

Defines the UL EARFCN


NOTE: This value is not applicable for TDD mode.

DL carrier frequency Int (Range TBD)

Downlink carrier frequency to use.

UL carrier frequency Int (Range TBD)

Uplink carrier frequency to use.

Attenuation Level Int (Range...TBD)

Defines the overall attenuation level of the system.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

N Cell Id Int 0 503

0...503 = Cell Identification number for PHY

Duplexing Scheme Int 0 1 0

Defines the Duplexing scheme to be used.

30
Physical layer commands

Parameter name Type Min Max Default


0 = FDD
1 = TDD

Choice ‘Duplexing Scheme’ is 1


0 6 0
( Int
> DL_UL_Configuration
Defines the DL UL configuration to be used for TDD duplexing scheme
0 8 0
> SpecialSubframePattern Int
)
Defines the special subframe pattern to be used for TDD duplexing
scheme

Downlink System Bandwidth Int 0 5 3

Defines the Downlink System Bandwidth


0 = 1.4 MHz 3 = 10 MHz
1 = 3 MHz 4 = 15 MHz
2 = 5 MHz 5 = 20 MHz

Cyclic Prefix Int 0 1 0

0 = Normal Cyclic Prefix


1 = Extended Cyclic Prefix ( supported in Downlink)

Number of eNB transmit Int 1 4 1


antennas
Denotes the number of antennae used for the transmission.

System Frame Number Int 0 1023 0

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).

Cell Offset Int 0 307199 0

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)

Uplink System Bandwidth Int 0 5 3

Defines the uplink system bandwidth


0 = 1.4 MHz 3 = 10 MHz
1 = 3 MHz 4 = 15 MHz
2 = 5 MHz 5 = 20 MHz

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Number of entries Int 1 255

Number of entries supplied in this command

For each ‘Number of entries’ supplied (1...255)

{ 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.

> DL grant TPC command Enum -2 3

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 1/1A/2.

> UE Group TPC command Enum -2 3

32
Physical layer physical channels

Parameter name Type Min Max Default


}
TPC command index: 0, 1, 2, 3 mapping onto the power control delta
values in dB. If 1 bit power control is configured, values 2 and 3 are
truncated to 1.
-1 = DTX
-2 = Signalled value
This is the TPC command received in DCI Format 3/3A.

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

FORW TE PHYCONFIGDLPRS <PARAMETERS>

Request parameters

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

PRS Enabled bool 0 1 0

0-Disabled
1-Enabled

Choice ‘PRS Enabled ’ is 1

( 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

PRS Configuration Index Int 0 4095 0

33
Physical layer physical channels

Parameter name Type Min Max Default

Section 6.10.4.3 36.211 v9.0.0

Num Downlink Subframes Int 1,2,4,6 1

Section 6.5.1.2 36.355 v9.6.0

[ 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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

EPRE Rb Int -52 16

Defines the Tx power level of the P-BCH channel. Ra is the same


as Rb

MIB content (Transport data) HexString 3 octets

Master Information Block data in Hexadecimal format.

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

[ Int 0 65535
UE-RNTI
Used for normal DL-SCH reception.

UE Group RNTI Int 0 65535

35
Physical layer physical channels

Parameter name Type Min Max Default

16-bit UE Group RNTI characterizing 8 different UEs


UE Group RNTI used by DCI format 3 to send the PUCCH TPC
commands to a group of UEs.

UE Group Index Int 0 7

UE index within group

Aggregation and DCI Format Int 0 4


]
0 = Reserved
1 = PDCCH Format 2 and DCI Format 3
2 = PDCCH Format 3 and DCI Format 3
3 = PDCCH Format 2 and DCI Format 3A
4 = PDCCH Format 3 and DCI Format 3A
Used for UL Power Control

EPRE Ra Int -52 16 0

Specified in QdB.

EPRE Rb Int -52 16 0

Specified in QdB.

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

RS Power Boosting Enabled Bool 0 1

0 = Disabled
1 = Enabled

Choice 'RS Power Boosting Enabled' is 1

( Int -52 16 0
> EPRE Ra
In QdB
Single antenna case: Ra = Pax4;
Two antennas case: Ra = (p+3) x4;

> EPRE Rb Int -52 16 0


)
In QdB

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

37
Physical layer physical channels

Parameter name Type Min Max Default

PRACH Configuration Int 0 63

Index io the table describing in which TTI the preamble can be


transmitted.
The values 30, 46, 60, 61 and 62 are reserved.
Note: According to 36.211 v8.4.0 Table 5.7.1-2, the PRACH
configurations indices range from 0 to 63 and the Preamble Format
field is understood from the PRACH configuration and hence need
not be configured.

Preamble Index Int 0 15

Currently unused.

Preamble Frequency Offset Int 0 94

This parameter indicates the start of the block of RBs, which is


occupied by the PRACH. The maximum number of RBs depends
upon the bandwidth (15, 25, 50 or 100) and the PRACH requires 6
RBs. The permitted range for this parameter is as follows:
0 … 9 (3 MHz bandwidth)
0 … 19 (5 MHz bandwidth)
0 … 44 (10 MHz bandwidth)
0 … 94 (20 MHz bandwidth)

Cyclic Shift Index (NCS Int 0 1


Configuration) 5

Used to derive the cyclic shift. Depends on the high-speed flag.


Value ‘0’ is currently not supported.
Refer Section 5.7.2 of 36.211 v8.6.0

High speed flag Bool 0 1

0 = Normal (unrestricted preamble set)


1 = High Speed (restricted preamble set). Currently not supported.

Root sequence index Int 0 837

The range 0 to 837 is only supported for Preamble formats 0 to 3.

Preamble Format Enum 0 4

Indicates the format of the preamble and hence defines the preamble
length.

Preamble Initial Power / Int 0 0


Cell Specific Target Power
Reserved.
Note: This parameter is no more used.

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Closed loop power control present Bool 0 1

0 = Closed-loop power control not present


1 = Closed-loop power control present
Note: Value 1 is currently not supported

TPC step size Enum 0 1

Determines the size of the set of δPUCCH / δPUSCH TPC adjustment


values signalled on the PDCCH with DCI formats 3 / 3A
0 = 1 bit format [-1, 1]
1 = 2 bit format [-1, 0, 1, 3]
Note: Unused in current release

PUCCH Resource Size Int 1 2


(NRB,PUCCH)

Number of resource blocks in a slot used for PUCCH transmission.


Due to PUCCH hopping every slot, double the specified resource
size is reserved for PUCCH. Therefore, the number of RBs for the
current bandwidth available for the PUSCH is equal to: Number of
RBs for bandwidth – (2 * PUCCH Resource Size). For example, at
10MHz if the PUCCH resource size is 2, the number of RBs
available for PUSCH is 50 – (2 * 2).

ΔShiftPUCCH Int 1 3

Used to derive the Cyclic Shift in PUCCH formats 1, 1a and 1b

δ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

Parameter name Type Min Max Default

NCS(1) Int 0 7

Number of cyclic shift used for PUCCH formats 1 / 1a / 1b in a


resource block used for a mix of formats. This must be an integer
multiple of the Δ Shift PUCCH value.

PUCCH Resource Index for Int 0 108


HARQ-ACK

The PUCCH resource index, which is used for the transmission of


HARQ-ACK of semi-persistently scheduled PDSCH by UE. Used to
derive nPUCCH(1).

PUCCH Resource Index for SR Int 0 108

The PUCCH resource index, which was used for the transmission of
SR by UE. Used to derive nPUCCH (1).

NPUCCH(1) Int 0 102

Used to derive the PUCCH resource, which is used for the


transmission of HARQ-ACK (nPUCCH(1)) from a dynamically
scheduled PDSCH by the UE.

NRB(2) Int 0 98

Used to derive the number of PRBs reserved for PUCCH formats 1 /


1a / 1b in each slot.

RS Sequence/Group Hopping Enum 0 2


mode
0 = No Sequence or Group Hopping
1 = Sequence Hopping present
2 = Group Hopping present
Applies to both SRS and DMRS (PUCCH and PUSCH)

CQI Transmissions Enabled Bool 0 1

0 = CQI transmissions not present


1 = CQI transmission present

Choice ‘CQI Transmission Enabled’ is 1

( 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.

> Simultaneous Transmission Bool 0 1


of ACK/NAK and CQI
) 0 = CQI is dropped

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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Delta Sequence Shift Pattern (∆SS) Int 0 29

Used to derive the PUSCH DMRS sequence shift pattern for


sequence hopping.

Section 5.5.1.3 36.211 v 8.6.0

TPC Command Accumulation Int 0 1


Enabled
0 = Accumulation Disabled
1 = Accumulation Enabled

Frequency Hopping mode Enum 0 1

0 = inter-subframe
1 = inter and intra-subframe

Section 8.4 36.213 v 8.6.0

Nsb Int 1 4

Number of frequency hopping sub-bands

Section 8.4 of 36.213 v 8.6.0

41
Physical layer physical channels

Parameter name Type Min Max Default

Cyclic shift Int 0 7

(1)
Used to derive nDMRS

Section 5.5.2.1.1-2 of 36.211 v 8.6.0

∆ Offset HARQ-ACK Int 0 15

In dB
Used to derive the number of coded symbols for HARQ-ACK
Note: Value 15 is reserved.

Section 8.6.3-1 of 36.213 v 8.6.0

∆ 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.

Section 5.2.2.6 of 36.212 v 8.6.0

∆ Offset CQI Int 0 15

In dB
Used to derive the number of coded symbols for channel quality
Note: Values 0 and 1 are reserved.

Section 5.2.2.6 of 36.212 v 8.6.0

RS Sequence/Group Hopping Enum 0 2


mode
0 = No Sequence or Group Hopping
1 = Sequence Hopping present
2 = Group Hopping present
Applies to both SRS and DMRS (PUCCH and PUSCH)

[ Int 0 63 98
HO
PUSCH Hopping Offset (NRB )
] The offset used for PUSCH hopping expressed in number of
resource blocks.

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

UL power control table override Enum 0, 2 0


operation
0 = Disabled, signalled values are used
2 = Forced event, values are taken based on UL transmissions.
Table entries are added using the PhyAddUlPowerCtrlTableEntry
command

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

43
Physical layer physical channels

Parameter name Type Min Max Default

Identification of cell from user perspective

Bool 0 1
SRS Enable Flag
0 – SRS OFF
1 – SRS ON

Choice ‘SRS Enable Flag’ is 1

( Int 0 15 14
SRS Sub-frame Configuration
Table 5.5.3.3-1 36.211

Simultaneous Tx of Ack/Nak and Bool 0 1 1


SRS
0 = SRS is dropped (Ack/Nak transmitted using normal PUCCH
format 1a or 1b)
1 = Ack/Nak and SRS transmissions performed in the same sub-
frame

Section 8.2 36.213 v8.5.0

SRS Bandwidth (B SRS) Int 0 3 0

Section 5.5.3.2 36.211 v8.5.0

SRS Bandwidth Configuration Int 0 7 7

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

Section 5.5.3.2 36.211 v 8.5.0

SRS Resource Index (nSRS) Int 0 7 0

Used to derive the SRS cyclic shift

Section 5.5.3.1 36.211 v8.5.0

SRS Hopping Bandwidth (bhop) Int 0 3 0

SRS frequency hopping is enabled when SRS Hopping Bandwidth


(bhop) < SRS Bandwidth (BSRS)

Section 8.2 36.213 v8.5.0


Section 5.5.3.2 36.211 v8.5.0

Frequency Domain Position Int 0 31 0


(nRRC)
Starting SRS physical resource block assignment.

Section 8.2 36.213 v8.5.0


Section 5.5.3.2 36.211 v8.5.0
Section 6.3.2 36.331 v8.4.0

44
Physical layer physical channels

Parameter name Type Min Max Default

SRS Transmission Duration Int 0 1 0

0 = single
1 = Indefinite (until disabled)

Section 8.2 36.213 v8.5.0

SRS Config Index Int 0 1023 0

637-1023 values are reserved for FDD

Transmission Comb (KTC) Int 0 1


)
Defines the spacing of the SRS CAZAC sequence.
0 = Even sub-carriers
1 = Odd sub-carriers

Section 5.5.3.2 36.211 v8.5.0


Section 8.2 36.213 v8.5.0

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Rank indicator override Enum 0 2 0

0 = Use normal calculated rank indicator


1 = Rank indicator reported in CQI is rank 1
2 = Rank indicator reported in CQI is rank 2

Choice 'Rank indicator override' is not equal to 0

( 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

> Choice 'PMI Override' is not equal to -1


(

>> Choice 'Rank indicator override' is 1


(

>>> Number of Rank 1 CQI Int 0 25


values

>>> For each CQI value (0 …'Number of Rank 1 CQI values')

{ Int 0 15

46
Physical layer physical channels

Parameter name Type Min Max Default


>>>> CQI for Codeword 0
}
)

>> Choice 'Rank indicator override' is 2


(

>>> Number of Rank 2 CQI Int 0 25


values

>>> For each CQI value (0 …'Number of Rank 2 CQI values')

{ Int 0 15
>>>> CQI for Codeword 0

>>>> CQI for Codeword 1 Int 0 15


}
)
)
)

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

47
Physical layer physical channels

Parameter name Type Min Max Default

Bool 0 1
SRS Enable Flag
0 – SRS OFF
1 – SRS ON

Choice ‘SRS Enable Flag’ is 1

( Int 0 15 14
SRS Sub-frame Configuration
Table 5.5.3.3-1 36.211

Simultaneous Tx of Ack/Nak and Bool 0 1 1


SRS
0 = SRS is dropped (Ack/Nak transmitted using normal PUCCH
format 1a or 1b)
1 = Ack/Nak and SRS transmissions performed in the same sub-
frame

Section 8.2 36.213 v8.5.0

SRS Bandwidth (B SRS) Int 0 3 0

Section 5.5.3.2 36.211 v8.5.0

SRS Bandwidth Configuration Int 0 7 7

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

Section 5.5.3.2 36.211 v 8.5.0

SRS Resource Index (nSRS) Int 0 7 0

Used to derive the SRS cyclic shift

Section 5.5.3.1 36.211 v8.5.0

SRS Hopping Bandwidth (bhop) Int 0 3 0

SRS frequency hopping is enabled when SRS Hopping Bandwidth


(bhop) < SRS Bandwidth (BSRS)

Section 8.2 36.213 v8.5.0


Section 5.5.3.2 36.211 v8.5.0

Frequency Domain Position Int 0 31 0


(nRRC)
Starting SRS physical resource block assignment.

Section 8.2 36.213 v8.5.0


Section 5.5.3.2 36.211 v8.5.0
Section 6.3.2 36.331 v8.4.0

SRS Transmission Duration Int 0 1 0

48
Physical layer physical channels

Parameter name Type Min Max Default

0 = single
1 = Indefinite (until disabled)

Section 8.2 36.213 v8.5.0

SRS Config Index Int 0 1023 0

637-1023 values are reserved for FDD

Transmission Comb (KTC) Int 0 1


)
Defines the spacing of the SRS CAZAC sequence.
0 = Even sub-carriers
1 = Odd sub-carriers

Section 5.5.3.2 36.211 v8.5.0


Section 8.2 36.213 v8.5.0

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Applicability Int 1 3

Indicates the applicability of the command.


1 = TPC values applicable for PUSCH only. UL grant has to be
present in a TTI for it to be counted.
2 = TPC values applicable for PUCCH only. Only the DL grant has to
be present in a TTI for it to be counted.
3 = TPC values applicable for every subframe irrespective of whether
it is a PUSCH transmission or PUCCH. Either a DL or a UL grant has
to be present in a TTI for it to be counted.

Number of entries Int 1 128

Number of entries supplied in this command

For each ‘Number of entries’ supplied (1...128)

{ Int 0 3
> TPC value
0 = -1dB
}
1 = 0dB
2 = 1dB
3 = 3dB

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

PDSCH Transmission Mode Enum 0 7 0

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.

Section 7.1 36.213 v 8.6.0

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

CQI Periodic Report Method Enum 0 1 -

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)

CQI aperiodic Report Method Enum 0 4 -

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

CQI/PMI Periodicity and Offset Int 0 1023 -


Configuration Index (ICQI/PMI)
317 = Periodic CQI disabled. This is used to derive the CQI Periodicity
(NP) and the CQI subframe Offset (N OFFSET, CQI). See 36.213 $7.2.2

Choice 'PeriodicityCQI/PMI Periodicity and Offset Configuration Index' is less than 317

( Int 1 4 -

52
Physical layer transport channels

Parameter name Type Min Max Default


> 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).

PMI Delay Int 0 16 0

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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

CQI Periodic Report Method Enum 0 1 -

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)

CQI aperiodic Report Method Enum 0 4 -

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

CQI/PMI Periodicity and Offset Int 0 1023 -


Configuration Index (ICQI/PMI)
317 = Periodic CQI disabled. This is used to derive the CQI Periodicity
(NP) and the CQI subframe Offset (N OFFSET, CQI). See 36.213 $7.2.2

Choice 'PeriodicityCQI/PMI Periodicity and Offset Configuration Index' is less than 317

55
Physical layer transport channels

Parameter name Type Min Max Default

( 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).

PMI Delay Int 4 16 6

This parameter indicates the delay in applying the PMI report

Parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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.

In the 2x2 fading mode:


When the velocity of the UE is zero, the static channel that is simulated is as per Section B.1 of

3GPP TS 36.101, i.e. .


If there are multiple paths, each path has the above channel matrix and is weighted by its path
gain.

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.

In the 4x2 fading mode,


When the velocity of the UE is zero, the default static channel that is simulated is [1 1 1 1; 1 -1 -1
1].

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.)

Static Channel Configuration in 4X2 Fading Mode:

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

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.
For precoding Indices 2,4,10:
FORW TE PhyConfigRadioChannel 0 2 2140 [1 ( { 1000 0,1000 0,1000 0,1000 180,1000
0,1000 180,1000 180,1000 0 } )]
For precoding Indices 8,11:
FORW TE PhyConfigRadioChannel 0 2 2140 [1 ( { 1000 0,1000 0,1000 0,1000 0,1000
0,1000 180,1000 180,1000 180 } )]
Once the registration is successful, PhyConfigRadioChannel is issued again according to the fading
profile with dynamic channel ‘ON’ to test 4X2 Fading.

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

3GPP TS 36.101, i.e. .


If there are multiple paths, each path has the above channel matrix and is weighted by its path
gain.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Number of Receive Int 1 2 -


Antennas
Number of receiver antennas in the UE

DL Carrier Frequency Int 600 3000 -

Downlink carrier frequency in MHz

[ Int 0 63 0

58
Channel emulation commands

Parameter name Type Min Max Default


Channel Model
Channel model:
0: User defined dynamic channel
1: User defined static channel
2...63: Reserved for standard models (not supported in this release).

Choice 'Channel Model’ is 0

( Enum 0 63 0
>> MIMO Correlation Model

MIMO correlation properties:


0: User defined

1...63: Reserved for standard models (not supported in this release).

Choice 'MIMO correlation model’ is 0

>> ( Enum 0 1 0
>>>> MIMO Correlation
Scope

0: Same correlation matrix applies to all paths


1: Each path has its own correlation.

Note: The value 1 is not supported in this release.

Choice 'MIMO correlation scope’ is 0

>>>> ( Int -1 1000 0


>>>>>> Transmitter
Correlation The parameter α in B.2.3.1 of 36.101 V8.6.0 is the same as “Transmitter
Correlation”/1000. Special value of -1 indicates no cross paths between
antennas – that is, no signal from Tx1 reaches antenna Rx1 and vice versa.

>>>>>> Receiver Int -1 1000 0


Correlation
>>>> ) The parameter β in B.2.3.1 of 36.101 V8.6.0 is the same as “Receiver
Correlation”/1000. Special value of -1 indicates no cross paths between
>> ) antennas.

[ Int 0 6000 0
Velocity
Reference velocity of the UE in decikmph.

Velocity Pattern Enum 0 2 0

0: None
1: Periodic
2: Random Set
[Note] : If ‘Path Type’ is 2, the value of this parameter is 0

Choice ‘Velocity Pattern’ is 1

( Enum 0 2 0
>>[
0: Sine
>>Velocity Pattern Shape
1: Square

59
Channel emulation commands

Parameter name Type Min Max Default


2: Triangle

>>Peak to Peak Amplitude Int 0 6000 0

Peak to peak amplitude in decikmph for the velocity pattern. ‘Velocity’ +/-
½*‘Peak to peak amplitude’) should be within the range given for ‘Velocity’.

>>Period Int 1 3600000 1

Period of the pattern in milliseconds

Int 0 359 0

>>Phase Starting phase of the pattern


>>]
)

Choice ‘Velocity Pattern’ is 2

( Int 0 6000 0
>>[
Range in decikmph of random velocities in set
>> Set Range

>> Number of velocities in Int 1 256 1


set
Number of random velocities in the set

>> Update Period Int 1 3600000 1

Update period in milliseconds. Every update period a new value is chosen.

>> Start Phase Int 0 359 0

Starting phase in degrees

>> Seed Int 0 255 0

Seed for the random selection in the set

>> Exclusions Enum 0 2 0


>> ]
0: No exclusions
)
1: Self
] //Velocity
2: All

Number of paths Int 1 9 9

Number of paths in the fading profile


[Note] : If ‘Path Type’ is 2, the value of this parameter should be given as 1

For each path in the fading profile

{ 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

Parameter name Type Min Max Default

>>Delay Pattern Enum 0 2 0

0: None
1: Periodic
2 From a random set
[Note] : If ‘Path Type’ is 2, the value of this parameter is 0

Choice ‘Delay Pattern’ is 1

>>( Enum 0 2 0
>>>>[
0: Sine
>>>>Delay Pattern Shape
1: Square
2: Triangle

>>>>Peak to peak Int 0 33000 0


amplitude
Peak to peak amplitude in ns for the delay pattern. ‘Delay’ +/- ½*‘Peak to
peak amplitude’) must be within the range given for ‘Delay’.

>>>>Period Int 1 3600000 1

Period of the pattern in milliseconds

>>>>Phase Int 0 359 0


>>>>]
Starting phase of the pattern in degrees
>>)

Choice ‘Delay Pattern’ is 2

>>( Int 0 33000 0


>>>>[
Range in ns of random delays in set
>>>>Set Range

>>>>Number of delays in Int 1 256 1


set
Number of random delays in the set

>>>>Update Period Int 1 3600000 1

Update period in milliseconds. Every update period a new value is chosen.

>>>>Starting Phase Int 359 0


0

Starting phase in degrees

Int 0 255 0

Seed for the random selection in the set


>>>>Seed

61
Channel emulation commands

Parameter name Type Min Max Default

>>>>Exclusions Enum 0 2 0
>>>>]
0: No exclusions
>>)
1: Self
2: All

>>Path Gain Int - 0 0


5000

Reference path gain in centidB. At least one path must have 0 dB gain.

[Note] : If ‘Path Type’ is 2, the value of this parameter must be given as 0

>>[ Int 0 35999 0


>>Phase
Reference phase in centidegrees
>>]
[Note] : If ‘Path Type’ is 2, the value of this parameter must be given as 0

>> Gain Pattern Enum 0 2 0

0: None
1: Periodic
2: log-normal
[Note] : If ‘Path Type’ is 2, the value of this parameter must be given as 0

Choice ‘Gain Pattern’ is 1

>>( Enum 2 0
>>>>[ 0
>>>>Gain Pattern Shape
0: Sine
1: Square
2: Triangle

>>>> Peak to peak Int 0 5000 0


amplitude
Peak to peak amplitude in centidB for the gain pattern. ‘Path gain’ +/-
½*‘Peak to peak amplitude’) must be within the range given for ‘Path gain’.

>>>>Period Int 1 3600000 1

Period of the pattern in milliseconds

>>>>Phase Int 0 359 0


>>>>]
>>)

Choice ‘Gain Pattern’ is 2

>>( Int 1 10000 1


>>>>[
In metres
>>>>Feature Spacing

>>>>Standard Deviation Int 0 100 0

62
Channel emulation commands

Parameter name Type Min Max Default

In dB

>>>>Seed Int 0 255 0


>>>>]
Seed
)

>>[ Enum 1 1
0
>>Path Type

0: Pure Doppler
1: Rayleigh
2: High Speed Train

Choice ‘Path Type’ is 0

>>( Int 0 35999 -


>>>>Bearing Angle
>>) In centidegrees

Choice ‘Path Type is 1’

>>( Int 0 255 0


>>>>Seed

Seed

>>>>Doppler Spectrum Enum 0 1 1

>>)
0: Classical

1: Flat

Choice ‘Path Type’ is 2

>>( Int 0 100000 30000

>>>> ds

Twice the initial distance of the train from the eNodeB in centimetres

>>>> dmin Int 1 1000 200

>>)

>>]
The eNodeB-Railway track distance in centimetres

Choice ‘MIMO Correlation scope’ is 1 (not supported in this release).

>>( Int -1 1000


>>>>Transmitter Correlation

The parameter α in B.2.3.1 of 36.101 V8.6.0 is the same as “Transmitter


Correlation”/1000. Special value of -1 indicates no cross paths between
antennas.

63
Channel emulation commands

Parameter name Type Min Max Default

>> >>Receiver Correlation Int -1 1000 -


>>)
} The parameter β in B.2.3.1 of 36.101 V8.6.0 is the same as “Receiver
Correlation”/1000. Special value of -1 indicates no cross paths between
) antennas.
]

Choice 'Channel Model’ is 1

(
> For each ‘Number of Receive Antennas supplied (1..RxN) where RxN can be 4. Second parameter of this API

{ float 0 2000 1000

>>( 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.

>>>> theta11 Int 0 359 0

>>) Theta in terms of degrees

>>( float 0 2000 1000

>>>> 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.

>>>> theta21 Int 0 359 0

>>) Theta in terms of degrees

>>( float 0 2000 1000

>>>> 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.

>>>> thetaM1 Int 0 359 0

>>)
Theta in terms of degrees
}
Where M is Number of Transmitters Configured in PhySetSystemParams

{ float 0 2000 1000

>>( GainFactor in terms of initial Gain.GainFactor should be in steps of 10. This


>>>> GainFactor1N value is scaled by 1000 to get resolution of 0.01. Value 10 means 0.01.
Value 1000 means multiplication factor 1.

>>>> theta1N Int 0 359 0

>>) Theta in terms of degrees

>>( float 0 2000 1000

>>>> 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

Parameter name Type Min Max Default

>>>> theta2N Int 0 359 0

>>) Theta in terms of degrees

>>( float 0 2000 1000

>>>> 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

>>>> thetaMN Int 0 359 0

>>)
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

Parameter name Comment

Return Code Number indicating the success or failure of the request.

Return Text Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

AWGN Level Float -100 5 -100

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.

[ Int 0 2500 [See below]


AWGN Bandwidth
AWGN BW in 10 kHz steps (0 to 25 MHz)
]
Default value is the Cell DL BW.

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

HARQ result override type Enum 1 2

1 = Forced Time. ACK/NACK result transmitted every TTI,


independently of the HARQ process
2 = Forced Event. ACK/NACK result overrides actual result for a
given HARQ process on a given codeword

Choice 'HARQ result override type' is 1

( Int 1 255
Number of Entries
Number of entries supplied in this command

For each ‘Number of entries’ supplied (1…255)

{ Enum 6 93
>Downlink Channel Number (nCCE)
Used to derive the PUCCH resource for transmission of HARQ
result

> Codeword 0 DL HARQ Result Enum -1 1

67
HARQ commands

Parameter name Type Min Max Default

-1 = DTX
0 = NACK
1 = ACK

> Codeword 1 DL HARQ Result Enum -1 1


}
) -1 = DTX
0 = NACK
1 = ACK

Choice 'HARQ result override type' is 2

(Codeword Identifier Int 0 1

Codeblock identifier
0 = First transport block
1 = Second transport block

DL Harq Id Int 0 7

DL HARQ id = 0 … 7

Number of Entries Int 1 255

Number of entries supplied in this command

For each ‘Number of entries’ supplied (1…255)

{ Enum -2 1
>DL HARQ result
}
-2 = Derived result
)
-1 = DTX
0 = NACK
1 = ACK

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Number of HARQ processes Int 1 8 8

[ 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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

DL-SCH ACK table override operation Enum 0 2 0

0 = Disabled, signalled values are used,


1 = Forced time, transmissions are performed every TTI,
2 = Forced event, transmissions are performed upon a
transmission to the HARQ.

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Data Flow Type Enum 0 2

0 = Downlink transmission,
1 = Uplink transmission,
2 = MSG3 transmission.

Maximum Transmission Integer 1 28

70
HARQ commands

Parameter name Type Min Max Default

For Down Link Transmission


Range – 1 to 28
For Uplink Transmission
Range - 1, 2, 3, 4, 5, 6, 7, 8, 10, 12, 16, 20, 24, 28
For Msg3 transmission
Range – 1 to 8

For no. of Maximum Transmissions specified above

{ Integer 0 3
RV INDEX
Redundancy version.
}

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Number of HARQ Processes Int 1 8 8

Maximum Re-transmissions Int 1 28 5

71
HARQ commands

Parameter name Type Min Max Default

This parameter applies to all UL HARQ processes.

[ 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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Allow failed transport blocks Bool 0 1 0

0 = Disabled; HARQ operates as normal.


1 = Allow failed TBs to pass through the HARQ.

72
HARQ commands

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

TPC Command Field in


DCI format 1A/1B/1D/1/2A/2/3 δ [dB]
0 -1
1 0
2 1
3 3

Mapping of TPC Command Field in DCI Format 3A

TPC Command Field in


DCI format 3A
δ [dB]
0 -1
1 1

For DCI Format 3A the TPC command in ‘SCHEDULERADDULSCHCTRLTABLEENTRY’ ‘is


interpreted as 0, 1 = 0 and 2, 3 = 1.
Note: UL power control using DCI Format 3 and 3A is not supported in this release.
Scheduler Reconfiguration
When reconfigured, activation of these commands happens on the next available opportunity at
subframe 0 for immediate activation whereas for time-based activation it happens at the activation
time configured if Harq process number is 0 or the next available opportunity at subframe 0. There
can be a maximum of 9 DTX subframes before the activation. Activation can be delayed,
depending on dynamic conditions, by a maximum of 2 radio frames in TDD and 1 radio frame in
FDD in time-based activation.
Note: To achieve a one-to-one mapping of DL grants to subframes, SIBs must not be present and
the scheduler command must be reconfigured with number of entries modified so that it repeats
over an inter multiples of radio frames. For example, in FDD if there are only 9 DL grants present in
a radio frame, number of entries in DL scheduler command should be 72. This ensures that the
pattern of 72 grants is repeated with exact mapping to 8 radio frames considering the missing
subframe command and wrapped around until the command is reconfigured or stopped.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of Cell from User perspective

Number of entries Int 1 255

Number of entries specified in this command.

For each of the entries specified above

{ 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

Parameter name Comment

RETURN_CODE Number to indicate the success/failure of the request.

RETURN_TEXT Text to indicate the success/failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of Cell from User perspective

Number of Entries Int 1 255

Number of entries specified in this command.

For each of the entries specified above

{ Int 0, 1 0
DL Grant Status
Specifies the type of Grant
}
0 = No Grant
1 = DL Grant present

Confirm parameters

Parameter name Comment

RETURN_CODE Number to indicate the success/failure of the request.

RETURN_TEXT Text to indicate the success/failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of Cell from User perspective

Number of entries Int 1 255

Number of entries specified in this command.

For each of the entries specified above

{ Int 0, 1 0
UL Grant Status
Specifies the type of Grant
}
0 = No Grant
1 = UL Grant present

Confirm parameters

Parameter name Comment

RETURN_CODE Number to indicate the success/failure of the request.

RETURN_TEXT Text to indicate the success/failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification Of Cell From User Perspective

Entry Index Int 1 510

Index identifying the table entry

78
Scheduler commands

Parameter name Type Min Max Default

Number of entries Int 1 255

Number of entries supplied in this command

For each ‘Number of entries’ supplied (1..255)

{ 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).

> Choice ‘Downlink HARQ ID’ is not -1

( Enum 0…2
> Downlink Resource
Allocation type Info 0 to 2 = Resource Allocation Type

> Choice ‘Downlink Resource Allocation Type Info’ = 0

( Int 0 335544 0
31
>> Resource Block Groups
(Or
) 0x1FFF
FFF)

A bit-field of 25 bits to indicate which RBGs in the range of 0 to 24


are used. The bit-field is represented as a hexadecimal number with
7 digits where 6 digits on the right most side specifies a bit field of
length 4 and the left most digit specifies a single bit-field. The RBG
numbers count upwards starting at 0 from the least significant bit of
the least significant hex digit. A bit-field of ‘1’ indicates that the
corresponding RBG is present.
For 1.4MHz BW, only the least significant 6 bit-fields can be used.
For 3MHz BW, only the least significant 8 bit-fields can be used.
For 5MHz BW, only the least significant 13 bit-fields can be used.
For 10MHz BW, only the least significant 17 bit-fields can be used.
For 15MHz BW, only the least significant 18 bit-fields can be used.
For 20MHz BW, all the bit-fields can be used.

> Choice ‘Downlink Resource Allocation Type Info’ = 1

( 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

Parameter name Type Min Max Default

>> RB’s in RBG sub-set Int 0 268435 0


455
(Or
0xFFFF
FFF)

A bit-field of 28 bits to indicate which RB indices in the range of 0 to


27 are used. The bit-field is represented as a hexadecimal number
with 7 digits where digit specifies a bit field of length 4. The RB
indices count upwards starting at 0 from the least significant bit of the
least significant hex digit. A bit-field of ‘1’ indicates that the RB with
the corresponding RB index is present.
For 1.4MHz BW, only the least significant 6 bit-fields can be used.
For 3MHz BW, only the least significant 8 bit-fields can be used.
For 5MHz BW, only the least significant 13 bit-fields can be used.
For 10MHz BW, only the least significant 18 bit-fields can be used.
For 15MHz BW, only the least significant 20 bit-fields can be used.
For 20MHz BW, all the bit-fields can be used.

>> RBG sub-set shift Int 0 1 0


)
0 = left justified
1 = right justified

> Choice ‘Downlink Resource Allocation Type Info’ = 2

( Enum 0 … 99 0
>> RB start
Resource Blocks star index
0 to 99 = RB start

>> RB length Enum 1 … 100 1

Number of Resource Blocks


1 to 100 = RB length

[ Int 0 2
>> NGap Type
0 -- DVRB Off
]
1 or 2 --- Distribution of VRBs to be done with this gap type.
)

> Number of codeword’s Enum 1..2

1 = Only codeword 0
2 = Codeword 0 and 1

> For each ‘Number of downlink codeword’s’ supplied (1..2)

{ Int -2, 0..3


>> RV
Redundancy version.
0...3 = RSN value. Only value 0 is supported in this release.

>> ACK/NACK Int -3, -2, 0..1

80
Scheduler commands

Parameter name Type Min Max Default

This is the ACK/NACK result to be used for this transmission on the


HARQ.
0 = NACK
1 = ACK
-2 = Signalled value
-3 = Corrupt L1/L2 data.

>> MCS Int 0..28


}
Modulation and coding scheme.
0...28 = MCS value.

[ 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.
)

Number of layers Int 1..4 1

Number of Transmission layers. Based on the DL transmission


mode.
Note: Only value 2 is supported in the CL MIMO transmission mode
operation.
Number of Layers = 4 is not supported in this Release

Precoding Index Int -2,0,1,2,3.....63 0

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

DCI Format Int 1.. 9 2

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

PDCCH format Int 0..3 0

81
Scheduler commands

Parameter name Type Min Max Default

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.

Search Type Int 0..1 0

Defines the search space for UL and DL grants.


0 = Common search space.
1 = UE specific search space.

Candidate Index Int 0..5 0


}
Candidate index for DL DCI. Only formats 0, 1A, 2A are supported.

Confirm Parameters

Parameter name Comment

RETURN_CODE Number to indicate success or failure of the request.

RETURN_TEXT Text to indicate success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of Cell from User perspective

Entry Index Int 1 510

Index identifying the table entry

Number of Entries Int 1 255

Number of entries supplied in this command

82
Scheduler commands

Parameter name Type Min Max Default

For each ‘Number of entries’ supplied (1..255)

{ 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.)

> ACK/NACK Enum -2, 0, 1

This is the ACK/NACK result to be used for this transmission on the


HARQ.
0 = NACK
1 = ACK
-2 = Signalled value.

> Grant Operation Int 1 1

Choice ‘Grant operation’ is not 0

( Enum 0, 1
> Hopping flag
0 = Hopping disabled
1 = Hopping enabled

> Hopping Information Int 0..3

This parameter is ignored unless the ‘Hopping flag’ parameter is


enabled.

> RB Start Int 0..99

0..99 = The lowest indexed RB assigned

> Number RB Int 1 100

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

> I_MCS Int 0..20, 29..31

0..20 = Index Transport Format and Redundancy Version


29..31 = Index Redundancy Version

> TPC Command Int 0 4 0

0 = Default TPC (compatible with previous releases)


1 maps to 0
...
4 maps to 3

> DMRS Cyclic Shift Enum 0..7

83
Scheduler commands

Parameter name Type Min Max Default

0..7 = Cyclic shift

> CQI Request Enum 0, 1


)
0 = CQI not requested
}
1 = CQI requested

Confirm Parameters

Parameter name Comment

RETURN_CODE Number to indicate the success/failure of the request.

RETURN_TEXT Text to indicate the success/failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of Cell from User perspective

DL-SCH control table override Enum 0 2


operation
0 = Disabled, signalled values are used
1 = Forced time, transmissions are performed every TTI
2 = Forced event, transmissions are performed upon a
transmission to the HARQ.

Confirm parameters

Parameter name Comment

RETURN_CODE Number to indicate the success/failure of the request.

RETURN_TEXT Text to indicate the success/failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of Cell from User perspective

UL-SCH control table override Enum 0 2


operation
0 = Disabled, signalled values are used
1 = Forced time, transmissions are performed every TTI
2 = Forced event, transmissions are performed when SG is signalled
to the HARQ.

Confirm parameters

Parameter Name Comment

RETURN_CODE Number to indicate the success/failure of the request.

RETURN_TEXT Text to indicate the success/failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

DBCH MCS Int -1, 0...31

MCS value used for the transmission of SIB messages.


-1- Use the value from MACCONFIGDLSCHCommand

DBCH NRB Int -1, 1...100, 1001, 1004

Number of resource blocks used for the transmission of SIB messages.


-1- Use the value from MACCONFIGDLSCHCommand
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.

DBCH START RB Int 1 100

Start RB value used for the transmission of SIB messages.

DCI Format Int 0,1

0 – DCI Format 1A
1- DCI Format 1 C

Gap Type Int 0 2

86
MAC layer commands

Parameter name Type Min Max Default

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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It


includes the cell number.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Band Int 0 1

0 -Wide Band
1 - Sub Band

If Band selected is subband, then the following parameters need to be included

( Int 0 1
CQI Selection Case
1- Worst
0 - Best

Resource Allocation Type Int -1, 1, 2, 3, 4, 5


)
-1 – All Resources
1 – 5 No. of subbands
Note: Only -1 is supported in this release

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It


includes cell number.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

88
MAC layer commands

Parameter name Type Min Max Default

Cell Number Int 0 63

[ 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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It


includes the cell number.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

BCCH-Type Int 1 4

1 = SIB1 Present, 2(SI) = SIB2-SIB7and SIB10, 3(SI) = SIB8, 4(SI) =


SIB11
SIB-10 SystemInformationBlockType10 contains an ETWS primary
notification
Refer section 5.2.2.17 of 36331-880

To identify SI number to be sent. This value is the order of entry.

89
MAC layer commands

Parameter name Type Min Max Default

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

>Periodicity Enum 8, 16, 32, 64, 128, 256, 512

rf8 – 8, rf16 – 16, rf32 – 32, rf64 – 64, rf128 – 128, rf256 – 256, rf512 –
512
To be provided for SI Data

>SI Window Length Enum 1, 2, 5, 10, 15, 20, 40

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

Optional Parameter to be provided for Sib1

[ Enum 20, 40, 80 80


>Sib1 Periodicity
ms20 - 20, ms40 - 40, ms80 – 80
]
Sib1 Periodicity

90
MAC layer commands

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Number of logical channels Int 1 28

Number of logical channels supplied in this command.

For each ‘Number of logical channels’ supplied (up to 28)

{ 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

> Prioritized Bit Rate Int 0 9214000

RESERVED

> Logical Channel Priority Int 1 16

RESERVED

> Bucket Size Duration Int 50, 100, 150, 300, 500, 1000
}
RESERVED

91
MAC layer commands

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It


includes the cell number.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Number of Logical Channels Int 1 28

Number of logical channels supplied in this command. When testing in the


RLC mode the maximum number of logical channels is limited to the
maximum number of radio bearers.

For each ‘Number of logical channels’ supplied (up to 28)

{ 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.

> Prioritized Bit Rate Int 0 9214000

RESERVED

> Logical Channel Priority Int 1 16

RESERVED

> Bucket Size Duration Int 50, 100, 150, 300, 500, 1000
}
RESERVED

92
MAC layer commands

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It


includes the cell number.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Paging DRX UE Id Int 0 1023

This is equivalent to the IMSI modulo 1024

Default paging cycle (T) Int 320, 640, 1280, 2560

Specified in ms.

nB Enum 0 7

Used to derive the number of paging groups.


0 = 4T
1 = 2T
2=T
3 = 1/2T
4 = 1/4T
5 = 1/8T
6 = 1/16T
7 = 1/32T
(where 'T' is the default paging cycle in radio frames)

93
MAC layer commands

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating success failure of request.

RETURN_TEXT Text describing the success or failure of the request. It


includes cell number

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Antenna Type Enum 0 7 1

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.

DL Bandwidth Enum 3, 5, 10, 14, 15, 20

14-1.4 MHz, 3-3 MHz, 5-5MHz, 10-10 MHz, 15-15 MHz, 20-20 MHz

UE-RNTI Int 10 65522

UE Radio Network Temporary Identifier.

[ Int 0 1 0

94
MAC layer commands

Parameter name Type Min Max Default


Dynamic Scheduling
Enable or disable dynamic scheduling
] 1 – Enable dynamic scheduling
0 – Disable dynamic scheduling

[ 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 1, 2, 3, 4, 1001, 1004 3


PCH NRB
Number of resource blocks used for the transmission of paging 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

MCS value used for the transmission of Random Access Response.


RAR MCS
]

[ Int 1, 2, 3, 4, 1001, 1004 3

95
MAC layer commands

Parameter name Type Min Max Default


RAR NRB
Number of resource blocks used for the transmission of random access
] response.
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 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.

[ Enum 4, 8, 16, 32, 64


dsr TransMax
4 – sf4,
]
8 – sf8,
16 – sf16,
32 – sf32,
64 – sf64
Note: This field has been deprecated

MacOverrideDataTableEntry Int 0 1
Enable
0 – False
1 – True

If MacOverrideDataTableEntry is enabled, then following parameters need to be included:

( Int 0 8640
> Downlink Guaranteed Bit
Rate Downlink guaranteed bit rate in kbps

> Downlink Maximum Bit Int 0 8640


Rate
Downlink maximum bit rate in kbps

96
MAC layer commands

Parameter name Type Min Max Default

> Uplink Guaranteed Bit Rate Int 0 8640

Uplink guaranteed bit rate in kbps

> Uplink Maximum Bit Rate Int 0 8640


)
Uplink maximum bit rate in kbps

TimeAlignment Timer Enum -1,500


750,1280,
1920,
2560,
10240

-1 – Infinity,
500 – sf500,
750 – sf750,
1280 – sf1280,
1920 – sf1920,
2560 – sf2560,
10240 – sf10240

TimeAdvanceExplicit Int 0 1

0 – False
1 – True

If TimeAdvanceExplicit is enabled, then following parameters need to be included

TimeAdvanceValue Int 0 63

Timing advance to be sent in Mac Control Element


Note: Any value other than 31 causes the UE to go out of sync

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It


includes cell number.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

SPS RNTI Int 10 65522

SPS Radio Network Temporary Identifier.

Scheduling Interval Enum 10, 20, 32, 40, 64,80, 128,


160, 320, 640

sf10 = 10
sf20 = 20
sf32 = 32
sf40 = 40
sf64 = 64
sf80 = 80
sf128 = 128
sf160 = 160
sf320 = 320
sf640 = 640

No. Of SPS Processes Int 1 8


Configured
Number of SPS processes configured

Number of Transmissions Int 2 1000

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

> Choice ‘Downlink Resource Allocation Type Info’ = 0

( Int 0 335544 0
31
>> Resource Block Groups
(Or
) 0x1FFF
FFF)

98
MAC layer commands

Parameter name Type Min Max Default

A bit-field of 25 bits to indicate the RBGs in the range of 0 to 24 that


are used. The bit-field is represented as a hexadecimal number with
7 digits where 6 digits on the right most side specifies a bit field of
length 4 and the leftmost digit specifies a single bit-field. The RBG
numbers count upwards starting at 0 from the least significant bit of
the least significant hex digit. A bit-field of ‘1’ indicates that the
corresponding RBG is present.
For 1.4MHz BW, only the least significant 6 bit-fields can be used.
For 3MHz BW, only the least significant 8 bit-fields can be used.
For 5MHz BW, only the least significant 13 bit-fields can be used.
For 10MHz BW, only the least significant 17 bit-fields can be used.
For 15MHz BW, only the least significant 18 bit-fields can be used.
For 20MHz BW, all the bit-fields can be used.

> Choice ‘Downlink Resource Allocation Type Info’ = 1

( 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’

>> RBs in RBG sub-set Int 0 268435 0


455
(Or
0xFFFF
FFF)

A bit-field of 28 bits to indicate the RB indices in the range of 0 to 27


that are used. The bit-field is represented as a hexadecimal number
with 7 digits where digit specifies a bit field of length 4. The RB
indices count upwards starting at 0 from the least significant bit of the
least significant hex digit. A bit-field of ‘1’ indicates that the RB with
the corresponding RB index is present.
For 1.4MHz BW, only the least significant 6 bit-fields can be used.
For 3MHz BW, only the least significant 8 bit-fields can be used.
For 5MHz BW, only the least significant 13 bit-fields can be used.
For 10MHz BW, only the least significant 18 bit-fields can be used.
For 15MHz BW, only the least significant 20 bit-fields can be used.
For 20MHz BW, all the bit-fields can be used.

>> RBG sub-set shift Int 0 1 0


)
0 = left justified
1 = right justified

> Choice ‘Downlink Resource Allocation Type Info’ = 2

( Enum -0 … 99 0

99
MAC layer commands

Parameter name Type Min Max Default


>> RB start
Resource blocks star index
0...99 = RB start

>> RB length Enum 1 … 100 1


)
Number of resource blocks
1...100 = RB length

> Number of codewords Enum 1...2

1 = Only codeword 0 (not available for ‘DL-SCH control table


override operation’ is ‘forced event’)
2 = Codewords 0 and 1 (not available for ‘DL-SCH control table
override operation’ is ‘forced event’)

> 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

>> NDI Int 0...1

New data indicator.


0...1 = NDI value

>> MCS Int 0...31


}
Modulation and coding scheme.
0...31 = MCS 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.

[ Int -2, 0...63 0


> Precoding info
-2 = Use signalled value (not available if ‘DL-SCH control table
] override operation’ is ‘forced time’)
0...63 = Precoding info

Number of layers Int 1...4 1

Number of transmission layers, based on the DL transmission mode


Note: Number of layers = 4 is not supported in this release

Precoding Index Int -2,0,1,2,3 0

100
MAC layer commands

Parameter name Type Min Max Default

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

DCI Format Int 1...9 1

Aggregation Level Int 0...3 0

Defines the search spaces and DCI formats.


Section 9.1.1 of 36.213 v8.5.0

Search Type Int 0...1 0

Defines the search space.


0 = UE specific search space.
1 = Common search space.

Candidate Index Int 0...5 0

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

101
MAC layer commands

Parameter name Type Min Max Default

Identification of cell from user perspective

OnDurationTimer Enum 1, 2, 3, 4, 5, 6, 8, 10, 20, 30,


40, 50, 60, 80, 100, 200

1- psf1, 2- psf2, 3 - psf3, 4 - psf4, 5 - psf5, 6 - psf6, 8 - psf8, 10 - psf10, 20 -


psf20, 30 - psf30, 40 - psf40, 50 - psf50, 60 - psf60, 80 - psf80, 100 -
psf100, 200 - psf200
OnDurationTimer information element is specified in 36.331

drx-InactivityTimer Enum 1, 2, 3, 4, 5, 6, 8, 10, 20, 30,


40, 50, 60, 80, 100, 200, 300,
500, 750, 1280, 1920, 2560
1 - psf1, 2 - psf2, 3 - psf3, 4 - psf4, 5 - psf5, 6 - psf6,8 - psf8, 10 - psf10, 20
- psf20, 30 - psf30, 40 - psf40,50 - psf50, 60 - psf60, 80 - psf80, 100 -
psf100,200 - psf200, 300 - psf300, 500 - psf500, 750 - psf750,1280 -
psf1280, 1920 - psf1920, 2560 - psf2560
drx-InactivityTimer information element is specified in 36.331

drx-RetransmissionTimer Enum 1,2,4,6,8,16,24,33

psf1, 2- psf2, 4 - psf4, 6 - psf6, 8 - psf8, 16 - psf16, 24 - psf24, 33 - psf33


drx-RetransmissionTimer information element is specified in 36.331

longDrxCycle 10, 20, 32, 40, 64, 80, 128, 160,


256, 320, 512, 640, 1024, 1280,
Enum 2048, 2560

10 - sf10, 20 - sf20, 32 - sf32, 40 - sf40, 64 - sf64, 80 - sf80, 128 - sf128,


160 - sf160, 256 - sf256, 320 - sf320, 512 - sf512, 640 - sf640, 1024 -
sf1024, 1280 - sf1280, 2048 - sf2048, 2560 - sf2560
LongDrxCycle information element is specified in 36.331

drxStartOffset Int 0 2559

drxStartOffset information element is specified in 36.331

StartGrant Int 1 1000

Tick for the start of the grant during active cycle

StopGrant Int 1 1000

Tick for the start of the grant during active cycle

Reserved Int 0 0

Reserved for future use

Reserved Int 0 0
Reserved

Reserved for future use

Reserved Int 0 0

Reserved for future use

shotDrxEnable Int 0 1

102
MAC layer commands

Parameter name Type Min Max Default

0 - Disable
1 – Enable

(
2, 5, 8, 10, 16, 20, 32, 40, 64, 80,
shortDRX-Cycle Enum 128, 160, 256, 320, 512, 640

2 - sf2, 5 - sf5, 8 - sf8, 10 - sf10, 16 - sf16, 20 - sf20, 32 - sf32, 40 - sf40, 64


- sf64, 80 - sf80, 128 - sf128, 160 - sf160, 256 - sf256, 320 - sf320, 512 -
sf512, 640- sf640
shortDRX-Cycle information element is specified in 36.331

drxShortCycleTimer Int 1 16

drxShortCycleTimer information element is specified in 36.331

Reserved Int 0 0
Reserved

Reserved for future use

Reserved Int 0 0

Reserved for future use

Reserved Int 0 0

Reserved for future use

Reserved Int 0 0

Reserved for future use

Reserved Int 0 0

Reserved for future use

Reserved Int 0 0
)
Reserved for future use

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It


includes the cell number.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

PCH MCS Int -1,0...31

MCS value used for the transmission of SIB messages.


-1- Use the value from MACCONFIGDLSCHCommand

PCH NRB Int -1,1...100,1001,1004

Number of resource blocks used for the transmission of PCH messages.


-1- Use the value from MACCONFIGDLSCH command
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.

PCH START RB Int 1 100

Start RB value used for the transmission of SIB messages.

DCI Format
Int 0,1

0 – DCI Format 1A
1- DCI Format 1 C

Gap Type Int 0 2

0 -- DVRB Off
1 or 2 --- Distribution of VRBs to be done with this gap type.

Reserved Int 0

Reserved

104
MAC layer commands

Parameter name Type Min Max Default

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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It


includes the cell number.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

RA ResponseWindowSize Enum 2 10

2 – sf2, 3 – sf3, 4 – sf4, 5 – sf5, 6 – sf6, 7 – sf7, 8 – sf8, 9 – sf9, 10 – sf10


RACH-ConfigCommon information element is specified in 36.331

ContentionResolutionTimer Enum 8, 16, 24, 32, 40, 48, 56, 64

8 - sf8, 16 - sf16, 24 - sf24, 32 - sf32, 40 - sf40, 48 - sf48, 56 - sf56, 64 -


sf64
RACH-ConfigCommon information element is specified in 36.331

[ Bool 0 1 0

Rach-preambleindex Rach-preambleindexexplicit is set when Rach-preambleindex is dedicated


explicit set for the UE.

] Enable – 1
Disable - 0

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It


includes the cell number.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

[ Int 1 20
Number of Entries
Number of entries supplied in this command
]

For each ‘Number of entries’ supplied (1...20)

{ Int -1, 0...31


RAR IMCS
MCS value used for the transmission of random access response.
-1- Use the value from the MACCONFIGDLSCH Command

RAR RB Int -1,1...100,1001,1004

Number of RB value used for the transmission of random access response.


-1- Use the value from MACCONFIGDLSCHCommand
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

RAR RB Start Int -1, 0...98

[ Int 0 15 0
Backoff Indication
Back off indication value used for the transmission of random access
] response.

RAR Timing Advance Int -1, 0...63

Timing advance value used in random access response.


-1 – TA calculated from RACH preamble received

RAR Temp CRNTI Int -1, 1...65522

CRNTI value used in random access response.


-1 – CRNTI used from MACCONFIGDLCH command

[ Int 0 1 0
Hopping Flag
Hopping flag value used in random access response.
]
CQI Request Flag Int -1,0,1

CQI request flag value used in Random Access Response.


-1 – Use value 0 for network entry. Use value based on Scheduler command
for non- network entry RACH procedure.

107
MAC layer commands

Parameter name Type Min Max Default

Msg3 IMCS Int -1, 0...15

MCS value used in Random Access Response.


-1 – MCS value used from MACConfigDlsch command.

Msg3 RB Int -1,1...100

Number of RB value used in Random Access Response.


-1 – RB value used from MACConfigDlsch command

[ Int 0 99 0
Msg3 RB Start
RB Start value used in Random Access Response.
]
TPC Int -1,0...7

TPC value used in Random Access Response.


-1 – Calculated from RACH preamble received

[ 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

0 – Enable the RACH response


1 – Disable the RACH response.

Reserved Int 0 0 0

Reserved for future use

Reserved Int 0 0 0

Reserved for future use

Reserved Int 0 0 0
}
Reserved for future use

108
MAC layer commands

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It includes


the cell number.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

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 Int 0 7

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

Parameter name Type Min Max Default

[ Int 0 2047
PucchResourceIndex
sr-PUCCH-ResourceIndex
]
Reference: Spec 36.321 and 36.331

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It


includes the cell number.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It


includes Cell_Number

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Number of logical channels Int 1 28

Number of logical channels supplied in this command.

For each ‘Number of logical channels’ supplied (up to 28)

{ 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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It


includes the cell number.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Number of logical channels Int 1 28

Number of logical channels supplied in this command.

For each ‘Number of logical channels’ supplied (up to 28)

{ 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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It


includes Cell Number

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

UL Bandwidth Enum 3, 5, 10, 14, 15, 20

112
MAC layer commands

Parameter name Type Min Max Default

14-1.4 MHz, 3-3 MHz, 5-5MHz, 10-10 MHz, , 15-15 MHz, 20-20 MHz

[ Int 0 1 0
Dynamic Scheduling
]

Enable or disable dynamic scheduling


0 – Disable dynamic scheduling
1 – Enable dynamic scheduling
2- BSR based scheduling
Note: Value 2 has been deprecated. BSR based scheduling is
available in the command MacConfigSchdBaseSr

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It


includes cell number.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

SPS-RNTI Int 10 65522

SPS Radio Network Temporary Identifier.

113
MAC layer commands

Parameter name Type Min Max Default

Scheduling Interval Enum 10, 20, 32, 40, 64,80,


128, 160, 320, 640

sf10 = 10,
sf20 = 20,
sf32 = 32,
sf40 = 40,
sf64 = 64,
sf80 = 80,
sf128 = 128,
sf160 = 160,
sf320 = 320,
sf640 = 640

Release after Number of Enum 2,3,4,8


Transmission
e2 = 2,
e3 = 3,
e4 = 4,
e8 = 8

Hopping Flag Enum , 0, 1

This is the result from the previous transmission on the HARQ.


0 = Disable hopping
1 = Enable hopping

Hopping Information Int 0, ... 3

This parameter is ignored unless the ‘Hopping flag’ parameter is


enabled.

RB Start Int 1...99

1...99 = The lowest indexed RB assigned

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’.

I_MCS Int 0...20, 29...31

0...20 = Index Transport Format and Redundancy Version


29...31 = Index Redundancy Version

NDI Flush Enum -2, 0, 1

114
MAC layer commands

Parameter name Type Min Max Default

-2 = Signalled value (only supported if grant operation is -2)


0 = Do not flush HARQ buffer
1 = Flush associated HARQ buffer
The meaning of this parameter is fixed across TTIs (that is, it does
not need to toggle to indicate flush unlike the 3GPP NDI).
DMRS cyclic shift Enum 0...7

0...7 = Cyclic shift

CQI Request Enum 0, 1

0 = CQI not requested


1 = CQI requested

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

115
MAC layer commands

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It includes


the cell number.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It includes


the cell number.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Logical channel type Enum 0 8

0 = BCCH (not currently supported)


1 = Downlink DCCH
2 = Downlink DTCH
3 = Uplink DCCH
4 = Uplink DTCH
5 = Downlink PCCH
6 = Downlink CCCH
7 = Uplink CCCH
8 = BCCH-DL-SCH
Choice 'Logical channel type' is 1, 2, 3, 4, 6 or 7
( Int 0 27
Logical Channel Identity
)

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It includes


the cell number.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Number of Radio Bearers Int 1 8

Number of radio bearers supplied in this command

For each Number of Radio Bearers supplied (up to 8)

{ Int 0 34
> Radio Bearer Identity
0 = SRB0
1 = SRB1
2 = SRB2
3...34 = DRB1…DRB32(DTCH)

> Downlink logical channel Enum 1, 2


type 1 = Downlink DCCH
2 = Downlink DTCH
> Downlink logical channel Int 0 27
identity
Logical channel to connect to
> Uplink logical channel type Enum 3, 4
3 = Uplink DCCH
4 = Uplink DTCH
> Uplink logical channel Int 0 27
identity
Logical channel to connect to

118
RLC layer commands

Parameter name Type Min Max Default

> 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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It


includes cell number and radio bearer identity.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Number of Radio Bearers Int 1 8

Number of radio bearers supplied in this command

For each Number of Radio Bearers supplied (up to 8)

{ 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)

> Logical channel type Enum 0, 1, 2, 5, 6, 8


0 = BCCH
1 = Downlink DCCH
2 = Downlink DTCH
5 = Downlink PCCH
6 = Downlink CCCH
8 = BCCH-DL-SCH

120
RLC layer commands

Parameter name Type Min Max Default

> Choice ‘Logical channel type’ is 1, 2 or 6


( Int 0 27
>> Downlink logical channel Logical channel to connect to
identity
)
> 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

Timer based SDU discard in ms


0 = No RLC timer based discard

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It


includes cell number and radio bearer identity.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Number of Radio Bearers Int 1 8

Number of radio bearers supplied in this command

121
RLC layer commands

Parameter name Type Min Max Default

For each Number of Radio Bearers supplied (up to 8)

{ Int 0 34
> Radio Bearer Identity
0 = SRB0
1 = SRB1
2 = SRB2
3...34 = DRB1…DRB32(DTCH)

> Logical channel type Enum 1, 2, 6


1 = Downlink DCCH
2 = Downlink DTCH
6 = Downlink CCCH
> Downlink logical channel Int 0 27
identity
Logical channel to connect to
> SN Size Int 5, 10
The size of the SN field
> SDU discard timer Int 0, 10, 20, 30, 40, 50, 60, 70,
} 80, 90,
100, 250, 500, 750, 1000,
1250,
1500, 1750, 2000, 3000,
3500,
4000, 4500, 5000, 7500

Timer based SDU discard in ms


0 = No RLC timer based discard
[ Bool 0 1 0
Reset This parameter is ignored if not modifying
] 1 = Clear radio bearer state
0 = Maintain radio bearer state

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It


includes Cell_Number and Radio bearer Identity.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Number of Radio Bearers Int 1 8

Number of radio bearers supplied in this command

For each Number of Radio Bearers supplied (up to 8)

{ Int 0 34
> Radio Bearer Identity
0 = SRB0
1 = SRB1
2 = SRB2
3...34 = DRB1…DRB32(DTCH)

> Logical channel type Enum 3, 4, 7


3 = Uplink DCCH
4 = Uplink DTCH
7 = Uplink CCCH
> Uplink logical channel Int 0 27
identity
Logical channel to connect to
}

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It


includes cell number and radio bearer identity.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Number of Radio Bearers Int 1 8

Number of radio bearers supplied in this command

For each Number of Radio Bearers supplied (up to 8)

{ Int 0 34
> Radio Bearer Identity
0 = SRB0
1 = SRB1
2 = SRB2
3...34 = DRB1…DRB32(DTCH)

> Logical channel type Enum 3, 4, 7


3 = Uplink DCCH
4 = Uplink DTCH
7 = Uplink CCCH
> Uplink logical channel Int 0 27
identity
Logical channel to connect to
> SN Size Int 5, 10
The size of the SN field
[ Int 0, 5, 10, 15, 20, 25, 30, 35,
> Reordering Timer 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 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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It


includes cell number and radio bearer identity.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Radio bearer id Int -3 31

-2 (not currently supported)

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request. It


includes cell number and radio bearer identity.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Number of access bearers Int 1 13

Number of access bearers supplied in this command

{ Int 1 34
> PDCP access bearer id
Access bearer identity
1 … 34 = DCCH, DTCH

> Radio bearer identity Int 1 34

Radio bearer to connect to


1 … 34 = DCCH, DTCH

> CipheringState Int 0 2


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

> IntegrityState Int 0 2

126
PDCP layer access bearer commands

Parameter name Type Min Max Default

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

> Direction Enum 0 2

} 0 = Bidirectional
1 = Uplink
2 = Downlink

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Number of access bearers Int 1 13

Number of access bearers supplied in this command

{ Int -3 34

127
PDCP layer access bearer commands

Parameter name Type Min Max Default


> PDCP access bearer id Access bearer identity
-3 = BCCH-DL-SCH
-2 = BCCH
-1 = PCCH
0 = SRB0(CCCH)
1 = SRB1(DCCH)
2 = SRB2(DCCH)
3…34 = DRB1…DRB32(DTCH)

> Radio bearer identity Int -3 34


Radio bearer to connect to
-3 = BCCH-DL-DSCH
-2 = BCCH
-1 = PCCH
0 = SRB0(CCCH)
1 = SRB1(DCCH)
2 = SRB2(DCCH)
3…34 = DRB1….DRB32(DTCH)

> Bearer type Enum 0 1


0 = Signalling Radio Bearer
1 = Data Radio Bearer

> PDCP mode Enum 0 1


0 = Use PDCP transparently, effectively disabling normal PDCP operation
1 = Normal PDCP operation
> Choice ‘PDCP mode’ is 1
( Int 0, 50, 100, 150, 300, 500, 750,
> SDU discard timer 1500,

Timer based SDU discard in milliseconds


0 = no PDCP timer based discard
Refer to specs 36.331 for PDCP discard timer value

> PDCP SN size Int 5, 7, 12


5 = Only valid for Signalling Radio Bearer
7 = Only valid for Data Radio Bearers in RLC UM
12 = Only valid for Data Radio Bearers in RLC AM and UM

> RLC mode Enum 0 2


0 = UM
1 = AM
2 = TM
> Choice ‘RLC mode’ is AM
( Bool 0 1
> Status report required 0 = Status Report is not required
1 = Status Report Is required
> Flush timer Int 10, 50, 100, 150, 200, 250,
) 500
In Ms
> ROHC configured Bool 0 1 0
) 0 = ROHC disabled
} 1 = ROHC enabled

128
PDCP layer access bearer commands

Parameter name Type Min Max Default

> Choice ‘ROHC Configured’


is 1

( Int 1 16383 15

> Max CID Indicates the value of the MAX_CID parameter as specified in 36.323

> ROHC Profiles Int 0 0x1FF 0

)
} 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:

Bit 0 (LSB) = profile0x0001 (RTP/UDP/IP, RFC 4995)


Bit 1 = profile0x0002 (UDP/IP, RFC 3095, RFC4815)
Bit 2 = profile0x0003 (ESP/IP, RFC 3095, RFC4815)
Bit 3 = profile0x0004 (IP, RFC 3095, RFC4815)
Bit 4 = profile0x0006 (TCP/IP, RFC 4996)
Bit 5 = profile0x0101 (RTP/UDP/IP, RFC 5225)
Bit 6 = profile0x0102 (UDP/IP, RFC 5225)
Bit 7 = profile0x0103 (ESP/IP, RFC 5225)
Bit 8 = profile0x0104 (IP, RFC 5225)

Profile0x0000 is always available if RoHC is configured.


If support of two ROHC profile identifiers with the same 8 LSBs is
signalled, only the profile corresponding to the highest value is applied.

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Ciphering Info Present Int 0 2

0 = Ciphering not required


1 = Ciphering required
2 = Ciphering keys to be applied after handover message.
Option 2 should only be used if user wants to perform handover using
DLSIGDATAREQ with delivery indication set to 3
Choice ‘Ciphering Info Present’ is ‘1’

( HEX STRING

KRRCenc [16] Control plane ciphering key of length 16 octets

KUPenc [16] HEX STRING

User plane ciphering key of length 16 octets

Enum 0 1 0
Supported Ciphering
Algorithm
0 = NULL
)
1= Encryption algorithm SNOW 3G
2 = EPS encryption algorithm AES-128

Integrity Info Present Int 0 2

0 = Integrity not required


1 = Integrity required
2 = Integrity keys to be applied after handover message.
Option 2 should only be used if user wants to perform handover using
DLSIGDATAREQ with delivery indication set to 3
Choice ‘Integrity Info Present’ is ‘1’

( 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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

130
PDCP layer access bearer commands

Parameter name Comment

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

PDCP access bearer id Int -3 34

Access bearer identity to delete


-2 (not currently supported)

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

PDCP access bearer id Int -3 34

Access bearer identity to reset the PDCP buffer (without deletion)


-2 (not currently supported)

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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:

Data entity definition and test modes


Depending on the test mode, each data entity must be defined using one of the commands
DeConfigLogCh, DeConfigRb or DeConfigAb. This connects channels or bearers to data entity IDs.
Data entities can be uplink only, downlink only, or bidirectional.

Data entity type


Depending on data entity type, a data entity must then be configured with at least one attribute
using DeConfigPneAttrib, DeConfigFfeAttrib, DeConfigFfgAttrib, DeConfigPngAttrib,
DeConfigTdiAttrib, or DeConfigIPAttrib.

Data entity direction


For bidirectional data entities, it is necessary to apply uplink and downlink, or bidirectional attributes
to the data entity.
• The command DeConfigTdiAttrib is used to configure attributes for bidirectional data entities. In
the case of unidirectional data entities, it is only necessary to apply either uplink or downlink, or
bidirectional, attributes to a data entity:
• The commands DeConfigFfeAttrib and DeConfigPneAttrib are used to configure attributes for
unidirectional uplink data entities.
• The commands DeAddToFfgBuffer and DeConfigPngAttrib are used to configure attributes for
unidirectional downlink data entities. Additional properties are available for the downlink to be
applied to a data entity using the DeConfigDlDataProfile command. This enables configuration
of a time varying data stream rate.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Data entity Id Int 1 38

Identifier of the data entity to apply this information to.

Number of entries Int 1 255

Number of entries supplied in this command


For each ‘Number of entries’ supplied (up to 255)

{ Int 0 1500

> Number of SDUs

> Byte size of SDU Int 1 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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Data entity Id Int 1 38

Identifier of the data entity to apply this information to.

Fixed frame buffer identity Int 1 8

Buffer identifier

Number of bytes Int 1 255


Number of bytes supplied in the command.
For each ‘Number of bytes’ values supplied (up to 255)

{ Int 0 255

> Byte values for buffer


}

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Data entity Id Int 1 38

135
Data entity commands

Parameter name Type Min Max Default

Identifier of the data entity to apply this information to.

Fixed frame buffer identity Int 1 8

Buffer identifier

Number of bytes Int 1 255


Number of bytes supplied in the command
For each ‘Number of bytes’ values supplied (up to 255)

{ Int 0 255

> Byte values for buffer


}

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Data entity Id Int 1 38

Unique identifier for the access bearers data entity

136
Data entity commands

Parameter name Type Min Max Default

Access bearer id Int -3 34

Access bearer identifier

[ Enum 0 2 0
Direction
Direction of data entity
]
0 = Bidirectional
1 = Uplink
2 = Downlink

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Data entity Id Int 1 38

Identifier of the data entity to apply this information to.

Flow control Bool 0 1

0 = Allow overflow of DL buffer


1 = Do not allow overflow of DL buffer

137
Data entity commands

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Data entity Id Int 1 38

Identifier of the data entity to apply this type to

[ Int 5410 5429 5410


TCP port number Same port must be used when using EDIP for signalling radio bearers.
]

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Data entity Id Int 1 38

Identifier of the data entity to apply this type to

Number of buffers Int 1 8

Number of available buffers


Each buffer is associated with an SDU

[ Bool 0 1 0

Auto resynchronize 0 = Disabled


] 1 = Resynchronize automatically after 20% or greater synchronization
loss

[ 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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Data entity Id Int 1 38

Identifier of the data entity to apply this type to

Number of buffers Int 1 8

Number of available buffers


Each buffer is associated with an SDU

[ Int 0 255 0
Padding byte value
Padding byte value to use on under run
]

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Data entity Id Int 1 38

Identifier of the data entity to apply this type to

IP Version Type Int 0 2

0 – IPV4
1 – IPV6
2- IPV4V6
3 – nackIPV6
4 – nackIPV4V6

For the values of IP Version Type = 3 or 4 (Not to be given for 0, 1 and 2)


(

numRetriesForNack Int -1 65535

Number of IP entries Int 1 16

Number of IP address entries supplied in the command


For each ‘Number of IP entries’ supplied (up to 16)
{

Choice ’IP Version Type’ is 2

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

Parameter name Type Min Max Default

> Subnet mask/ Prefix String 0.0.0.0 255.255


.255.25
Length
5
For IPV4 - Net mask in dotted notation
For IPV6 – Prefix Length values 64 to 128

[ Enum 0 1 0

>Address type Source or destination address specified


] 0 = Source
1 = Destination

[ Bool 0 1 0

>Inverse 0 = Route matching packets


1 = Route non-matching IP packets
]

[ Int 0 65535 0

> Source port range lower 0 = Port number ignored


number
1...65535 = Lower range of port number (inclusive)
This parameter is ignored for an uplink channel.
Int 0 65535 0

> Source port range upper 0 = Port number ignored


number
1...65535 = Upper range of port number (inclusive)
]
This parameter is ignored for an uplink channel.

[ Int 0 65535 0

> Destination port range 0 = Port number ignored


lower number
1...65535 = Lower range of port number (inclusive)
This parameter is ignored for an uplink channel.
Int 0 65535 0

> Destination port range 0 = Port number ignored


upper number
1...65535 = Upper range of port number (inclusive)
]
This parameter is ignored for an uplink channel.
}

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Data Entity Id Int 1 38

Unique identifier for the logical channels data entity

[ Enum 0, 1, 2, 5, 6, 8

DL logical channel type


Logical channel type
0 = BCCH
1 = Downlink DCCH
2 = Downlink DTCH
5 = Downlink PCCH
6 = Downlink CCCH
8 = BCCH-DL-SCH

Choice ‘DL logical channel type’ is 1, 2, or 6

( 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

UL logical channel identity Int 0 27


]
Logical channel identifier

143
Data entity commands

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Data entity Id Int 1 38

Identifier of the data entity to apply this type to

Sequence type Enum 0 5

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

[ Bool 0 1 0

Auto resynchronize 0 = Disabled


] 1 = Resynchronize automatically after 20% or greater sync loss

[ Int 0 100 0

144
Data entity commands

Parameter name Type Min Max Default

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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Data entity Id Int 1 38

Identifier of the data entity to apply this type to

Sequence type Enum 0 5

145
Data entity commands

Parameter name Type Min Max Default

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

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Data entity Id Int 0 255

Identifier of the data entity to apply this type to

Bearer Type Int 0 1 0

0 = Default
1 = Dedicated

146
Data entity commands

Parameter name Type Min Max Default

IP Address String 0.0.0.0 255.255.255.255

IPv4 address in dotted notation


This is the IP address of the destination for the UL and as well for DL.

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Data entity Id Int 1 38

Unique identifier for the radio bearers data entity

Radio bearer id Int -3 34

Radio bearer identifier

[ Enum 0 2 0

147
Data entity commands

Parameter name Type Min Max Default


Direction
Direction of data entity
]
0 = Bidirectional
1 = Uplink
2 = Downlink

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Data entity Id Int 1 38

Identifier of the data entity to apply this type to

TCP port number Int 5410 5429

Unique TCP/IP port number for this data entity

[ Int 1 1500 100

Downlink SDU size Size to use for DL SDUs.


] 1…1500 = DL SDU size for RLC_MODE, PDCP_MODE or
FULL_PROTOCOL_MODE
Omitted if not using RLC_MODE, PDCP_MODE or
FULL_PROTOCOL_MODE.

148
Data entity commands

Parameter name Type Min Max Default

[ Int 1 1500 2

Downlink maximum 1…1500 = Maximum number of SDUs to transfer in a frame for


number of SDUs MAC_MODE, RLC_MODE, PDCP_MODE or FULL_PROTOCOL_MODE
] Omitted if not using MAC_MODE, RLC_MODE, PDCP_MODE or
FULL_PROTOCOL_MODE.

[ Int 0 255 0

Padding byte value Padding byte value to use on under-run on the uplink

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Data entity Id Int 1 38

Identifier of the data entity to apply this type to

Destination IP address String 0.0.0.0 255.255.2


55.255

IPv4 address in dotted notation


This is the IP address of the destination for the UL.
Use 0.0.0.0 when specifying an entry for an DL only channel.

Destination UDP port Int 0 65535

149
Data entity commands

Parameter name Type Min Max Default


number
Unique UDP/IP port number used for UL data for this data entity.
Use 0 when specifying an entry for a DL only entity.

Source UDP port number Int 0, 5410…5429

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

Downlink UDP 0 = Up to one UDP packet per transport block


concatenate size
1…6250 = Fill transport block with ‘TrBlk size’ DIV ‘Downlink UDP
] concatenate size’, rounded down to the closest integer value, whole UDP
packets. Padding bytes are appended as appropriate.
Ignored if not using HARQ_MODE or MAC_MODE.

[ Int 0 150 0

Downlink maximum 0 = Use all available packets to transfer in a frame


number of SDUs
1…150 = Maximum number of SDUs to transfer in a frame for
] RLC_MODE, PDCP_MODE or FULL_PROTOCOL_MODE.
Ignored if using HARQ_MODE or MAC_MODE.

[ Int 0 255 0

Padding byte value Padding byte value to use on under-run on the uplink.
]

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Sae Bearer ID Int -1 34

Sae bearer identity


-1 = PCCH
0 … 34 = CCCH, DCCH, DTCH

Delivery Indication Required Int 0 3


0 = Delivery Indication not required
1 = Delivery Indication required
2 = Indicates SISO Handover message
3 = Indicates MIMO Handover message in single box.

RRC Msn Int 0 65535

NOTE: This parameter needs to be given only if L2/L3 message syncing


is required.

Data Length Int

Length of data

Data HEX STRING

RRC data in UPER encoded format. NAS data, if present, is always


embedded in RRC data.

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

151
RRC signaling commands/indications

Parameter name Comment

RETURN_TEXT Text describing the success or failure of the request.

CELL_NUMBER Identification of the Cell using which signalling data path has
been established

SAE BEARER ID PDCP bearer ID on which signalling data is sent

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Sae Bearer ID Int -1 34

Sae bearer identity


-1 = PCCH
0 … 34 = CCCH, DCCH, DTCH

pdcpSN Int 0 4095

PDCP Sequence Number

deliveryInd Int 0 1

Indicates the outcome of the data delivery


1 = Data delivered successfully
0 = Data delivery failed

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Sae Bearer ID Int -1 34

Sae bearer identity


-1 = PCCH
0 … 34 = CCCH, DCCH, DTCH

Data Length Int

Length of data

Data HEX STRING

RRC data in UPER encoded format. NAS data, if present, is always


embedded in RRC data.

Rrc Msn Int 0 65535

NOTE: This parameter is available if synching is on for l2/l3 messages.

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

Parameter name Type Min Max Default

cellId Int 0 63

Identification of cell from user perspective

Rbid Int 0 10

-1: Invalid value. It is received for MAC PDU

PduSduType Int 1 4

1 – Mac PDU
2 – RLC PDU
3 – PDCP PDU
4 – PDCP SDU
No of TTI Int 1 65535

1 for Mac and RLC


>= 1 for PDCP
No of PDUs Int 1 65535

{length, pdu}> Length,


value
pair

Length is the length of the Hex string received in value.


Value is the hex string of MAC or RLC or PDCP PDU

SFN Int 0 1023

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

Parameter name Type Min Max Default


CQI Report Number Int 1 20

To get the total number of CQI report from UE

Time Interval Int 1 40000

This is the time interval in millisecond between two CQI reports.


Note: - For periodic this time interval is recommended as 1ms.

Indication
CMPI L2 CQISTATINDICATION <PARAMETER>

Parameter name Type Min Max Default


Cell Number Int 0 63

Identification of cell from user perspective


SFN Int 0 1023
Frame Number
SUBFRAME Int 0 9
TTI
Report Type Int 0 1
Report Type is 0 for Aperiodic CQI report
( Int 0 15
Wide Band Code
Word 0 CQI

Wide Band Code Int 0 15


Word 1 CQI
Number of sub Band Int 0 13
{ Int 0 3
Sub Band
Differential CQI code
word 0 This is the sub-band differential CQI value for each sub-band code word 0.
If this is not a valid value it displays as ‘-‘.

155
Layer 2 commands

Parameter name Type Min Max Default


Sub Band Int 0 3
Differential CQI
This is the sub-band differential CQI value for each sub-band code word 1.
Code Word 1
If this is not valid value it displays as ‘-‘.
}
)
Report Type is 1 for periodic
( Int 1 4
Reporting Type from 1- Sub band report
UE
2- Wide band Report with PMI
3- Rank Indication Report
4- Wide band Report

Number of sub band Int 1 13


Sub band number Int 0 12
This is sub-band number of the CQI report.
Code word 0 sub Int 0 15
band CQI value
This is the code word 0 sub-band CQI value

Sub band differential Int 0 7


CQI code word 1
This is the Sub-band code word 1 differential CQI value.
So final CQI value of code word 1 = code word 0 Sub-band CQI value – code word 1 sub-
band differential CQI

Code word 0 Wide Int 0 15


band CQI value
This is the code word 0 wide band CQI value.
Code word 1 wide Int 0 7
band differential CQI
value This is the wide band code word 1 differential CQI value.

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

FORW L2 MAC GETCRCSTATS<PARAMETERS>

Request parameter

Parameter name Type Min Max Default

Number of CRCHARQ Int 1 100


indication
This is the total no of CRC HARQ status indications that the L2 layer sends to the application layer.

Time interval int 1 4000

This is the time interval in millisecond for which HARQ and CRC status are calculated for one CRC
HARQ status indication.

Indication

CMPI L2 CRCSTATINDICATION <PARAMETER>

Parameter name Type Min Max Default

Cell Number int 0 63

Identification of cell from user perspective

Number of Code Word int 1 2 1


in DL
This is Code word number and depends on the selected transmission mode type.
Ex- For single antenna port 0 it is 1 and for close loop spatial multiplexing it is 2.

Down-link ACK Int 0 4000

This is the total number HARQ ACK in specified time interval

Down-link NACK Int 0 4000

This is the total HARQ NACK in specified time interval

Down -link BLER float 0 100

Down-link BLER = (NACK/(ACK+NACK)):

Up-link CRC Pass Int 0 4000

This is the total CRC pass in specified time interval

157
Layer 2 commands

Up-Link CRC Fail Int 0 4000

This is the total number of crc fail in specified time interval

Up-link BLER float 0 100

Up link BLER – (CRC fail)/(CRC fail + CRC pass))

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

Parameter name Values

SUB Layer MAC – MAC Layer


RLC – RLC Layer
PDCP_PDU or PDCP– For PDCP PDU
PDCP_SDU – For PDCP_SDU

Parameters

Parameter name Type Min Max Default

cellNum (Cell Number) Int 0 63

Identification of cell from user perspective

enable Int 0 1

0 to Stop receiving indications and 1 to start receiving indications.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

PDCP access bearer id Int -3 34

Access bearer identity to reset the PDCP buffer (without deletion)


-2 (not currently supported)

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating the success or failure of the request.

RETURN_TEXT Text describing the success or failure of the request.

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

SFN Int -1 1023

System Frame Number

159
Layer 2 commands

Subframe Int -1 9

Subframe Number

Period Int 1 50

UL grant to be sent after the given period.

NoOfGrants Int 1 50

Number of times UL grant is send.

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating success or failure of request.

RETURN_TEXT Text to indicate success or failure of request.

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

Parameter name Type Min Max Default

Int 0 63
Cell Number
Identification of cell from user perspective

Int 0 1
Enable
1 – Enable
0 – Disable

Choice ‘Enable’ is 1

SFN Int 0 1023

System Frame Number

Sub Frame Number Int 0 9

Number of Code Word Int 1 2

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

Data Length Code Word 1 Int 1 1024

Length of data

Data Code Word 1 HEX STRING

Data Length Code Word 2 Int 1 1024

Length of data

Data Code Word 2 HEX STRING

Confirm parameters

Parameter name Comment

RETURN_CODE Number indicating success or failure of request.

RETURN_TEXT Text to indicate success or failure of request.

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

Parameter name Values

SUB Layer MAC – MAC Layer


RLC – RLC Layer
PDCP_PDU or PDCP– For PDCP PDU

Parameters:

Parameter name Type Min Max Default

cellNum (Cell Number) Int 0 63

Identification of cell from user perspective

Choice’ SUB Layer’ is RLC or PDCP/PDCP_PDU/PDCP_SDU

RBId Int 0 10

To be sent only for RLC and PDCP PDUs

HarqProcessId Int

Needs to be sent but not currently in use

SFN Int 0 1023

Need to send -1 if PDU is to be sent on next available SFN

SubFrameNumber Int 0 9

Need to send -1 if PDU is to be sent on next available SubFrameNumber

Choice’ SUB Layer’ is MAC

aflagSuppressPdcchFor Int
C_RNTI
Need to be sent only for MAC PDUs. Not currently in use.

NumberOfCodeWords Int 1 2

Need to be sent only for MAC PDUs.

PduLength Int 1 1024

Length of PDU

Pdu Data HexString

PDU

Choice’ SUB Layer’ is MAC and ‘NumberOfCodeWords’ is 2

Codeword2 PduLength Int 1 1024

Length of PDU

Codeword2 Pdu Data HexString

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

Parameter name Type Min Max Default

Downlink Enable Int 0 1

0-Disable
1-Enable

Uplink Enable Int 0 1

Note: Uplink Enable is not supported in this release

Interval (ms) Int 1 2000

This is the required interval in ms within which ACK or NACK status is sent.

Indication
CMPI L2 HARQSTATSINDICATION <Parameters>

Indication parameters

Parameter name Type Min Max Default


Cell Number Int 0 63

For each Harq Process (0...7)


Number of ACK Codeword0 Int 0 65535

,
NumberofNACKCodeword0 Int 0 65535
,

Number of DTX Codeword0 Int 0 65535


,

Number of ACK Codeword1 Int 0 65535


,

NumberofNACKCodeword1 Int 0 65535


,

163
Layer 2 commands

Parameter name Type Min Max Default


Number of DTX Codeword1 Int 0 65535
,

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

Parameter name Type Min Max Default

sendRachRarIndication Int 0 1

0 – Disable the RACH/RAR indications


1 – Enable the RACH/RAR indications

Reserved 1 This parameter is unused. Set to 0.

Reserved 2 This parameter is unused. Set to 0.

Reserved 3 This parameter is unused. Set to 0.

Reserved 4 This parameter is unused. Set to 0.

Reserved 5 This parameter is unused. Set to 0.

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

Parameter name Values

SUB Layer MAC – MAC Layer


RLC – RLC Layer
PDCP_PDU or PDCP– For PDCP PDU

164
Layer 2 commands

Parameters

Parameter name Type Min Max Default

cellNum (Cell Number) Int 0 63

Identification of cell from user perspective

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

Reserved 1 This parameter is unused. Set to 0.

Reserved 2 This parameter is unused. Set to 0.

No. Of Bearers Int 0 10

Number of bearers for which the count needs to be set.

For each ‘No. Of Bearers’. Each entry appears in a {} pair.

{ Int 0 10
>RB Id
AB Id whose PDCP count is to be set.

>UL PDCP Count Int -1

The UL PDCP Count to be set. Set this field to -1 in case UL PDCP Count is
not required to be set.

>DL PDCP Count Int -1


}
The DL PDCP Count to be set. Set this field to -1 in case DL 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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

SFN Int 0 1023

SystemFrameNumber

Sub Frame Number Int 0 9

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

Parameter name Type Min Max Default

Cell Number Int 0 63

Identification of cell from user perspective

166

You might also like