pti

Set command

The set command enables the RF transmitter.

CAUTION:
This command transmits power to the selected RF band and can violate the radio directives of the region or country. Make sure that the equipment is in an RF-shielded room or connected to an RF cable so that RF power does not leak.

Syntax:

%XRFTEST=<test>,<operation>[,<param0>,<param1>,…,<param10>]

The set command parameters and their defined values are the following:

<test>
1 – TX.
<operation>
1 – ON.
0 – OFF.
Note: Always send OFF <operation> before sending another ON <operation>.
<param0>
3GPP band number.
DECT NR+ band number. Bands 1, 2, 9, and 22 are supported. See ETSI TS 103 636-2 V1.4.1 Table 5.2-1.v2.3.x
<param1>
Frequency (100 kHz).
Valid range 6000–22000 (corresponds to 600.0 MHz–2200.0 MHz).
DECT NR+ carrier number. See ETSI TS 103 636-2 v1.3.1 Table 5.4.2-1 .v2.3.x
<param2>
TX signal power at the System in Package (SiP) antenna port.
Valid range from +23 dBm to −50 dBm.
<param3>
System mode.
0 – Narrowband Internet of Things (NB-IoT).
1 – LTE-M.
10 – DECT NR+.
Note: Some Long-Term Evolution (LTE) bands can be supported in only one of the system modes. To ensure that the band can be used, set the correct mode with the %XSYSTEMMODE command.
<param4>
Modulation.
0 – Quadrature Phase-Shift Keying (QPSK).
1 – 16-state Quadrature Amplitude Modulation (16-QAM).
2 – Reserved.
3 – Binary Phase-Shift Keying (BPSK).
4 – Carrier Wave (CW).
LTE-M: QPSK, 16-QAM, and CW.
NB-IoT: QPSK, BPSK, and CW.
Note:
  • If <param4> is 4 (CW), in system modes NB-IoT and LTE-M the CW tone is offset by 255 kHz from the frequency given in <param1>.
  • If <param4> is 4 (CW), the CW tone is offset from the frequency given in <param1> by 48.75 kHz in system mode NB-IoT and by 401.25 kHz in system mode LTE-M.
  • If <param4> is 4 (CW), <param5>, <param6>, and <param7> are 0 (do not care).
  • If <param4> is 4 (CW) in DECT NR+ system mode, the CW tone is offset by 150 kHz from the center frequency of the DECT NR+ carrier.
5 – DECT NR+ modulation.v2.3.x
DECT NR+ transmitted signal is burst-like. There is a short transmission gap of approximately 200 µs in the signal after four DECT NR+ slots.
<param5>
Resource Block (RB)/Tone count.
Note: For allowed combinations for <param5>, <param6>, and <param7> in NB-IoT and LTE-M system modes (<param3>). See Allowed parameter combinations for <param5>, <param6>, and <param7> in system modes NB-IoT and LTE-M.
Modulation and Coding Scheme (MCS) if <param4> is 5.v2.3.x
<param6>
RB/Tone start position.
If <param4> is 5, <param6> controls DECT NR+ Synchronization Training Field (STF) cover sequence.v2.3.1
0 – Disable cover sequence for STF.
1 – Enable cover sequence for STF.
<param7>
Subcarrier spacing.
0 – 15 k.
1 – 3.75 k.
Not applicable for DECT NR+.v2.3.x
<param8>
System bandwidth.
0 – NB-IoT.
1 – 1.4 M.
2 – Reserved.
3 – 5 MHz.
4 to 6 – Reserved.
Not applicable for DECT NR+.v2.3.x
<param9>
Narrowband index.
0 – 1.4 M.
0 to 3 – 5 M.
Defined in 3GPP TS 36.211 Ch. 6.2.7.
Note: <param9> has effect only when <param8> is 3 (5 MHz).
Not applicable for DECT NR+.v2.3.x
<param10>
TX burst mode.
0 – Disable TX burst mode.
1 – Enable TX burst mode. Not applicable for DECT NR+.v2.3.x
For more information, see TX burst mode.

The allowed combinations for <param5>, <param6>, and <param7> for both system mode (<param3>) values are listed in the following table:

Table 1. Allowed parameter combinations for <param5>, <param6>, and <param7> in system modes NB-IoT and LTE-M
System mode <param3> RB/Tone count <param5> RB/Tone start position <param6> Subcarrier spacing <param7>
NB-IoT (0) 1 0–11 0
3 0, 3, 6, 9 0
6 0, 6 0
12 0 0
1 0–47 1
LTE-M (1) 1 0–5 0
2 0–4 0
3 0–3 0
4 0–2 0
5 0–1 0
6 0 0
Note: In system mode LTE-M, subcarrier spacing 3.75 kHz is not allowed.

Response syntax when <operation> is ON and TX burst mode is disabled:

%XRFTEST: <antenna_power>

The response parameter and its defined value are the following:

<antenna_power>
Internally measured TX power at the SiP antenna port in q4 dBm. q4 means that dividing the result by 24 = 16 gives dBm.
In DECT NR+ system mode, the device does not support the self-measurement of antenna power. The power value in the response is always set to 0.v2.3.x

The following command example enables the RF transmitter for Band 5, 830.0 MHz, +17 dBm, NB-IoT, BPSK, 12 tones, tone start position 0, subcarrier spacing 15 kHz, system bandwidth NB1, NB index 0, TX burst mode disabled:

AT%XRFTEST=1,1,5,8300,17,0,3,12,0,0,0,0,0
%XRFTEST: 271 OK
Note: 271/16 = 16.9 dBm

The following command example enables the RF transmitter for Band 5, 830 MHz, +17 dBm, LTE-M, 16-QAM, 6 RB, RB start position 0, subcarrier spacing 15 kHz, system bandwidth 5 MHz, NB index 3, TX burst mode disabled:

AT%XRFTEST=1,1,5,8300,17,1,1,6,0,0,3,3,0
%XRFTEST: 271 
OK

The following command example enables the RF transmitter for DECT NR+ band 1 on carrier 1657 with +17 dBm power and MCS1 modulation:v2.3.x

AT%XRFTEST=1,1,1,1657,17,10,5,1,0,0,0,0
%XRFTEST: 0
OK

The following command example disables the RF transmitter:

AT%XRFTEST=1,0
OK