Importing and Exporting Multi-UE Settings Files

This topic provides information on importing and exporting multi-UE settings files, using *.csv and *.txt file formats.

File Format

Setting Parameters

MS Excel Tips

File Format

Delimiters

Comma ',' or Tab can be used as a delimiter of parameters.

File extension

".csv" or ".txt" can be used as file extension.

File extension and data format
Operation Extension

Data Descriptions

 

Write

.txt

A tab character is used as a delimiter of parameters.

.csv

A comma character is used as a delimiter of parameters.

Read

.txt

A comma or a Tab character is recognized as a delimiter of parameters.

.csv

Parameter notations

Signal Studio treats data strings as shown in the following table.

Parmeter notations

Data in a File

Data Treated in Signal Studio

ABC

ABC

0001

0001

"ABC"

ABC

"0001"

0001

Setting Parameters

The lines in the CSV file are categorized to lines described in the following table.

Line categories of CSV file

Line Categories

Parameter Descriptions

Parameter lines

Parameter definition lines, leading by a parameter type.

Comment lines

Comment lines, ignored for reading. Leading by a comment identify character.

Blank lines

Blank (empty) lines, ignored for reading.

Parameter type and line structure

The following table shows the parameter types of lines and the line structure of the CSV file. The parameter type specifies a category of a line in a CSV file.

Parameter type and line order

Parameter

Position

Parameter Descriptions

Parameter Values

1

Specify parameter type to the setting of CSV format version

*VERSION

2

Specify parameter type to the setting of the common parameters for all UEs

*UE-COMMON

3

Specify parameter type to the setting of PUSCH parameters for UE(n), where n = 1 … 100

*PUSCH

The parameter type starts with a "*" character, and it is located at the beginning of parameter lines.

CSV format version setting line

Parameters for version

Parameter

Position

Parameter Descriptions

Parameter Values

1

Parameter type of the common settings for all UEs

*VERSION

2

CSV format version

"1.0"

Common parameters line for all UEs

The following parameters are required for the common setting of all UEs. These parameters are defined in one line.

The range or choices of parameters are basically the same as GUI's parameters definition.

Parameters in all UEs

Parameter

Position

Parameter Descriptions

Parameter Values

1

Parameter type of the common settings for all UEs

*UE-COMMON

2

Multi-UE state

[Not allowed to change]

Choice: ON | OFF

3

Carrier type

Support Advanced LTE UL only

[Not allowed to change]

Choice: Advanced LTE UL

4

Frame structure

[Not allowed to change]

Choice: FDD | TDD

5

System bandwidth

Specify the number of MHz of bandwidth

Choice: 1.4 | 3 | 5 | 10 | 15 | 20

Default: 5

6

[Used TDD only, not used for FDD]

UL/DL configuration

Choice: <integer> 0 ... 6

Default: 0

7

Cell ID

Choice: <integer> 0 ... 503

Default: 0

8

Waveform generation length

Specify the waveform length in ms

Choice: <integer> 10 ... 160, stepped by 10

Default: 10

9

Number of UEs

Choice: <integer> 1 ... 100

Default: 25

10

PUSCH state

Read only

Choices: ON | OFF

Default: ON

PUSCH parameters line for each UE

The following parameters are required for each UE setting. These parameters are lined into one line. And one line represents the setting of one UE. One hundred lines, therefore, are required for 100 UEs settings, because one hundred is the maximum number of UEs and always all definitions are listed in a setting file.

The range or choices of parameters are basically the same as GUI's parameters definition.

PUSCH parameters for each UE

Parameter

Position

Parameter Descriptions

Parameter Values

1

Parameter type of PUSCH for each UE

The order of PUSCH setting lines expresses the UE number.

*PUSCH

2

RNTI

Choice: <integer> 0 ... 65535

3

MCS index

Choice: <integer> 0 ... 28

4

HARQ ACK state

Choice: ON | OFF

5

HARQ ACK offset index

Choice: <integer> 0 ... 14

6

HARQ ACK info

Choice: ACK | NACK | ACK-ACK | ACK-NACK | NACK-ACK | NACK-NACK | User Defined Bits (Up to 11 bits) consist of '0' and '1'

7

HARQ ACK info size

Choice: 1 to 11

Default: 1

8

RI state

Choice: ON | OFF

Default: OFF

9

RI offset index

Choice: <integer> 0 ... 12

Default: 0

10

RI info

Choice: 0 | 1 | 0-0 | 0-1 | 1-0 | 1-1

Default: 0

11

RI info size

[Read only]

12

CQI/PMI state

Choice: ON | OFF

13

CQI/PMI offset index

Choice: <integer> 2 ... 15

Default: 2

14

CQI/PMI info

Choice: PN9 | PN15 | User Defined Bits (Up to 128 bits)

Default: PN9

15

CQI/PMI info size

Choice: <integer> 1 … 128

Default: 4

16 + n * 3

Subframe(n) PUSCH Tx state, where n = 0 … 159

Choices: ON | OFF

Default: ON

17 + n * 3

Subframe(n) PUSCH RB offset, where n = 0 … 159

Choice: <integer> 0 … x

Default: 0

18 + n * 3

Subframe(n) PUSCH RB offset, where n = 0 … 159

Choice: <integer> 0 … x

Default: 1

Comment line

Comment lines are ignored for reading setting data.

The comment line is a line started with "#" character.

Blank line

The blank line is a line which does not have any characters.

The blank lines are ignored for reading data.

MS Excel Tips

Open file

Excel behavior has difference with the file extension of opening file name.

TXT extension: Users can choose several setting parameters for opening file.

CSV extension: Comma delimiters are expected, and parameter values are automatically converted by Excel.

Operation sample

Reading data as Text; How to set cell attribute to "Text"

  1. File tab, click Open.

  2. Set file extension to Text Files (*.prn, *.txt, *csv).

  3. Select a file (*.txt extension file) and open it.

  4. In the Text Import Wizard:

    Step 1 of 3:

    Select Delimited, then click Next button.

    Step 2 of 3:

    Select Tab as Delimiters. When commas are used as delimiter, click Comma as Delimiters. Then click Next button.

    Step 3 of 3:

    Click the column 1 in the Data preview area, then scroll the preview cell image to the most right side.

    Then Shift + click the most right cell. (All columns are selected on this action.)

    Select Text in the Column data format area. (All cells are recognized as Text cell.

    Then, click Finish button.

Import file

TXT, CSV extension: Users can choose several setting parameters for opening file.

Operation sample

Data tab, Get External section, click From Text.

Select *.csv or *.txt file on Import Text File window.

Proceed setting same as "File open" method.

Proceed as desired.

Save file

Excel behavior has difference with the file extension of saving file name.

TXT extension: Tab characters are used as delimiters.

CSV extension: Comma characters are used as delimiters.

Notes of values on Excel

Some values, such as 00000001, are treated by Excel when Excel reads a file and values. The values are sometimes converted with undesired manner. For example, 00000001 is recognized to 1 if Excel recognizes it as a numeric number. If Excel recognizes it as a text value, 00000001 is read correctly as 00000001.

Treat as a string:

Use "…" notation for bit data, such as "00001", because Excel treats 00001 to 1. If the type of cell is set to "string", this does not happen.

Hints: Set cell attribute to string type

  1. Select cells.

  2. Select Format Cells.

    In the Number tab, select Text in the Category selection.

    Click OK.