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
- <param1>
- Frequency (100 kHz)
Valid range 6000–22000 (corresponds to 600.0 MHz–2200.0
MHz)
- <param2>
- TX signal power at the System in Package (SiP) antenna port
Valid range
from +23 dBm to −50 dBm
- <param3>
- System mode
Valid range 0–1. Narrowband Internet of Things (NB-IoT) (0) or
LTE-M (1).
Note: Some 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>.v1.0.xv1.1.xv1.2.x
- 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.v1.2.x≥1pti_v1.1.x≥1
- If <param4> is 4 (CW), <param5>,
<param6>, and <param7> are 0 (do
not care).
- <param5>
- Resource Block (RB)/Tone count
- <param6>
- RB/Tone start position
- <param7>
- Subcarrier spacing
- 0 – 15 k
- 1 – 3.75 k
- <param8>v1.2.x
- System bandwidth
- 0 – NB-IoT
- 1 – 1.4 M
- 2 – Reserved
- 3 – 5 MHz
- 4 to 6 – Reserved
- <param9>v1.2.x
- 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).
- <param10>v1.2.x≥1pti_v1.1.x≥1
- TX burst mode
- 0 – Disable TX burst mode
- 1 – Enable TX burst mode
- 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.
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 disables the RF transmitter:
AT%XRFTEST=1,0
OK