NRPPa Tab


The NRPPa (NR Positioning Protocol A) tab is used in the AMF Nodal and AMF Node test cases and gNB CU SA Nodal test case. The AMF Node test case support of NRPPa is for testing of the AMF Nodal test case, the AMF Node / gNB CU SA Nodal will provide limited server (LMF) support of NRPPa. The NRPPa tab is under the LMF tab in AMF Node / gNB CU SA Nodal and the LCS tab in AMF Nodal. It becomes available when LCS Support is enabled in AMF Nodal/AMF Node test cases. Available on Service Based Node test case when LMF (Nlmf) is enabled. When enabled, NRPPa only supports AMF node as peer. 

Click here for the list of supported the messages and associated information elements. See Limitations section at the bottom of this topic. Per - spec 3GPP 38.455 v16.4.0 (2021-07)

    Enable NRPPa

    E-CID Measurement

 

 

    OTDOA Information

Apply Test Data File to NRPPa

Related Measurements

Measurements collected for NRPPa related processing are reported on the NRPPa Server Session and NRPPa Client Session report tabs.


Enable NRPPa

Select to initiate/trigger NRPPa (NR Positioning Protocol A). Available in AMF Nodal and AMF Node Test Cases. Available on Service Based Node test case when LMF (Nlmf) is enabled. When enabled, NRPPa only supports AMF node as peer. 

Tcl Parameter: NrppaEn

NRPPa Version (38.455)

Select to NRPPa Version (38.455). Available in AMF Nodal and AMF Node Test Cases. Available on Service Based Node test case when LMF (Nlmf) is enabled.

Option : 16.4.0/Jul20221

Tcl Parameter: NrppaVersion

E-CID Measurement

Select to include E-CID (Enhanced Cell-ID - positioning method) Measurement. Available in AMF Node Test Case and Service Based Node test case when LMF (Nlmf) is enabled.

The purpose of E-CID Measurement Initiation procedure is to allow the LMF to request the NG-RAN node to report E-CID measurements used by LMF to compute the location of the UE.

 

Report characteristics

 

Measurement Periodicity

 

Terminate on Report Count

Select the Report Characteristics to produce the report either "OnDemand" or "Periodic" - periodically. If "Periodic" is enabled, select the Measurement Periodicity and Report Number.

Select the Measurement Periodicity.

Options : 120ms, 240ms, 480ms, 640ms, 1024ms, 2048ms, 5120ms, 10240ms (default), 1min, 6 min, 12 min, 30 min, 60 min, 20480ms, 40960ms

Select to enable the Terminate on Report Count. This parameter is used to control if / when to send Ecid Measurement Termination Command.

If Terminate on Report Count is not enabled, the Ecid Measurement Termination Command will not be sent.

A value of Zero (0) means, the Ecid Measurement Termination Command will be sent immediately after Ecid Measurement Initiation Request.

Any other value means that the Ecid Measurement Termination Command will be sent after we receive the corresponding number of Ecid Measurement Report.

Options : 0 to 127, Default : 1

Tcl Parameter: NrppaReportCharacteristics

Tcl Parameter: NrppaMeasurementPeriodicity

Tcl Parameter: NrppaReportNumberEn

Tcl Parameter: NrppaReportNumber

Measurement Quantities

Select the Measurement Quantities item.

Options : Cell-ID, Angle of Arrival, Timing Advance Type 1, Timing Advance Type 2, RSRP,  RSRQ,  SS-RSRP, SS-RSRQ, CSI-RSRP,  CSI-RSRQ

Default : Cell-ID

Tcl Parameter: NrppaMeasurementQuantities

Other-RAT Measurement Quantities

Select the Other-RAT Measurement Quantities item.

Options: GERAN, UTRAN, NR, EUTRA

Tcl Parameter: NrppaOtherRatMeasurementQuantities

WLAN Measurement Quantities

Select the WLAN Measurement Quantities item.

Options: WLAN

Tcl Parameter: NrppaWlanMeasurementQuantities

 

Tcl Parameter: NrppaEcidMeasurementEn

OTDOA Information

Select to include OTDOA (Observed Time Difference of Arrival) information type. 

Available in AMF Node Test Case and Service Based Node test case when LMF (Nlmf) is enabled.

The available items are as following: pci (default), cellid, tac, earfcn, prsBandwidth

, prsConfigIndex, cpLength, noDlFrames, noAntennaPorts, sFNInitTime, 

nG-RANAccessPointPosition, prsmutingconfiguration, prsid, tpid, tpType,

crsCPlength, dlBandwidth, multipleprsConfigurationsperCell,

prsOccasionGroup, prsFrequencyHoppingConfiguration, tddConfig

Tcl Parameter: NrppaOtdoaInformationEn

Apply Test Data File to NRPPa

Apply Parameter Values from NRPPa Test Data Files.

TDF Parameter Name

Internal Parameter Name

Value Range
E-CID Measurement ecid_measure_en [true, false]
Report Characteristics report_charact

OnDemand : 0

Periodic : 1

Measurement Periodicity measure_period

120ms : 0

240ms : 1

480ms : 2

640ms : 3

1024ms : 4

2048ms : 5

5120ms : 6

10240ms : 7

1min : 8

6min : 9

12min : 10

30min : 11

60min : 12

20480ms : 13

40960ms : 14

Report Number report_number [-1, 127], -1 means we will not send Ecid Measurement Termination Command. 0 means we will send Ecid Measurement Termination Command immediately after Ecid Measurement Initiation Request. Other value means we will send Ecid Measurement Termination Command after received the corresponding number of Ecid Measurement Report.
Measurement Quantities measure_quant

Semicolon separated strings. The strings should be exactly as those specified in above. For example:Cell-ID,Angle of Arrival,Timing Advance Type 1,RSRP

Other-RAT Measurement Quantities other_rat_measure_quant Semicolon separated strings. The strings should be exactly as those specified in above. Blank value means it should not be included this IE in corresponding message.
WLAN Measurement Quantities wlan_measure_quant Semicolon separated strings. The strings should be exactly as those specified in above. Blank value means it should not be included this IE in corresponding message.
OTDOA Information otdoa_info_en [true, false]
OTDOA Information Type otdoa_info_type Semicolon separated strings. The strings should be exactly as those specified in above.

Tcl Parameter: NrppaCfgFileEn

Tcl Parameter: NrppaCfgFile

See About Applying Parameter ValuesAbout Applying Parameter Values.

See Test Data Files for further explanation and sample files. If a sample is not found for the specific TDF, you can obtain a sample file from your Technical Support representative. You may also use the following options to select an existing TDF or create/edit TDF-CSV files (TDF-CSV Editor). 

For most TDF Parameters used for Applying Parameters, each row in the file is the overridden value for a different “Session”, aka a different UE. But some TDFs are done in other dimensions, like Bearers, eNodeBs, Subscribers (2 per UE sometimes) or even Hosts, etc. Tooltips on the TDF Parameter: 

Note that the “ID” is a unique ID. Please Provide the ID when reporting issues with a TDF. For TDFs that do not apply / override Parameters, but instead are just their own configuration or data or media files you won’t see TDF ID row details.

TIP: When including large files, please be aware of memory limitations, since the TDF Editor shares memory with the Client.

NOTE: The available TDF options vary. on the L3-7 | IPSec tab > IKE with RSA Settings you may only select the Certificate TDF from TAS (these are non-CSV TDFs).

In addition, where applicable, any rules for defining TDFs are included in specific Test Cases. (For example, In MME Node test case, see MME Node - Provisioning TDF.)

From the DMF Window, press Shift+Alt+A to display the  Save DMF as Tcl window. Click the Save to File button to save as Tcl file. See additional details on Using the Tcl API.

 

Select/Create a new TDF-CSV

Allows you to create a new TDF by entering a file name that doesn’t already exist or select an existing file by entering a file name that already exists.

Click to open the Select Existing or Create window.

  • Navigate to the relevant library/folder,

  • Enter the name of the file:

  • If the file name already exists, the file is selected and applied in the test case.

  • If the file name does not exist, a message displays that says you are creating a new TDF and the embedded TDF-CSV will be launched.

    • Click Yes to launch the TDF-CSV Editor and create/save the new TDF-CSV.

    • Click No to select a different file

NOTE: If you do not have permission to save in the selected library, an error displays when you try to create a new file.
TIP: You may also navigate to the relevant library/folder and select file, and click OK.

 

Upload a New TDF to TAS

Click to import a new TDF file from your local folder and select in the test Case (instead of having to go to TDF Admin).

  • Navigate to the file on your local folder and select.
  • Then navigate to the location (library) where you want to save it on the TAS. You may rename the file, if required.  

View Edit Selected TDF in TDF-CSV Editor

Available only when you have selected a TDF on TAS. Click to open the selected file in TDF-CSV Editor (in place, that is, within the Test Case).

Edit the file and save. You may also click Save As to save the edited TDF-CSV to a different library and also rename the file, if required.

NOTE: You may also select a TDF from a library to which you do not have write permissions, edit the file as required, and save (Save As) only to a different library with the same file name or a different name.

The only options available are Save As and Cancel.

Open Selected TDF in Standalone TDF-CSV Editor

Available only when you have selected a TDF on TAS. Select to retrieve the CSV file and open it in the stand alone TDF-CSV Editor.

Generate Stub TDF-CSV

TIP: Available only when a CSV specification has been defined for in the Test Case for the TDF widget ( View TDF Actions/Options Menu)

 

Opens an example context specific test data parametersexample context specific test data parameters, which you may save as a .CSV file or open in the TDF-CSV Editor.

 

Launch Standalone TDF-CSV Editor

Click to open a blank TDF-CSV Editor.

The Launch Standalone TDF-CSV editor options handles very large TDFs that may use too much Client memory if opened within the Test Case/in the embedded editor.  You may set the standalone TDF-CSV Editor memory high to edit large TDFs.

 

Supported Messages

The following sections list the messages and associated information elements at a high level.  

We currently support the configurations of NRPPa parameters on AMF Node. AMF Nodal will use hard-coded values to build the corresponding messages.

Use Command Mode support on AMF Node to trigger the NRPPa procedure on-demand. Sequencer is not supported.

Per Spec reference : 3GPP 38.455 v16.4.0 (2021-07)

E-CID Measurement Initiation

The purpose of E-CID Measurement Initiation procedure is to allow the LMF to request the NG-RAN node to report E-CID measurements used by LMF to compute the location of the UE.  

Figure 1.1.1-1: E-CID Measurement Initiation procedure, successful operation,

 Figure 1.1.1-2: E-CID Measurement Initiation procedure, unsuccessful operation

f the NG-RAN node is not able to initiate at least one of the requested E-CID measurements, the NG-RAN node shall respond with an E-CID MEASUREMENT INITIATION FAILURE message.

E-CID Measurement Report

The purpose of E-CID Measurement Report procedure is for the NG-RAN node to provide the E-CID measurements for the UE to the LMF.  

Figure 1.1.2: E-CID Measurement Report procedure, successful operation

E-CID Measurement Termination

The purpose of E-CID Measurement Termination procedure is to terminate periodical E-CID measurements for the UE performed by the NG-RAN node.

Figure 1.1.3: E-CID Measurement Termination procedure, successful operation

OTDOA Information Exchange

The purpose of the OTDOA Information Exchange procedure is to allow the LMF to request the NG-RAN node to transfer OTDOA information to the LMF.

Figure 1.1.4-1: OTDOA Information Exchange procedure, successful operation

Figure 1.1.4-2: OTDOA Information Exchange procedure, unsuccessful operation

If the NG-RAN node does not have any OTDOA information to report, the NG-RAN node shall respond with an OTDOA INFORMATION FAILURE message

^ Back to Top