15 Commands for UE test functions

27.0073GPPAT command set for User Equipment (UE)Release 18TS

Tools: ARFCN - Frequency Conversion for 5G NR/LTE/UMTS/GSM

15.1 General

This clause defines AT commands that a TE can use to control MT test loop function for UE test loop and UTC time reset as specified in 3GPP TS 36.509 [142].

The UE test loop function provides access to isolated functions of the UE via the radio interface without introducing new physical interfaces just for the reason of conformance testing. The UE test loop function is activated by transmitting the appropriate TC message to the UE. The +CATM command activates and deactivates the UE test mode procedure and sets the UE into test loop mode. The +CCUTLE command opens and closes the UE test loop mode E function in the UE for either transmitting or receiving of V2X communication packets. Only UE test loop mode E is supported by AT commands.

The +CUSPCREQ command requests the UE to report the counter of successful reception of sidelink PSCCH transport blocks, STCH PDCP SDU packets and PSSCH transport blocks.

The +CUTCR command resets the UTC time previously calculated from GNSS in the UE.

The +CCBRREQ command requests the UE to report the channel busy ratio (CBR).

The +CV2XDTS command triggers the UE to start or stop sending V2X data over E-UTRA or NR PC5.

The +CSPSAIR command requests the UE to send E-UTRA or NR UEAssistanceInformation message to request SPS grant from eNB.

15.2 Activate test mode +CATM

Table 15.2-1: +CATM parameter command syntax

Command	Possible response(s)
+CATM=[<status>[,<test_loop_mode>]]	+CME ERROR: <err>
+CATM?	+CATM: <status>[,<test_loop_mode>]
+CATM=?	+CATM: (list of supported <status>s),(list of supported <test_loop_mode>s)

Description

The set command is used to activate or deactivate the UE test mode according to UE test mode procedures as defined in 3GPP TS 36.509 [142] clause 5.3.2 and clause 5.3.3 for V2X over E-UTRA PC5, and in 3GPP TS 38.509 [178] clause 5.2.2 and clause 5.2.3 for V2X over NR PC5. When <status>=1, the set command activates the UE test mode and sets the UE in test loop mode. The parameter <test_loop_mode> must be included to indicate the UE test loop mode. When <status>=0, the set command deactivates the UE test mode. Refer clause 9.2 for possible <err> values.

NOTE: Only UE test loop mode E is supported by AT commands.

The read command returns the current UE test mode activation and UE test loop mode statuses.

The test command returns values supported as compound values.

Defined values

<status>: integer type. Indicates the state of UE test mode.

0 deactivated

1 activated

<test_loop_mode>: integer type. Indicates the UE test loop mode.

1 UE test loop mode E

Implementation

Optional.

15.3 Close UE test loop mode E +CCUTLE

Table 15.3-1: +CCUTLE parameter command syntax

Command	Possible response(s)
+CCUTLE=<status>[,<direction>[,<format>,<length>,<monitor_list>]]	+CME ERROR: <err>
+CCUTLE?	+CCUTLE: <status>[,<direction>[,<format>,<length>,<monitor_list>,<sl_mimo>]]
+CCUTLE=?	+CCUTLE: (list of supported <status>s),(list of supported <direction>s),(list of supported <format>s)(maximum supported <length>),(list of supported <sl_mimo>s)

Description

The set command is used to close or open the UE test loop mode E according to UE test loop procedures as defined in 3GPP TS 36.509 [142] clause 5.4.2, clause 5.4.4c and clause 5.4.5 for V2X over E-UTRA PC5, and in 3GPP TS 38.509 [178] clause 5.3.2, clause 5.3.3 and clause 5.3.4.3. The AT command is only applicable when test mode is activated, see clause 15.2. The <status> indicates whether the UE test loop mode E is closed or opened. If <status>=0, the parameters <direction>, <format>, <length> and <monitor_list> are as required provided to configure UE test loop mode E.

The UE test loop mode E provides means for either transmitting or receiving of V2X communication packets, and the <direction> indicates the direction of communication under test. For communication receive operation, <direction>=0 and the UE test loop mode E provides counting of successfully received STCH PDCP SDUs for V2X over E-UTRA PC5 or STCH SDAP SDUs for V2X over NR PC5, PSCCH transport blocks and PSSCH transport blocks. The parameters <format>, <length> and <monitor_list> must be provided. For communication transmit operation, <direction>=1 and the UE test loop mode E provides trigger for transmission of IP packets for V2X communication message on STCH. The parameters <format>, <length> and <monitor_list> are not used and ignored if received. The parameter <sl_mimo> indicates the number of spatial layer(s) used for NR PSSCH transmission for UE which supports SL MIMO, and is not used and ignored if UE doesn’t support SL MIMO. All parameters are discarded when <status>=1 or when the UE test mode is deactivated.

The read command returns the current settings.

The test command returns values supported as compound values.

Defined values

<status>: integer type. Indicates the state of UE test loop E.

0 closed

1 opened

<direction>: integer type. Indicates the direction of communication under test.

0 communication receive

1 communication transmit

<format>: integer type. Indicates the format of the <monitor_list> parameter.

1 binary format

<length>: integer type. Indicates the number of 24 bit Destination Layer-2 IDs in the parameter <monitor_list>.

<monitor_list>: string of octets. This parameter contains all 24 bit Destination Layer-2 IDs to monitor for V2X communication. The type of string is in the format as specified by <format>. The number of 24 bit Destination Layer-2 IDs is given by <length>. The parameter shall not be subject to conventional character conversion as per +CSCS.

<sl_mimo>: integer type. Indicates the number of spatial layer(s) used for NR PSSCH transmission when <direction>=1.

0 1 layer

1 2 layers

Implementation

Optional.

15.4 UE sidelink packet counter request +CUSPCREQ

Table 15.4-1: +CUSPCREQ action command syntax

Command

Possible response(s)

+CUSPCREQ

+CUSPCREQ: [<type1>,<format>,<length1>,<counter1>],[<type2>,<format>,<length2>,<counter2>],[<type3>,<format>,<length3>,<counter3>]

+CME ERROR: <err>

+CUSPCREQ=?

Description

The set command is used to request the UE to report the counter of successful reception of sidelink PSCCH transport blocks, STCH PDCP SDU packets and PSSCH transport blocks according to the ProSe Packet Counter reporting procedure as defined in 3GPP TS 36.509 [142] clause 5.7 for ProSe or V2X over E-UTRA PC5 and/or sidelink PSCCH transport blocks, STCH SDAP SDU packets and/or PSSCH transport blocks according to the ProSe Packet Counter reporting procedure as defined in 3GPP TS 38.509 [178] clause 5.9 for V2X over NR PC5. The AT command is only applicable when test mode is activated, see clause 15.2. Refer clause 9.2 for possible <err> values.

Defined values

<type1>: integer type. Indicates the type of V2X communication.

1 E-UTRA PSCCH transport blocks

2 NR PSCCH transport blocks

<type2>: integer type. Indicates the type of V2X communication.

1 E-UTRA STCH PDCP SDU packets

2 NR STCH SDAP SDU packets

<type3>: integer type. Indicates the type of V2X communication.

1 E-UTRA PSSCH transport blocks

2 NR PSSCH transport blocks

<format>: integer type. Indicates the format of the requested packet counter.

1 binary format

<length1>: integer type. Indicates the number of octets of the <counter1> information element.

<length2>: integer type. Indicates the number of octets of the <counter2> information element.

<length3>: integer type. Indicates the number of octets of the <counter3> information element.

<counter1>: string of octets. Indicates the counter value of E-UTRA PSCCH transport blocks when <type1>=1 and of NR PSCCH transport blocks when <type1>=2. The type of string is in the format as specified by <format>. The parameter shall not be subject to conventional character conversion as per +CSCS.

<counter2>: string of octets. Indicates the counter value of E-UTRA STCH PDCP SDU packets when <type2>=1 and of NR STCH SDAP SDU packets when <type2>=2. The type of string is in the format as specified by <format>. The parameter shall not be subject to conventional character conversion as per +CSCS.

<counter3>: string of octets. Indicates the counter value of E-UTRA PSSCH transport blocks when <type3>=1 and of NR PSSCH transport blocks when <type3>=2. The type of string is in the format as specified by <format>. The parameter shall not be subject to conventional character conversion as per +CSCS.

Implementation

Optional.

15.5 UTC time reset +CUTCR

Table 15.5-1: +CUTCR action command syntax

Command	Possible response(s)
+CUTCR	+CME ERROR: <err>
+CUTCR=?

Description

The set command is used to reset the current UTC time that has been calculated from GNSS in the UE as defined in 3GPP TS 36.509 [142] clause 5.5.3. This allows the UE to rapidly reaquire GNSS and calculate a new value of UTC time. The UE can optionally retain the information that may aid rapid reaquisition of GNSS and the calculation of a new value of UTC time. The AT command is only applicable when test mode is activated, see clause 15.2. Refer clause 9.2 for possible <err> values.

NOTE: This command does not affect functionality provided by other AT commands defined in clauses other than clause 15.

Defined values

None.

Implementation

Optional.

15.6 Channel busy ratio request +CCBRREQ

Table 15.6-1: +CCBRREQ action command syntax

Command

Possible response(s)

+CCBRREQ[=<pc5_type>]

when <pc5_type>=0 (or omitted) and command successful:

+CCBRREQ: <cbr-pssch>[,<cbr-pscch>]

when <pc5_type>=1 and command successful:

+CCBRREQ: <nr-cbr>

+CME ERROR: <err>

+CCBRREQ=?

Description

The set command is used to request the UE to report the Channel busy ratio (CBR) for V2X communication over E-UTRA PC5 measured as specified in 3GPP TS 36.214 [167] clause 5.1.30 or over NR PC5 measured as specified in 3GPP TS 38.215 [179] clause 5.1.27. The AT command is only applicable when test mode is activated, see clause 15.2. Refer clause 9.2 for possible <err> values.

Defined values

<PC5_type>: integer type. Indicates the RAT type of PC5 interface.

0 E-UTRA PC5

1 NR PC5

<cbr-pssch>: integer type. Indicates the CBR measured on the PSSCH for V2X communication over E-UTRA PC5. Value 0 corresponds to CBR=0.0, value 1 corresponds to CBR=0.01, value 2 corresponds to CBR=0.02 and so on.

<cbr-pscch>: integer type. Indicates the CBR measured on the E-UTRA PSCCH. Value 0 corresponds to CBR=0.0, value 1 corresponds to CBR=0.01, value 2 corresponds to CBR=0.02 and so on. This parameter is only returned by the UE if the PSSCH and the PSCCH are transmitted in non-adjacent resource blocks as specified in 3GPP TS 36.214 [167] clause 5.1.30.

<nr-cbr>: integer type. Indicates the CBR measured on the PSSCH for V2X communication over NR PC5. Value 0 corresponds to CBR=0.0, value 1 corresponds to CBR=0.01, value 2 corresponds to CBR=0.02 and so on.

Implementation

Optional.

15.7 V2X data transmission over PC5 +CV2XDTS

Table 15.7-1: +CV2XDTS parameter command syntax

Command	Possible response(s)
+CV2XDTS=<action>[,<data_size>,<periodicity>,<pc5_type>]	+CME ERROR: <err>
+CV2XDTS?	+CV2XDTS: <action>[,<data_size>,<periodicity>][,<pc5_type>]
+CV2XDTS=?	+CV2XDTS: (list of supported <action>s)[,(maximum supported <data_size>),(minimum supported <periodicity>)][,list of supported <pc5_type> s]

Description

The set command is used to trigger the UE to start or stop sending V2X data over PC5 as defined in 3GPP TS 36.213 [166] clause 14. The AT command is only applicable when test mode is activated, see clause 15.2. The <action> indicates whether the UE shall start or stop sending data. If <action>=1, the parameters <data_size> and <periodicity> must be provided. All parameters are discarded when <action>=0 or when the UE test mode is deactivated.

The read command returns the current settings.

The test command returns values supported as compound values.

Defined values

<action>: integer type. Indicates whether the UE shall start or stop sending V2X data over PC5.

0 stop sending data

1 start sending data

<data_size>: integer type. Indicates how many bytes of data the UE shall send over PC5.

NOTE: The data sent by the UE consists of a random bit string. How it is generated is up to UE implementation.

<periodicity>: integer type. Indicates with which periodicity, in milliseconds, the UE shall transmit the number of bytes indicated in <data_size>.

<pc5_type>: integer type. indicates with the RAT type of PC5 over which the UE shall transmit V2X data.

0 E-UTRA PC5

1 NR PC5

Implementation

Optional.

15.8 SPS assistance information request +CSPSAIR

Table 15.8-1: +CSPSAIR action command syntax

Command	Possible Response(s)
+CSPSAIR=<interface>	+CME ERROR: <err>
+CSPSAIR=?	+CSPSAIR: (list of supported <interface>s)

Description

The set command is used to request the UE to send the UEAssistanceInformation message to request SPS grant from eNB as specified in 3GPP TS 36.331 [86] clause 5.6.10.2 or from gNB as specified in 3GPP TS 38.331 [160] clause 5.7.4.2. The set command is only applicable when test mode is activated, see clause 15.2. When <interface>=0, the UE shall send the UEAssistanceInformation message to request UL SPS grant for V2X communication over LTE-Uu from eNB. When <interface>=1, the UE shall send the UEAssistanceInformation message to request SL SPS grant for V2X communication over E-UTRA PC5 from eNB. When <interface>=2, the UE shall send the UEAssistanceInformation message to request UL SPS grant for V2X communication over NR-Uu from gNB. When <interface>=1, the UE shall send the UEAssistanceInformation message to request SL SPS grant for V2X communication over NR PC5 from gNB.

Refer clause 9.2 for possible <err> values.

Test command returns the values supported as a compound value.

Defined values

<interface>: integer type. Indicates the interface type for which UE requests SPS grant from eNB.

0 request UL SPS grant for V2X communication over LTE-Uu from eNB

1 request SL SPS grant for V2X communication over E-UTRA PC5 from eNB

2 request UL SPS grant for V2X communication over NR-Uu from gNB

3 request SL SPS grant for V2X communication over NR PC5 from gNB

Implementation

Optional.