This topic provides information on importing and exporting multi-UE settings files, using *.csv and *.txt file formats.
Comma ',' or Tab can be used as a delimiter of parameters.
".csv" or ".txt" can be used as file extension.
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 |
Signal Studio treats data strings as shown in the following table.
Data in a File |
Data Treated in Signal Studio |
---|---|
ABC |
ABC |
0001 |
0001 |
"ABC" |
ABC |
"0001" |
0001 |
The lines in the CSV file are categorized to lines described in the following table.
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. |
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 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.
Parameter Position |
Parameter Descriptions |
Parameter Values |
---|---|---|
1 |
Parameter type of the common settings for all UEs |
*VERSION |
2 |
CSV format version |
"1.0" |
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.
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 |
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.
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 lines are ignored for reading setting data.
The comment line is a line started with "#" character.
The blank line is a line which does not have any characters.
The blank lines are ignored for reading data.
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.
Reading data as Text; How to set cell attribute to "Text"
File tab, click Open.
Set file extension to Text Files (*.prn, *.txt, *csv).
Select a file (*.txt extension file) and open it.
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.
TXT, CSV extension: Users can choose several setting parameters for opening file.
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.
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.
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.
Select cells.
Select Format Cells.
In the Number tab, select Text in the Category selection.
Click OK.